1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507750875097510751175127513751475157516751775187519752075217522752375247525752675277528752975307531753275337534753575367537753875397540754175427543754475457546754775487549755075517552755375547555755675577558755975607561756275637564756575667567756875697570757175727573757475757576757775787579758075817582758375847585758675877588758975907591759275937594759575967597759875997600760176027603760476057606760776087609761076117612761376147615761676177618761976207621762276237624762576267627762876297630763176327633763476357636763776387639764076417642764376447645764676477648764976507651765276537654765576567657765876597660766176627663766476657666766776687669767076717672767376747675767676777678767976807681768276837684768576867687768876897690769176927693769476957696769776987699770077017702770377047705770677077708770977107711771277137714771577167717771877197720772177227723772477257726772777287729773077317732773377347735773677377738773977407741774277437744774577467747774877497750775177527753775477557756775777587759776077617762776377647765776677677768776977707771777277737774777577767777777877797780778177827783778477857786778777887789779077917792779377947795779677977798779978007801780278037804780578067807780878097810781178127813781478157816781778187819782078217822782378247825782678277828782978307831783278337834783578367837783878397840784178427843784478457846784778487849785078517852785378547855785678577858785978607861786278637864786578667867786878697870787178727873787478757876787778787879788078817882788378847885788678877888788978907891789278937894789578967897789878997900790179027903790479057906790779087909791079117912791379147915791679177918791979207921792279237924792579267927792879297930793179327933793479357936793779387939794079417942794379447945794679477948794979507951795279537954795579567957795879597960796179627963796479657966796779687969797079717972797379747975797679777978797979807981798279837984798579867987798879897990799179927993799479957996799779987999800080018002800380048005800680078008800980108011801280138014801580168017801880198020802180228023802480258026802780288029803080318032803380348035803680378038803980408041804280438044804580468047804880498050805180528053805480558056805780588059806080618062806380648065806680678068806980708071807280738074807580768077807880798080808180828083808480858086808780888089809080918092809380948095809680978098809981008101810281038104810581068107810881098110811181128113811481158116811781188119812081218122812381248125812681278128812981308131813281338134813581368137813881398140814181428143814481458146814781488149815081518152815381548155815681578158815981608161816281638164816581668167816881698170817181728173817481758176817781788179818081818182818381848185818681878188818981908191819281938194819581968197819881998200820182028203820482058206820782088209821082118212821382148215821682178218821982208221822282238224822582268227822882298230823182328233823482358236823782388239824082418242824382448245824682478248824982508251825282538254825582568257825882598260826182628263826482658266826782688269827082718272827382748275827682778278827982808281828282838284828582868287828882898290829182928293829482958296829782988299830083018302830383048305830683078308830983108311831283138314831583168317831883198320832183228323832483258326832783288329833083318332833383348335833683378338833983408341834283438344834583468347834883498350835183528353835483558356835783588359836083618362836383648365836683678368836983708371837283738374837583768377837883798380838183828383838483858386838783888389839083918392839383948395839683978398839984008401840284038404840584068407840884098410841184128413841484158416841784188419842084218422842384248425842684278428842984308431843284338434843584368437843884398440844184428443844484458446844784488449845084518452845384548455845684578458845984608461846284638464846584668467846884698470847184728473847484758476847784788479848084818482848384848485848684878488848984908491849284938494849584968497849884998500850185028503850485058506850785088509851085118512851385148515851685178518851985208521852285238524852585268527852885298530853185328533853485358536853785388539854085418542854385448545854685478548854985508551855285538554855585568557855885598560856185628563856485658566856785688569857085718572857385748575857685778578857985808581858285838584858585868587858885898590859185928593859485958596859785988599860086018602860386048605860686078608860986108611861286138614861586168617861886198620862186228623862486258626862786288629863086318632863386348635863686378638863986408641864286438644864586468647864886498650865186528653865486558656865786588659866086618662866386648665866686678668866986708671867286738674867586768677867886798680868186828683868486858686868786888689869086918692869386948695869686978698869987008701870287038704870587068707870887098710871187128713871487158716871787188719872087218722872387248725872687278728872987308731873287338734873587368737873887398740874187428743874487458746874787488749875087518752875387548755875687578758875987608761876287638764876587668767876887698770877187728773877487758776877787788779878087818782878387848785878687878788878987908791879287938794879587968797879887998800880188028803880488058806880788088809881088118812881388148815881688178818881988208821882288238824882588268827882888298830883188328833883488358836883788388839884088418842884388448845884688478848884988508851885288538854885588568857885888598860886188628863886488658866886788688869887088718872887388748875887688778878887988808881888288838884888588868887888888898890889188928893889488958896889788988899890089018902890389048905890689078908890989108911891289138914891589168917891889198920892189228923892489258926892789288929893089318932893389348935893689378938893989408941894289438944894589468947894889498950895189528953895489558956895789588959896089618962896389648965896689678968896989708971897289738974897589768977897889798980898189828983898489858986898789888989899089918992899389948995899689978998899990009001900290039004900590069007900890099010901190129013901490159016901790189019902090219022902390249025902690279028902990309031903290339034903590369037903890399040904190429043904490459046904790489049905090519052905390549055905690579058905990609061906290639064906590669067906890699070907190729073907490759076907790789079908090819082908390849085908690879088908990909091909290939094909590969097909890999100910191029103910491059106910791089109911091119112911391149115911691179118911991209121912291239124912591269127912891299130913191329133913491359136913791389139914091419142914391449145914691479148914991509151915291539154915591569157915891599160916191629163916491659166916791689169917091719172917391749175917691779178917991809181918291839184918591869187918891899190919191929193919491959196919791989199920092019202920392049205920692079208920992109211921292139214921592169217921892199220922192229223922492259226922792289229923092319232923392349235923692379238923992409241924292439244924592469247924892499250925192529253925492559256925792589259926092619262926392649265926692679268926992709271927292739274927592769277927892799280928192829283928492859286928792889289929092919292929392949295929692979298929993009301930293039304930593069307930893099310931193129313931493159316931793189319932093219322932393249325932693279328932993309331933293339334933593369337933893399340934193429343934493459346934793489349935093519352935393549355935693579358935993609361936293639364936593669367936893699370937193729373937493759376937793789379938093819382938393849385938693879388938993909391939293939394939593969397939893999400940194029403940494059406940794089409941094119412941394149415941694179418941994209421942294239424942594269427942894299430943194329433943494359436943794389439944094419442944394449445944694479448944994509451945294539454945594569457945894599460946194629463946494659466946794689469947094719472947394749475947694779478947994809481948294839484948594869487948894899490949194929493949494959496949794989499950095019502950395049505950695079508950995109511951295139514951595169517951895199520952195229523952495259526952795289529953095319532953395349535953695379538953995409541954295439544954595469547954895499550955195529553955495559556955795589559956095619562956395649565956695679568956995709571957295739574957595769577957895799580958195829583958495859586958795889589959095919592959395949595959695979598959996009601960296039604960596069607960896099610961196129613961496159616961796189619962096219622962396249625962696279628962996309631963296339634963596369637963896399640964196429643964496459646964796489649965096519652965396549655965696579658965996609661966296639664966596669667966896699670967196729673967496759676967796789679968096819682968396849685968696879688968996909691969296939694969596969697969896999700970197029703970497059706970797089709971097119712971397149715971697179718971997209721972297239724972597269727972897299730973197329733973497359736973797389739974097419742974397449745974697479748974997509751975297539754975597569757975897599760976197629763976497659766976797689769977097719772977397749775977697779778977997809781978297839784978597869787978897899790979197929793979497959796979797989799980098019802980398049805980698079808980998109811981298139814981598169817981898199820982198229823982498259826982798289829983098319832983398349835983698379838983998409841984298439844984598469847984898499850985198529853985498559856985798589859986098619862986398649865986698679868986998709871987298739874987598769877987898799880988198829883988498859886988798889889989098919892989398949895989698979898989999009901990299039904990599069907990899099910991199129913991499159916991799189919992099219922992399249925992699279928992999309931993299339934993599369937993899399940994199429943994499459946994799489949995099519952995399549955995699579958995999609961996299639964996599669967996899699970997199729973997499759976997799789979998099819982998399849985998699879988998999909991999299939994999599969997999899991000010001100021000310004100051000610007100081000910010100111001210013100141001510016100171001810019100201002110022100231002410025100261002710028100291003010031100321003310034100351003610037100381003910040100411004210043100441004510046100471004810049100501005110052100531005410055100561005710058100591006010061100621006310064100651006610067100681006910070100711007210073100741007510076100771007810079100801008110082100831008410085100861008710088100891009010091100921009310094100951009610097100981009910100101011010210103101041010510106101071010810109101101011110112101131011410115101161011710118101191012010121101221012310124101251012610127101281012910130101311013210133101341013510136101371013810139101401014110142101431014410145101461014710148101491015010151101521015310154101551015610157101581015910160101611016210163101641016510166101671016810169101701017110172101731017410175101761017710178101791018010181101821018310184101851018610187101881018910190101911019210193101941019510196101971019810199102001020110202102031020410205102061020710208102091021010211102121021310214102151021610217102181021910220102211022210223102241022510226102271022810229102301023110232102331023410235102361023710238102391024010241102421024310244102451024610247102481024910250102511025210253102541025510256102571025810259102601026110262102631026410265102661026710268102691027010271102721027310274102751027610277102781027910280102811028210283102841028510286102871028810289102901029110292102931029410295102961029710298102991030010301103021030310304103051030610307103081030910310103111031210313103141031510316103171031810319103201032110322103231032410325103261032710328103291033010331103321033310334103351033610337103381033910340103411034210343103441034510346103471034810349103501035110352103531035410355103561035710358103591036010361103621036310364103651036610367103681036910370103711037210373103741037510376103771037810379103801038110382103831038410385103861038710388103891039010391103921039310394103951039610397103981039910400104011040210403104041040510406104071040810409104101041110412104131041410415104161041710418104191042010421104221042310424104251042610427104281042910430104311043210433104341043510436104371043810439104401044110442104431044410445104461044710448104491045010451104521045310454104551045610457104581045910460104611046210463104641046510466104671046810469104701047110472104731047410475104761047710478104791048010481104821048310484104851048610487104881048910490104911049210493104941049510496104971049810499105001050110502105031050410505105061050710508105091051010511105121051310514105151051610517105181051910520105211052210523105241052510526105271052810529105301053110532105331053410535105361053710538105391054010541105421054310544105451054610547105481054910550105511055210553105541055510556105571055810559105601056110562105631056410565105661056710568105691057010571105721057310574105751057610577105781057910580105811058210583105841058510586105871058810589105901059110592105931059410595105961059710598105991060010601106021060310604106051060610607106081060910610106111061210613106141061510616106171061810619106201062110622106231062410625106261062710628106291063010631106321063310634106351063610637106381063910640106411064210643106441064510646106471064810649106501065110652106531065410655106561065710658106591066010661106621066310664106651066610667106681066910670106711067210673106741067510676106771067810679106801068110682106831068410685106861068710688106891069010691106921069310694106951069610697106981069910700107011070210703107041070510706107071070810709107101071110712107131071410715107161071710718107191072010721107221072310724107251072610727107281072910730107311073210733107341073510736107371073810739107401074110742107431074410745107461074710748107491075010751107521075310754107551075610757107581075910760107611076210763107641076510766107671076810769107701077110772107731077410775107761077710778107791078010781107821078310784107851078610787107881078910790107911079210793107941079510796107971079810799108001080110802108031080410805108061080710808108091081010811108121081310814108151081610817108181081910820108211082210823108241082510826108271082810829108301083110832108331083410835108361083710838108391084010841108421084310844108451084610847108481084910850108511085210853108541085510856108571085810859108601086110862108631086410865108661086710868108691087010871108721087310874108751087610877108781087910880108811088210883108841088510886108871088810889108901089110892108931089410895108961089710898108991090010901109021090310904109051090610907109081090910910109111091210913109141091510916109171091810919109201092110922109231092410925109261092710928109291093010931109321093310934109351093610937109381093910940109411094210943109441094510946109471094810949109501095110952109531095410955109561095710958109591096010961109621096310964109651096610967109681096910970109711097210973109741097510976109771097810979109801098110982109831098410985109861098710988109891099010991109921099310994109951099610997109981099911000110011100211003110041100511006110071100811009110101101111012110131101411015110161101711018110191102011021110221102311024110251102611027110281102911030110311103211033110341103511036110371103811039110401104111042110431104411045110461104711048110491105011051110521105311054110551105611057110581105911060110611106211063110641106511066110671106811069110701107111072110731107411075110761107711078110791108011081110821108311084110851108611087110881108911090110911109211093110941109511096110971109811099111001110111102111031110411105111061110711108111091111011111111121111311114111151111611117111181111911120111211112211123111241112511126111271112811129111301113111132111331113411135111361113711138111391114011141111421114311144111451114611147111481114911150111511115211153111541115511156111571115811159111601116111162111631116411165111661116711168111691117011171111721117311174111751117611177111781117911180111811118211183111841118511186111871118811189111901119111192111931119411195111961119711198111991120011201112021120311204112051120611207112081120911210112111121211213112141121511216112171121811219112201122111222112231122411225112261122711228112291123011231112321123311234112351123611237112381123911240112411124211243112441124511246112471124811249112501125111252112531125411255112561125711258112591126011261112621126311264112651126611267112681126911270112711127211273112741127511276112771127811279112801128111282112831128411285112861128711288112891129011291112921129311294112951129611297112981129911300113011130211303113041130511306113071130811309113101131111312113131131411315113161131711318113191132011321113221132311324113251132611327113281132911330113311133211333113341133511336113371133811339113401134111342113431134411345113461134711348113491135011351113521135311354113551135611357113581135911360113611136211363113641136511366113671136811369113701137111372113731137411375113761137711378113791138011381113821138311384113851138611387113881138911390113911139211393113941139511396113971139811399114001140111402114031140411405114061140711408114091141011411114121141311414114151141611417114181141911420114211142211423114241142511426114271142811429114301143111432114331143411435114361143711438114391144011441114421144311444114451144611447114481144911450114511145211453114541145511456114571145811459114601146111462114631146411465114661146711468114691147011471114721147311474114751147611477114781147911480114811148211483114841148511486114871148811489114901149111492114931149411495114961149711498114991150011501115021150311504115051150611507115081150911510115111151211513115141151511516115171151811519115201152111522115231152411525115261152711528115291153011531115321153311534115351153611537115381153911540115411154211543115441154511546115471154811549115501155111552115531155411555115561155711558115591156011561115621156311564115651156611567115681156911570115711157211573115741157511576115771157811579115801158111582115831158411585115861158711588115891159011591115921159311594115951159611597115981159911600116011160211603116041160511606116071160811609116101161111612116131161411615116161161711618116191162011621116221162311624116251162611627116281162911630116311163211633116341163511636116371163811639116401164111642116431164411645116461164711648116491165011651116521165311654116551165611657116581165911660116611166211663116641166511666116671166811669116701167111672116731167411675116761167711678116791168011681116821168311684116851168611687116881168911690116911169211693116941169511696116971169811699117001170111702117031170411705117061170711708117091171011711117121171311714117151171611717117181171911720117211172211723117241172511726117271172811729117301173111732117331173411735117361173711738117391174011741117421174311744117451174611747117481174911750117511175211753117541175511756117571175811759117601176111762117631176411765117661176711768117691177011771117721177311774117751177611777117781177911780117811178211783117841178511786117871178811789117901179111792117931179411795117961179711798117991180011801118021180311804118051180611807118081180911810118111181211813118141181511816118171181811819118201182111822118231182411825118261182711828118291183011831118321183311834118351183611837118381183911840118411184211843118441184511846118471184811849118501185111852118531185411855118561185711858118591186011861118621186311864118651186611867118681186911870118711187211873118741187511876118771187811879118801188111882118831188411885118861188711888118891189011891118921189311894118951189611897118981189911900119011190211903119041190511906119071190811909119101191111912119131191411915119161191711918119191192011921119221192311924119251192611927119281192911930119311193211933119341193511936119371193811939119401194111942119431194411945119461194711948119491195011951119521195311954119551195611957119581195911960119611196211963119641196511966119671196811969119701197111972119731197411975119761197711978119791198011981119821198311984119851198611987119881198911990119911199211993119941199511996119971199811999120001200112002120031200412005120061200712008120091201012011120121201312014120151201612017120181201912020120211202212023120241202512026120271202812029120301203112032120331203412035120361203712038120391204012041120421204312044120451204612047120481204912050120511205212053120541205512056120571205812059120601206112062120631206412065120661206712068120691207012071120721207312074120751207612077120781207912080120811208212083120841208512086120871208812089120901209112092120931209412095120961209712098120991210012101121021210312104121051210612107121081210912110121111211212113121141211512116121171211812119121201212112122121231212412125121261212712128121291213012131121321213312134121351213612137121381213912140121411214212143121441214512146121471214812149121501215112152121531215412155121561215712158121591216012161121621216312164121651216612167121681216912170121711217212173121741217512176121771217812179121801218112182121831218412185121861218712188121891219012191121921219312194121951219612197121981219912200122011220212203122041220512206122071220812209122101221112212122131221412215122161221712218122191222012221122221222312224122251222612227122281222912230122311223212233122341223512236122371223812239122401224112242122431224412245122461224712248122491225012251122521225312254122551225612257122581225912260122611226212263122641226512266122671226812269122701227112272122731227412275122761227712278122791228012281122821228312284122851228612287122881228912290122911229212293122941229512296122971229812299123001230112302123031230412305123061230712308123091231012311123121231312314123151231612317123181231912320123211232212323123241232512326123271232812329123301233112332123331233412335123361233712338123391234012341123421234312344123451234612347123481234912350123511235212353123541235512356123571235812359123601236112362123631236412365123661236712368123691237012371123721237312374123751237612377123781237912380123811238212383123841238512386123871238812389123901239112392123931239412395123961239712398123991240012401124021240312404124051240612407124081240912410124111241212413124141241512416124171241812419124201242112422124231242412425124261242712428124291243012431124321243312434124351243612437124381243912440124411244212443124441244512446124471244812449124501245112452124531245412455124561245712458124591246012461124621246312464124651246612467124681246912470124711247212473124741247512476124771247812479124801248112482124831248412485124861248712488124891249012491124921249312494124951249612497124981249912500125011250212503125041250512506125071250812509125101251112512125131251412515125161251712518125191252012521125221252312524125251252612527125281252912530125311253212533125341253512536125371253812539125401254112542125431254412545125461254712548125491255012551125521255312554125551255612557125581255912560125611256212563125641256512566125671256812569125701257112572125731257412575125761257712578125791258012581125821258312584125851258612587125881258912590125911259212593125941259512596125971259812599126001260112602126031260412605126061260712608126091261012611126121261312614126151261612617126181261912620126211262212623126241262512626126271262812629126301263112632126331263412635126361263712638126391264012641126421264312644126451264612647126481264912650126511265212653126541265512656126571265812659126601266112662126631266412665126661266712668126691267012671126721267312674126751267612677126781267912680126811268212683126841268512686126871268812689126901269112692126931269412695126961269712698126991270012701127021270312704127051270612707127081270912710127111271212713127141271512716127171271812719127201272112722127231272412725127261272712728127291273012731127321273312734127351273612737127381273912740127411274212743127441274512746127471274812749127501275112752127531275412755127561275712758127591276012761127621276312764127651276612767127681276912770127711277212773127741277512776127771277812779127801278112782127831278412785127861278712788127891279012791127921279312794127951279612797127981279912800128011280212803128041280512806128071280812809128101281112812128131281412815128161281712818128191282012821128221282312824128251282612827128281282912830128311283212833128341283512836128371283812839128401284112842128431284412845128461284712848128491285012851128521285312854128551285612857128581285912860128611286212863128641286512866128671286812869128701287112872128731287412875128761287712878128791288012881128821288312884128851288612887128881288912890128911289212893128941289512896128971289812899129001290112902129031290412905129061290712908129091291012911129121291312914129151291612917129181291912920129211292212923129241292512926129271292812929129301293112932129331293412935129361293712938129391294012941129421294312944129451294612947129481294912950129511295212953129541295512956129571295812959129601296112962129631296412965129661296712968129691297012971129721297312974129751297612977129781297912980129811298212983129841298512986129871298812989129901299112992129931299412995129961299712998129991300013001130021300313004130051300613007130081300913010130111301213013130141301513016130171301813019130201302113022130231302413025130261302713028130291303013031130321303313034130351303613037130381303913040130411304213043130441304513046130471304813049130501305113052130531305413055130561305713058130591306013061130621306313064130651306613067130681306913070130711307213073130741307513076130771307813079130801308113082130831308413085130861308713088130891309013091130921309313094130951309613097130981309913100131011310213103131041310513106131071310813109131101311113112131131311413115131161311713118131191312013121131221312313124131251312613127131281312913130131311313213133131341313513136131371313813139131401314113142131431314413145131461314713148131491315013151131521315313154131551315613157131581315913160131611316213163131641316513166131671316813169131701317113172131731317413175131761317713178131791318013181131821318313184131851318613187131881318913190131911319213193131941319513196131971319813199132001320113202132031320413205132061320713208132091321013211132121321313214132151321613217132181321913220132211322213223132241322513226132271322813229132301323113232132331323413235132361323713238132391324013241132421324313244132451324613247132481324913250132511325213253132541325513256132571325813259132601326113262132631326413265132661326713268132691327013271132721327313274132751327613277132781327913280132811328213283132841328513286132871328813289132901329113292132931329413295132961329713298132991330013301133021330313304133051330613307133081330913310133111331213313133141331513316133171331813319133201332113322133231332413325133261332713328133291333013331133321333313334133351333613337133381333913340133411334213343133441334513346133471334813349133501335113352133531335413355133561335713358133591336013361133621336313364133651336613367133681336913370133711337213373133741337513376133771337813379133801338113382133831338413385133861338713388133891339013391133921339313394133951339613397133981339913400134011340213403134041340513406134071340813409134101341113412134131341413415134161341713418134191342013421134221342313424134251342613427134281342913430134311343213433134341343513436134371343813439134401344113442134431344413445134461344713448134491345013451134521345313454134551345613457134581345913460134611346213463134641346513466134671346813469134701347113472134731347413475134761347713478134791348013481134821348313484134851348613487134881348913490134911349213493134941349513496134971349813499135001350113502135031350413505135061350713508135091351013511135121351313514135151351613517135181351913520135211352213523135241352513526135271352813529135301353113532135331353413535135361353713538135391354013541135421354313544135451354613547135481354913550135511355213553135541355513556135571355813559135601356113562135631356413565135661356713568135691357013571135721357313574135751357613577135781357913580135811358213583135841358513586135871358813589135901359113592135931359413595135961359713598135991360013601136021360313604136051360613607136081360913610136111361213613136141361513616136171361813619136201362113622136231362413625136261362713628136291363013631136321363313634136351363613637136381363913640136411364213643136441364513646136471364813649136501365113652136531365413655136561365713658136591366013661136621366313664136651366613667136681366913670136711367213673136741367513676136771367813679136801368113682136831368413685136861368713688136891369013691136921369313694136951369613697136981369913700137011370213703137041370513706137071370813709137101371113712137131371413715137161371713718137191372013721137221372313724137251372613727137281372913730137311373213733137341373513736137371373813739137401374113742137431374413745137461374713748137491375013751137521375313754137551375613757137581375913760137611376213763137641376513766137671376813769137701377113772137731377413775137761377713778137791378013781137821378313784137851378613787137881378913790137911379213793137941379513796137971379813799138001380113802138031380413805138061380713808138091381013811138121381313814138151381613817138181381913820138211382213823138241382513826138271382813829138301383113832138331383413835138361383713838138391384013841138421384313844138451384613847138481384913850138511385213853138541385513856138571385813859138601386113862138631386413865138661386713868138691387013871138721387313874138751387613877138781387913880138811388213883138841388513886138871388813889138901389113892138931389413895138961389713898138991390013901139021390313904139051390613907139081390913910139111391213913139141391513916139171391813919139201392113922139231392413925139261392713928139291393013931139321393313934139351393613937139381393913940139411394213943139441394513946139471394813949139501395113952139531395413955139561395713958139591396013961139621396313964139651396613967139681396913970139711397213973139741397513976139771397813979139801398113982139831398413985139861398713988139891399013991139921399313994139951399613997139981399914000140011400214003140041400514006140071400814009140101401114012140131401414015140161401714018140191402014021140221402314024140251402614027140281402914030140311403214033140341403514036140371403814039140401404114042140431404414045140461404714048140491405014051140521405314054140551405614057140581405914060140611406214063140641406514066140671406814069140701407114072140731407414075140761407714078140791408014081140821408314084140851408614087140881408914090140911409214093140941409514096140971409814099141001410114102141031410414105141061410714108141091411014111141121411314114141151411614117141181411914120141211412214123141241412514126141271412814129141301413114132141331413414135141361413714138141391414014141141421414314144141451414614147141481414914150141511415214153141541415514156141571415814159141601416114162141631416414165141661416714168141691417014171141721417314174141751417614177141781417914180141811418214183141841418514186141871418814189141901419114192141931419414195141961419714198141991420014201142021420314204142051420614207142081420914210142111421214213142141421514216142171421814219142201422114222142231422414225142261422714228142291423014231142321423314234142351423614237142381423914240142411424214243142441424514246142471424814249142501425114252142531425414255142561425714258142591426014261142621426314264142651426614267142681426914270142711427214273142741427514276142771427814279142801428114282142831428414285142861428714288142891429014291142921429314294142951429614297142981429914300143011430214303143041430514306143071430814309143101431114312143131431414315143161431714318143191432014321143221432314324143251432614327143281432914330143311433214333143341433514336143371433814339143401434114342143431434414345143461434714348143491435014351143521435314354143551435614357143581435914360143611436214363143641436514366143671436814369143701437114372143731437414375143761437714378143791438014381143821438314384143851438614387143881438914390143911439214393143941439514396143971439814399144001440114402144031440414405144061440714408144091441014411144121441314414144151441614417144181441914420144211442214423144241442514426144271442814429144301443114432144331443414435144361443714438144391444014441144421444314444144451444614447144481444914450144511445214453144541445514456144571445814459144601446114462144631446414465144661446714468144691447014471144721447314474144751447614477144781447914480144811448214483144841448514486144871448814489144901449114492144931449414495144961449714498144991450014501145021450314504145051450614507145081450914510145111451214513145141451514516145171451814519145201452114522145231452414525145261452714528145291453014531145321453314534145351453614537145381453914540145411454214543145441454514546145471454814549145501455114552145531455414555145561455714558145591456014561145621456314564145651456614567145681456914570145711457214573145741457514576145771457814579145801458114582145831458414585145861458714588145891459014591145921459314594145951459614597145981459914600146011460214603146041460514606146071460814609146101461114612146131461414615146161461714618146191462014621146221462314624146251462614627146281462914630146311463214633146341463514636146371463814639146401464114642146431464414645146461464714648146491465014651146521465314654146551465614657146581465914660146611466214663146641466514666146671466814669146701467114672146731467414675146761467714678146791468014681146821468314684146851468614687146881468914690146911469214693146941469514696146971469814699147001470114702147031470414705147061470714708147091471014711147121471314714147151471614717147181471914720147211472214723147241472514726147271472814729147301473114732147331473414735147361473714738147391474014741147421474314744147451474614747147481474914750147511475214753147541475514756147571475814759147601476114762147631476414765147661476714768147691477014771147721477314774147751477614777147781477914780147811478214783147841478514786147871478814789147901479114792147931479414795147961479714798147991480014801148021480314804148051480614807148081480914810148111481214813148141481514816148171481814819148201482114822148231482414825148261482714828148291483014831148321483314834148351483614837148381483914840148411484214843148441484514846148471484814849148501485114852148531485414855148561485714858148591486014861148621486314864148651486614867148681486914870148711487214873148741487514876148771487814879148801488114882148831488414885148861488714888148891489014891148921489314894148951489614897148981489914900149011490214903149041490514906149071490814909149101491114912149131491414915149161491714918149191492014921149221492314924149251492614927149281492914930149311493214933149341493514936149371493814939149401494114942149431494414945149461494714948149491495014951149521495314954149551495614957149581495914960149611496214963149641496514966149671496814969149701497114972149731497414975149761497714978149791498014981149821498314984149851498614987149881498914990149911499214993149941499514996149971499814999150001500115002150031500415005150061500715008150091501015011150121501315014150151501615017150181501915020150211502215023150241502515026150271502815029150301503115032150331503415035150361503715038150391504015041150421504315044150451504615047150481504915050150511505215053150541505515056150571505815059150601506115062150631506415065150661506715068150691507015071150721507315074150751507615077150781507915080150811508215083150841508515086150871508815089150901509115092150931509415095150961509715098150991510015101151021510315104151051510615107151081510915110151111511215113151141511515116151171511815119151201512115122151231512415125151261512715128151291513015131151321513315134151351513615137151381513915140151411514215143151441514515146151471514815149151501515115152151531515415155151561515715158151591516015161151621516315164151651516615167151681516915170151711517215173151741517515176151771517815179151801518115182151831518415185151861518715188151891519015191151921519315194151951519615197151981519915200152011520215203152041520515206152071520815209152101521115212152131521415215152161521715218152191522015221152221522315224152251522615227152281522915230152311523215233152341523515236152371523815239152401524115242152431524415245152461524715248152491525015251152521525315254152551525615257152581525915260152611526215263152641526515266152671526815269152701527115272152731527415275152761527715278152791528015281152821528315284152851528615287152881528915290152911529215293152941529515296152971529815299153001530115302153031530415305153061530715308153091531015311153121531315314153151531615317153181531915320153211532215323153241532515326153271532815329153301533115332153331533415335153361533715338153391534015341153421534315344153451534615347153481534915350153511535215353153541535515356153571535815359153601536115362153631536415365153661536715368153691537015371153721537315374153751537615377153781537915380153811538215383153841538515386153871538815389153901539115392153931539415395153961539715398153991540015401154021540315404154051540615407154081540915410154111541215413154141541515416154171541815419154201542115422154231542415425154261542715428154291543015431154321543315434154351543615437154381543915440154411544215443154441544515446154471544815449154501545115452154531545415455154561545715458154591546015461154621546315464154651546615467154681546915470154711547215473154741547515476154771547815479154801548115482154831548415485154861548715488154891549015491154921549315494154951549615497154981549915500155011550215503155041550515506155071550815509155101551115512155131551415515155161551715518155191552015521155221552315524155251552615527155281552915530155311553215533155341553515536155371553815539155401554115542155431554415545155461554715548155491555015551155521555315554155551555615557155581555915560155611556215563155641556515566155671556815569155701557115572155731557415575155761557715578155791558015581155821558315584155851558615587155881558915590155911559215593155941559515596155971559815599156001560115602156031560415605156061560715608156091561015611156121561315614156151561615617156181561915620156211562215623156241562515626156271562815629156301563115632156331563415635156361563715638156391564015641156421564315644156451564615647156481564915650156511565215653156541565515656156571565815659156601566115662156631566415665156661566715668156691567015671156721567315674156751567615677156781567915680156811568215683156841568515686156871568815689156901569115692156931569415695156961569715698156991570015701157021570315704157051570615707157081570915710157111571215713157141571515716157171571815719157201572115722157231572415725157261572715728157291573015731157321573315734157351573615737157381573915740157411574215743157441574515746157471574815749157501575115752157531575415755157561575715758157591576015761157621576315764157651576615767157681576915770157711577215773157741577515776157771577815779157801578115782157831578415785157861578715788157891579015791157921579315794157951579615797157981579915800158011580215803158041580515806158071580815809158101581115812158131581415815158161581715818158191582015821158221582315824158251582615827158281582915830158311583215833158341583515836158371583815839158401584115842158431584415845158461584715848158491585015851158521585315854158551585615857158581585915860158611586215863158641586515866158671586815869158701587115872158731587415875158761587715878158791588015881158821588315884158851588615887158881588915890158911589215893158941589515896158971589815899159001590115902159031590415905159061590715908159091591015911159121591315914159151591615917159181591915920159211592215923159241592515926159271592815929159301593115932159331593415935159361593715938159391594015941159421594315944159451594615947159481594915950159511595215953159541595515956159571595815959159601596115962159631596415965159661596715968159691597015971159721597315974159751597615977159781597915980159811598215983159841598515986159871598815989159901599115992159931599415995159961599715998159991600016001160021600316004160051600616007160081600916010160111601216013160141601516016160171601816019160201602116022160231602416025160261602716028160291603016031160321603316034160351603616037160381603916040160411604216043160441604516046160471604816049160501605116052160531605416055160561605716058160591606016061160621606316064160651606616067160681606916070160711607216073160741607516076160771607816079160801608116082160831608416085160861608716088160891609016091160921609316094160951609616097160981609916100161011610216103161041610516106161071610816109161101611116112161131611416115161161611716118161191612016121161221612316124161251612616127161281612916130161311613216133161341613516136161371613816139161401614116142161431614416145161461614716148161491615016151161521615316154161551615616157161581615916160161611616216163161641616516166161671616816169161701617116172161731617416175161761617716178161791618016181161821618316184161851618616187161881618916190161911619216193161941619516196161971619816199162001620116202162031620416205162061620716208162091621016211162121621316214162151621616217162181621916220162211622216223162241622516226162271622816229162301623116232162331623416235162361623716238162391624016241162421624316244162451624616247162481624916250162511625216253162541625516256162571625816259162601626116262162631626416265162661626716268162691627016271162721627316274162751627616277162781627916280162811628216283162841628516286162871628816289162901629116292162931629416295162961629716298162991630016301163021630316304163051630616307163081630916310163111631216313163141631516316163171631816319163201632116322163231632416325163261632716328163291633016331163321633316334163351633616337163381633916340163411634216343163441634516346163471634816349163501635116352163531635416355163561635716358163591636016361163621636316364163651636616367163681636916370163711637216373163741637516376163771637816379163801638116382163831638416385163861638716388163891639016391163921639316394163951639616397163981639916400164011640216403164041640516406164071640816409164101641116412164131641416415164161641716418164191642016421164221642316424164251642616427164281642916430164311643216433164341643516436164371643816439164401644116442164431644416445164461644716448164491645016451164521645316454164551645616457164581645916460164611646216463164641646516466164671646816469164701647116472164731647416475164761647716478164791648016481164821648316484164851648616487164881648916490164911649216493164941649516496164971649816499165001650116502165031650416505165061650716508165091651016511165121651316514165151651616517165181651916520165211652216523165241652516526165271652816529165301653116532165331653416535165361653716538165391654016541165421654316544165451654616547165481654916550165511655216553165541655516556165571655816559165601656116562165631656416565165661656716568165691657016571165721657316574165751657616577165781657916580165811658216583165841658516586165871658816589165901659116592165931659416595165961659716598165991660016601166021660316604166051660616607166081660916610166111661216613166141661516616166171661816619166201662116622166231662416625166261662716628166291663016631166321663316634166351663616637166381663916640166411664216643166441664516646166471664816649166501665116652166531665416655166561665716658166591666016661166621666316664166651666616667166681666916670166711667216673166741667516676166771667816679166801668116682166831668416685166861668716688166891669016691166921669316694166951669616697166981669916700167011670216703167041670516706167071670816709167101671116712167131671416715167161671716718167191672016721167221672316724167251672616727167281672916730167311673216733167341673516736167371673816739167401674116742167431674416745167461674716748167491675016751167521675316754167551675616757167581675916760167611676216763167641676516766167671676816769167701677116772167731677416775167761677716778167791678016781167821678316784167851678616787167881678916790167911679216793167941679516796167971679816799168001680116802168031680416805168061680716808168091681016811168121681316814168151681616817168181681916820168211682216823168241682516826168271682816829168301683116832168331683416835168361683716838168391684016841168421684316844168451684616847168481684916850168511685216853168541685516856168571685816859168601686116862168631686416865168661686716868168691687016871168721687316874168751687616877168781687916880168811688216883168841688516886168871688816889168901689116892168931689416895168961689716898168991690016901169021690316904169051690616907169081690916910169111691216913169141691516916169171691816919169201692116922169231692416925169261692716928169291693016931169321693316934169351693616937169381693916940169411694216943169441694516946169471694816949169501695116952169531695416955169561695716958169591696016961169621696316964169651696616967169681696916970169711697216973169741697516976169771697816979169801698116982169831698416985169861698716988169891699016991169921699316994169951699616997169981699917000170011700217003170041700517006170071700817009170101701117012170131701417015170161701717018170191702017021170221702317024170251702617027170281702917030170311703217033170341703517036170371703817039170401704117042170431704417045170461704717048170491705017051170521705317054170551705617057170581705917060170611706217063170641706517066170671706817069170701707117072170731707417075170761707717078170791708017081170821708317084170851708617087170881708917090170911709217093170941709517096170971709817099171001710117102171031710417105171061710717108171091711017111171121711317114171151711617117171181711917120171211712217123171241712517126171271712817129171301713117132171331713417135171361713717138171391714017141171421714317144171451714617147171481714917150171511715217153171541715517156171571715817159171601716117162171631716417165171661716717168171691717017171171721717317174171751717617177171781717917180171811718217183 |
- /**
- * Cesium - https://github.com/CesiumGS/cesium
- *
- * Copyright 2011-2020 Cesium Contributors
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * Columbus View (Pat. Pend.)
- *
- * Portions licensed separately.
- * See https://github.com/CesiumGS/cesium/blob/master/LICENSE.md for full licensing details.
- */
- define(['exports', './when-54c2dc71', './Check-6c0211bc', './Math-1124a290', './Cartesian2-33d2657c', './RuntimeError-2109023a'], function (exports, when, Check, _Math, Cartesian2, RuntimeError) { 'use strict';
- /**
- * A simple map projection where longitude and latitude are linearly mapped to X and Y by multiplying
- * them by the {@link Ellipsoid#maximumRadius}. This projection
- * is commonly known as geographic, equirectangular, equidistant cylindrical, or plate carrée. It
- * is also known as EPSG:4326.
- *
- * @alias GeographicProjection
- * @constructor
- *
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid.
- *
- * @see WebMercatorProjection
- */
- function GeographicProjection(ellipsoid) {
- this._ellipsoid = when.defaultValue(ellipsoid, Cartesian2.Ellipsoid.WGS84);
- this._semimajorAxis = this._ellipsoid.maximumRadius;
- this._oneOverSemimajorAxis = 1.0 / this._semimajorAxis;
- }
- Object.defineProperties(GeographicProjection.prototype, {
- /**
- * Gets the {@link Ellipsoid}.
- *
- * @memberof GeographicProjection.prototype
- *
- * @type {Ellipsoid}
- * @readonly
- */
- ellipsoid: {
- get: function () {
- return this._ellipsoid;
- },
- },
- });
- /**
- * Projects a set of {@link Cartographic} coordinates, in radians, to map coordinates, in meters.
- * X and Y are the longitude and latitude, respectively, multiplied by the maximum radius of the
- * ellipsoid. Z is the unmodified height.
- *
- * @param {Cartographic} cartographic The coordinates to project.
- * @param {Cartesian3} [result] An instance into which to copy the result. If this parameter is
- * undefined, a new instance is created and returned.
- * @returns {Cartesian3} The projected coordinates. If the result parameter is not undefined, the
- * coordinates are copied there and that instance is returned. Otherwise, a new instance is
- * created and returned.
- */
- GeographicProjection.prototype.project = function (cartographic, result) {
- // Actually this is the special case of equidistant cylindrical called the plate carree
- var semimajorAxis = this._semimajorAxis;
- var x = cartographic.longitude * semimajorAxis;
- var y = cartographic.latitude * semimajorAxis;
- var z = cartographic.height;
- if (!when.defined(result)) {
- return new Cartesian2.Cartesian3(x, y, z);
- }
- result.x = x;
- result.y = y;
- result.z = z;
- return result;
- };
- /**
- * Unprojects a set of projected {@link Cartesian3} coordinates, in meters, to {@link Cartographic}
- * coordinates, in radians. Longitude and Latitude are the X and Y coordinates, respectively,
- * divided by the maximum radius of the ellipsoid. Height is the unmodified Z coordinate.
- *
- * @param {Cartesian3} cartesian The Cartesian position to unproject with height (z) in meters.
- * @param {Cartographic} [result] An instance into which to copy the result. If this parameter is
- * undefined, a new instance is created and returned.
- * @returns {Cartographic} The unprojected coordinates. If the result parameter is not undefined, the
- * coordinates are copied there and that instance is returned. Otherwise, a new instance is
- * created and returned.
- */
- GeographicProjection.prototype.unproject = function (cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(cartesian)) {
- throw new Check.DeveloperError("cartesian is required");
- }
- //>>includeEnd('debug');
- var oneOverEarthSemimajorAxis = this._oneOverSemimajorAxis;
- var longitude = cartesian.x * oneOverEarthSemimajorAxis;
- var latitude = cartesian.y * oneOverEarthSemimajorAxis;
- var height = cartesian.z;
- if (!when.defined(result)) {
- return new Cartesian2.Cartographic(longitude, latitude, height);
- }
- result.longitude = longitude;
- result.latitude = latitude;
- result.height = height;
- return result;
- };
- /**
- * This enumerated type is used in determining where, relative to the frustum, an
- * object is located. The object can either be fully contained within the frustum (INSIDE),
- * partially inside the frustum and partially outside (INTERSECTING), or somewhere entirely
- * outside of the frustum's 6 planes (OUTSIDE).
- *
- * @enum {Number}
- */
- var Intersect = {
- /**
- * Represents that an object is not contained within the frustum.
- *
- * @type {Number}
- * @constant
- */
- OUTSIDE: -1,
- /**
- * Represents that an object intersects one of the frustum's planes.
- *
- * @type {Number}
- * @constant
- */
- INTERSECTING: 0,
- /**
- * Represents that an object is fully within the frustum.
- *
- * @type {Number}
- * @constant
- */
- INSIDE: 1,
- };
- var Intersect$1 = Object.freeze(Intersect);
- /**
- * Represents the closed interval [start, stop].
- * @alias Interval
- * @constructor
- *
- * @param {Number} [start=0.0] The beginning of the interval.
- * @param {Number} [stop=0.0] The end of the interval.
- */
- function Interval(start, stop) {
- /**
- * The beginning of the interval.
- * @type {Number}
- * @default 0.0
- */
- this.start = when.defaultValue(start, 0.0);
- /**
- * The end of the interval.
- * @type {Number}
- * @default 0.0
- */
- this.stop = when.defaultValue(stop, 0.0);
- }
- /**
- * A 3x3 matrix, indexable as a column-major order array.
- * Constructor parameters are in row-major order for code readability.
- * @alias Matrix3
- * @constructor
- * @implements {ArrayLike<number>}
- *
- * @param {Number} [column0Row0=0.0] The value for column 0, row 0.
- * @param {Number} [column1Row0=0.0] The value for column 1, row 0.
- * @param {Number} [column2Row0=0.0] The value for column 2, row 0.
- * @param {Number} [column0Row1=0.0] The value for column 0, row 1.
- * @param {Number} [column1Row1=0.0] The value for column 1, row 1.
- * @param {Number} [column2Row1=0.0] The value for column 2, row 1.
- * @param {Number} [column0Row2=0.0] The value for column 0, row 2.
- * @param {Number} [column1Row2=0.0] The value for column 1, row 2.
- * @param {Number} [column2Row2=0.0] The value for column 2, row 2.
- *
- * @see Matrix3.fromColumnMajorArray
- * @see Matrix3.fromRowMajorArray
- * @see Matrix3.fromQuaternion
- * @see Matrix3.fromScale
- * @see Matrix3.fromUniformScale
- * @see Matrix2
- * @see Matrix4
- */
- function Matrix3(
- column0Row0,
- column1Row0,
- column2Row0,
- column0Row1,
- column1Row1,
- column2Row1,
- column0Row2,
- column1Row2,
- column2Row2
- ) {
- this[0] = when.defaultValue(column0Row0, 0.0);
- this[1] = when.defaultValue(column0Row1, 0.0);
- this[2] = when.defaultValue(column0Row2, 0.0);
- this[3] = when.defaultValue(column1Row0, 0.0);
- this[4] = when.defaultValue(column1Row1, 0.0);
- this[5] = when.defaultValue(column1Row2, 0.0);
- this[6] = when.defaultValue(column2Row0, 0.0);
- this[7] = when.defaultValue(column2Row1, 0.0);
- this[8] = when.defaultValue(column2Row2, 0.0);
- }
- /**
- * The number of elements used to pack the object into an array.
- * @type {Number}
- */
- Matrix3.packedLength = 9;
- /**
- * Stores the provided instance into the provided array.
- *
- * @param {Matrix3} value The value to pack.
- * @param {Number[]} array The array to pack into.
- * @param {Number} [startingIndex=0] The index into the array at which to start packing the elements.
- *
- * @returns {Number[]} The array that was packed into
- */
- Matrix3.pack = function (value, array, startingIndex) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("value", value);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- array[startingIndex++] = value[0];
- array[startingIndex++] = value[1];
- array[startingIndex++] = value[2];
- array[startingIndex++] = value[3];
- array[startingIndex++] = value[4];
- array[startingIndex++] = value[5];
- array[startingIndex++] = value[6];
- array[startingIndex++] = value[7];
- array[startingIndex++] = value[8];
- return array;
- };
- /**
- * Retrieves an instance from a packed array.
- *
- * @param {Number[]} array The packed array.
- * @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
- * @param {Matrix3} [result] The object into which to store the result.
- * @returns {Matrix3} The modified result parameter or a new Matrix3 instance if one was not provided.
- */
- Matrix3.unpack = function (array, startingIndex, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- if (!when.defined(result)) {
- result = new Matrix3();
- }
- result[0] = array[startingIndex++];
- result[1] = array[startingIndex++];
- result[2] = array[startingIndex++];
- result[3] = array[startingIndex++];
- result[4] = array[startingIndex++];
- result[5] = array[startingIndex++];
- result[6] = array[startingIndex++];
- result[7] = array[startingIndex++];
- result[8] = array[startingIndex++];
- return result;
- };
- /**
- * Duplicates a Matrix3 instance.
- *
- * @param {Matrix3} matrix The matrix to duplicate.
- * @param {Matrix3} [result] The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter or a new Matrix3 instance if one was not provided. (Returns undefined if matrix is undefined)
- */
- Matrix3.clone = function (matrix, result) {
- if (!when.defined(matrix)) {
- return undefined;
- }
- if (!when.defined(result)) {
- return new Matrix3(
- matrix[0],
- matrix[3],
- matrix[6],
- matrix[1],
- matrix[4],
- matrix[7],
- matrix[2],
- matrix[5],
- matrix[8]
- );
- }
- result[0] = matrix[0];
- result[1] = matrix[1];
- result[2] = matrix[2];
- result[3] = matrix[3];
- result[4] = matrix[4];
- result[5] = matrix[5];
- result[6] = matrix[6];
- result[7] = matrix[7];
- result[8] = matrix[8];
- return result;
- };
- /**
- * Creates a Matrix3 from 9 consecutive elements in an array.
- *
- * @param {Number[]} array The array whose 9 consecutive elements correspond to the positions of the matrix. Assumes column-major order.
- * @param {Number} [startingIndex=0] The offset into the array of the first element, which corresponds to first column first row position in the matrix.
- * @param {Matrix3} [result] The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter or a new Matrix3 instance if one was not provided.
- *
- * @example
- * // Create the Matrix3:
- * // [1.0, 2.0, 3.0]
- * // [1.0, 2.0, 3.0]
- * // [1.0, 2.0, 3.0]
- *
- * var v = [1.0, 1.0, 1.0, 2.0, 2.0, 2.0, 3.0, 3.0, 3.0];
- * var m = Cesium.Matrix3.fromArray(v);
- *
- * // Create same Matrix3 with using an offset into an array
- * var v2 = [0.0, 0.0, 1.0, 1.0, 1.0, 2.0, 2.0, 2.0, 3.0, 3.0, 3.0];
- * var m2 = Cesium.Matrix3.fromArray(v2, 2);
- */
- Matrix3.fromArray = function (array, startingIndex, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- if (!when.defined(result)) {
- result = new Matrix3();
- }
- result[0] = array[startingIndex];
- result[1] = array[startingIndex + 1];
- result[2] = array[startingIndex + 2];
- result[3] = array[startingIndex + 3];
- result[4] = array[startingIndex + 4];
- result[5] = array[startingIndex + 5];
- result[6] = array[startingIndex + 6];
- result[7] = array[startingIndex + 7];
- result[8] = array[startingIndex + 8];
- return result;
- };
- /**
- * Creates a Matrix3 instance from a column-major order array.
- *
- * @param {Number[]} values The column-major order array.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The modified result parameter, or a new Matrix3 instance if one was not provided.
- */
- Matrix3.fromColumnMajorArray = function (values, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("values", values);
- //>>includeEnd('debug');
- return Matrix3.clone(values, result);
- };
- /**
- * Creates a Matrix3 instance from a row-major order array.
- * The resulting matrix will be in column-major order.
- *
- * @param {Number[]} values The row-major order array.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The modified result parameter, or a new Matrix3 instance if one was not provided.
- */
- Matrix3.fromRowMajorArray = function (values, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("values", values);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return new Matrix3(
- values[0],
- values[1],
- values[2],
- values[3],
- values[4],
- values[5],
- values[6],
- values[7],
- values[8]
- );
- }
- result[0] = values[0];
- result[1] = values[3];
- result[2] = values[6];
- result[3] = values[1];
- result[4] = values[4];
- result[5] = values[7];
- result[6] = values[2];
- result[7] = values[5];
- result[8] = values[8];
- return result;
- };
- /**
- * Computes a 3x3 rotation matrix from the provided quaternion.
- *
- * @param {Quaternion} quaternion the quaternion to use.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The 3x3 rotation matrix from this quaternion.
- */
- Matrix3.fromQuaternion = function (quaternion, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- //>>includeEnd('debug');
- var x2 = quaternion.x * quaternion.x;
- var xy = quaternion.x * quaternion.y;
- var xz = quaternion.x * quaternion.z;
- var xw = quaternion.x * quaternion.w;
- var y2 = quaternion.y * quaternion.y;
- var yz = quaternion.y * quaternion.z;
- var yw = quaternion.y * quaternion.w;
- var z2 = quaternion.z * quaternion.z;
- var zw = quaternion.z * quaternion.w;
- var w2 = quaternion.w * quaternion.w;
- var m00 = x2 - y2 - z2 + w2;
- var m01 = 2.0 * (xy - zw);
- var m02 = 2.0 * (xz + yw);
- var m10 = 2.0 * (xy + zw);
- var m11 = -x2 + y2 - z2 + w2;
- var m12 = 2.0 * (yz - xw);
- var m20 = 2.0 * (xz - yw);
- var m21 = 2.0 * (yz + xw);
- var m22 = -x2 - y2 + z2 + w2;
- if (!when.defined(result)) {
- return new Matrix3(m00, m01, m02, m10, m11, m12, m20, m21, m22);
- }
- result[0] = m00;
- result[1] = m10;
- result[2] = m20;
- result[3] = m01;
- result[4] = m11;
- result[5] = m21;
- result[6] = m02;
- result[7] = m12;
- result[8] = m22;
- return result;
- };
- /**
- * Computes a 3x3 rotation matrix from the provided headingPitchRoll. (see http://en.wikipedia.org/wiki/Conversion_between_quaternions_and_Euler_angles )
- *
- * @param {HeadingPitchRoll} headingPitchRoll the headingPitchRoll to use.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The 3x3 rotation matrix from this headingPitchRoll.
- */
- Matrix3.fromHeadingPitchRoll = function (headingPitchRoll, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("headingPitchRoll", headingPitchRoll);
- //>>includeEnd('debug');
- var cosTheta = Math.cos(-headingPitchRoll.pitch);
- var cosPsi = Math.cos(-headingPitchRoll.heading);
- var cosPhi = Math.cos(headingPitchRoll.roll);
- var sinTheta = Math.sin(-headingPitchRoll.pitch);
- var sinPsi = Math.sin(-headingPitchRoll.heading);
- var sinPhi = Math.sin(headingPitchRoll.roll);
- var m00 = cosTheta * cosPsi;
- var m01 = -cosPhi * sinPsi + sinPhi * sinTheta * cosPsi;
- var m02 = sinPhi * sinPsi + cosPhi * sinTheta * cosPsi;
- var m10 = cosTheta * sinPsi;
- var m11 = cosPhi * cosPsi + sinPhi * sinTheta * sinPsi;
- var m12 = -sinPhi * cosPsi + cosPhi * sinTheta * sinPsi;
- var m20 = -sinTheta;
- var m21 = sinPhi * cosTheta;
- var m22 = cosPhi * cosTheta;
- if (!when.defined(result)) {
- return new Matrix3(m00, m01, m02, m10, m11, m12, m20, m21, m22);
- }
- result[0] = m00;
- result[1] = m10;
- result[2] = m20;
- result[3] = m01;
- result[4] = m11;
- result[5] = m21;
- result[6] = m02;
- result[7] = m12;
- result[8] = m22;
- return result;
- };
- /**
- * Computes a Matrix3 instance representing a non-uniform scale.
- *
- * @param {Cartesian3} scale The x, y, and z scale factors.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The modified result parameter, or a new Matrix3 instance if one was not provided.
- *
- * @example
- * // Creates
- * // [7.0, 0.0, 0.0]
- * // [0.0, 8.0, 0.0]
- * // [0.0, 0.0, 9.0]
- * var m = Cesium.Matrix3.fromScale(new Cesium.Cartesian3(7.0, 8.0, 9.0));
- */
- Matrix3.fromScale = function (scale, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("scale", scale);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return new Matrix3(scale.x, 0.0, 0.0, 0.0, scale.y, 0.0, 0.0, 0.0, scale.z);
- }
- result[0] = scale.x;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = scale.y;
- result[5] = 0.0;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = scale.z;
- return result;
- };
- /**
- * Computes a Matrix3 instance representing a uniform scale.
- *
- * @param {Number} scale The uniform scale factor.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The modified result parameter, or a new Matrix3 instance if one was not provided.
- *
- * @example
- * // Creates
- * // [2.0, 0.0, 0.0]
- * // [0.0, 2.0, 0.0]
- * // [0.0, 0.0, 2.0]
- * var m = Cesium.Matrix3.fromUniformScale(2.0);
- */
- Matrix3.fromUniformScale = function (scale, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("scale", scale);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return new Matrix3(scale, 0.0, 0.0, 0.0, scale, 0.0, 0.0, 0.0, scale);
- }
- result[0] = scale;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = scale;
- result[5] = 0.0;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = scale;
- return result;
- };
- /**
- * Computes a Matrix3 instance representing the cross product equivalent matrix of a Cartesian3 vector.
- *
- * @param {Cartesian3} vector the vector on the left hand side of the cross product operation.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The modified result parameter, or a new Matrix3 instance if one was not provided.
- *
- * @example
- * // Creates
- * // [0.0, -9.0, 8.0]
- * // [9.0, 0.0, -7.0]
- * // [-8.0, 7.0, 0.0]
- * var m = Cesium.Matrix3.fromCrossProduct(new Cesium.Cartesian3(7.0, 8.0, 9.0));
- */
- Matrix3.fromCrossProduct = function (vector, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("vector", vector);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return new Matrix3(
- 0.0,
- -vector.z,
- vector.y,
- vector.z,
- 0.0,
- -vector.x,
- -vector.y,
- vector.x,
- 0.0
- );
- }
- result[0] = 0.0;
- result[1] = vector.z;
- result[2] = -vector.y;
- result[3] = -vector.z;
- result[4] = 0.0;
- result[5] = vector.x;
- result[6] = vector.y;
- result[7] = -vector.x;
- result[8] = 0.0;
- return result;
- };
- /**
- * Creates a rotation matrix around the x-axis.
- *
- * @param {Number} angle The angle, in radians, of the rotation. Positive angles are counterclockwise.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The modified result parameter, or a new Matrix3 instance if one was not provided.
- *
- * @example
- * // Rotate a point 45 degrees counterclockwise around the x-axis.
- * var p = new Cesium.Cartesian3(5, 6, 7);
- * var m = Cesium.Matrix3.fromRotationX(Cesium.Math.toRadians(45.0));
- * var rotated = Cesium.Matrix3.multiplyByVector(m, p, new Cesium.Cartesian3());
- */
- Matrix3.fromRotationX = function (angle, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("angle", angle);
- //>>includeEnd('debug');
- var cosAngle = Math.cos(angle);
- var sinAngle = Math.sin(angle);
- if (!when.defined(result)) {
- return new Matrix3(
- 1.0,
- 0.0,
- 0.0,
- 0.0,
- cosAngle,
- -sinAngle,
- 0.0,
- sinAngle,
- cosAngle
- );
- }
- result[0] = 1.0;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = cosAngle;
- result[5] = sinAngle;
- result[6] = 0.0;
- result[7] = -sinAngle;
- result[8] = cosAngle;
- return result;
- };
- /**
- * Creates a rotation matrix around the y-axis.
- *
- * @param {Number} angle The angle, in radians, of the rotation. Positive angles are counterclockwise.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The modified result parameter, or a new Matrix3 instance if one was not provided.
- *
- * @example
- * // Rotate a point 45 degrees counterclockwise around the y-axis.
- * var p = new Cesium.Cartesian3(5, 6, 7);
- * var m = Cesium.Matrix3.fromRotationY(Cesium.Math.toRadians(45.0));
- * var rotated = Cesium.Matrix3.multiplyByVector(m, p, new Cesium.Cartesian3());
- */
- Matrix3.fromRotationY = function (angle, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("angle", angle);
- //>>includeEnd('debug');
- var cosAngle = Math.cos(angle);
- var sinAngle = Math.sin(angle);
- if (!when.defined(result)) {
- return new Matrix3(
- cosAngle,
- 0.0,
- sinAngle,
- 0.0,
- 1.0,
- 0.0,
- -sinAngle,
- 0.0,
- cosAngle
- );
- }
- result[0] = cosAngle;
- result[1] = 0.0;
- result[2] = -sinAngle;
- result[3] = 0.0;
- result[4] = 1.0;
- result[5] = 0.0;
- result[6] = sinAngle;
- result[7] = 0.0;
- result[8] = cosAngle;
- return result;
- };
- /**
- * Creates a rotation matrix around the z-axis.
- *
- * @param {Number} angle The angle, in radians, of the rotation. Positive angles are counterclockwise.
- * @param {Matrix3} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix3} The modified result parameter, or a new Matrix3 instance if one was not provided.
- *
- * @example
- * // Rotate a point 45 degrees counterclockwise around the z-axis.
- * var p = new Cesium.Cartesian3(5, 6, 7);
- * var m = Cesium.Matrix3.fromRotationZ(Cesium.Math.toRadians(45.0));
- * var rotated = Cesium.Matrix3.multiplyByVector(m, p, new Cesium.Cartesian3());
- */
- Matrix3.fromRotationZ = function (angle, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("angle", angle);
- //>>includeEnd('debug');
- var cosAngle = Math.cos(angle);
- var sinAngle = Math.sin(angle);
- if (!when.defined(result)) {
- return new Matrix3(
- cosAngle,
- -sinAngle,
- 0.0,
- sinAngle,
- cosAngle,
- 0.0,
- 0.0,
- 0.0,
- 1.0
- );
- }
- result[0] = cosAngle;
- result[1] = sinAngle;
- result[2] = 0.0;
- result[3] = -sinAngle;
- result[4] = cosAngle;
- result[5] = 0.0;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = 1.0;
- return result;
- };
- /**
- * Creates an Array from the provided Matrix3 instance.
- * The array will be in column-major order.
- *
- * @param {Matrix3} matrix The matrix to use..
- * @param {Number[]} [result] The Array onto which to store the result.
- * @returns {Number[]} The modified Array parameter or a new Array instance if one was not provided.
- */
- Matrix3.toArray = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return [
- matrix[0],
- matrix[1],
- matrix[2],
- matrix[3],
- matrix[4],
- matrix[5],
- matrix[6],
- matrix[7],
- matrix[8],
- ];
- }
- result[0] = matrix[0];
- result[1] = matrix[1];
- result[2] = matrix[2];
- result[3] = matrix[3];
- result[4] = matrix[4];
- result[5] = matrix[5];
- result[6] = matrix[6];
- result[7] = matrix[7];
- result[8] = matrix[8];
- return result;
- };
- /**
- * Computes the array index of the element at the provided row and column.
- *
- * @param {Number} row The zero-based index of the row.
- * @param {Number} column The zero-based index of the column.
- * @returns {Number} The index of the element at the provided row and column.
- *
- * @exception {DeveloperError} row must be 0, 1, or 2.
- * @exception {DeveloperError} column must be 0, 1, or 2.
- *
- * @example
- * var myMatrix = new Cesium.Matrix3();
- * var column1Row0Index = Cesium.Matrix3.getElementIndex(1, 0);
- * var column1Row0 = myMatrix[column1Row0Index]
- * myMatrix[column1Row0Index] = 10.0;
- */
- Matrix3.getElementIndex = function (column, row) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number.greaterThanOrEquals("row", row, 0);
- Check.Check.typeOf.number.lessThanOrEquals("row", row, 2);
- Check.Check.typeOf.number.greaterThanOrEquals("column", column, 0);
- Check.Check.typeOf.number.lessThanOrEquals("column", column, 2);
- //>>includeEnd('debug');
- return column * 3 + row;
- };
- /**
- * Retrieves a copy of the matrix column at the provided index as a Cartesian3 instance.
- *
- * @param {Matrix3} matrix The matrix to use.
- * @param {Number} index The zero-based index of the column to retrieve.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- *
- * @exception {DeveloperError} index must be 0, 1, or 2.
- */
- Matrix3.getColumn = function (matrix, index, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number.greaterThanOrEquals("index", index, 0);
- Check.Check.typeOf.number.lessThanOrEquals("index", index, 2);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var startIndex = index * 3;
- var x = matrix[startIndex];
- var y = matrix[startIndex + 1];
- var z = matrix[startIndex + 2];
- result.x = x;
- result.y = y;
- result.z = z;
- return result;
- };
- /**
- * Computes a new matrix that replaces the specified column in the provided matrix with the provided Cartesian3 instance.
- *
- * @param {Matrix3} matrix The matrix to use.
- * @param {Number} index The zero-based index of the column to set.
- * @param {Cartesian3} cartesian The Cartesian whose values will be assigned to the specified column.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- *
- * @exception {DeveloperError} index must be 0, 1, or 2.
- */
- Matrix3.setColumn = function (matrix, index, cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number.greaterThanOrEquals("index", index, 0);
- Check.Check.typeOf.number.lessThanOrEquals("index", index, 2);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result = Matrix3.clone(matrix, result);
- var startIndex = index * 3;
- result[startIndex] = cartesian.x;
- result[startIndex + 1] = cartesian.y;
- result[startIndex + 2] = cartesian.z;
- return result;
- };
- /**
- * Retrieves a copy of the matrix row at the provided index as a Cartesian3 instance.
- *
- * @param {Matrix3} matrix The matrix to use.
- * @param {Number} index The zero-based index of the row to retrieve.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- *
- * @exception {DeveloperError} index must be 0, 1, or 2.
- */
- Matrix3.getRow = function (matrix, index, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number.greaterThanOrEquals("index", index, 0);
- Check.Check.typeOf.number.lessThanOrEquals("index", index, 2);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var x = matrix[index];
- var y = matrix[index + 3];
- var z = matrix[index + 6];
- result.x = x;
- result.y = y;
- result.z = z;
- return result;
- };
- /**
- * Computes a new matrix that replaces the specified row in the provided matrix with the provided Cartesian3 instance.
- *
- * @param {Matrix3} matrix The matrix to use.
- * @param {Number} index The zero-based index of the row to set.
- * @param {Cartesian3} cartesian The Cartesian whose values will be assigned to the specified row.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- *
- * @exception {DeveloperError} index must be 0, 1, or 2.
- */
- Matrix3.setRow = function (matrix, index, cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number.greaterThanOrEquals("index", index, 0);
- Check.Check.typeOf.number.lessThanOrEquals("index", index, 2);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result = Matrix3.clone(matrix, result);
- result[index] = cartesian.x;
- result[index + 3] = cartesian.y;
- result[index + 6] = cartesian.z;
- return result;
- };
- var scratchColumn = new Cartesian2.Cartesian3();
- /**
- * Extracts the non-uniform scale assuming the matrix is an affine transformation.
- *
- * @param {Matrix3} matrix The matrix.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- */
- Matrix3.getScale = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.fromElements(matrix[0], matrix[1], matrix[2], scratchColumn)
- );
- result.y = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.fromElements(matrix[3], matrix[4], matrix[5], scratchColumn)
- );
- result.z = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.fromElements(matrix[6], matrix[7], matrix[8], scratchColumn)
- );
- return result;
- };
- var scratchScale = new Cartesian2.Cartesian3();
- /**
- * Computes the maximum scale assuming the matrix is an affine transformation.
- * The maximum scale is the maximum length of the column vectors.
- *
- * @param {Matrix3} matrix The matrix.
- * @returns {Number} The maximum scale.
- */
- Matrix3.getMaximumScale = function (matrix) {
- Matrix3.getScale(matrix, scratchScale);
- return Cartesian2.Cartesian3.maximumComponent(scratchScale);
- };
- /**
- * Computes the product of two matrices.
- *
- * @param {Matrix3} left The first matrix.
- * @param {Matrix3} right The second matrix.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- */
- Matrix3.multiply = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var column0Row0 =
- left[0] * right[0] + left[3] * right[1] + left[6] * right[2];
- var column0Row1 =
- left[1] * right[0] + left[4] * right[1] + left[7] * right[2];
- var column0Row2 =
- left[2] * right[0] + left[5] * right[1] + left[8] * right[2];
- var column1Row0 =
- left[0] * right[3] + left[3] * right[4] + left[6] * right[5];
- var column1Row1 =
- left[1] * right[3] + left[4] * right[4] + left[7] * right[5];
- var column1Row2 =
- left[2] * right[3] + left[5] * right[4] + left[8] * right[5];
- var column2Row0 =
- left[0] * right[6] + left[3] * right[7] + left[6] * right[8];
- var column2Row1 =
- left[1] * right[6] + left[4] * right[7] + left[7] * right[8];
- var column2Row2 =
- left[2] * right[6] + left[5] * right[7] + left[8] * right[8];
- result[0] = column0Row0;
- result[1] = column0Row1;
- result[2] = column0Row2;
- result[3] = column1Row0;
- result[4] = column1Row1;
- result[5] = column1Row2;
- result[6] = column2Row0;
- result[7] = column2Row1;
- result[8] = column2Row2;
- return result;
- };
- /**
- * Computes the sum of two matrices.
- *
- * @param {Matrix3} left The first matrix.
- * @param {Matrix3} right The second matrix.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- */
- Matrix3.add = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = left[0] + right[0];
- result[1] = left[1] + right[1];
- result[2] = left[2] + right[2];
- result[3] = left[3] + right[3];
- result[4] = left[4] + right[4];
- result[5] = left[5] + right[5];
- result[6] = left[6] + right[6];
- result[7] = left[7] + right[7];
- result[8] = left[8] + right[8];
- return result;
- };
- /**
- * Computes the difference of two matrices.
- *
- * @param {Matrix3} left The first matrix.
- * @param {Matrix3} right The second matrix.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- */
- Matrix3.subtract = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = left[0] - right[0];
- result[1] = left[1] - right[1];
- result[2] = left[2] - right[2];
- result[3] = left[3] - right[3];
- result[4] = left[4] - right[4];
- result[5] = left[5] - right[5];
- result[6] = left[6] - right[6];
- result[7] = left[7] - right[7];
- result[8] = left[8] - right[8];
- return result;
- };
- /**
- * Computes the product of a matrix and a column vector.
- *
- * @param {Matrix3} matrix The matrix.
- * @param {Cartesian3} cartesian The column.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- */
- Matrix3.multiplyByVector = function (matrix, cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var vX = cartesian.x;
- var vY = cartesian.y;
- var vZ = cartesian.z;
- var x = matrix[0] * vX + matrix[3] * vY + matrix[6] * vZ;
- var y = matrix[1] * vX + matrix[4] * vY + matrix[7] * vZ;
- var z = matrix[2] * vX + matrix[5] * vY + matrix[8] * vZ;
- result.x = x;
- result.y = y;
- result.z = z;
- return result;
- };
- /**
- * Computes the product of a matrix and a scalar.
- *
- * @param {Matrix3} matrix The matrix.
- * @param {Number} scalar The number to multiply by.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- */
- Matrix3.multiplyByScalar = function (matrix, scalar, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number("scalar", scalar);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = matrix[0] * scalar;
- result[1] = matrix[1] * scalar;
- result[2] = matrix[2] * scalar;
- result[3] = matrix[3] * scalar;
- result[4] = matrix[4] * scalar;
- result[5] = matrix[5] * scalar;
- result[6] = matrix[6] * scalar;
- result[7] = matrix[7] * scalar;
- result[8] = matrix[8] * scalar;
- return result;
- };
- /**
- * Computes the product of a matrix times a (non-uniform) scale, as if the scale were a scale matrix.
- *
- * @param {Matrix3} matrix The matrix on the left-hand side.
- * @param {Cartesian3} scale The non-uniform scale on the right-hand side.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- *
- *
- * @example
- * // Instead of Cesium.Matrix3.multiply(m, Cesium.Matrix3.fromScale(scale), m);
- * Cesium.Matrix3.multiplyByScale(m, scale, m);
- *
- * @see Matrix3.fromScale
- * @see Matrix3.multiplyByUniformScale
- */
- Matrix3.multiplyByScale = function (matrix, scale, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("scale", scale);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = matrix[0] * scale.x;
- result[1] = matrix[1] * scale.x;
- result[2] = matrix[2] * scale.x;
- result[3] = matrix[3] * scale.y;
- result[4] = matrix[4] * scale.y;
- result[5] = matrix[5] * scale.y;
- result[6] = matrix[6] * scale.z;
- result[7] = matrix[7] * scale.z;
- result[8] = matrix[8] * scale.z;
- return result;
- };
- /**
- * Creates a negated copy of the provided matrix.
- *
- * @param {Matrix3} matrix The matrix to negate.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- */
- Matrix3.negate = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = -matrix[0];
- result[1] = -matrix[1];
- result[2] = -matrix[2];
- result[3] = -matrix[3];
- result[4] = -matrix[4];
- result[5] = -matrix[5];
- result[6] = -matrix[6];
- result[7] = -matrix[7];
- result[8] = -matrix[8];
- return result;
- };
- /**
- * Computes the transpose of the provided matrix.
- *
- * @param {Matrix3} matrix The matrix to transpose.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- */
- Matrix3.transpose = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var column0Row0 = matrix[0];
- var column0Row1 = matrix[3];
- var column0Row2 = matrix[6];
- var column1Row0 = matrix[1];
- var column1Row1 = matrix[4];
- var column1Row2 = matrix[7];
- var column2Row0 = matrix[2];
- var column2Row1 = matrix[5];
- var column2Row2 = matrix[8];
- result[0] = column0Row0;
- result[1] = column0Row1;
- result[2] = column0Row2;
- result[3] = column1Row0;
- result[4] = column1Row1;
- result[5] = column1Row2;
- result[6] = column2Row0;
- result[7] = column2Row1;
- result[8] = column2Row2;
- return result;
- };
- var UNIT = new Cartesian2.Cartesian3(1, 1, 1);
- /**
- * Extracts the rotation assuming the matrix is an affine transformation.
- *
- * @param {Matrix3} matrix The matrix.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter
- */
- Matrix3.getRotation = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var inverseScale = Cartesian2.Cartesian3.divideComponents(
- UNIT,
- Matrix3.getScale(matrix, scratchScale),
- scratchScale
- );
- result = Matrix3.multiplyByScale(matrix, inverseScale, result);
- return result;
- };
- function computeFrobeniusNorm(matrix) {
- var norm = 0.0;
- for (var i = 0; i < 9; ++i) {
- var temp = matrix[i];
- norm += temp * temp;
- }
- return Math.sqrt(norm);
- }
- var rowVal = [1, 0, 0];
- var colVal = [2, 2, 1];
- function offDiagonalFrobeniusNorm(matrix) {
- // Computes the "off-diagonal" Frobenius norm.
- // Assumes matrix is symmetric.
- var norm = 0.0;
- for (var i = 0; i < 3; ++i) {
- var temp = matrix[Matrix3.getElementIndex(colVal[i], rowVal[i])];
- norm += 2.0 * temp * temp;
- }
- return Math.sqrt(norm);
- }
- function shurDecomposition(matrix, result) {
- // This routine was created based upon Matrix Computations, 3rd ed., by Golub and Van Loan,
- // section 8.4.2 The 2by2 Symmetric Schur Decomposition.
- //
- // The routine takes a matrix, which is assumed to be symmetric, and
- // finds the largest off-diagonal term, and then creates
- // a matrix (result) which can be used to help reduce it
- var tolerance = _Math.CesiumMath.EPSILON15;
- var maxDiagonal = 0.0;
- var rotAxis = 1;
- // find pivot (rotAxis) based on max diagonal of matrix
- for (var i = 0; i < 3; ++i) {
- var temp = Math.abs(matrix[Matrix3.getElementIndex(colVal[i], rowVal[i])]);
- if (temp > maxDiagonal) {
- rotAxis = i;
- maxDiagonal = temp;
- }
- }
- var c = 1.0;
- var s = 0.0;
- var p = rowVal[rotAxis];
- var q = colVal[rotAxis];
- if (Math.abs(matrix[Matrix3.getElementIndex(q, p)]) > tolerance) {
- var qq = matrix[Matrix3.getElementIndex(q, q)];
- var pp = matrix[Matrix3.getElementIndex(p, p)];
- var qp = matrix[Matrix3.getElementIndex(q, p)];
- var tau = (qq - pp) / 2.0 / qp;
- var t;
- if (tau < 0.0) {
- t = -1.0 / (-tau + Math.sqrt(1.0 + tau * tau));
- } else {
- t = 1.0 / (tau + Math.sqrt(1.0 + tau * tau));
- }
- c = 1.0 / Math.sqrt(1.0 + t * t);
- s = t * c;
- }
- result = Matrix3.clone(Matrix3.IDENTITY, result);
- result[Matrix3.getElementIndex(p, p)] = result[
- Matrix3.getElementIndex(q, q)
- ] = c;
- result[Matrix3.getElementIndex(q, p)] = s;
- result[Matrix3.getElementIndex(p, q)] = -s;
- return result;
- }
- var jMatrix = new Matrix3();
- var jMatrixTranspose = new Matrix3();
- /**
- * Computes the eigenvectors and eigenvalues of a symmetric matrix.
- * <p>
- * Returns a diagonal matrix and unitary matrix such that:
- * <code>matrix = unitary matrix * diagonal matrix * transpose(unitary matrix)</code>
- * </p>
- * <p>
- * The values along the diagonal of the diagonal matrix are the eigenvalues. The columns
- * of the unitary matrix are the corresponding eigenvectors.
- * </p>
- *
- * @param {Matrix3} matrix The matrix to decompose into diagonal and unitary matrix. Expected to be symmetric.
- * @param {Object} [result] An object with unitary and diagonal properties which are matrices onto which to store the result.
- * @returns {Object} An object with unitary and diagonal properties which are the unitary and diagonal matrices, respectively.
- *
- * @example
- * var a = //... symetric matrix
- * var result = {
- * unitary : new Cesium.Matrix3(),
- * diagonal : new Cesium.Matrix3()
- * };
- * Cesium.Matrix3.computeEigenDecomposition(a, result);
- *
- * var unitaryTranspose = Cesium.Matrix3.transpose(result.unitary, new Cesium.Matrix3());
- * var b = Cesium.Matrix3.multiply(result.unitary, result.diagonal, new Cesium.Matrix3());
- * Cesium.Matrix3.multiply(b, unitaryTranspose, b); // b is now equal to a
- *
- * var lambda = Cesium.Matrix3.getColumn(result.diagonal, 0, new Cesium.Cartesian3()).x; // first eigenvalue
- * var v = Cesium.Matrix3.getColumn(result.unitary, 0, new Cesium.Cartesian3()); // first eigenvector
- * var c = Cesium.Cartesian3.multiplyByScalar(v, lambda, new Cesium.Cartesian3()); // equal to Cesium.Matrix3.multiplyByVector(a, v)
- */
- Matrix3.computeEigenDecomposition = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- //>>includeEnd('debug');
- // This routine was created based upon Matrix Computations, 3rd ed., by Golub and Van Loan,
- // section 8.4.3 The Classical Jacobi Algorithm
- var tolerance = _Math.CesiumMath.EPSILON20;
- var maxSweeps = 10;
- var count = 0;
- var sweep = 0;
- if (!when.defined(result)) {
- result = {};
- }
- var unitaryMatrix = (result.unitary = Matrix3.clone(
- Matrix3.IDENTITY,
- result.unitary
- ));
- var diagMatrix = (result.diagonal = Matrix3.clone(matrix, result.diagonal));
- var epsilon = tolerance * computeFrobeniusNorm(diagMatrix);
- while (sweep < maxSweeps && offDiagonalFrobeniusNorm(diagMatrix) > epsilon) {
- shurDecomposition(diagMatrix, jMatrix);
- Matrix3.transpose(jMatrix, jMatrixTranspose);
- Matrix3.multiply(diagMatrix, jMatrix, diagMatrix);
- Matrix3.multiply(jMatrixTranspose, diagMatrix, diagMatrix);
- Matrix3.multiply(unitaryMatrix, jMatrix, unitaryMatrix);
- if (++count > 2) {
- ++sweep;
- count = 0;
- }
- }
- return result;
- };
- /**
- * Computes a matrix, which contains the absolute (unsigned) values of the provided matrix's elements.
- *
- * @param {Matrix3} matrix The matrix with signed elements.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- */
- Matrix3.abs = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = Math.abs(matrix[0]);
- result[1] = Math.abs(matrix[1]);
- result[2] = Math.abs(matrix[2]);
- result[3] = Math.abs(matrix[3]);
- result[4] = Math.abs(matrix[4]);
- result[5] = Math.abs(matrix[5]);
- result[6] = Math.abs(matrix[6]);
- result[7] = Math.abs(matrix[7]);
- result[8] = Math.abs(matrix[8]);
- return result;
- };
- /**
- * Computes the determinant of the provided matrix.
- *
- * @param {Matrix3} matrix The matrix to use.
- * @returns {Number} The value of the determinant of the matrix.
- */
- Matrix3.determinant = function (matrix) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- //>>includeEnd('debug');
- var m11 = matrix[0];
- var m21 = matrix[3];
- var m31 = matrix[6];
- var m12 = matrix[1];
- var m22 = matrix[4];
- var m32 = matrix[7];
- var m13 = matrix[2];
- var m23 = matrix[5];
- var m33 = matrix[8];
- return (
- m11 * (m22 * m33 - m23 * m32) +
- m12 * (m23 * m31 - m21 * m33) +
- m13 * (m21 * m32 - m22 * m31)
- );
- };
- /**
- * Computes the inverse of the provided matrix.
- *
- * @param {Matrix3} matrix The matrix to invert.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- *
- * @exception {DeveloperError} matrix is not invertible.
- */
- Matrix3.inverse = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var m11 = matrix[0];
- var m21 = matrix[1];
- var m31 = matrix[2];
- var m12 = matrix[3];
- var m22 = matrix[4];
- var m32 = matrix[5];
- var m13 = matrix[6];
- var m23 = matrix[7];
- var m33 = matrix[8];
- var determinant = Matrix3.determinant(matrix);
- //>>includeStart('debug', pragmas.debug);
- if (Math.abs(determinant) <= _Math.CesiumMath.EPSILON15) {
- throw new Check.DeveloperError("matrix is not invertible");
- }
- //>>includeEnd('debug');
- result[0] = m22 * m33 - m23 * m32;
- result[1] = m23 * m31 - m21 * m33;
- result[2] = m21 * m32 - m22 * m31;
- result[3] = m13 * m32 - m12 * m33;
- result[4] = m11 * m33 - m13 * m31;
- result[5] = m12 * m31 - m11 * m32;
- result[6] = m12 * m23 - m13 * m22;
- result[7] = m13 * m21 - m11 * m23;
- result[8] = m11 * m22 - m12 * m21;
- var scale = 1.0 / determinant;
- return Matrix3.multiplyByScalar(result, scale, result);
- };
- /**
- * Compares the provided matrices componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {Matrix3} [left] The first matrix.
- * @param {Matrix3} [right] The second matrix.
- * @returns {Boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- */
- Matrix3.equals = function (left, right) {
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- left[0] === right[0] &&
- left[1] === right[1] &&
- left[2] === right[2] &&
- left[3] === right[3] &&
- left[4] === right[4] &&
- left[5] === right[5] &&
- left[6] === right[6] &&
- left[7] === right[7] &&
- left[8] === right[8])
- );
- };
- /**
- * Compares the provided matrices componentwise and returns
- * <code>true</code> if they are within the provided epsilon,
- * <code>false</code> otherwise.
- *
- * @param {Matrix3} [left] The first matrix.
- * @param {Matrix3} [right] The second matrix.
- * @param {Number} [epsilon=0] The epsilon to use for equality testing.
- * @returns {Boolean} <code>true</code> if left and right are within the provided epsilon, <code>false</code> otherwise.
- */
- Matrix3.equalsEpsilon = function (left, right, epsilon) {
- epsilon = when.defaultValue(epsilon, 0);
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- Math.abs(left[0] - right[0]) <= epsilon &&
- Math.abs(left[1] - right[1]) <= epsilon &&
- Math.abs(left[2] - right[2]) <= epsilon &&
- Math.abs(left[3] - right[3]) <= epsilon &&
- Math.abs(left[4] - right[4]) <= epsilon &&
- Math.abs(left[5] - right[5]) <= epsilon &&
- Math.abs(left[6] - right[6]) <= epsilon &&
- Math.abs(left[7] - right[7]) <= epsilon &&
- Math.abs(left[8] - right[8]) <= epsilon)
- );
- };
- /**
- * An immutable Matrix3 instance initialized to the identity matrix.
- *
- * @type {Matrix3}
- * @constant
- */
- Matrix3.IDENTITY = Object.freeze(
- new Matrix3(1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1.0)
- );
- /**
- * An immutable Matrix3 instance initialized to the zero matrix.
- *
- * @type {Matrix3}
- * @constant
- */
- Matrix3.ZERO = Object.freeze(
- new Matrix3(0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0)
- );
- /**
- * The index into Matrix3 for column 0, row 0.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN0ROW0 = 0;
- /**
- * The index into Matrix3 for column 0, row 1.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN0ROW1 = 1;
- /**
- * The index into Matrix3 for column 0, row 2.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN0ROW2 = 2;
- /**
- * The index into Matrix3 for column 1, row 0.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN1ROW0 = 3;
- /**
- * The index into Matrix3 for column 1, row 1.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN1ROW1 = 4;
- /**
- * The index into Matrix3 for column 1, row 2.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN1ROW2 = 5;
- /**
- * The index into Matrix3 for column 2, row 0.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN2ROW0 = 6;
- /**
- * The index into Matrix3 for column 2, row 1.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN2ROW1 = 7;
- /**
- * The index into Matrix3 for column 2, row 2.
- *
- * @type {Number}
- * @constant
- */
- Matrix3.COLUMN2ROW2 = 8;
- Object.defineProperties(Matrix3.prototype, {
- /**
- * Gets the number of items in the collection.
- * @memberof Matrix3.prototype
- *
- * @type {Number}
- */
- length: {
- get: function () {
- return Matrix3.packedLength;
- },
- },
- });
- /**
- * Duplicates the provided Matrix3 instance.
- *
- * @param {Matrix3} [result] The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter or a new Matrix3 instance if one was not provided.
- */
- Matrix3.prototype.clone = function (result) {
- return Matrix3.clone(this, result);
- };
- /**
- * Compares this matrix to the provided matrix componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {Matrix3} [right] The right hand side matrix.
- * @returns {Boolean} <code>true</code> if they are equal, <code>false</code> otherwise.
- */
- Matrix3.prototype.equals = function (right) {
- return Matrix3.equals(this, right);
- };
- /**
- * @private
- */
- Matrix3.equalsArray = function (matrix, array, offset) {
- return (
- matrix[0] === array[offset] &&
- matrix[1] === array[offset + 1] &&
- matrix[2] === array[offset + 2] &&
- matrix[3] === array[offset + 3] &&
- matrix[4] === array[offset + 4] &&
- matrix[5] === array[offset + 5] &&
- matrix[6] === array[offset + 6] &&
- matrix[7] === array[offset + 7] &&
- matrix[8] === array[offset + 8]
- );
- };
- /**
- * Compares this matrix to the provided matrix componentwise and returns
- * <code>true</code> if they are within the provided epsilon,
- * <code>false</code> otherwise.
- *
- * @param {Matrix3} [right] The right hand side matrix.
- * @param {Number} [epsilon=0] The epsilon to use for equality testing.
- * @returns {Boolean} <code>true</code> if they are within the provided epsilon, <code>false</code> otherwise.
- */
- Matrix3.prototype.equalsEpsilon = function (right, epsilon) {
- return Matrix3.equalsEpsilon(this, right, epsilon);
- };
- /**
- * Creates a string representing this Matrix with each row being
- * on a separate line and in the format '(column0, column1, column2)'.
- *
- * @returns {String} A string representing the provided Matrix with each row being on a separate line and in the format '(column0, column1, column2)'.
- */
- Matrix3.prototype.toString = function () {
- return (
- "(" +
- this[0] +
- ", " +
- this[3] +
- ", " +
- this[6] +
- ")\n" +
- "(" +
- this[1] +
- ", " +
- this[4] +
- ", " +
- this[7] +
- ")\n" +
- "(" +
- this[2] +
- ", " +
- this[5] +
- ", " +
- this[8] +
- ")"
- );
- };
- /**
- * A 4D Cartesian point.
- * @alias Cartesian4
- * @constructor
- *
- * @param {Number} [x=0.0] The X component.
- * @param {Number} [y=0.0] The Y component.
- * @param {Number} [z=0.0] The Z component.
- * @param {Number} [w=0.0] The W component.
- *
- * @see Cartesian2
- * @see Cartesian3
- * @see Packable
- */
- function Cartesian4(x, y, z, w) {
- /**
- * The X component.
- * @type {Number}
- * @default 0.0
- */
- this.x = when.defaultValue(x, 0.0);
- /**
- * The Y component.
- * @type {Number}
- * @default 0.0
- */
- this.y = when.defaultValue(y, 0.0);
- /**
- * The Z component.
- * @type {Number}
- * @default 0.0
- */
- this.z = when.defaultValue(z, 0.0);
- /**
- * The W component.
- * @type {Number}
- * @default 0.0
- */
- this.w = when.defaultValue(w, 0.0);
- }
- /**
- * Creates a Cartesian4 instance from x, y, z and w coordinates.
- *
- * @param {Number} x The x coordinate.
- * @param {Number} y The y coordinate.
- * @param {Number} z The z coordinate.
- * @param {Number} w The w coordinate.
- * @param {Cartesian4} [result] The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter or a new Cartesian4 instance if one was not provided.
- */
- Cartesian4.fromElements = function (x, y, z, w, result) {
- if (!when.defined(result)) {
- return new Cartesian4(x, y, z, w);
- }
- result.x = x;
- result.y = y;
- result.z = z;
- result.w = w;
- return result;
- };
- /**
- * Creates a Cartesian4 instance from a {@link Color}. <code>red</code>, <code>green</code>, <code>blue</code>,
- * and <code>alpha</code> map to <code>x</code>, <code>y</code>, <code>z</code>, and <code>w</code>, respectively.
- *
- * @param {Color} color The source color.
- * @param {Cartesian4} [result] The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter or a new Cartesian4 instance if one was not provided.
- */
- Cartesian4.fromColor = function (color, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("color", color);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return new Cartesian4(color.red, color.green, color.blue, color.alpha);
- }
- result.x = color.red;
- result.y = color.green;
- result.z = color.blue;
- result.w = color.alpha;
- return result;
- };
- /**
- * Duplicates a Cartesian4 instance.
- *
- * @param {Cartesian4} cartesian The Cartesian to duplicate.
- * @param {Cartesian4} [result] The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter or a new Cartesian4 instance if one was not provided. (Returns undefined if cartesian is undefined)
- */
- Cartesian4.clone = function (cartesian, result) {
- if (!when.defined(cartesian)) {
- return undefined;
- }
- if (!when.defined(result)) {
- return new Cartesian4(cartesian.x, cartesian.y, cartesian.z, cartesian.w);
- }
- result.x = cartesian.x;
- result.y = cartesian.y;
- result.z = cartesian.z;
- result.w = cartesian.w;
- return result;
- };
- /**
- * The number of elements used to pack the object into an array.
- * @type {Number}
- */
- Cartesian4.packedLength = 4;
- /**
- * Stores the provided instance into the provided array.
- *
- * @param {Cartesian4} value The value to pack.
- * @param {Number[]} array The array to pack into.
- * @param {Number} [startingIndex=0] The index into the array at which to start packing the elements.
- *
- * @returns {Number[]} The array that was packed into
- */
- Cartesian4.pack = function (value, array, startingIndex) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("value", value);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- array[startingIndex++] = value.x;
- array[startingIndex++] = value.y;
- array[startingIndex++] = value.z;
- array[startingIndex] = value.w;
- return array;
- };
- /**
- * Retrieves an instance from a packed array.
- *
- * @param {Number[]} array The packed array.
- * @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
- * @param {Cartesian4} [result] The object into which to store the result.
- * @returns {Cartesian4} The modified result parameter or a new Cartesian4 instance if one was not provided.
- */
- Cartesian4.unpack = function (array, startingIndex, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- if (!when.defined(result)) {
- result = new Cartesian4();
- }
- result.x = array[startingIndex++];
- result.y = array[startingIndex++];
- result.z = array[startingIndex++];
- result.w = array[startingIndex];
- return result;
- };
- /**
- * Flattens an array of Cartesian4s into and array of components.
- *
- * @param {Cartesian4[]} array The array of cartesians to pack.
- * @param {Number[]} [result] The array onto which to store the result. If this is a typed array, it must have array.length * 4 components, else a {@link DeveloperError} will be thrown. If it is a regular array, it will be resized to have (array.length * 4) elements.
- * @returns {Number[]} The packed array.
- */
- Cartesian4.packArray = function (array, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- var length = array.length;
- var resultLength = length * 4;
- if (!when.defined(result)) {
- result = new Array(resultLength);
- } else if (!Array.isArray(result) && result.length !== resultLength) {
- throw new Check.DeveloperError(
- "If result is a typed array, it must have exactly array.length * 4 elements"
- );
- } else if (result.length !== resultLength) {
- result.length = resultLength;
- }
- for (var i = 0; i < length; ++i) {
- Cartesian4.pack(array[i], result, i * 4);
- }
- return result;
- };
- /**
- * Unpacks an array of cartesian components into and array of Cartesian4s.
- *
- * @param {Number[]} array The array of components to unpack.
- * @param {Cartesian4[]} [result] The array onto which to store the result.
- * @returns {Cartesian4[]} The unpacked array.
- */
- Cartesian4.unpackArray = function (array, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- Check.Check.typeOf.number.greaterThanOrEquals("array.length", array.length, 4);
- if (array.length % 4 !== 0) {
- throw new Check.DeveloperError("array length must be a multiple of 4.");
- }
- //>>includeEnd('debug');
- var length = array.length;
- if (!when.defined(result)) {
- result = new Array(length / 4);
- } else {
- result.length = length / 4;
- }
- for (var i = 0; i < length; i += 4) {
- var index = i / 4;
- result[index] = Cartesian4.unpack(array, i, result[index]);
- }
- return result;
- };
- /**
- * Creates a Cartesian4 from four consecutive elements in an array.
- * @function
- *
- * @param {Number[]} array The array whose four consecutive elements correspond to the x, y, z, and w components, respectively.
- * @param {Number} [startingIndex=0] The offset into the array of the first element, which corresponds to the x component.
- * @param {Cartesian4} [result] The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter or a new Cartesian4 instance if one was not provided.
- *
- * @example
- * // Create a Cartesian4 with (1.0, 2.0, 3.0, 4.0)
- * var v = [1.0, 2.0, 3.0, 4.0];
- * var p = Cesium.Cartesian4.fromArray(v);
- *
- * // Create a Cartesian4 with (1.0, 2.0, 3.0, 4.0) using an offset into an array
- * var v2 = [0.0, 0.0, 1.0, 2.0, 3.0, 4.0];
- * var p2 = Cesium.Cartesian4.fromArray(v2, 2);
- */
- Cartesian4.fromArray = Cartesian4.unpack;
- /**
- * Computes the value of the maximum component for the supplied Cartesian.
- *
- * @param {Cartesian4} cartesian The cartesian to use.
- * @returns {Number} The value of the maximum component.
- */
- Cartesian4.maximumComponent = function (cartesian) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- //>>includeEnd('debug');
- return Math.max(cartesian.x, cartesian.y, cartesian.z, cartesian.w);
- };
- /**
- * Computes the value of the minimum component for the supplied Cartesian.
- *
- * @param {Cartesian4} cartesian The cartesian to use.
- * @returns {Number} The value of the minimum component.
- */
- Cartesian4.minimumComponent = function (cartesian) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- //>>includeEnd('debug');
- return Math.min(cartesian.x, cartesian.y, cartesian.z, cartesian.w);
- };
- /**
- * Compares two Cartesians and computes a Cartesian which contains the minimum components of the supplied Cartesians.
- *
- * @param {Cartesian4} first A cartesian to compare.
- * @param {Cartesian4} second A cartesian to compare.
- * @param {Cartesian4} result The object into which to store the result.
- * @returns {Cartesian4} A cartesian with the minimum components.
- */
- Cartesian4.minimumByComponent = function (first, second, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("first", first);
- Check.Check.typeOf.object("second", second);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = Math.min(first.x, second.x);
- result.y = Math.min(first.y, second.y);
- result.z = Math.min(first.z, second.z);
- result.w = Math.min(first.w, second.w);
- return result;
- };
- /**
- * Compares two Cartesians and computes a Cartesian which contains the maximum components of the supplied Cartesians.
- *
- * @param {Cartesian4} first A cartesian to compare.
- * @param {Cartesian4} second A cartesian to compare.
- * @param {Cartesian4} result The object into which to store the result.
- * @returns {Cartesian4} A cartesian with the maximum components.
- */
- Cartesian4.maximumByComponent = function (first, second, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("first", first);
- Check.Check.typeOf.object("second", second);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = Math.max(first.x, second.x);
- result.y = Math.max(first.y, second.y);
- result.z = Math.max(first.z, second.z);
- result.w = Math.max(first.w, second.w);
- return result;
- };
- /**
- * Computes the provided Cartesian's squared magnitude.
- *
- * @param {Cartesian4} cartesian The Cartesian instance whose squared magnitude is to be computed.
- * @returns {Number} The squared magnitude.
- */
- Cartesian4.magnitudeSquared = function (cartesian) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- //>>includeEnd('debug');
- return (
- cartesian.x * cartesian.x +
- cartesian.y * cartesian.y +
- cartesian.z * cartesian.z +
- cartesian.w * cartesian.w
- );
- };
- /**
- * Computes the Cartesian's magnitude (length).
- *
- * @param {Cartesian4} cartesian The Cartesian instance whose magnitude is to be computed.
- * @returns {Number} The magnitude.
- */
- Cartesian4.magnitude = function (cartesian) {
- return Math.sqrt(Cartesian4.magnitudeSquared(cartesian));
- };
- var distanceScratch = new Cartesian4();
- /**
- * Computes the 4-space distance between two points.
- *
- * @param {Cartesian4} left The first point to compute the distance from.
- * @param {Cartesian4} right The second point to compute the distance to.
- * @returns {Number} The distance between two points.
- *
- * @example
- * // Returns 1.0
- * var d = Cesium.Cartesian4.distance(
- * new Cesium.Cartesian4(1.0, 0.0, 0.0, 0.0),
- * new Cesium.Cartesian4(2.0, 0.0, 0.0, 0.0));
- */
- Cartesian4.distance = function (left, right) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- //>>includeEnd('debug');
- Cartesian4.subtract(left, right, distanceScratch);
- return Cartesian4.magnitude(distanceScratch);
- };
- /**
- * Computes the squared distance between two points. Comparing squared distances
- * using this function is more efficient than comparing distances using {@link Cartesian4#distance}.
- *
- * @param {Cartesian4} left The first point to compute the distance from.
- * @param {Cartesian4} right The second point to compute the distance to.
- * @returns {Number} The distance between two points.
- *
- * @example
- * // Returns 4.0, not 2.0
- * var d = Cesium.Cartesian4.distance(
- * new Cesium.Cartesian4(1.0, 0.0, 0.0, 0.0),
- * new Cesium.Cartesian4(3.0, 0.0, 0.0, 0.0));
- */
- Cartesian4.distanceSquared = function (left, right) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- //>>includeEnd('debug');
- Cartesian4.subtract(left, right, distanceScratch);
- return Cartesian4.magnitudeSquared(distanceScratch);
- };
- /**
- * Computes the normalized form of the supplied Cartesian.
- *
- * @param {Cartesian4} cartesian The Cartesian to be normalized.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.normalize = function (cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var magnitude = Cartesian4.magnitude(cartesian);
- result.x = cartesian.x / magnitude;
- result.y = cartesian.y / magnitude;
- result.z = cartesian.z / magnitude;
- result.w = cartesian.w / magnitude;
- //>>includeStart('debug', pragmas.debug);
- if (
- isNaN(result.x) ||
- isNaN(result.y) ||
- isNaN(result.z) ||
- isNaN(result.w)
- ) {
- throw new Check.DeveloperError("normalized result is not a number");
- }
- //>>includeEnd('debug');
- return result;
- };
- /**
- * Computes the dot (scalar) product of two Cartesians.
- *
- * @param {Cartesian4} left The first Cartesian.
- * @param {Cartesian4} right The second Cartesian.
- * @returns {Number} The dot product.
- */
- Cartesian4.dot = function (left, right) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- //>>includeEnd('debug');
- return (
- left.x * right.x + left.y * right.y + left.z * right.z + left.w * right.w
- );
- };
- /**
- * Computes the componentwise product of two Cartesians.
- *
- * @param {Cartesian4} left The first Cartesian.
- * @param {Cartesian4} right The second Cartesian.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.multiplyComponents = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = left.x * right.x;
- result.y = left.y * right.y;
- result.z = left.z * right.z;
- result.w = left.w * right.w;
- return result;
- };
- /**
- * Computes the componentwise quotient of two Cartesians.
- *
- * @param {Cartesian4} left The first Cartesian.
- * @param {Cartesian4} right The second Cartesian.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.divideComponents = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = left.x / right.x;
- result.y = left.y / right.y;
- result.z = left.z / right.z;
- result.w = left.w / right.w;
- return result;
- };
- /**
- * Computes the componentwise sum of two Cartesians.
- *
- * @param {Cartesian4} left The first Cartesian.
- * @param {Cartesian4} right The second Cartesian.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.add = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = left.x + right.x;
- result.y = left.y + right.y;
- result.z = left.z + right.z;
- result.w = left.w + right.w;
- return result;
- };
- /**
- * Computes the componentwise difference of two Cartesians.
- *
- * @param {Cartesian4} left The first Cartesian.
- * @param {Cartesian4} right The second Cartesian.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.subtract = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = left.x - right.x;
- result.y = left.y - right.y;
- result.z = left.z - right.z;
- result.w = left.w - right.w;
- return result;
- };
- /**
- * Multiplies the provided Cartesian componentwise by the provided scalar.
- *
- * @param {Cartesian4} cartesian The Cartesian to be scaled.
- * @param {Number} scalar The scalar to multiply with.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.multiplyByScalar = function (cartesian, scalar, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.number("scalar", scalar);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = cartesian.x * scalar;
- result.y = cartesian.y * scalar;
- result.z = cartesian.z * scalar;
- result.w = cartesian.w * scalar;
- return result;
- };
- /**
- * Divides the provided Cartesian componentwise by the provided scalar.
- *
- * @param {Cartesian4} cartesian The Cartesian to be divided.
- * @param {Number} scalar The scalar to divide by.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.divideByScalar = function (cartesian, scalar, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.number("scalar", scalar);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = cartesian.x / scalar;
- result.y = cartesian.y / scalar;
- result.z = cartesian.z / scalar;
- result.w = cartesian.w / scalar;
- return result;
- };
- /**
- * Negates the provided Cartesian.
- *
- * @param {Cartesian4} cartesian The Cartesian to be negated.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.negate = function (cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = -cartesian.x;
- result.y = -cartesian.y;
- result.z = -cartesian.z;
- result.w = -cartesian.w;
- return result;
- };
- /**
- * Computes the absolute value of the provided Cartesian.
- *
- * @param {Cartesian4} cartesian The Cartesian whose absolute value is to be computed.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.abs = function (cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = Math.abs(cartesian.x);
- result.y = Math.abs(cartesian.y);
- result.z = Math.abs(cartesian.z);
- result.w = Math.abs(cartesian.w);
- return result;
- };
- var lerpScratch = new Cartesian4();
- /**
- * Computes the linear interpolation or extrapolation at t using the provided cartesians.
- *
- * @param {Cartesian4} start The value corresponding to t at 0.0.
- * @param {Cartesian4}end The value corresponding to t at 1.0.
- * @param {Number} t The point along t at which to interpolate.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Cartesian4.lerp = function (start, end, t, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("start", start);
- Check.Check.typeOf.object("end", end);
- Check.Check.typeOf.number("t", t);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- Cartesian4.multiplyByScalar(end, t, lerpScratch);
- result = Cartesian4.multiplyByScalar(start, 1.0 - t, result);
- return Cartesian4.add(lerpScratch, result, result);
- };
- var mostOrthogonalAxisScratch = new Cartesian4();
- /**
- * Returns the axis that is most orthogonal to the provided Cartesian.
- *
- * @param {Cartesian4} cartesian The Cartesian on which to find the most orthogonal axis.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The most orthogonal axis.
- */
- Cartesian4.mostOrthogonalAxis = function (cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var f = Cartesian4.normalize(cartesian, mostOrthogonalAxisScratch);
- Cartesian4.abs(f, f);
- if (f.x <= f.y) {
- if (f.x <= f.z) {
- if (f.x <= f.w) {
- result = Cartesian4.clone(Cartesian4.UNIT_X, result);
- } else {
- result = Cartesian4.clone(Cartesian4.UNIT_W, result);
- }
- } else if (f.z <= f.w) {
- result = Cartesian4.clone(Cartesian4.UNIT_Z, result);
- } else {
- result = Cartesian4.clone(Cartesian4.UNIT_W, result);
- }
- } else if (f.y <= f.z) {
- if (f.y <= f.w) {
- result = Cartesian4.clone(Cartesian4.UNIT_Y, result);
- } else {
- result = Cartesian4.clone(Cartesian4.UNIT_W, result);
- }
- } else if (f.z <= f.w) {
- result = Cartesian4.clone(Cartesian4.UNIT_Z, result);
- } else {
- result = Cartesian4.clone(Cartesian4.UNIT_W, result);
- }
- return result;
- };
- /**
- * Compares the provided Cartesians componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {Cartesian4} [left] The first Cartesian.
- * @param {Cartesian4} [right] The second Cartesian.
- * @returns {Boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- */
- Cartesian4.equals = function (left, right) {
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- left.x === right.x &&
- left.y === right.y &&
- left.z === right.z &&
- left.w === right.w)
- );
- };
- /**
- * @private
- */
- Cartesian4.equalsArray = function (cartesian, array, offset) {
- return (
- cartesian.x === array[offset] &&
- cartesian.y === array[offset + 1] &&
- cartesian.z === array[offset + 2] &&
- cartesian.w === array[offset + 3]
- );
- };
- /**
- * Compares the provided Cartesians componentwise and returns
- * <code>true</code> if they pass an absolute or relative tolerance test,
- * <code>false</code> otherwise.
- *
- * @param {Cartesian4} [left] The first Cartesian.
- * @param {Cartesian4} [right] The second Cartesian.
- * @param {Number} [relativeEpsilon=0] The relative epsilon tolerance to use for equality testing.
- * @param {Number} [absoluteEpsilon=relativeEpsilon] The absolute epsilon tolerance to use for equality testing.
- * @returns {Boolean} <code>true</code> if left and right are within the provided epsilon, <code>false</code> otherwise.
- */
- Cartesian4.equalsEpsilon = function (
- left,
- right,
- relativeEpsilon,
- absoluteEpsilon
- ) {
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- _Math.CesiumMath.equalsEpsilon(
- left.x,
- right.x,
- relativeEpsilon,
- absoluteEpsilon
- ) &&
- _Math.CesiumMath.equalsEpsilon(
- left.y,
- right.y,
- relativeEpsilon,
- absoluteEpsilon
- ) &&
- _Math.CesiumMath.equalsEpsilon(
- left.z,
- right.z,
- relativeEpsilon,
- absoluteEpsilon
- ) &&
- _Math.CesiumMath.equalsEpsilon(
- left.w,
- right.w,
- relativeEpsilon,
- absoluteEpsilon
- ))
- );
- };
- /**
- * An immutable Cartesian4 instance initialized to (0.0, 0.0, 0.0, 0.0).
- *
- * @type {Cartesian4}
- * @constant
- */
- Cartesian4.ZERO = Object.freeze(new Cartesian4(0.0, 0.0, 0.0, 0.0));
- /**
- * An immutable Cartesian4 instance initialized to (1.0, 0.0, 0.0, 0.0).
- *
- * @type {Cartesian4}
- * @constant
- */
- Cartesian4.UNIT_X = Object.freeze(new Cartesian4(1.0, 0.0, 0.0, 0.0));
- /**
- * An immutable Cartesian4 instance initialized to (0.0, 1.0, 0.0, 0.0).
- *
- * @type {Cartesian4}
- * @constant
- */
- Cartesian4.UNIT_Y = Object.freeze(new Cartesian4(0.0, 1.0, 0.0, 0.0));
- /**
- * An immutable Cartesian4 instance initialized to (0.0, 0.0, 1.0, 0.0).
- *
- * @type {Cartesian4}
- * @constant
- */
- Cartesian4.UNIT_Z = Object.freeze(new Cartesian4(0.0, 0.0, 1.0, 0.0));
- /**
- * An immutable Cartesian4 instance initialized to (0.0, 0.0, 0.0, 1.0).
- *
- * @type {Cartesian4}
- * @constant
- */
- Cartesian4.UNIT_W = Object.freeze(new Cartesian4(0.0, 0.0, 0.0, 1.0));
- /**
- * Duplicates this Cartesian4 instance.
- *
- * @param {Cartesian4} [result] The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter or a new Cartesian4 instance if one was not provided.
- */
- Cartesian4.prototype.clone = function (result) {
- return Cartesian4.clone(this, result);
- };
- /**
- * Compares this Cartesian against the provided Cartesian componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {Cartesian4} [right] The right hand side Cartesian.
- * @returns {Boolean} <code>true</code> if they are equal, <code>false</code> otherwise.
- */
- Cartesian4.prototype.equals = function (right) {
- return Cartesian4.equals(this, right);
- };
- /**
- * Compares this Cartesian against the provided Cartesian componentwise and returns
- * <code>true</code> if they pass an absolute or relative tolerance test,
- * <code>false</code> otherwise.
- *
- * @param {Cartesian4} [right] The right hand side Cartesian.
- * @param {Number} [relativeEpsilon=0] The relative epsilon tolerance to use for equality testing.
- * @param {Number} [absoluteEpsilon=relativeEpsilon] The absolute epsilon tolerance to use for equality testing.
- * @returns {Boolean} <code>true</code> if they are within the provided epsilon, <code>false</code> otherwise.
- */
- Cartesian4.prototype.equalsEpsilon = function (
- right,
- relativeEpsilon,
- absoluteEpsilon
- ) {
- return Cartesian4.equalsEpsilon(
- this,
- right,
- relativeEpsilon,
- absoluteEpsilon
- );
- };
- /**
- * Creates a string representing this Cartesian in the format '(x, y, z, w)'.
- *
- * @returns {String} A string representing the provided Cartesian in the format '(x, y, z, w)'.
- */
- Cartesian4.prototype.toString = function () {
- return "(" + this.x + ", " + this.y + ", " + this.z + ", " + this.w + ")";
- };
- var scratchFloatArray = new Float32Array(1);
- var SHIFT_LEFT_8 = 256.0;
- var SHIFT_LEFT_16 = 65536.0;
- var SHIFT_LEFT_24 = 16777216.0;
- var SHIFT_RIGHT_8 = 1.0 / SHIFT_LEFT_8;
- var SHIFT_RIGHT_16 = 1.0 / SHIFT_LEFT_16;
- var SHIFT_RIGHT_24 = 1.0 / SHIFT_LEFT_24;
- var BIAS = 38.0;
- /**
- * Packs an arbitrary floating point value to 4 values representable using uint8.
- *
- * @param {Number} value A floating point number
- * @param {Cartesian4} [result] The Cartesian4 that will contain the packed float.
- * @returns {Cartesian4} A Cartesian4 representing the float packed to values in x, y, z, and w.
- */
- Cartesian4.packFloat = function (value, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("value", value);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new Cartesian4();
- }
- // Force the value to 32 bit precision
- scratchFloatArray[0] = value;
- value = scratchFloatArray[0];
- if (value === 0.0) {
- return Cartesian4.clone(Cartesian4.ZERO, result);
- }
- var sign = value < 0.0 ? 1.0 : 0.0;
- var exponent;
- if (!isFinite(value)) {
- value = 0.1;
- exponent = BIAS;
- } else {
- value = Math.abs(value);
- exponent = Math.floor(_Math.CesiumMath.logBase(value, 10)) + 1.0;
- value = value / Math.pow(10.0, exponent);
- }
- var temp = value * SHIFT_LEFT_8;
- result.x = Math.floor(temp);
- temp = (temp - result.x) * SHIFT_LEFT_8;
- result.y = Math.floor(temp);
- temp = (temp - result.y) * SHIFT_LEFT_8;
- result.z = Math.floor(temp);
- result.w = (exponent + BIAS) * 2.0 + sign;
- return result;
- };
- /**
- * Unpacks a float packed using Cartesian4.packFloat.
- *
- * @param {Cartesian4} packedFloat A Cartesian4 containing a float packed to 4 values representable using uint8.
- * @returns {Number} The unpacked float.
- * @private
- */
- Cartesian4.unpackFloat = function (packedFloat) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("packedFloat", packedFloat);
- //>>includeEnd('debug');
- var temp = packedFloat.w / 2.0;
- var exponent = Math.floor(temp);
- var sign = (temp - exponent) * 2.0;
- exponent = exponent - BIAS;
- sign = sign * 2.0 - 1.0;
- sign = -sign;
- if (exponent >= BIAS) {
- return sign < 0.0 ? Number.NEGATIVE_INFINITY : Number.POSITIVE_INFINITY;
- }
- var unpacked = sign * packedFloat.x * SHIFT_RIGHT_8;
- unpacked += sign * packedFloat.y * SHIFT_RIGHT_16;
- unpacked += sign * packedFloat.z * SHIFT_RIGHT_24;
- return unpacked * Math.pow(10.0, exponent);
- };
- /**
- * A 4x4 matrix, indexable as a column-major order array.
- * Constructor parameters are in row-major order for code readability.
- * @alias Matrix4
- * @constructor
- * @implements {ArrayLike<number>}
- *
- * @param {Number} [column0Row0=0.0] The value for column 0, row 0.
- * @param {Number} [column1Row0=0.0] The value for column 1, row 0.
- * @param {Number} [column2Row0=0.0] The value for column 2, row 0.
- * @param {Number} [column3Row0=0.0] The value for column 3, row 0.
- * @param {Number} [column0Row1=0.0] The value for column 0, row 1.
- * @param {Number} [column1Row1=0.0] The value for column 1, row 1.
- * @param {Number} [column2Row1=0.0] The value for column 2, row 1.
- * @param {Number} [column3Row1=0.0] The value for column 3, row 1.
- * @param {Number} [column0Row2=0.0] The value for column 0, row 2.
- * @param {Number} [column1Row2=0.0] The value for column 1, row 2.
- * @param {Number} [column2Row2=0.0] The value for column 2, row 2.
- * @param {Number} [column3Row2=0.0] The value for column 3, row 2.
- * @param {Number} [column0Row3=0.0] The value for column 0, row 3.
- * @param {Number} [column1Row3=0.0] The value for column 1, row 3.
- * @param {Number} [column2Row3=0.0] The value for column 2, row 3.
- * @param {Number} [column3Row3=0.0] The value for column 3, row 3.
- *
- * @see Matrix4.fromColumnMajorArray
- * @see Matrix4.fromRowMajorArray
- * @see Matrix4.fromRotationTranslation
- * @see Matrix4.fromTranslationRotationScale
- * @see Matrix4.fromTranslationQuaternionRotationScale
- * @see Matrix4.fromTranslation
- * @see Matrix4.fromScale
- * @see Matrix4.fromUniformScale
- * @see Matrix4.fromCamera
- * @see Matrix4.computePerspectiveFieldOfView
- * @see Matrix4.computeOrthographicOffCenter
- * @see Matrix4.computePerspectiveOffCenter
- * @see Matrix4.computeInfinitePerspectiveOffCenter
- * @see Matrix4.computeViewportTransformation
- * @see Matrix4.computeView
- * @see Matrix2
- * @see Matrix3
- * @see Packable
- */
- function Matrix4(
- column0Row0,
- column1Row0,
- column2Row0,
- column3Row0,
- column0Row1,
- column1Row1,
- column2Row1,
- column3Row1,
- column0Row2,
- column1Row2,
- column2Row2,
- column3Row2,
- column0Row3,
- column1Row3,
- column2Row3,
- column3Row3
- ) {
- this[0] = when.defaultValue(column0Row0, 0.0);
- this[1] = when.defaultValue(column0Row1, 0.0);
- this[2] = when.defaultValue(column0Row2, 0.0);
- this[3] = when.defaultValue(column0Row3, 0.0);
- this[4] = when.defaultValue(column1Row0, 0.0);
- this[5] = when.defaultValue(column1Row1, 0.0);
- this[6] = when.defaultValue(column1Row2, 0.0);
- this[7] = when.defaultValue(column1Row3, 0.0);
- this[8] = when.defaultValue(column2Row0, 0.0);
- this[9] = when.defaultValue(column2Row1, 0.0);
- this[10] = when.defaultValue(column2Row2, 0.0);
- this[11] = when.defaultValue(column2Row3, 0.0);
- this[12] = when.defaultValue(column3Row0, 0.0);
- this[13] = when.defaultValue(column3Row1, 0.0);
- this[14] = when.defaultValue(column3Row2, 0.0);
- this[15] = when.defaultValue(column3Row3, 0.0);
- }
- /**
- * The number of elements used to pack the object into an array.
- * @type {Number}
- */
- Matrix4.packedLength = 16;
- /**
- * Stores the provided instance into the provided array.
- *
- * @param {Matrix4} value The value to pack.
- * @param {Number[]} array The array to pack into.
- * @param {Number} [startingIndex=0] The index into the array at which to start packing the elements.
- *
- * @returns {Number[]} The array that was packed into
- */
- Matrix4.pack = function (value, array, startingIndex) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("value", value);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- array[startingIndex++] = value[0];
- array[startingIndex++] = value[1];
- array[startingIndex++] = value[2];
- array[startingIndex++] = value[3];
- array[startingIndex++] = value[4];
- array[startingIndex++] = value[5];
- array[startingIndex++] = value[6];
- array[startingIndex++] = value[7];
- array[startingIndex++] = value[8];
- array[startingIndex++] = value[9];
- array[startingIndex++] = value[10];
- array[startingIndex++] = value[11];
- array[startingIndex++] = value[12];
- array[startingIndex++] = value[13];
- array[startingIndex++] = value[14];
- array[startingIndex] = value[15];
- return array;
- };
- /**
- * Retrieves an instance from a packed array.
- *
- * @param {Number[]} array The packed array.
- * @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
- * @param {Matrix4} [result] The object into which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if one was not provided.
- */
- Matrix4.unpack = function (array, startingIndex, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- if (!when.defined(result)) {
- result = new Matrix4();
- }
- result[0] = array[startingIndex++];
- result[1] = array[startingIndex++];
- result[2] = array[startingIndex++];
- result[3] = array[startingIndex++];
- result[4] = array[startingIndex++];
- result[5] = array[startingIndex++];
- result[6] = array[startingIndex++];
- result[7] = array[startingIndex++];
- result[8] = array[startingIndex++];
- result[9] = array[startingIndex++];
- result[10] = array[startingIndex++];
- result[11] = array[startingIndex++];
- result[12] = array[startingIndex++];
- result[13] = array[startingIndex++];
- result[14] = array[startingIndex++];
- result[15] = array[startingIndex];
- return result;
- };
- /**
- * Duplicates a Matrix4 instance.
- *
- * @param {Matrix4} matrix The matrix to duplicate.
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if one was not provided. (Returns undefined if matrix is undefined)
- */
- Matrix4.clone = function (matrix, result) {
- if (!when.defined(matrix)) {
- return undefined;
- }
- if (!when.defined(result)) {
- return new Matrix4(
- matrix[0],
- matrix[4],
- matrix[8],
- matrix[12],
- matrix[1],
- matrix[5],
- matrix[9],
- matrix[13],
- matrix[2],
- matrix[6],
- matrix[10],
- matrix[14],
- matrix[3],
- matrix[7],
- matrix[11],
- matrix[15]
- );
- }
- result[0] = matrix[0];
- result[1] = matrix[1];
- result[2] = matrix[2];
- result[3] = matrix[3];
- result[4] = matrix[4];
- result[5] = matrix[5];
- result[6] = matrix[6];
- result[7] = matrix[7];
- result[8] = matrix[8];
- result[9] = matrix[9];
- result[10] = matrix[10];
- result[11] = matrix[11];
- result[12] = matrix[12];
- result[13] = matrix[13];
- result[14] = matrix[14];
- result[15] = matrix[15];
- return result;
- };
- /**
- * Creates a Matrix4 from 16 consecutive elements in an array.
- * @function
- *
- * @param {Number[]} array The array whose 16 consecutive elements correspond to the positions of the matrix. Assumes column-major order.
- * @param {Number} [startingIndex=0] The offset into the array of the first element, which corresponds to first column first row position in the matrix.
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if one was not provided.
- *
- * @example
- * // Create the Matrix4:
- * // [1.0, 2.0, 3.0, 4.0]
- * // [1.0, 2.0, 3.0, 4.0]
- * // [1.0, 2.0, 3.0, 4.0]
- * // [1.0, 2.0, 3.0, 4.0]
- *
- * var v = [1.0, 1.0, 1.0, 1.0, 2.0, 2.0, 2.0, 2.0, 3.0, 3.0, 3.0, 3.0, 4.0, 4.0, 4.0, 4.0];
- * var m = Cesium.Matrix4.fromArray(v);
- *
- * // Create same Matrix4 with using an offset into an array
- * var v2 = [0.0, 0.0, 1.0, 1.0, 1.0, 1.0, 2.0, 2.0, 2.0, 2.0, 3.0, 3.0, 3.0, 3.0, 4.0, 4.0, 4.0, 4.0];
- * var m2 = Cesium.Matrix4.fromArray(v2, 2);
- */
- Matrix4.fromArray = Matrix4.unpack;
- /**
- * Computes a Matrix4 instance from a column-major order array.
- *
- * @param {Number[]} values The column-major order array.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- */
- Matrix4.fromColumnMajorArray = function (values, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("values", values);
- //>>includeEnd('debug');
- return Matrix4.clone(values, result);
- };
- /**
- * Computes a Matrix4 instance from a row-major order array.
- * The resulting matrix will be in column-major order.
- *
- * @param {Number[]} values The row-major order array.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- */
- Matrix4.fromRowMajorArray = function (values, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("values", values);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return new Matrix4(
- values[0],
- values[1],
- values[2],
- values[3],
- values[4],
- values[5],
- values[6],
- values[7],
- values[8],
- values[9],
- values[10],
- values[11],
- values[12],
- values[13],
- values[14],
- values[15]
- );
- }
- result[0] = values[0];
- result[1] = values[4];
- result[2] = values[8];
- result[3] = values[12];
- result[4] = values[1];
- result[5] = values[5];
- result[6] = values[9];
- result[7] = values[13];
- result[8] = values[2];
- result[9] = values[6];
- result[10] = values[10];
- result[11] = values[14];
- result[12] = values[3];
- result[13] = values[7];
- result[14] = values[11];
- result[15] = values[15];
- return result;
- };
- /**
- * Computes a Matrix4 instance from a Matrix3 representing the rotation
- * and a Cartesian3 representing the translation.
- *
- * @param {Matrix3} rotation The upper left portion of the matrix representing the rotation.
- * @param {Cartesian3} [translation=Cartesian3.ZERO] The upper right portion of the matrix representing the translation.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- */
- Matrix4.fromRotationTranslation = function (rotation, translation, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("rotation", rotation);
- //>>includeEnd('debug');
- translation = when.defaultValue(translation, Cartesian2.Cartesian3.ZERO);
- if (!when.defined(result)) {
- return new Matrix4(
- rotation[0],
- rotation[3],
- rotation[6],
- translation.x,
- rotation[1],
- rotation[4],
- rotation[7],
- translation.y,
- rotation[2],
- rotation[5],
- rotation[8],
- translation.z,
- 0.0,
- 0.0,
- 0.0,
- 1.0
- );
- }
- result[0] = rotation[0];
- result[1] = rotation[1];
- result[2] = rotation[2];
- result[3] = 0.0;
- result[4] = rotation[3];
- result[5] = rotation[4];
- result[6] = rotation[5];
- result[7] = 0.0;
- result[8] = rotation[6];
- result[9] = rotation[7];
- result[10] = rotation[8];
- result[11] = 0.0;
- result[12] = translation.x;
- result[13] = translation.y;
- result[14] = translation.z;
- result[15] = 1.0;
- return result;
- };
- /**
- * Computes a Matrix4 instance from a translation, rotation, and scale (TRS)
- * representation with the rotation represented as a quaternion.
- *
- * @param {Cartesian3} translation The translation transformation.
- * @param {Quaternion} rotation The rotation transformation.
- * @param {Cartesian3} scale The non-uniform scale transformation.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- *
- * @example
- * var result = Cesium.Matrix4.fromTranslationQuaternionRotationScale(
- * new Cesium.Cartesian3(1.0, 2.0, 3.0), // translation
- * Cesium.Quaternion.IDENTITY, // rotation
- * new Cesium.Cartesian3(7.0, 8.0, 9.0), // scale
- * result);
- */
- Matrix4.fromTranslationQuaternionRotationScale = function (
- translation,
- rotation,
- scale,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("translation", translation);
- Check.Check.typeOf.object("rotation", rotation);
- Check.Check.typeOf.object("scale", scale);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new Matrix4();
- }
- var scaleX = scale.x;
- var scaleY = scale.y;
- var scaleZ = scale.z;
- var x2 = rotation.x * rotation.x;
- var xy = rotation.x * rotation.y;
- var xz = rotation.x * rotation.z;
- var xw = rotation.x * rotation.w;
- var y2 = rotation.y * rotation.y;
- var yz = rotation.y * rotation.z;
- var yw = rotation.y * rotation.w;
- var z2 = rotation.z * rotation.z;
- var zw = rotation.z * rotation.w;
- var w2 = rotation.w * rotation.w;
- var m00 = x2 - y2 - z2 + w2;
- var m01 = 2.0 * (xy - zw);
- var m02 = 2.0 * (xz + yw);
- var m10 = 2.0 * (xy + zw);
- var m11 = -x2 + y2 - z2 + w2;
- var m12 = 2.0 * (yz - xw);
- var m20 = 2.0 * (xz - yw);
- var m21 = 2.0 * (yz + xw);
- var m22 = -x2 - y2 + z2 + w2;
- result[0] = m00 * scaleX;
- result[1] = m10 * scaleX;
- result[2] = m20 * scaleX;
- result[3] = 0.0;
- result[4] = m01 * scaleY;
- result[5] = m11 * scaleY;
- result[6] = m21 * scaleY;
- result[7] = 0.0;
- result[8] = m02 * scaleZ;
- result[9] = m12 * scaleZ;
- result[10] = m22 * scaleZ;
- result[11] = 0.0;
- result[12] = translation.x;
- result[13] = translation.y;
- result[14] = translation.z;
- result[15] = 1.0;
- return result;
- };
- /**
- * Creates a Matrix4 instance from a {@link TranslationRotationScale} instance.
- *
- * @param {TranslationRotationScale} translationRotationScale The instance.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- */
- Matrix4.fromTranslationRotationScale = function (
- translationRotationScale,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("translationRotationScale", translationRotationScale);
- //>>includeEnd('debug');
- return Matrix4.fromTranslationQuaternionRotationScale(
- translationRotationScale.translation,
- translationRotationScale.rotation,
- translationRotationScale.scale,
- result
- );
- };
- /**
- * Creates a Matrix4 instance from a Cartesian3 representing the translation.
- *
- * @param {Cartesian3} translation The upper right portion of the matrix representing the translation.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- *
- * @see Matrix4.multiplyByTranslation
- */
- Matrix4.fromTranslation = function (translation, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("translation", translation);
- //>>includeEnd('debug');
- return Matrix4.fromRotationTranslation(Matrix3.IDENTITY, translation, result);
- };
- /**
- * Computes a Matrix4 instance representing a non-uniform scale.
- *
- * @param {Cartesian3} scale The x, y, and z scale factors.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- *
- * @example
- * // Creates
- * // [7.0, 0.0, 0.0, 0.0]
- * // [0.0, 8.0, 0.0, 0.0]
- * // [0.0, 0.0, 9.0, 0.0]
- * // [0.0, 0.0, 0.0, 1.0]
- * var m = Cesium.Matrix4.fromScale(new Cesium.Cartesian3(7.0, 8.0, 9.0));
- */
- Matrix4.fromScale = function (scale, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("scale", scale);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return new Matrix4(
- scale.x,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- scale.y,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- scale.z,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 1.0
- );
- }
- result[0] = scale.x;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = 0.0;
- result[5] = scale.y;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = 0.0;
- result[9] = 0.0;
- result[10] = scale.z;
- result[11] = 0.0;
- result[12] = 0.0;
- result[13] = 0.0;
- result[14] = 0.0;
- result[15] = 1.0;
- return result;
- };
- /**
- * Computes a Matrix4 instance representing a uniform scale.
- *
- * @param {Number} scale The uniform scale factor.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- *
- * @example
- * // Creates
- * // [2.0, 0.0, 0.0, 0.0]
- * // [0.0, 2.0, 0.0, 0.0]
- * // [0.0, 0.0, 2.0, 0.0]
- * // [0.0, 0.0, 0.0, 1.0]
- * var m = Cesium.Matrix4.fromUniformScale(2.0);
- */
- Matrix4.fromUniformScale = function (scale, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("scale", scale);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return new Matrix4(
- scale,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- scale,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- scale,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 1.0
- );
- }
- result[0] = scale;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = 0.0;
- result[5] = scale;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = 0.0;
- result[9] = 0.0;
- result[10] = scale;
- result[11] = 0.0;
- result[12] = 0.0;
- result[13] = 0.0;
- result[14] = 0.0;
- result[15] = 1.0;
- return result;
- };
- var fromCameraF = new Cartesian2.Cartesian3();
- var fromCameraR = new Cartesian2.Cartesian3();
- var fromCameraU = new Cartesian2.Cartesian3();
- /**
- * Computes a Matrix4 instance from a Camera.
- *
- * @param {Camera} camera The camera to use.
- * @param {Matrix4} [result] The object in which the result will be stored, if undefined a new instance will be created.
- * @returns {Matrix4} The modified result parameter, or a new Matrix4 instance if one was not provided.
- */
- Matrix4.fromCamera = function (camera, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("camera", camera);
- //>>includeEnd('debug');
- var position = camera.position;
- var direction = camera.direction;
- var up = camera.up;
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("camera.position", position);
- Check.Check.typeOf.object("camera.direction", direction);
- Check.Check.typeOf.object("camera.up", up);
- //>>includeEnd('debug');
- Cartesian2.Cartesian3.normalize(direction, fromCameraF);
- Cartesian2.Cartesian3.normalize(
- Cartesian2.Cartesian3.cross(fromCameraF, up, fromCameraR),
- fromCameraR
- );
- Cartesian2.Cartesian3.normalize(
- Cartesian2.Cartesian3.cross(fromCameraR, fromCameraF, fromCameraU),
- fromCameraU
- );
- var sX = fromCameraR.x;
- var sY = fromCameraR.y;
- var sZ = fromCameraR.z;
- var fX = fromCameraF.x;
- var fY = fromCameraF.y;
- var fZ = fromCameraF.z;
- var uX = fromCameraU.x;
- var uY = fromCameraU.y;
- var uZ = fromCameraU.z;
- var positionX = position.x;
- var positionY = position.y;
- var positionZ = position.z;
- var t0 = sX * -positionX + sY * -positionY + sZ * -positionZ;
- var t1 = uX * -positionX + uY * -positionY + uZ * -positionZ;
- var t2 = fX * positionX + fY * positionY + fZ * positionZ;
- // The code below this comment is an optimized
- // version of the commented lines.
- // Rather that create two matrices and then multiply,
- // we just bake in the multiplcation as part of creation.
- // var rotation = new Matrix4(
- // sX, sY, sZ, 0.0,
- // uX, uY, uZ, 0.0,
- // -fX, -fY, -fZ, 0.0,
- // 0.0, 0.0, 0.0, 1.0);
- // var translation = new Matrix4(
- // 1.0, 0.0, 0.0, -position.x,
- // 0.0, 1.0, 0.0, -position.y,
- // 0.0, 0.0, 1.0, -position.z,
- // 0.0, 0.0, 0.0, 1.0);
- // return rotation.multiply(translation);
- if (!when.defined(result)) {
- return new Matrix4(
- sX,
- sY,
- sZ,
- t0,
- uX,
- uY,
- uZ,
- t1,
- -fX,
- -fY,
- -fZ,
- t2,
- 0.0,
- 0.0,
- 0.0,
- 1.0
- );
- }
- result[0] = sX;
- result[1] = uX;
- result[2] = -fX;
- result[3] = 0.0;
- result[4] = sY;
- result[5] = uY;
- result[6] = -fY;
- result[7] = 0.0;
- result[8] = sZ;
- result[9] = uZ;
- result[10] = -fZ;
- result[11] = 0.0;
- result[12] = t0;
- result[13] = t1;
- result[14] = t2;
- result[15] = 1.0;
- return result;
- };
- /**
- * Computes a Matrix4 instance representing a perspective transformation matrix.
- *
- * @param {Number} fovY The field of view along the Y axis in radians.
- * @param {Number} aspectRatio The aspect ratio.
- * @param {Number} near The distance to the near plane in meters.
- * @param {Number} far The distance to the far plane in meters.
- * @param {Matrix4} result The object in which the result will be stored.
- * @returns {Matrix4} The modified result parameter.
- *
- * @exception {DeveloperError} fovY must be in (0, PI].
- * @exception {DeveloperError} aspectRatio must be greater than zero.
- * @exception {DeveloperError} near must be greater than zero.
- * @exception {DeveloperError} far must be greater than zero.
- */
- Matrix4.computePerspectiveFieldOfView = function (
- fovY,
- aspectRatio,
- near,
- far,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number.greaterThan("fovY", fovY, 0.0);
- Check.Check.typeOf.number.lessThan("fovY", fovY, Math.PI);
- Check.Check.typeOf.number.greaterThan("near", near, 0.0);
- Check.Check.typeOf.number.greaterThan("far", far, 0.0);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var bottom = Math.tan(fovY * 0.5);
- var column1Row1 = 1.0 / bottom;
- var column0Row0 = column1Row1 / aspectRatio;
- var column2Row2 = (far + near) / (near - far);
- var column3Row2 = (2.0 * far * near) / (near - far);
- result[0] = column0Row0;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = 0.0;
- result[5] = column1Row1;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = 0.0;
- result[9] = 0.0;
- result[10] = column2Row2;
- result[11] = -1.0;
- result[12] = 0.0;
- result[13] = 0.0;
- result[14] = column3Row2;
- result[15] = 0.0;
- return result;
- };
- /**
- * Computes a Matrix4 instance representing an orthographic transformation matrix.
- *
- * @param {Number} left The number of meters to the left of the camera that will be in view.
- * @param {Number} right The number of meters to the right of the camera that will be in view.
- * @param {Number} bottom The number of meters below of the camera that will be in view.
- * @param {Number} top The number of meters above of the camera that will be in view.
- * @param {Number} near The distance to the near plane in meters.
- * @param {Number} far The distance to the far plane in meters.
- * @param {Matrix4} result The object in which the result will be stored.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.computeOrthographicOffCenter = function (
- left,
- right,
- bottom,
- top,
- near,
- far,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("left", left);
- Check.Check.typeOf.number("right", right);
- Check.Check.typeOf.number("bottom", bottom);
- Check.Check.typeOf.number("top", top);
- Check.Check.typeOf.number("near", near);
- Check.Check.typeOf.number("far", far);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var a = 1.0 / (right - left);
- var b = 1.0 / (top - bottom);
- var c = 1.0 / (far - near);
- var tx = -(right + left) * a;
- var ty = -(top + bottom) * b;
- var tz = -(far + near) * c;
- a *= 2.0;
- b *= 2.0;
- c *= -2.0;
- result[0] = a;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = 0.0;
- result[5] = b;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = 0.0;
- result[9] = 0.0;
- result[10] = c;
- result[11] = 0.0;
- result[12] = tx;
- result[13] = ty;
- result[14] = tz;
- result[15] = 1.0;
- return result;
- };
- /**
- * Computes a Matrix4 instance representing an off center perspective transformation.
- *
- * @param {Number} left The number of meters to the left of the camera that will be in view.
- * @param {Number} right The number of meters to the right of the camera that will be in view.
- * @param {Number} bottom The number of meters below of the camera that will be in view.
- * @param {Number} top The number of meters above of the camera that will be in view.
- * @param {Number} near The distance to the near plane in meters.
- * @param {Number} far The distance to the far plane in meters.
- * @param {Matrix4} result The object in which the result will be stored.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.computePerspectiveOffCenter = function (
- left,
- right,
- bottom,
- top,
- near,
- far,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("left", left);
- Check.Check.typeOf.number("right", right);
- Check.Check.typeOf.number("bottom", bottom);
- Check.Check.typeOf.number("top", top);
- Check.Check.typeOf.number("near", near);
- Check.Check.typeOf.number("far", far);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var column0Row0 = (2.0 * near) / (right - left);
- var column1Row1 = (2.0 * near) / (top - bottom);
- var column2Row0 = (right + left) / (right - left);
- var column2Row1 = (top + bottom) / (top - bottom);
- var column2Row2 = -(far + near) / (far - near);
- var column2Row3 = -1.0;
- var column3Row2 = (-2.0 * far * near) / (far - near);
- result[0] = column0Row0;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = 0.0;
- result[5] = column1Row1;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = column2Row0;
- result[9] = column2Row1;
- result[10] = column2Row2;
- result[11] = column2Row3;
- result[12] = 0.0;
- result[13] = 0.0;
- result[14] = column3Row2;
- result[15] = 0.0;
- return result;
- };
- /**
- * Computes a Matrix4 instance representing an infinite off center perspective transformation.
- *
- * @param {Number} left The number of meters to the left of the camera that will be in view.
- * @param {Number} right The number of meters to the right of the camera that will be in view.
- * @param {Number} bottom The number of meters below of the camera that will be in view.
- * @param {Number} top The number of meters above of the camera that will be in view.
- * @param {Number} near The distance to the near plane in meters.
- * @param {Matrix4} result The object in which the result will be stored.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.computeInfinitePerspectiveOffCenter = function (
- left,
- right,
- bottom,
- top,
- near,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number("left", left);
- Check.Check.typeOf.number("right", right);
- Check.Check.typeOf.number("bottom", bottom);
- Check.Check.typeOf.number("top", top);
- Check.Check.typeOf.number("near", near);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var column0Row0 = (2.0 * near) / (right - left);
- var column1Row1 = (2.0 * near) / (top - bottom);
- var column2Row0 = (right + left) / (right - left);
- var column2Row1 = (top + bottom) / (top - bottom);
- var column2Row2 = -1.0;
- var column2Row3 = -1.0;
- var column3Row2 = -2.0 * near;
- result[0] = column0Row0;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = 0.0;
- result[5] = column1Row1;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = column2Row0;
- result[9] = column2Row1;
- result[10] = column2Row2;
- result[11] = column2Row3;
- result[12] = 0.0;
- result[13] = 0.0;
- result[14] = column3Row2;
- result[15] = 0.0;
- return result;
- };
- /**
- * Computes a Matrix4 instance that transforms from normalized device coordinates to window coordinates.
- *
- * @param {Object} [viewport = { x : 0.0, y : 0.0, width : 0.0, height : 0.0 }] The viewport's corners as shown in Example 1.
- * @param {Number} [nearDepthRange=0.0] The near plane distance in window coordinates.
- * @param {Number} [farDepthRange=1.0] The far plane distance in window coordinates.
- * @param {Matrix4} [result] The object in which the result will be stored.
- * @returns {Matrix4} The modified result parameter.
- *
- * @example
- * // Create viewport transformation using an explicit viewport and depth range.
- * var m = Cesium.Matrix4.computeViewportTransformation({
- * x : 0.0,
- * y : 0.0,
- * width : 1024.0,
- * height : 768.0
- * }, 0.0, 1.0, new Cesium.Matrix4());
- */
- Matrix4.computeViewportTransformation = function (
- viewport,
- nearDepthRange,
- farDepthRange,
- result
- ) {
- if (!when.defined(result)) {
- result = new Matrix4();
- }
- viewport = when.defaultValue(viewport, when.defaultValue.EMPTY_OBJECT);
- var x = when.defaultValue(viewport.x, 0.0);
- var y = when.defaultValue(viewport.y, 0.0);
- var width = when.defaultValue(viewport.width, 0.0);
- var height = when.defaultValue(viewport.height, 0.0);
- nearDepthRange = when.defaultValue(nearDepthRange, 0.0);
- farDepthRange = when.defaultValue(farDepthRange, 1.0);
- var halfWidth = width * 0.5;
- var halfHeight = height * 0.5;
- var halfDepth = (farDepthRange - nearDepthRange) * 0.5;
- var column0Row0 = halfWidth;
- var column1Row1 = halfHeight;
- var column2Row2 = halfDepth;
- var column3Row0 = x + halfWidth;
- var column3Row1 = y + halfHeight;
- var column3Row2 = nearDepthRange + halfDepth;
- var column3Row3 = 1.0;
- result[0] = column0Row0;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = 0.0;
- result[5] = column1Row1;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = 0.0;
- result[9] = 0.0;
- result[10] = column2Row2;
- result[11] = 0.0;
- result[12] = column3Row0;
- result[13] = column3Row1;
- result[14] = column3Row2;
- result[15] = column3Row3;
- return result;
- };
- /**
- * Computes a Matrix4 instance that transforms from world space to view space.
- *
- * @param {Cartesian3} position The position of the camera.
- * @param {Cartesian3} direction The forward direction.
- * @param {Cartesian3} up The up direction.
- * @param {Cartesian3} right The right direction.
- * @param {Matrix4} result The object in which the result will be stored.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.computeView = function (position, direction, up, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("position", position);
- Check.Check.typeOf.object("direction", direction);
- Check.Check.typeOf.object("up", up);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = right.x;
- result[1] = up.x;
- result[2] = -direction.x;
- result[3] = 0.0;
- result[4] = right.y;
- result[5] = up.y;
- result[6] = -direction.y;
- result[7] = 0.0;
- result[8] = right.z;
- result[9] = up.z;
- result[10] = -direction.z;
- result[11] = 0.0;
- result[12] = -Cartesian2.Cartesian3.dot(right, position);
- result[13] = -Cartesian2.Cartesian3.dot(up, position);
- result[14] = Cartesian2.Cartesian3.dot(direction, position);
- result[15] = 1.0;
- return result;
- };
- /**
- * Computes an Array from the provided Matrix4 instance.
- * The array will be in column-major order.
- *
- * @param {Matrix4} matrix The matrix to use..
- * @param {Number[]} [result] The Array onto which to store the result.
- * @returns {Number[]} The modified Array parameter or a new Array instance if one was not provided.
- *
- * @example
- * //create an array from an instance of Matrix4
- * // m = [10.0, 14.0, 18.0, 22.0]
- * // [11.0, 15.0, 19.0, 23.0]
- * // [12.0, 16.0, 20.0, 24.0]
- * // [13.0, 17.0, 21.0, 25.0]
- * var a = Cesium.Matrix4.toArray(m);
- *
- * // m remains the same
- * //creates a = [10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0, 17.0, 18.0, 19.0, 20.0, 21.0, 22.0, 23.0, 24.0, 25.0]
- */
- Matrix4.toArray = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- return [
- matrix[0],
- matrix[1],
- matrix[2],
- matrix[3],
- matrix[4],
- matrix[5],
- matrix[6],
- matrix[7],
- matrix[8],
- matrix[9],
- matrix[10],
- matrix[11],
- matrix[12],
- matrix[13],
- matrix[14],
- matrix[15],
- ];
- }
- result[0] = matrix[0];
- result[1] = matrix[1];
- result[2] = matrix[2];
- result[3] = matrix[3];
- result[4] = matrix[4];
- result[5] = matrix[5];
- result[6] = matrix[6];
- result[7] = matrix[7];
- result[8] = matrix[8];
- result[9] = matrix[9];
- result[10] = matrix[10];
- result[11] = matrix[11];
- result[12] = matrix[12];
- result[13] = matrix[13];
- result[14] = matrix[14];
- result[15] = matrix[15];
- return result;
- };
- /**
- * Computes the array index of the element at the provided row and column.
- *
- * @param {Number} row The zero-based index of the row.
- * @param {Number} column The zero-based index of the column.
- * @returns {Number} The index of the element at the provided row and column.
- *
- * @exception {DeveloperError} row must be 0, 1, 2, or 3.
- * @exception {DeveloperError} column must be 0, 1, 2, or 3.
- *
- * @example
- * var myMatrix = new Cesium.Matrix4();
- * var column1Row0Index = Cesium.Matrix4.getElementIndex(1, 0);
- * var column1Row0 = myMatrix[column1Row0Index];
- * myMatrix[column1Row0Index] = 10.0;
- */
- Matrix4.getElementIndex = function (column, row) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number.greaterThanOrEquals("row", row, 0);
- Check.Check.typeOf.number.lessThanOrEquals("row", row, 3);
- Check.Check.typeOf.number.greaterThanOrEquals("column", column, 0);
- Check.Check.typeOf.number.lessThanOrEquals("column", column, 3);
- //>>includeEnd('debug');
- return column * 4 + row;
- };
- /**
- * Retrieves a copy of the matrix column at the provided index as a Cartesian4 instance.
- *
- * @param {Matrix4} matrix The matrix to use.
- * @param {Number} index The zero-based index of the column to retrieve.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- *
- * @exception {DeveloperError} index must be 0, 1, 2, or 3.
- *
- * @example
- * //returns a Cartesian4 instance with values from the specified column
- * // m = [10.0, 11.0, 12.0, 13.0]
- * // [14.0, 15.0, 16.0, 17.0]
- * // [18.0, 19.0, 20.0, 21.0]
- * // [22.0, 23.0, 24.0, 25.0]
- *
- * //Example 1: Creates an instance of Cartesian
- * var a = Cesium.Matrix4.getColumn(m, 2, new Cesium.Cartesian4());
- *
- * @example
- * //Example 2: Sets values for Cartesian instance
- * var a = new Cesium.Cartesian4();
- * Cesium.Matrix4.getColumn(m, 2, a);
- *
- * // a.x = 12.0; a.y = 16.0; a.z = 20.0; a.w = 24.0;
- */
- Matrix4.getColumn = function (matrix, index, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number.greaterThanOrEquals("index", index, 0);
- Check.Check.typeOf.number.lessThanOrEquals("index", index, 3);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var startIndex = index * 4;
- var x = matrix[startIndex];
- var y = matrix[startIndex + 1];
- var z = matrix[startIndex + 2];
- var w = matrix[startIndex + 3];
- result.x = x;
- result.y = y;
- result.z = z;
- result.w = w;
- return result;
- };
- /**
- * Computes a new matrix that replaces the specified column in the provided matrix with the provided Cartesian4 instance.
- *
- * @param {Matrix4} matrix The matrix to use.
- * @param {Number} index The zero-based index of the column to set.
- * @param {Cartesian4} cartesian The Cartesian whose values will be assigned to the specified column.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @exception {DeveloperError} index must be 0, 1, 2, or 3.
- *
- * @example
- * //creates a new Matrix4 instance with new column values from the Cartesian4 instance
- * // m = [10.0, 11.0, 12.0, 13.0]
- * // [14.0, 15.0, 16.0, 17.0]
- * // [18.0, 19.0, 20.0, 21.0]
- * // [22.0, 23.0, 24.0, 25.0]
- *
- * var a = Cesium.Matrix4.setColumn(m, 2, new Cesium.Cartesian4(99.0, 98.0, 97.0, 96.0), new Cesium.Matrix4());
- *
- * // m remains the same
- * // a = [10.0, 11.0, 99.0, 13.0]
- * // [14.0, 15.0, 98.0, 17.0]
- * // [18.0, 19.0, 97.0, 21.0]
- * // [22.0, 23.0, 96.0, 25.0]
- */
- Matrix4.setColumn = function (matrix, index, cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number.greaterThanOrEquals("index", index, 0);
- Check.Check.typeOf.number.lessThanOrEquals("index", index, 3);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result = Matrix4.clone(matrix, result);
- var startIndex = index * 4;
- result[startIndex] = cartesian.x;
- result[startIndex + 1] = cartesian.y;
- result[startIndex + 2] = cartesian.z;
- result[startIndex + 3] = cartesian.w;
- return result;
- };
- /**
- * Computes a new matrix that replaces the translation in the rightmost column of the provided
- * matrix with the provided translation. This assumes the matrix is an affine transformation
- *
- * @param {Matrix4} matrix The matrix to use.
- * @param {Cartesian3} translation The translation that replaces the translation of the provided matrix.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.setTranslation = function (matrix, translation, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("translation", translation);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = matrix[0];
- result[1] = matrix[1];
- result[2] = matrix[2];
- result[3] = matrix[3];
- result[4] = matrix[4];
- result[5] = matrix[5];
- result[6] = matrix[6];
- result[7] = matrix[7];
- result[8] = matrix[8];
- result[9] = matrix[9];
- result[10] = matrix[10];
- result[11] = matrix[11];
- result[12] = translation.x;
- result[13] = translation.y;
- result[14] = translation.z;
- result[15] = matrix[15];
- return result;
- };
- var scaleScratch = new Cartesian2.Cartesian3();
- /**
- * Computes a new matrix that replaces the scale with the provided scale. This assumes the matrix is an affine transformation
- *
- * @param {Matrix4} matrix The matrix to use.
- * @param {Cartesian3} scale The scale that replaces the scale of the provided matrix.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.setScale = function (matrix, scale, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("scale", scale);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var existingScale = Matrix4.getScale(matrix, scaleScratch);
- var newScale = Cartesian2.Cartesian3.divideComponents(
- scale,
- existingScale,
- scaleScratch
- );
- return Matrix4.multiplyByScale(matrix, newScale, result);
- };
- /**
- * Retrieves a copy of the matrix row at the provided index as a Cartesian4 instance.
- *
- * @param {Matrix4} matrix The matrix to use.
- * @param {Number} index The zero-based index of the row to retrieve.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- *
- * @exception {DeveloperError} index must be 0, 1, 2, or 3.
- *
- * @example
- * //returns a Cartesian4 instance with values from the specified column
- * // m = [10.0, 11.0, 12.0, 13.0]
- * // [14.0, 15.0, 16.0, 17.0]
- * // [18.0, 19.0, 20.0, 21.0]
- * // [22.0, 23.0, 24.0, 25.0]
- *
- * //Example 1: Returns an instance of Cartesian
- * var a = Cesium.Matrix4.getRow(m, 2, new Cesium.Cartesian4());
- *
- * @example
- * //Example 2: Sets values for a Cartesian instance
- * var a = new Cesium.Cartesian4();
- * Cesium.Matrix4.getRow(m, 2, a);
- *
- * // a.x = 18.0; a.y = 19.0; a.z = 20.0; a.w = 21.0;
- */
- Matrix4.getRow = function (matrix, index, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number.greaterThanOrEquals("index", index, 0);
- Check.Check.typeOf.number.lessThanOrEquals("index", index, 3);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var x = matrix[index];
- var y = matrix[index + 4];
- var z = matrix[index + 8];
- var w = matrix[index + 12];
- result.x = x;
- result.y = y;
- result.z = z;
- result.w = w;
- return result;
- };
- /**
- * Computes a new matrix that replaces the specified row in the provided matrix with the provided Cartesian4 instance.
- *
- * @param {Matrix4} matrix The matrix to use.
- * @param {Number} index The zero-based index of the row to set.
- * @param {Cartesian4} cartesian The Cartesian whose values will be assigned to the specified row.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @exception {DeveloperError} index must be 0, 1, 2, or 3.
- *
- * @example
- * //create a new Matrix4 instance with new row values from the Cartesian4 instance
- * // m = [10.0, 11.0, 12.0, 13.0]
- * // [14.0, 15.0, 16.0, 17.0]
- * // [18.0, 19.0, 20.0, 21.0]
- * // [22.0, 23.0, 24.0, 25.0]
- *
- * var a = Cesium.Matrix4.setRow(m, 2, new Cesium.Cartesian4(99.0, 98.0, 97.0, 96.0), new Cesium.Matrix4());
- *
- * // m remains the same
- * // a = [10.0, 11.0, 12.0, 13.0]
- * // [14.0, 15.0, 16.0, 17.0]
- * // [99.0, 98.0, 97.0, 96.0]
- * // [22.0, 23.0, 24.0, 25.0]
- */
- Matrix4.setRow = function (matrix, index, cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number.greaterThanOrEquals("index", index, 0);
- Check.Check.typeOf.number.lessThanOrEquals("index", index, 3);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result = Matrix4.clone(matrix, result);
- result[index] = cartesian.x;
- result[index + 4] = cartesian.y;
- result[index + 8] = cartesian.z;
- result[index + 12] = cartesian.w;
- return result;
- };
- var scratchColumn$1 = new Cartesian2.Cartesian3();
- /**
- * Extracts the non-uniform scale assuming the matrix is an affine transformation.
- *
- * @param {Matrix4} matrix The matrix.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter
- */
- Matrix4.getScale = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.fromElements(matrix[0], matrix[1], matrix[2], scratchColumn$1)
- );
- result.y = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.fromElements(matrix[4], matrix[5], matrix[6], scratchColumn$1)
- );
- result.z = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.fromElements(matrix[8], matrix[9], matrix[10], scratchColumn$1)
- );
- return result;
- };
- var scratchScale$1 = new Cartesian2.Cartesian3();
- /**
- * Computes the maximum scale assuming the matrix is an affine transformation.
- * The maximum scale is the maximum length of the column vectors in the upper-left
- * 3x3 matrix.
- *
- * @param {Matrix4} matrix The matrix.
- * @returns {Number} The maximum scale.
- */
- Matrix4.getMaximumScale = function (matrix) {
- Matrix4.getScale(matrix, scratchScale$1);
- return Cartesian2.Cartesian3.maximumComponent(scratchScale$1);
- };
- /**
- * Computes the product of two matrices.
- *
- * @param {Matrix4} left The first matrix.
- * @param {Matrix4} right The second matrix.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.multiply = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var left0 = left[0];
- var left1 = left[1];
- var left2 = left[2];
- var left3 = left[3];
- var left4 = left[4];
- var left5 = left[5];
- var left6 = left[6];
- var left7 = left[7];
- var left8 = left[8];
- var left9 = left[9];
- var left10 = left[10];
- var left11 = left[11];
- var left12 = left[12];
- var left13 = left[13];
- var left14 = left[14];
- var left15 = left[15];
- var right0 = right[0];
- var right1 = right[1];
- var right2 = right[2];
- var right3 = right[3];
- var right4 = right[4];
- var right5 = right[5];
- var right6 = right[6];
- var right7 = right[7];
- var right8 = right[8];
- var right9 = right[9];
- var right10 = right[10];
- var right11 = right[11];
- var right12 = right[12];
- var right13 = right[13];
- var right14 = right[14];
- var right15 = right[15];
- var column0Row0 =
- left0 * right0 + left4 * right1 + left8 * right2 + left12 * right3;
- var column0Row1 =
- left1 * right0 + left5 * right1 + left9 * right2 + left13 * right3;
- var column0Row2 =
- left2 * right0 + left6 * right1 + left10 * right2 + left14 * right3;
- var column0Row3 =
- left3 * right0 + left7 * right1 + left11 * right2 + left15 * right3;
- var column1Row0 =
- left0 * right4 + left4 * right5 + left8 * right6 + left12 * right7;
- var column1Row1 =
- left1 * right4 + left5 * right5 + left9 * right6 + left13 * right7;
- var column1Row2 =
- left2 * right4 + left6 * right5 + left10 * right6 + left14 * right7;
- var column1Row3 =
- left3 * right4 + left7 * right5 + left11 * right6 + left15 * right7;
- var column2Row0 =
- left0 * right8 + left4 * right9 + left8 * right10 + left12 * right11;
- var column2Row1 =
- left1 * right8 + left5 * right9 + left9 * right10 + left13 * right11;
- var column2Row2 =
- left2 * right8 + left6 * right9 + left10 * right10 + left14 * right11;
- var column2Row3 =
- left3 * right8 + left7 * right9 + left11 * right10 + left15 * right11;
- var column3Row0 =
- left0 * right12 + left4 * right13 + left8 * right14 + left12 * right15;
- var column3Row1 =
- left1 * right12 + left5 * right13 + left9 * right14 + left13 * right15;
- var column3Row2 =
- left2 * right12 + left6 * right13 + left10 * right14 + left14 * right15;
- var column3Row3 =
- left3 * right12 + left7 * right13 + left11 * right14 + left15 * right15;
- result[0] = column0Row0;
- result[1] = column0Row1;
- result[2] = column0Row2;
- result[3] = column0Row3;
- result[4] = column1Row0;
- result[5] = column1Row1;
- result[6] = column1Row2;
- result[7] = column1Row3;
- result[8] = column2Row0;
- result[9] = column2Row1;
- result[10] = column2Row2;
- result[11] = column2Row3;
- result[12] = column3Row0;
- result[13] = column3Row1;
- result[14] = column3Row2;
- result[15] = column3Row3;
- return result;
- };
- /**
- * Computes the sum of two matrices.
- *
- * @param {Matrix4} left The first matrix.
- * @param {Matrix4} right The second matrix.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.add = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = left[0] + right[0];
- result[1] = left[1] + right[1];
- result[2] = left[2] + right[2];
- result[3] = left[3] + right[3];
- result[4] = left[4] + right[4];
- result[5] = left[5] + right[5];
- result[6] = left[6] + right[6];
- result[7] = left[7] + right[7];
- result[8] = left[8] + right[8];
- result[9] = left[9] + right[9];
- result[10] = left[10] + right[10];
- result[11] = left[11] + right[11];
- result[12] = left[12] + right[12];
- result[13] = left[13] + right[13];
- result[14] = left[14] + right[14];
- result[15] = left[15] + right[15];
- return result;
- };
- /**
- * Computes the difference of two matrices.
- *
- * @param {Matrix4} left The first matrix.
- * @param {Matrix4} right The second matrix.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.subtract = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = left[0] - right[0];
- result[1] = left[1] - right[1];
- result[2] = left[2] - right[2];
- result[3] = left[3] - right[3];
- result[4] = left[4] - right[4];
- result[5] = left[5] - right[5];
- result[6] = left[6] - right[6];
- result[7] = left[7] - right[7];
- result[8] = left[8] - right[8];
- result[9] = left[9] - right[9];
- result[10] = left[10] - right[10];
- result[11] = left[11] - right[11];
- result[12] = left[12] - right[12];
- result[13] = left[13] - right[13];
- result[14] = left[14] - right[14];
- result[15] = left[15] - right[15];
- return result;
- };
- /**
- * Computes the product of two matrices assuming the matrices are
- * affine transformation matrices, where the upper left 3x3 elements
- * are a rotation matrix, and the upper three elements in the fourth
- * column are the translation. The bottom row is assumed to be [0, 0, 0, 1].
- * The matrix is not verified to be in the proper form.
- * This method is faster than computing the product for general 4x4
- * matrices using {@link Matrix4.multiply}.
- *
- * @param {Matrix4} left The first matrix.
- * @param {Matrix4} right The second matrix.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @example
- * var m1 = new Cesium.Matrix4(1.0, 6.0, 7.0, 0.0, 2.0, 5.0, 8.0, 0.0, 3.0, 4.0, 9.0, 0.0, 0.0, 0.0, 0.0, 1.0);
- * var m2 = Cesium.Transforms.eastNorthUpToFixedFrame(new Cesium.Cartesian3(1.0, 1.0, 1.0));
- * var m3 = Cesium.Matrix4.multiplyTransformation(m1, m2, new Cesium.Matrix4());
- */
- Matrix4.multiplyTransformation = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var left0 = left[0];
- var left1 = left[1];
- var left2 = left[2];
- var left4 = left[4];
- var left5 = left[5];
- var left6 = left[6];
- var left8 = left[8];
- var left9 = left[9];
- var left10 = left[10];
- var left12 = left[12];
- var left13 = left[13];
- var left14 = left[14];
- var right0 = right[0];
- var right1 = right[1];
- var right2 = right[2];
- var right4 = right[4];
- var right5 = right[5];
- var right6 = right[6];
- var right8 = right[8];
- var right9 = right[9];
- var right10 = right[10];
- var right12 = right[12];
- var right13 = right[13];
- var right14 = right[14];
- var column0Row0 = left0 * right0 + left4 * right1 + left8 * right2;
- var column0Row1 = left1 * right0 + left5 * right1 + left9 * right2;
- var column0Row2 = left2 * right0 + left6 * right1 + left10 * right2;
- var column1Row0 = left0 * right4 + left4 * right5 + left8 * right6;
- var column1Row1 = left1 * right4 + left5 * right5 + left9 * right6;
- var column1Row2 = left2 * right4 + left6 * right5 + left10 * right6;
- var column2Row0 = left0 * right8 + left4 * right9 + left8 * right10;
- var column2Row1 = left1 * right8 + left5 * right9 + left9 * right10;
- var column2Row2 = left2 * right8 + left6 * right9 + left10 * right10;
- var column3Row0 =
- left0 * right12 + left4 * right13 + left8 * right14 + left12;
- var column3Row1 =
- left1 * right12 + left5 * right13 + left9 * right14 + left13;
- var column3Row2 =
- left2 * right12 + left6 * right13 + left10 * right14 + left14;
- result[0] = column0Row0;
- result[1] = column0Row1;
- result[2] = column0Row2;
- result[3] = 0.0;
- result[4] = column1Row0;
- result[5] = column1Row1;
- result[6] = column1Row2;
- result[7] = 0.0;
- result[8] = column2Row0;
- result[9] = column2Row1;
- result[10] = column2Row2;
- result[11] = 0.0;
- result[12] = column3Row0;
- result[13] = column3Row1;
- result[14] = column3Row2;
- result[15] = 1.0;
- return result;
- };
- /**
- * Multiplies a transformation matrix (with a bottom row of <code>[0.0, 0.0, 0.0, 1.0]</code>)
- * by a 3x3 rotation matrix. This is an optimization
- * for <code>Matrix4.multiply(m, Matrix4.fromRotationTranslation(rotation), m);</code> with less allocations and arithmetic operations.
- *
- * @param {Matrix4} matrix The matrix on the left-hand side.
- * @param {Matrix3} rotation The 3x3 rotation matrix on the right-hand side.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @example
- * // Instead of Cesium.Matrix4.multiply(m, Cesium.Matrix4.fromRotationTranslation(rotation), m);
- * Cesium.Matrix4.multiplyByMatrix3(m, rotation, m);
- */
- Matrix4.multiplyByMatrix3 = function (matrix, rotation, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("rotation", rotation);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var left0 = matrix[0];
- var left1 = matrix[1];
- var left2 = matrix[2];
- var left4 = matrix[4];
- var left5 = matrix[5];
- var left6 = matrix[6];
- var left8 = matrix[8];
- var left9 = matrix[9];
- var left10 = matrix[10];
- var right0 = rotation[0];
- var right1 = rotation[1];
- var right2 = rotation[2];
- var right4 = rotation[3];
- var right5 = rotation[4];
- var right6 = rotation[5];
- var right8 = rotation[6];
- var right9 = rotation[7];
- var right10 = rotation[8];
- var column0Row0 = left0 * right0 + left4 * right1 + left8 * right2;
- var column0Row1 = left1 * right0 + left5 * right1 + left9 * right2;
- var column0Row2 = left2 * right0 + left6 * right1 + left10 * right2;
- var column1Row0 = left0 * right4 + left4 * right5 + left8 * right6;
- var column1Row1 = left1 * right4 + left5 * right5 + left9 * right6;
- var column1Row2 = left2 * right4 + left6 * right5 + left10 * right6;
- var column2Row0 = left0 * right8 + left4 * right9 + left8 * right10;
- var column2Row1 = left1 * right8 + left5 * right9 + left9 * right10;
- var column2Row2 = left2 * right8 + left6 * right9 + left10 * right10;
- result[0] = column0Row0;
- result[1] = column0Row1;
- result[2] = column0Row2;
- result[3] = 0.0;
- result[4] = column1Row0;
- result[5] = column1Row1;
- result[6] = column1Row2;
- result[7] = 0.0;
- result[8] = column2Row0;
- result[9] = column2Row1;
- result[10] = column2Row2;
- result[11] = 0.0;
- result[12] = matrix[12];
- result[13] = matrix[13];
- result[14] = matrix[14];
- result[15] = matrix[15];
- return result;
- };
- /**
- * Multiplies a transformation matrix (with a bottom row of <code>[0.0, 0.0, 0.0, 1.0]</code>)
- * by an implicit translation matrix defined by a {@link Cartesian3}. This is an optimization
- * for <code>Matrix4.multiply(m, Matrix4.fromTranslation(position), m);</code> with less allocations and arithmetic operations.
- *
- * @param {Matrix4} matrix The matrix on the left-hand side.
- * @param {Cartesian3} translation The translation on the right-hand side.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @example
- * // Instead of Cesium.Matrix4.multiply(m, Cesium.Matrix4.fromTranslation(position), m);
- * Cesium.Matrix4.multiplyByTranslation(m, position, m);
- */
- Matrix4.multiplyByTranslation = function (matrix, translation, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("translation", translation);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var x = translation.x;
- var y = translation.y;
- var z = translation.z;
- var tx = x * matrix[0] + y * matrix[4] + z * matrix[8] + matrix[12];
- var ty = x * matrix[1] + y * matrix[5] + z * matrix[9] + matrix[13];
- var tz = x * matrix[2] + y * matrix[6] + z * matrix[10] + matrix[14];
- result[0] = matrix[0];
- result[1] = matrix[1];
- result[2] = matrix[2];
- result[3] = matrix[3];
- result[4] = matrix[4];
- result[5] = matrix[5];
- result[6] = matrix[6];
- result[7] = matrix[7];
- result[8] = matrix[8];
- result[9] = matrix[9];
- result[10] = matrix[10];
- result[11] = matrix[11];
- result[12] = tx;
- result[13] = ty;
- result[14] = tz;
- result[15] = matrix[15];
- return result;
- };
- var uniformScaleScratch = new Cartesian2.Cartesian3();
- /**
- * Multiplies an affine transformation matrix (with a bottom row of <code>[0.0, 0.0, 0.0, 1.0]</code>)
- * by an implicit uniform scale matrix. This is an optimization
- * for <code>Matrix4.multiply(m, Matrix4.fromUniformScale(scale), m);</code>, where
- * <code>m</code> must be an affine matrix.
- * This function performs fewer allocations and arithmetic operations.
- *
- * @param {Matrix4} matrix The affine matrix on the left-hand side.
- * @param {Number} scale The uniform scale on the right-hand side.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- *
- * @example
- * // Instead of Cesium.Matrix4.multiply(m, Cesium.Matrix4.fromUniformScale(scale), m);
- * Cesium.Matrix4.multiplyByUniformScale(m, scale, m);
- *
- * @see Matrix4.fromUniformScale
- * @see Matrix4.multiplyByScale
- */
- Matrix4.multiplyByUniformScale = function (matrix, scale, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number("scale", scale);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- uniformScaleScratch.x = scale;
- uniformScaleScratch.y = scale;
- uniformScaleScratch.z = scale;
- return Matrix4.multiplyByScale(matrix, uniformScaleScratch, result);
- };
- /**
- * Multiplies an affine transformation matrix (with a bottom row of <code>[0.0, 0.0, 0.0, 1.0]</code>)
- * by an implicit non-uniform scale matrix. This is an optimization
- * for <code>Matrix4.multiply(m, Matrix4.fromUniformScale(scale), m);</code>, where
- * <code>m</code> must be an affine matrix.
- * This function performs fewer allocations and arithmetic operations.
- *
- * @param {Matrix4} matrix The affine matrix on the left-hand side.
- * @param {Cartesian3} scale The non-uniform scale on the right-hand side.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- *
- * @example
- * // Instead of Cesium.Matrix4.multiply(m, Cesium.Matrix4.fromScale(scale), m);
- * Cesium.Matrix4.multiplyByScale(m, scale, m);
- *
- * @see Matrix4.fromScale
- * @see Matrix4.multiplyByUniformScale
- */
- Matrix4.multiplyByScale = function (matrix, scale, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("scale", scale);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var scaleX = scale.x;
- var scaleY = scale.y;
- var scaleZ = scale.z;
- // Faster than Cartesian3.equals
- if (scaleX === 1.0 && scaleY === 1.0 && scaleZ === 1.0) {
- return Matrix4.clone(matrix, result);
- }
- result[0] = scaleX * matrix[0];
- result[1] = scaleX * matrix[1];
- result[2] = scaleX * matrix[2];
- result[3] = 0.0;
- result[4] = scaleY * matrix[4];
- result[5] = scaleY * matrix[5];
- result[6] = scaleY * matrix[6];
- result[7] = 0.0;
- result[8] = scaleZ * matrix[8];
- result[9] = scaleZ * matrix[9];
- result[10] = scaleZ * matrix[10];
- result[11] = 0.0;
- result[12] = matrix[12];
- result[13] = matrix[13];
- result[14] = matrix[14];
- result[15] = 1.0;
- return result;
- };
- /**
- * Computes the product of a matrix and a column vector.
- *
- * @param {Matrix4} matrix The matrix.
- * @param {Cartesian4} cartesian The vector.
- * @param {Cartesian4} result The object onto which to store the result.
- * @returns {Cartesian4} The modified result parameter.
- */
- Matrix4.multiplyByVector = function (matrix, cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var vX = cartesian.x;
- var vY = cartesian.y;
- var vZ = cartesian.z;
- var vW = cartesian.w;
- var x = matrix[0] * vX + matrix[4] * vY + matrix[8] * vZ + matrix[12] * vW;
- var y = matrix[1] * vX + matrix[5] * vY + matrix[9] * vZ + matrix[13] * vW;
- var z = matrix[2] * vX + matrix[6] * vY + matrix[10] * vZ + matrix[14] * vW;
- var w = matrix[3] * vX + matrix[7] * vY + matrix[11] * vZ + matrix[15] * vW;
- result.x = x;
- result.y = y;
- result.z = z;
- result.w = w;
- return result;
- };
- /**
- * Computes the product of a matrix and a {@link Cartesian3}. This is equivalent to calling {@link Matrix4.multiplyByVector}
- * with a {@link Cartesian4} with a <code>w</code> component of zero.
- *
- * @param {Matrix4} matrix The matrix.
- * @param {Cartesian3} cartesian The point.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- *
- * @example
- * var p = new Cesium.Cartesian3(1.0, 2.0, 3.0);
- * var result = Cesium.Matrix4.multiplyByPointAsVector(matrix, p, new Cesium.Cartesian3());
- * // A shortcut for
- * // Cartesian3 p = ...
- * // Cesium.Matrix4.multiplyByVector(matrix, new Cesium.Cartesian4(p.x, p.y, p.z, 0.0), result);
- */
- Matrix4.multiplyByPointAsVector = function (matrix, cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var vX = cartesian.x;
- var vY = cartesian.y;
- var vZ = cartesian.z;
- var x = matrix[0] * vX + matrix[4] * vY + matrix[8] * vZ;
- var y = matrix[1] * vX + matrix[5] * vY + matrix[9] * vZ;
- var z = matrix[2] * vX + matrix[6] * vY + matrix[10] * vZ;
- result.x = x;
- result.y = y;
- result.z = z;
- return result;
- };
- /**
- * Computes the product of a matrix and a {@link Cartesian3}. This is equivalent to calling {@link Matrix4.multiplyByVector}
- * with a {@link Cartesian4} with a <code>w</code> component of 1, but returns a {@link Cartesian3} instead of a {@link Cartesian4}.
- *
- * @param {Matrix4} matrix The matrix.
- * @param {Cartesian3} cartesian The point.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- *
- * @example
- * var p = new Cesium.Cartesian3(1.0, 2.0, 3.0);
- * var result = Cesium.Matrix4.multiplyByPoint(matrix, p, new Cesium.Cartesian3());
- */
- Matrix4.multiplyByPoint = function (matrix, cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var vX = cartesian.x;
- var vY = cartesian.y;
- var vZ = cartesian.z;
- var x = matrix[0] * vX + matrix[4] * vY + matrix[8] * vZ + matrix[12];
- var y = matrix[1] * vX + matrix[5] * vY + matrix[9] * vZ + matrix[13];
- var z = matrix[2] * vX + matrix[6] * vY + matrix[10] * vZ + matrix[14];
- result.x = x;
- result.y = y;
- result.z = z;
- return result;
- };
- /**
- * Computes the product of a matrix and a scalar.
- *
- * @param {Matrix4} matrix The matrix.
- * @param {Number} scalar The number to multiply by.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @example
- * //create a Matrix4 instance which is a scaled version of the supplied Matrix4
- * // m = [10.0, 11.0, 12.0, 13.0]
- * // [14.0, 15.0, 16.0, 17.0]
- * // [18.0, 19.0, 20.0, 21.0]
- * // [22.0, 23.0, 24.0, 25.0]
- *
- * var a = Cesium.Matrix4.multiplyByScalar(m, -2, new Cesium.Matrix4());
- *
- * // m remains the same
- * // a = [-20.0, -22.0, -24.0, -26.0]
- * // [-28.0, -30.0, -32.0, -34.0]
- * // [-36.0, -38.0, -40.0, -42.0]
- * // [-44.0, -46.0, -48.0, -50.0]
- */
- Matrix4.multiplyByScalar = function (matrix, scalar, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.number("scalar", scalar);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = matrix[0] * scalar;
- result[1] = matrix[1] * scalar;
- result[2] = matrix[2] * scalar;
- result[3] = matrix[3] * scalar;
- result[4] = matrix[4] * scalar;
- result[5] = matrix[5] * scalar;
- result[6] = matrix[6] * scalar;
- result[7] = matrix[7] * scalar;
- result[8] = matrix[8] * scalar;
- result[9] = matrix[9] * scalar;
- result[10] = matrix[10] * scalar;
- result[11] = matrix[11] * scalar;
- result[12] = matrix[12] * scalar;
- result[13] = matrix[13] * scalar;
- result[14] = matrix[14] * scalar;
- result[15] = matrix[15] * scalar;
- return result;
- };
- /**
- * Computes a negated copy of the provided matrix.
- *
- * @param {Matrix4} matrix The matrix to negate.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @example
- * //create a new Matrix4 instance which is a negation of a Matrix4
- * // m = [10.0, 11.0, 12.0, 13.0]
- * // [14.0, 15.0, 16.0, 17.0]
- * // [18.0, 19.0, 20.0, 21.0]
- * // [22.0, 23.0, 24.0, 25.0]
- *
- * var a = Cesium.Matrix4.negate(m, new Cesium.Matrix4());
- *
- * // m remains the same
- * // a = [-10.0, -11.0, -12.0, -13.0]
- * // [-14.0, -15.0, -16.0, -17.0]
- * // [-18.0, -19.0, -20.0, -21.0]
- * // [-22.0, -23.0, -24.0, -25.0]
- */
- Matrix4.negate = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = -matrix[0];
- result[1] = -matrix[1];
- result[2] = -matrix[2];
- result[3] = -matrix[3];
- result[4] = -matrix[4];
- result[5] = -matrix[5];
- result[6] = -matrix[6];
- result[7] = -matrix[7];
- result[8] = -matrix[8];
- result[9] = -matrix[9];
- result[10] = -matrix[10];
- result[11] = -matrix[11];
- result[12] = -matrix[12];
- result[13] = -matrix[13];
- result[14] = -matrix[14];
- result[15] = -matrix[15];
- return result;
- };
- /**
- * Computes the transpose of the provided matrix.
- *
- * @param {Matrix4} matrix The matrix to transpose.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @example
- * //returns transpose of a Matrix4
- * // m = [10.0, 11.0, 12.0, 13.0]
- * // [14.0, 15.0, 16.0, 17.0]
- * // [18.0, 19.0, 20.0, 21.0]
- * // [22.0, 23.0, 24.0, 25.0]
- *
- * var a = Cesium.Matrix4.transpose(m, new Cesium.Matrix4());
- *
- * // m remains the same
- * // a = [10.0, 14.0, 18.0, 22.0]
- * // [11.0, 15.0, 19.0, 23.0]
- * // [12.0, 16.0, 20.0, 24.0]
- * // [13.0, 17.0, 21.0, 25.0]
- */
- Matrix4.transpose = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var matrix1 = matrix[1];
- var matrix2 = matrix[2];
- var matrix3 = matrix[3];
- var matrix6 = matrix[6];
- var matrix7 = matrix[7];
- var matrix11 = matrix[11];
- result[0] = matrix[0];
- result[1] = matrix[4];
- result[2] = matrix[8];
- result[3] = matrix[12];
- result[4] = matrix1;
- result[5] = matrix[5];
- result[6] = matrix[9];
- result[7] = matrix[13];
- result[8] = matrix2;
- result[9] = matrix6;
- result[10] = matrix[10];
- result[11] = matrix[14];
- result[12] = matrix3;
- result[13] = matrix7;
- result[14] = matrix11;
- result[15] = matrix[15];
- return result;
- };
- /**
- * Computes a matrix, which contains the absolute (unsigned) values of the provided matrix's elements.
- *
- * @param {Matrix4} matrix The matrix with signed elements.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.abs = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = Math.abs(matrix[0]);
- result[1] = Math.abs(matrix[1]);
- result[2] = Math.abs(matrix[2]);
- result[3] = Math.abs(matrix[3]);
- result[4] = Math.abs(matrix[4]);
- result[5] = Math.abs(matrix[5]);
- result[6] = Math.abs(matrix[6]);
- result[7] = Math.abs(matrix[7]);
- result[8] = Math.abs(matrix[8]);
- result[9] = Math.abs(matrix[9]);
- result[10] = Math.abs(matrix[10]);
- result[11] = Math.abs(matrix[11]);
- result[12] = Math.abs(matrix[12]);
- result[13] = Math.abs(matrix[13]);
- result[14] = Math.abs(matrix[14]);
- result[15] = Math.abs(matrix[15]);
- return result;
- };
- /**
- * Compares the provided matrices componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {Matrix4} [left] The first matrix.
- * @param {Matrix4} [right] The second matrix.
- * @returns {Boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- *
- * @example
- * //compares two Matrix4 instances
- *
- * // a = [10.0, 14.0, 18.0, 22.0]
- * // [11.0, 15.0, 19.0, 23.0]
- * // [12.0, 16.0, 20.0, 24.0]
- * // [13.0, 17.0, 21.0, 25.0]
- *
- * // b = [10.0, 14.0, 18.0, 22.0]
- * // [11.0, 15.0, 19.0, 23.0]
- * // [12.0, 16.0, 20.0, 24.0]
- * // [13.0, 17.0, 21.0, 25.0]
- *
- * if(Cesium.Matrix4.equals(a,b)) {
- * console.log("Both matrices are equal");
- * } else {
- * console.log("They are not equal");
- * }
- *
- * //Prints "Both matrices are equal" on the console
- */
- Matrix4.equals = function (left, right) {
- // Given that most matrices will be transformation matrices, the elements
- // are tested in order such that the test is likely to fail as early
- // as possible. I _think_ this is just as friendly to the L1 cache
- // as testing in index order. It is certainty faster in practice.
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- // Translation
- left[12] === right[12] &&
- left[13] === right[13] &&
- left[14] === right[14] &&
- // Rotation/scale
- left[0] === right[0] &&
- left[1] === right[1] &&
- left[2] === right[2] &&
- left[4] === right[4] &&
- left[5] === right[5] &&
- left[6] === right[6] &&
- left[8] === right[8] &&
- left[9] === right[9] &&
- left[10] === right[10] &&
- // Bottom row
- left[3] === right[3] &&
- left[7] === right[7] &&
- left[11] === right[11] &&
- left[15] === right[15])
- );
- };
- /**
- * Compares the provided matrices componentwise and returns
- * <code>true</code> if they are within the provided epsilon,
- * <code>false</code> otherwise.
- *
- * @param {Matrix4} [left] The first matrix.
- * @param {Matrix4} [right] The second matrix.
- * @param {Number} [epsilon=0] The epsilon to use for equality testing.
- * @returns {Boolean} <code>true</code> if left and right are within the provided epsilon, <code>false</code> otherwise.
- *
- * @example
- * //compares two Matrix4 instances
- *
- * // a = [10.5, 14.5, 18.5, 22.5]
- * // [11.5, 15.5, 19.5, 23.5]
- * // [12.5, 16.5, 20.5, 24.5]
- * // [13.5, 17.5, 21.5, 25.5]
- *
- * // b = [10.0, 14.0, 18.0, 22.0]
- * // [11.0, 15.0, 19.0, 23.0]
- * // [12.0, 16.0, 20.0, 24.0]
- * // [13.0, 17.0, 21.0, 25.0]
- *
- * if(Cesium.Matrix4.equalsEpsilon(a,b,0.1)){
- * console.log("Difference between both the matrices is less than 0.1");
- * } else {
- * console.log("Difference between both the matrices is not less than 0.1");
- * }
- *
- * //Prints "Difference between both the matrices is not less than 0.1" on the console
- */
- Matrix4.equalsEpsilon = function (left, right, epsilon) {
- epsilon = when.defaultValue(epsilon, 0);
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- Math.abs(left[0] - right[0]) <= epsilon &&
- Math.abs(left[1] - right[1]) <= epsilon &&
- Math.abs(left[2] - right[2]) <= epsilon &&
- Math.abs(left[3] - right[3]) <= epsilon &&
- Math.abs(left[4] - right[4]) <= epsilon &&
- Math.abs(left[5] - right[5]) <= epsilon &&
- Math.abs(left[6] - right[6]) <= epsilon &&
- Math.abs(left[7] - right[7]) <= epsilon &&
- Math.abs(left[8] - right[8]) <= epsilon &&
- Math.abs(left[9] - right[9]) <= epsilon &&
- Math.abs(left[10] - right[10]) <= epsilon &&
- Math.abs(left[11] - right[11]) <= epsilon &&
- Math.abs(left[12] - right[12]) <= epsilon &&
- Math.abs(left[13] - right[13]) <= epsilon &&
- Math.abs(left[14] - right[14]) <= epsilon &&
- Math.abs(left[15] - right[15]) <= epsilon)
- );
- };
- /**
- * Gets the translation portion of the provided matrix, assuming the matrix is a affine transformation matrix.
- *
- * @param {Matrix4} matrix The matrix to use.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- */
- Matrix4.getTranslation = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = matrix[12];
- result.y = matrix[13];
- result.z = matrix[14];
- return result;
- };
- /**
- * Gets the upper left 3x3 rotation matrix of the provided matrix, assuming the matrix is an affine transformation matrix.
- *
- * @param {Matrix4} matrix The matrix to use.
- * @param {Matrix3} result The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter.
- *
- * @example
- * // returns a Matrix3 instance from a Matrix4 instance
- *
- * // m = [10.0, 14.0, 18.0, 22.0]
- * // [11.0, 15.0, 19.0, 23.0]
- * // [12.0, 16.0, 20.0, 24.0]
- * // [13.0, 17.0, 21.0, 25.0]
- *
- * var b = new Cesium.Matrix3();
- * Cesium.Matrix4.getMatrix3(m,b);
- *
- * // b = [10.0, 14.0, 18.0]
- * // [11.0, 15.0, 19.0]
- * // [12.0, 16.0, 20.0]
- */
- Matrix4.getMatrix3 = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result[0] = matrix[0];
- result[1] = matrix[1];
- result[2] = matrix[2];
- result[3] = matrix[4];
- result[4] = matrix[5];
- result[5] = matrix[6];
- result[6] = matrix[8];
- result[7] = matrix[9];
- result[8] = matrix[10];
- return result;
- };
- var scratchInverseRotation = new Matrix3();
- var scratchMatrix3Zero = new Matrix3();
- var scratchBottomRow = new Cartesian4();
- var scratchExpectedBottomRow = new Cartesian4(0.0, 0.0, 0.0, 1.0);
- /**
- * Computes the inverse of the provided matrix using Cramers Rule.
- * If the determinant is zero, the matrix can not be inverted, and an exception is thrown.
- * If the matrix is an affine transformation matrix, it is more efficient
- * to invert it with {@link Matrix4.inverseTransformation}.
- *
- * @param {Matrix4} matrix The matrix to invert.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- *
- * @exception {RuntimeError} matrix is not invertible because its determinate is zero.
- */
- Matrix4.inverse = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- //
- // Ported from:
- // ftp://download.intel.com/design/PentiumIII/sml/24504301.pdf
- //
- var src0 = matrix[0];
- var src1 = matrix[4];
- var src2 = matrix[8];
- var src3 = matrix[12];
- var src4 = matrix[1];
- var src5 = matrix[5];
- var src6 = matrix[9];
- var src7 = matrix[13];
- var src8 = matrix[2];
- var src9 = matrix[6];
- var src10 = matrix[10];
- var src11 = matrix[14];
- var src12 = matrix[3];
- var src13 = matrix[7];
- var src14 = matrix[11];
- var src15 = matrix[15];
- // calculate pairs for first 8 elements (cofactors)
- var tmp0 = src10 * src15;
- var tmp1 = src11 * src14;
- var tmp2 = src9 * src15;
- var tmp3 = src11 * src13;
- var tmp4 = src9 * src14;
- var tmp5 = src10 * src13;
- var tmp6 = src8 * src15;
- var tmp7 = src11 * src12;
- var tmp8 = src8 * src14;
- var tmp9 = src10 * src12;
- var tmp10 = src8 * src13;
- var tmp11 = src9 * src12;
- // calculate first 8 elements (cofactors)
- var dst0 =
- tmp0 * src5 +
- tmp3 * src6 +
- tmp4 * src7 -
- (tmp1 * src5 + tmp2 * src6 + tmp5 * src7);
- var dst1 =
- tmp1 * src4 +
- tmp6 * src6 +
- tmp9 * src7 -
- (tmp0 * src4 + tmp7 * src6 + tmp8 * src7);
- var dst2 =
- tmp2 * src4 +
- tmp7 * src5 +
- tmp10 * src7 -
- (tmp3 * src4 + tmp6 * src5 + tmp11 * src7);
- var dst3 =
- tmp5 * src4 +
- tmp8 * src5 +
- tmp11 * src6 -
- (tmp4 * src4 + tmp9 * src5 + tmp10 * src6);
- var dst4 =
- tmp1 * src1 +
- tmp2 * src2 +
- tmp5 * src3 -
- (tmp0 * src1 + tmp3 * src2 + tmp4 * src3);
- var dst5 =
- tmp0 * src0 +
- tmp7 * src2 +
- tmp8 * src3 -
- (tmp1 * src0 + tmp6 * src2 + tmp9 * src3);
- var dst6 =
- tmp3 * src0 +
- tmp6 * src1 +
- tmp11 * src3 -
- (tmp2 * src0 + tmp7 * src1 + tmp10 * src3);
- var dst7 =
- tmp4 * src0 +
- tmp9 * src1 +
- tmp10 * src2 -
- (tmp5 * src0 + tmp8 * src1 + tmp11 * src2);
- // calculate pairs for second 8 elements (cofactors)
- tmp0 = src2 * src7;
- tmp1 = src3 * src6;
- tmp2 = src1 * src7;
- tmp3 = src3 * src5;
- tmp4 = src1 * src6;
- tmp5 = src2 * src5;
- tmp6 = src0 * src7;
- tmp7 = src3 * src4;
- tmp8 = src0 * src6;
- tmp9 = src2 * src4;
- tmp10 = src0 * src5;
- tmp11 = src1 * src4;
- // calculate second 8 elements (cofactors)
- var dst8 =
- tmp0 * src13 +
- tmp3 * src14 +
- tmp4 * src15 -
- (tmp1 * src13 + tmp2 * src14 + tmp5 * src15);
- var dst9 =
- tmp1 * src12 +
- tmp6 * src14 +
- tmp9 * src15 -
- (tmp0 * src12 + tmp7 * src14 + tmp8 * src15);
- var dst10 =
- tmp2 * src12 +
- tmp7 * src13 +
- tmp10 * src15 -
- (tmp3 * src12 + tmp6 * src13 + tmp11 * src15);
- var dst11 =
- tmp5 * src12 +
- tmp8 * src13 +
- tmp11 * src14 -
- (tmp4 * src12 + tmp9 * src13 + tmp10 * src14);
- var dst12 =
- tmp2 * src10 +
- tmp5 * src11 +
- tmp1 * src9 -
- (tmp4 * src11 + tmp0 * src9 + tmp3 * src10);
- var dst13 =
- tmp8 * src11 +
- tmp0 * src8 +
- tmp7 * src10 -
- (tmp6 * src10 + tmp9 * src11 + tmp1 * src8);
- var dst14 =
- tmp6 * src9 +
- tmp11 * src11 +
- tmp3 * src8 -
- (tmp10 * src11 + tmp2 * src8 + tmp7 * src9);
- var dst15 =
- tmp10 * src10 +
- tmp4 * src8 +
- tmp9 * src9 -
- (tmp8 * src9 + tmp11 * src10 + tmp5 * src8);
- // calculate determinant
- var det = src0 * dst0 + src1 * dst1 + src2 * dst2 + src3 * dst3;
- if (Math.abs(det) < _Math.CesiumMath.EPSILON21) {
- // Special case for a zero scale matrix that can occur, for example,
- // when a model's node has a [0, 0, 0] scale.
- if (
- Matrix3.equalsEpsilon(
- Matrix4.getMatrix3(matrix, scratchInverseRotation),
- scratchMatrix3Zero,
- _Math.CesiumMath.EPSILON7
- ) &&
- Cartesian4.equals(
- Matrix4.getRow(matrix, 3, scratchBottomRow),
- scratchExpectedBottomRow
- )
- ) {
- result[0] = 0.0;
- result[1] = 0.0;
- result[2] = 0.0;
- result[3] = 0.0;
- result[4] = 0.0;
- result[5] = 0.0;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = 0.0;
- result[9] = 0.0;
- result[10] = 0.0;
- result[11] = 0.0;
- result[12] = -matrix[12];
- result[13] = -matrix[13];
- result[14] = -matrix[14];
- result[15] = 1.0;
- return result;
- }
- throw new RuntimeError.RuntimeError(
- "matrix is not invertible because its determinate is zero."
- );
- }
- // calculate matrix inverse
- det = 1.0 / det;
- result[0] = dst0 * det;
- result[1] = dst1 * det;
- result[2] = dst2 * det;
- result[3] = dst3 * det;
- result[4] = dst4 * det;
- result[5] = dst5 * det;
- result[6] = dst6 * det;
- result[7] = dst7 * det;
- result[8] = dst8 * det;
- result[9] = dst9 * det;
- result[10] = dst10 * det;
- result[11] = dst11 * det;
- result[12] = dst12 * det;
- result[13] = dst13 * det;
- result[14] = dst14 * det;
- result[15] = dst15 * det;
- return result;
- };
- /**
- * Computes the inverse of the provided matrix assuming it is
- * an affine transformation matrix, where the upper left 3x3 elements
- * are a rotation matrix, and the upper three elements in the fourth
- * column are the translation. The bottom row is assumed to be [0, 0, 0, 1].
- * The matrix is not verified to be in the proper form.
- * This method is faster than computing the inverse for a general 4x4
- * matrix using {@link Matrix4.inverse}.
- *
- * @param {Matrix4} matrix The matrix to invert.
- * @param {Matrix4} result The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter.
- */
- Matrix4.inverseTransformation = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- //This function is an optimized version of the below 4 lines.
- //var rT = Matrix3.transpose(Matrix4.getMatrix3(matrix));
- //var rTN = Matrix3.negate(rT);
- //var rTT = Matrix3.multiplyByVector(rTN, Matrix4.getTranslation(matrix));
- //return Matrix4.fromRotationTranslation(rT, rTT, result);
- var matrix0 = matrix[0];
- var matrix1 = matrix[1];
- var matrix2 = matrix[2];
- var matrix4 = matrix[4];
- var matrix5 = matrix[5];
- var matrix6 = matrix[6];
- var matrix8 = matrix[8];
- var matrix9 = matrix[9];
- var matrix10 = matrix[10];
- var vX = matrix[12];
- var vY = matrix[13];
- var vZ = matrix[14];
- var x = -matrix0 * vX - matrix1 * vY - matrix2 * vZ;
- var y = -matrix4 * vX - matrix5 * vY - matrix6 * vZ;
- var z = -matrix8 * vX - matrix9 * vY - matrix10 * vZ;
- result[0] = matrix0;
- result[1] = matrix4;
- result[2] = matrix8;
- result[3] = 0.0;
- result[4] = matrix1;
- result[5] = matrix5;
- result[6] = matrix9;
- result[7] = 0.0;
- result[8] = matrix2;
- result[9] = matrix6;
- result[10] = matrix10;
- result[11] = 0.0;
- result[12] = x;
- result[13] = y;
- result[14] = z;
- result[15] = 1.0;
- return result;
- };
- /**
- * An immutable Matrix4 instance initialized to the identity matrix.
- *
- * @type {Matrix4}
- * @constant
- */
- Matrix4.IDENTITY = Object.freeze(
- new Matrix4(
- 1.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 1.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 1.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 1.0
- )
- );
- /**
- * An immutable Matrix4 instance initialized to the zero matrix.
- *
- * @type {Matrix4}
- * @constant
- */
- Matrix4.ZERO = Object.freeze(
- new Matrix4(
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0
- )
- );
- /**
- * The index into Matrix4 for column 0, row 0.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN0ROW0 = 0;
- /**
- * The index into Matrix4 for column 0, row 1.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN0ROW1 = 1;
- /**
- * The index into Matrix4 for column 0, row 2.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN0ROW2 = 2;
- /**
- * The index into Matrix4 for column 0, row 3.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN0ROW3 = 3;
- /**
- * The index into Matrix4 for column 1, row 0.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN1ROW0 = 4;
- /**
- * The index into Matrix4 for column 1, row 1.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN1ROW1 = 5;
- /**
- * The index into Matrix4 for column 1, row 2.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN1ROW2 = 6;
- /**
- * The index into Matrix4 for column 1, row 3.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN1ROW3 = 7;
- /**
- * The index into Matrix4 for column 2, row 0.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN2ROW0 = 8;
- /**
- * The index into Matrix4 for column 2, row 1.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN2ROW1 = 9;
- /**
- * The index into Matrix4 for column 2, row 2.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN2ROW2 = 10;
- /**
- * The index into Matrix4 for column 2, row 3.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN2ROW3 = 11;
- /**
- * The index into Matrix4 for column 3, row 0.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN3ROW0 = 12;
- /**
- * The index into Matrix4 for column 3, row 1.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN3ROW1 = 13;
- /**
- * The index into Matrix4 for column 3, row 2.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN3ROW2 = 14;
- /**
- * The index into Matrix4 for column 3, row 3.
- *
- * @type {Number}
- * @constant
- */
- Matrix4.COLUMN3ROW3 = 15;
- Object.defineProperties(Matrix4.prototype, {
- /**
- * Gets the number of items in the collection.
- * @memberof Matrix4.prototype
- *
- * @type {Number}
- */
- length: {
- get: function () {
- return Matrix4.packedLength;
- },
- },
- });
- /**
- * Duplicates the provided Matrix4 instance.
- *
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if one was not provided.
- */
- Matrix4.prototype.clone = function (result) {
- return Matrix4.clone(this, result);
- };
- /**
- * Compares this matrix to the provided matrix componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {Matrix4} [right] The right hand side matrix.
- * @returns {Boolean} <code>true</code> if they are equal, <code>false</code> otherwise.
- */
- Matrix4.prototype.equals = function (right) {
- return Matrix4.equals(this, right);
- };
- /**
- * @private
- */
- Matrix4.equalsArray = function (matrix, array, offset) {
- return (
- matrix[0] === array[offset] &&
- matrix[1] === array[offset + 1] &&
- matrix[2] === array[offset + 2] &&
- matrix[3] === array[offset + 3] &&
- matrix[4] === array[offset + 4] &&
- matrix[5] === array[offset + 5] &&
- matrix[6] === array[offset + 6] &&
- matrix[7] === array[offset + 7] &&
- matrix[8] === array[offset + 8] &&
- matrix[9] === array[offset + 9] &&
- matrix[10] === array[offset + 10] &&
- matrix[11] === array[offset + 11] &&
- matrix[12] === array[offset + 12] &&
- matrix[13] === array[offset + 13] &&
- matrix[14] === array[offset + 14] &&
- matrix[15] === array[offset + 15]
- );
- };
- /**
- * Compares this matrix to the provided matrix componentwise and returns
- * <code>true</code> if they are within the provided epsilon,
- * <code>false</code> otherwise.
- *
- * @param {Matrix4} [right] The right hand side matrix.
- * @param {Number} [epsilon=0] The epsilon to use for equality testing.
- * @returns {Boolean} <code>true</code> if they are within the provided epsilon, <code>false</code> otherwise.
- */
- Matrix4.prototype.equalsEpsilon = function (right, epsilon) {
- return Matrix4.equalsEpsilon(this, right, epsilon);
- };
- /**
- * Computes a string representing this Matrix with each row being
- * on a separate line and in the format '(column0, column1, column2, column3)'.
- *
- * @returns {String} A string representing the provided Matrix with each row being on a separate line and in the format '(column0, column1, column2, column3)'.
- */
- Matrix4.prototype.toString = function () {
- return (
- "(" +
- this[0] +
- ", " +
- this[4] +
- ", " +
- this[8] +
- ", " +
- this[12] +
- ")\n" +
- "(" +
- this[1] +
- ", " +
- this[5] +
- ", " +
- this[9] +
- ", " +
- this[13] +
- ")\n" +
- "(" +
- this[2] +
- ", " +
- this[6] +
- ", " +
- this[10] +
- ", " +
- this[14] +
- ")\n" +
- "(" +
- this[3] +
- ", " +
- this[7] +
- ", " +
- this[11] +
- ", " +
- this[15] +
- ")"
- );
- };
- /**
- * A bounding sphere with a center and a radius.
- * @alias BoundingSphere
- * @constructor
- *
- * @param {Cartesian3} [center=Cartesian3.ZERO] The center of the bounding sphere.
- * @param {Number} [radius=0.0] The radius of the bounding sphere.
- *
- * @see AxisAlignedBoundingBox
- * @see BoundingRectangle
- * @see Packable
- */
- function BoundingSphere(center, radius) {
- /**
- * The center point of the sphere.
- * @type {Cartesian3}
- * @default {@link Cartesian3.ZERO}
- */
- this.center = Cartesian2.Cartesian3.clone(when.defaultValue(center, Cartesian2.Cartesian3.ZERO));
- /**
- * The radius of the sphere.
- * @type {Number}
- * @default 0.0
- */
- this.radius = when.defaultValue(radius, 0.0);
- }
- var fromPointsXMin = new Cartesian2.Cartesian3();
- var fromPointsYMin = new Cartesian2.Cartesian3();
- var fromPointsZMin = new Cartesian2.Cartesian3();
- var fromPointsXMax = new Cartesian2.Cartesian3();
- var fromPointsYMax = new Cartesian2.Cartesian3();
- var fromPointsZMax = new Cartesian2.Cartesian3();
- var fromPointsCurrentPos = new Cartesian2.Cartesian3();
- var fromPointsScratch = new Cartesian2.Cartesian3();
- var fromPointsRitterCenter = new Cartesian2.Cartesian3();
- var fromPointsMinBoxPt = new Cartesian2.Cartesian3();
- var fromPointsMaxBoxPt = new Cartesian2.Cartesian3();
- var fromPointsNaiveCenterScratch = new Cartesian2.Cartesian3();
- var volumeConstant = (4.0 / 3.0) * _Math.CesiumMath.PI;
- /**
- * Computes a tight-fitting bounding sphere enclosing a list of 3D Cartesian points.
- * The bounding sphere is computed by running two algorithms, a naive algorithm and
- * Ritter's algorithm. The smaller of the two spheres is used to ensure a tight fit.
- *
- * @param {Cartesian3[]} [positions] An array of points that the bounding sphere will enclose. Each point must have <code>x</code>, <code>y</code>, and <code>z</code> properties.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if one was not provided.
- *
- * @see {@link http://help.agi.com/AGIComponents/html/BlogBoundingSphere.htm|Bounding Sphere computation article}
- */
- BoundingSphere.fromPoints = function (positions, result) {
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- if (!when.defined(positions) || positions.length === 0) {
- result.center = Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.ZERO, result.center);
- result.radius = 0.0;
- return result;
- }
- var currentPos = Cartesian2.Cartesian3.clone(positions[0], fromPointsCurrentPos);
- var xMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsXMin);
- var yMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsYMin);
- var zMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsZMin);
- var xMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsXMax);
- var yMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsYMax);
- var zMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsZMax);
- var numPositions = positions.length;
- var i;
- for (i = 1; i < numPositions; i++) {
- Cartesian2.Cartesian3.clone(positions[i], currentPos);
- var x = currentPos.x;
- var y = currentPos.y;
- var z = currentPos.z;
- // Store points containing the the smallest and largest components
- if (x < xMin.x) {
- Cartesian2.Cartesian3.clone(currentPos, xMin);
- }
- if (x > xMax.x) {
- Cartesian2.Cartesian3.clone(currentPos, xMax);
- }
- if (y < yMin.y) {
- Cartesian2.Cartesian3.clone(currentPos, yMin);
- }
- if (y > yMax.y) {
- Cartesian2.Cartesian3.clone(currentPos, yMax);
- }
- if (z < zMin.z) {
- Cartesian2.Cartesian3.clone(currentPos, zMin);
- }
- if (z > zMax.z) {
- Cartesian2.Cartesian3.clone(currentPos, zMax);
- }
- }
- // Compute x-, y-, and z-spans (Squared distances b/n each component's min. and max.).
- var xSpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(xMax, xMin, fromPointsScratch)
- );
- var ySpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(yMax, yMin, fromPointsScratch)
- );
- var zSpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(zMax, zMin, fromPointsScratch)
- );
- // Set the diameter endpoints to the largest span.
- var diameter1 = xMin;
- var diameter2 = xMax;
- var maxSpan = xSpan;
- if (ySpan > maxSpan) {
- maxSpan = ySpan;
- diameter1 = yMin;
- diameter2 = yMax;
- }
- if (zSpan > maxSpan) {
- maxSpan = zSpan;
- diameter1 = zMin;
- diameter2 = zMax;
- }
- // Calculate the center of the initial sphere found by Ritter's algorithm
- var ritterCenter = fromPointsRitterCenter;
- ritterCenter.x = (diameter1.x + diameter2.x) * 0.5;
- ritterCenter.y = (diameter1.y + diameter2.y) * 0.5;
- ritterCenter.z = (diameter1.z + diameter2.z) * 0.5;
- // Calculate the radius of the initial sphere found by Ritter's algorithm
- var radiusSquared = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(diameter2, ritterCenter, fromPointsScratch)
- );
- var ritterRadius = Math.sqrt(radiusSquared);
- // Find the center of the sphere found using the Naive method.
- var minBoxPt = fromPointsMinBoxPt;
- minBoxPt.x = xMin.x;
- minBoxPt.y = yMin.y;
- minBoxPt.z = zMin.z;
- var maxBoxPt = fromPointsMaxBoxPt;
- maxBoxPt.x = xMax.x;
- maxBoxPt.y = yMax.y;
- maxBoxPt.z = zMax.z;
- var naiveCenter = Cartesian2.Cartesian3.midpoint(
- minBoxPt,
- maxBoxPt,
- fromPointsNaiveCenterScratch
- );
- // Begin 2nd pass to find naive radius and modify the ritter sphere.
- var naiveRadius = 0;
- for (i = 0; i < numPositions; i++) {
- Cartesian2.Cartesian3.clone(positions[i], currentPos);
- // Find the furthest point from the naive center to calculate the naive radius.
- var r = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.subtract(currentPos, naiveCenter, fromPointsScratch)
- );
- if (r > naiveRadius) {
- naiveRadius = r;
- }
- // Make adjustments to the Ritter Sphere to include all points.
- var oldCenterToPointSquared = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(currentPos, ritterCenter, fromPointsScratch)
- );
- if (oldCenterToPointSquared > radiusSquared) {
- var oldCenterToPoint = Math.sqrt(oldCenterToPointSquared);
- // Calculate new radius to include the point that lies outside
- ritterRadius = (ritterRadius + oldCenterToPoint) * 0.5;
- radiusSquared = ritterRadius * ritterRadius;
- // Calculate center of new Ritter sphere
- var oldToNew = oldCenterToPoint - ritterRadius;
- ritterCenter.x =
- (ritterRadius * ritterCenter.x + oldToNew * currentPos.x) /
- oldCenterToPoint;
- ritterCenter.y =
- (ritterRadius * ritterCenter.y + oldToNew * currentPos.y) /
- oldCenterToPoint;
- ritterCenter.z =
- (ritterRadius * ritterCenter.z + oldToNew * currentPos.z) /
- oldCenterToPoint;
- }
- }
- if (ritterRadius < naiveRadius) {
- Cartesian2.Cartesian3.clone(ritterCenter, result.center);
- result.radius = ritterRadius;
- } else {
- Cartesian2.Cartesian3.clone(naiveCenter, result.center);
- result.radius = naiveRadius;
- }
- return result;
- };
- var defaultProjection = new GeographicProjection();
- var fromRectangle2DLowerLeft = new Cartesian2.Cartesian3();
- var fromRectangle2DUpperRight = new Cartesian2.Cartesian3();
- var fromRectangle2DSouthwest = new Cartesian2.Cartographic();
- var fromRectangle2DNortheast = new Cartesian2.Cartographic();
- /**
- * Computes a bounding sphere from a rectangle projected in 2D.
- *
- * @param {Rectangle} [rectangle] The rectangle around which to create a bounding sphere.
- * @param {Object} [projection=GeographicProjection] The projection used to project the rectangle into 2D.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.fromRectangle2D = function (rectangle, projection, result) {
- return BoundingSphere.fromRectangleWithHeights2D(
- rectangle,
- projection,
- 0.0,
- 0.0,
- result
- );
- };
- /**
- * Computes a bounding sphere from a rectangle projected in 2D. The bounding sphere accounts for the
- * object's minimum and maximum heights over the rectangle.
- *
- * @param {Rectangle} [rectangle] The rectangle around which to create a bounding sphere.
- * @param {Object} [projection=GeographicProjection] The projection used to project the rectangle into 2D.
- * @param {Number} [minimumHeight=0.0] The minimum height over the rectangle.
- * @param {Number} [maximumHeight=0.0] The maximum height over the rectangle.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.fromRectangleWithHeights2D = function (
- rectangle,
- projection,
- minimumHeight,
- maximumHeight,
- result
- ) {
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- if (!when.defined(rectangle)) {
- result.center = Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.ZERO, result.center);
- result.radius = 0.0;
- return result;
- }
- projection = when.defaultValue(projection, defaultProjection);
- Cartesian2.Rectangle.southwest(rectangle, fromRectangle2DSouthwest);
- fromRectangle2DSouthwest.height = minimumHeight;
- Cartesian2.Rectangle.northeast(rectangle, fromRectangle2DNortheast);
- fromRectangle2DNortheast.height = maximumHeight;
- var lowerLeft = projection.project(
- fromRectangle2DSouthwest,
- fromRectangle2DLowerLeft
- );
- var upperRight = projection.project(
- fromRectangle2DNortheast,
- fromRectangle2DUpperRight
- );
- var width = upperRight.x - lowerLeft.x;
- var height = upperRight.y - lowerLeft.y;
- var elevation = upperRight.z - lowerLeft.z;
- result.radius =
- Math.sqrt(width * width + height * height + elevation * elevation) * 0.5;
- var center = result.center;
- center.x = lowerLeft.x + width * 0.5;
- center.y = lowerLeft.y + height * 0.5;
- center.z = lowerLeft.z + elevation * 0.5;
- return result;
- };
- var fromRectangle3DScratch = [];
- /**
- * Computes a bounding sphere from a rectangle in 3D. The bounding sphere is created using a subsample of points
- * on the ellipsoid and contained in the rectangle. It may not be accurate for all rectangles on all types of ellipsoids.
- *
- * @param {Rectangle} [rectangle] The valid rectangle used to create a bounding sphere.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid used to determine positions of the rectangle.
- * @param {Number} [surfaceHeight=0.0] The height above the surface of the ellipsoid.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.fromRectangle3D = function (
- rectangle,
- ellipsoid,
- surfaceHeight,
- result
- ) {
- ellipsoid = when.defaultValue(ellipsoid, Cartesian2.Ellipsoid.WGS84);
- surfaceHeight = when.defaultValue(surfaceHeight, 0.0);
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- if (!when.defined(rectangle)) {
- result.center = Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.ZERO, result.center);
- result.radius = 0.0;
- return result;
- }
- var positions = Cartesian2.Rectangle.subsample(
- rectangle,
- ellipsoid,
- surfaceHeight,
- fromRectangle3DScratch
- );
- return BoundingSphere.fromPoints(positions, result);
- };
- /**
- * Computes a tight-fitting bounding sphere enclosing a list of 3D points, where the points are
- * stored in a flat array in X, Y, Z, order. The bounding sphere is computed by running two
- * algorithms, a naive algorithm and Ritter's algorithm. The smaller of the two spheres is used to
- * ensure a tight fit.
- *
- * @param {Number[]} [positions] An array of points that the bounding sphere will enclose. Each point
- * is formed from three elements in the array in the order X, Y, Z.
- * @param {Cartesian3} [center=Cartesian3.ZERO] The position to which the positions are relative, which need not be the
- * origin of the coordinate system. This is useful when the positions are to be used for
- * relative-to-center (RTC) rendering.
- * @param {Number} [stride=3] The number of array elements per vertex. It must be at least 3, but it may
- * be higher. Regardless of the value of this parameter, the X coordinate of the first position
- * is at array index 0, the Y coordinate is at array index 1, and the Z coordinate is at array index
- * 2. When stride is 3, the X coordinate of the next position then begins at array index 3. If
- * the stride is 5, however, two array elements are skipped and the next position begins at array
- * index 5.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if one was not provided.
- *
- * @example
- * // Compute the bounding sphere from 3 positions, each specified relative to a center.
- * // In addition to the X, Y, and Z coordinates, the points array contains two additional
- * // elements per point which are ignored for the purpose of computing the bounding sphere.
- * var center = new Cesium.Cartesian3(1.0, 2.0, 3.0);
- * var points = [1.0, 2.0, 3.0, 0.1, 0.2,
- * 4.0, 5.0, 6.0, 0.1, 0.2,
- * 7.0, 8.0, 9.0, 0.1, 0.2];
- * var sphere = Cesium.BoundingSphere.fromVertices(points, center, 5);
- *
- * @see {@link http://blogs.agi.com/insight3d/index.php/2008/02/04/a-bounding/|Bounding Sphere computation article}
- */
- BoundingSphere.fromVertices = function (positions, center, stride, result) {
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- if (!when.defined(positions) || positions.length === 0) {
- result.center = Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.ZERO, result.center);
- result.radius = 0.0;
- return result;
- }
- center = when.defaultValue(center, Cartesian2.Cartesian3.ZERO);
- stride = when.defaultValue(stride, 3);
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number.greaterThanOrEquals("stride", stride, 3);
- //>>includeEnd('debug');
- var currentPos = fromPointsCurrentPos;
- currentPos.x = positions[0] + center.x;
- currentPos.y = positions[1] + center.y;
- currentPos.z = positions[2] + center.z;
- var xMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsXMin);
- var yMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsYMin);
- var zMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsZMin);
- var xMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsXMax);
- var yMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsYMax);
- var zMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsZMax);
- var numElements = positions.length;
- var i;
- for (i = 0; i < numElements; i += stride) {
- var x = positions[i] + center.x;
- var y = positions[i + 1] + center.y;
- var z = positions[i + 2] + center.z;
- currentPos.x = x;
- currentPos.y = y;
- currentPos.z = z;
- // Store points containing the the smallest and largest components
- if (x < xMin.x) {
- Cartesian2.Cartesian3.clone(currentPos, xMin);
- }
- if (x > xMax.x) {
- Cartesian2.Cartesian3.clone(currentPos, xMax);
- }
- if (y < yMin.y) {
- Cartesian2.Cartesian3.clone(currentPos, yMin);
- }
- if (y > yMax.y) {
- Cartesian2.Cartesian3.clone(currentPos, yMax);
- }
- if (z < zMin.z) {
- Cartesian2.Cartesian3.clone(currentPos, zMin);
- }
- if (z > zMax.z) {
- Cartesian2.Cartesian3.clone(currentPos, zMax);
- }
- }
- // Compute x-, y-, and z-spans (Squared distances b/n each component's min. and max.).
- var xSpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(xMax, xMin, fromPointsScratch)
- );
- var ySpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(yMax, yMin, fromPointsScratch)
- );
- var zSpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(zMax, zMin, fromPointsScratch)
- );
- // Set the diameter endpoints to the largest span.
- var diameter1 = xMin;
- var diameter2 = xMax;
- var maxSpan = xSpan;
- if (ySpan > maxSpan) {
- maxSpan = ySpan;
- diameter1 = yMin;
- diameter2 = yMax;
- }
- if (zSpan > maxSpan) {
- maxSpan = zSpan;
- diameter1 = zMin;
- diameter2 = zMax;
- }
- // Calculate the center of the initial sphere found by Ritter's algorithm
- var ritterCenter = fromPointsRitterCenter;
- ritterCenter.x = (diameter1.x + diameter2.x) * 0.5;
- ritterCenter.y = (diameter1.y + diameter2.y) * 0.5;
- ritterCenter.z = (diameter1.z + diameter2.z) * 0.5;
- // Calculate the radius of the initial sphere found by Ritter's algorithm
- var radiusSquared = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(diameter2, ritterCenter, fromPointsScratch)
- );
- var ritterRadius = Math.sqrt(radiusSquared);
- // Find the center of the sphere found using the Naive method.
- var minBoxPt = fromPointsMinBoxPt;
- minBoxPt.x = xMin.x;
- minBoxPt.y = yMin.y;
- minBoxPt.z = zMin.z;
- var maxBoxPt = fromPointsMaxBoxPt;
- maxBoxPt.x = xMax.x;
- maxBoxPt.y = yMax.y;
- maxBoxPt.z = zMax.z;
- var naiveCenter = Cartesian2.Cartesian3.midpoint(
- minBoxPt,
- maxBoxPt,
- fromPointsNaiveCenterScratch
- );
- // Begin 2nd pass to find naive radius and modify the ritter sphere.
- var naiveRadius = 0;
- for (i = 0; i < numElements; i += stride) {
- currentPos.x = positions[i] + center.x;
- currentPos.y = positions[i + 1] + center.y;
- currentPos.z = positions[i + 2] + center.z;
- // Find the furthest point from the naive center to calculate the naive radius.
- var r = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.subtract(currentPos, naiveCenter, fromPointsScratch)
- );
- if (r > naiveRadius) {
- naiveRadius = r;
- }
- // Make adjustments to the Ritter Sphere to include all points.
- var oldCenterToPointSquared = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(currentPos, ritterCenter, fromPointsScratch)
- );
- if (oldCenterToPointSquared > radiusSquared) {
- var oldCenterToPoint = Math.sqrt(oldCenterToPointSquared);
- // Calculate new radius to include the point that lies outside
- ritterRadius = (ritterRadius + oldCenterToPoint) * 0.5;
- radiusSquared = ritterRadius * ritterRadius;
- // Calculate center of new Ritter sphere
- var oldToNew = oldCenterToPoint - ritterRadius;
- ritterCenter.x =
- (ritterRadius * ritterCenter.x + oldToNew * currentPos.x) /
- oldCenterToPoint;
- ritterCenter.y =
- (ritterRadius * ritterCenter.y + oldToNew * currentPos.y) /
- oldCenterToPoint;
- ritterCenter.z =
- (ritterRadius * ritterCenter.z + oldToNew * currentPos.z) /
- oldCenterToPoint;
- }
- }
- if (ritterRadius < naiveRadius) {
- Cartesian2.Cartesian3.clone(ritterCenter, result.center);
- result.radius = ritterRadius;
- } else {
- Cartesian2.Cartesian3.clone(naiveCenter, result.center);
- result.radius = naiveRadius;
- }
- return result;
- };
- /**
- * Computes a tight-fitting bounding sphere enclosing a list of EncodedCartesian3s, where the points are
- * stored in parallel flat arrays in X, Y, Z, order. The bounding sphere is computed by running two
- * algorithms, a naive algorithm and Ritter's algorithm. The smaller of the two spheres is used to
- * ensure a tight fit.
- *
- * @param {Number[]} [positionsHigh] An array of high bits of the encoded cartesians that the bounding sphere will enclose. Each point
- * is formed from three elements in the array in the order X, Y, Z.
- * @param {Number[]} [positionsLow] An array of low bits of the encoded cartesians that the bounding sphere will enclose. Each point
- * is formed from three elements in the array in the order X, Y, Z.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if one was not provided.
- *
- * @see {@link http://blogs.agi.com/insight3d/index.php/2008/02/04/a-bounding/|Bounding Sphere computation article}
- */
- BoundingSphere.fromEncodedCartesianVertices = function (
- positionsHigh,
- positionsLow,
- result
- ) {
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- if (
- !when.defined(positionsHigh) ||
- !when.defined(positionsLow) ||
- positionsHigh.length !== positionsLow.length ||
- positionsHigh.length === 0
- ) {
- result.center = Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.ZERO, result.center);
- result.radius = 0.0;
- return result;
- }
- var currentPos = fromPointsCurrentPos;
- currentPos.x = positionsHigh[0] + positionsLow[0];
- currentPos.y = positionsHigh[1] + positionsLow[1];
- currentPos.z = positionsHigh[2] + positionsLow[2];
- var xMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsXMin);
- var yMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsYMin);
- var zMin = Cartesian2.Cartesian3.clone(currentPos, fromPointsZMin);
- var xMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsXMax);
- var yMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsYMax);
- var zMax = Cartesian2.Cartesian3.clone(currentPos, fromPointsZMax);
- var numElements = positionsHigh.length;
- var i;
- for (i = 0; i < numElements; i += 3) {
- var x = positionsHigh[i] + positionsLow[i];
- var y = positionsHigh[i + 1] + positionsLow[i + 1];
- var z = positionsHigh[i + 2] + positionsLow[i + 2];
- currentPos.x = x;
- currentPos.y = y;
- currentPos.z = z;
- // Store points containing the the smallest and largest components
- if (x < xMin.x) {
- Cartesian2.Cartesian3.clone(currentPos, xMin);
- }
- if (x > xMax.x) {
- Cartesian2.Cartesian3.clone(currentPos, xMax);
- }
- if (y < yMin.y) {
- Cartesian2.Cartesian3.clone(currentPos, yMin);
- }
- if (y > yMax.y) {
- Cartesian2.Cartesian3.clone(currentPos, yMax);
- }
- if (z < zMin.z) {
- Cartesian2.Cartesian3.clone(currentPos, zMin);
- }
- if (z > zMax.z) {
- Cartesian2.Cartesian3.clone(currentPos, zMax);
- }
- }
- // Compute x-, y-, and z-spans (Squared distances b/n each component's min. and max.).
- var xSpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(xMax, xMin, fromPointsScratch)
- );
- var ySpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(yMax, yMin, fromPointsScratch)
- );
- var zSpan = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(zMax, zMin, fromPointsScratch)
- );
- // Set the diameter endpoints to the largest span.
- var diameter1 = xMin;
- var diameter2 = xMax;
- var maxSpan = xSpan;
- if (ySpan > maxSpan) {
- maxSpan = ySpan;
- diameter1 = yMin;
- diameter2 = yMax;
- }
- if (zSpan > maxSpan) {
- maxSpan = zSpan;
- diameter1 = zMin;
- diameter2 = zMax;
- }
- // Calculate the center of the initial sphere found by Ritter's algorithm
- var ritterCenter = fromPointsRitterCenter;
- ritterCenter.x = (diameter1.x + diameter2.x) * 0.5;
- ritterCenter.y = (diameter1.y + diameter2.y) * 0.5;
- ritterCenter.z = (diameter1.z + diameter2.z) * 0.5;
- // Calculate the radius of the initial sphere found by Ritter's algorithm
- var radiusSquared = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(diameter2, ritterCenter, fromPointsScratch)
- );
- var ritterRadius = Math.sqrt(radiusSquared);
- // Find the center of the sphere found using the Naive method.
- var minBoxPt = fromPointsMinBoxPt;
- minBoxPt.x = xMin.x;
- minBoxPt.y = yMin.y;
- minBoxPt.z = zMin.z;
- var maxBoxPt = fromPointsMaxBoxPt;
- maxBoxPt.x = xMax.x;
- maxBoxPt.y = yMax.y;
- maxBoxPt.z = zMax.z;
- var naiveCenter = Cartesian2.Cartesian3.midpoint(
- minBoxPt,
- maxBoxPt,
- fromPointsNaiveCenterScratch
- );
- // Begin 2nd pass to find naive radius and modify the ritter sphere.
- var naiveRadius = 0;
- for (i = 0; i < numElements; i += 3) {
- currentPos.x = positionsHigh[i] + positionsLow[i];
- currentPos.y = positionsHigh[i + 1] + positionsLow[i + 1];
- currentPos.z = positionsHigh[i + 2] + positionsLow[i + 2];
- // Find the furthest point from the naive center to calculate the naive radius.
- var r = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.subtract(currentPos, naiveCenter, fromPointsScratch)
- );
- if (r > naiveRadius) {
- naiveRadius = r;
- }
- // Make adjustments to the Ritter Sphere to include all points.
- var oldCenterToPointSquared = Cartesian2.Cartesian3.magnitudeSquared(
- Cartesian2.Cartesian3.subtract(currentPos, ritterCenter, fromPointsScratch)
- );
- if (oldCenterToPointSquared > radiusSquared) {
- var oldCenterToPoint = Math.sqrt(oldCenterToPointSquared);
- // Calculate new radius to include the point that lies outside
- ritterRadius = (ritterRadius + oldCenterToPoint) * 0.5;
- radiusSquared = ritterRadius * ritterRadius;
- // Calculate center of new Ritter sphere
- var oldToNew = oldCenterToPoint - ritterRadius;
- ritterCenter.x =
- (ritterRadius * ritterCenter.x + oldToNew * currentPos.x) /
- oldCenterToPoint;
- ritterCenter.y =
- (ritterRadius * ritterCenter.y + oldToNew * currentPos.y) /
- oldCenterToPoint;
- ritterCenter.z =
- (ritterRadius * ritterCenter.z + oldToNew * currentPos.z) /
- oldCenterToPoint;
- }
- }
- if (ritterRadius < naiveRadius) {
- Cartesian2.Cartesian3.clone(ritterCenter, result.center);
- result.radius = ritterRadius;
- } else {
- Cartesian2.Cartesian3.clone(naiveCenter, result.center);
- result.radius = naiveRadius;
- }
- return result;
- };
- /**
- * Computes a bounding sphere from the corner points of an axis-aligned bounding box. The sphere
- * tighly and fully encompases the box.
- *
- * @param {Cartesian3} [corner] The minimum height over the rectangle.
- * @param {Cartesian3} [oppositeCorner] The maximum height over the rectangle.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- *
- * @example
- * // Create a bounding sphere around the unit cube
- * var sphere = Cesium.BoundingSphere.fromCornerPoints(new Cesium.Cartesian3(-0.5, -0.5, -0.5), new Cesium.Cartesian3(0.5, 0.5, 0.5));
- */
- BoundingSphere.fromCornerPoints = function (corner, oppositeCorner, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("corner", corner);
- Check.Check.typeOf.object("oppositeCorner", oppositeCorner);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- var center = Cartesian2.Cartesian3.midpoint(corner, oppositeCorner, result.center);
- result.radius = Cartesian2.Cartesian3.distance(center, oppositeCorner);
- return result;
- };
- /**
- * Creates a bounding sphere encompassing an ellipsoid.
- *
- * @param {Ellipsoid} ellipsoid The ellipsoid around which to create a bounding sphere.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- *
- * @example
- * var boundingSphere = Cesium.BoundingSphere.fromEllipsoid(ellipsoid);
- */
- BoundingSphere.fromEllipsoid = function (ellipsoid, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("ellipsoid", ellipsoid);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.ZERO, result.center);
- result.radius = ellipsoid.maximumRadius;
- return result;
- };
- var fromBoundingSpheresScratch = new Cartesian2.Cartesian3();
- /**
- * Computes a tight-fitting bounding sphere enclosing the provided array of bounding spheres.
- *
- * @param {BoundingSphere[]} [boundingSpheres] The array of bounding spheres.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.fromBoundingSpheres = function (boundingSpheres, result) {
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- if (!when.defined(boundingSpheres) || boundingSpheres.length === 0) {
- result.center = Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.ZERO, result.center);
- result.radius = 0.0;
- return result;
- }
- var length = boundingSpheres.length;
- if (length === 1) {
- return BoundingSphere.clone(boundingSpheres[0], result);
- }
- if (length === 2) {
- return BoundingSphere.union(boundingSpheres[0], boundingSpheres[1], result);
- }
- var positions = [];
- var i;
- for (i = 0; i < length; i++) {
- positions.push(boundingSpheres[i].center);
- }
- result = BoundingSphere.fromPoints(positions, result);
- var center = result.center;
- var radius = result.radius;
- for (i = 0; i < length; i++) {
- var tmp = boundingSpheres[i];
- radius = Math.max(
- radius,
- Cartesian2.Cartesian3.distance(center, tmp.center, fromBoundingSpheresScratch) +
- tmp.radius
- );
- }
- result.radius = radius;
- return result;
- };
- var fromOrientedBoundingBoxScratchU = new Cartesian2.Cartesian3();
- var fromOrientedBoundingBoxScratchV = new Cartesian2.Cartesian3();
- var fromOrientedBoundingBoxScratchW = new Cartesian2.Cartesian3();
- /**
- * Computes a tight-fitting bounding sphere enclosing the provided oriented bounding box.
- *
- * @param {OrientedBoundingBox} orientedBoundingBox The oriented bounding box.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.fromOrientedBoundingBox = function (
- orientedBoundingBox,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("orientedBoundingBox", orientedBoundingBox);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- var halfAxes = orientedBoundingBox.halfAxes;
- var u = Matrix3.getColumn(halfAxes, 0, fromOrientedBoundingBoxScratchU);
- var v = Matrix3.getColumn(halfAxes, 1, fromOrientedBoundingBoxScratchV);
- var w = Matrix3.getColumn(halfAxes, 2, fromOrientedBoundingBoxScratchW);
- Cartesian2.Cartesian3.add(u, v, u);
- Cartesian2.Cartesian3.add(u, w, u);
- result.center = Cartesian2.Cartesian3.clone(orientedBoundingBox.center, result.center);
- result.radius = Cartesian2.Cartesian3.magnitude(u);
- return result;
- };
- /**
- * Duplicates a BoundingSphere instance.
- *
- * @param {BoundingSphere} sphere The bounding sphere to duplicate.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided. (Returns undefined if sphere is undefined)
- */
- BoundingSphere.clone = function (sphere, result) {
- if (!when.defined(sphere)) {
- return undefined;
- }
- if (!when.defined(result)) {
- return new BoundingSphere(sphere.center, sphere.radius);
- }
- result.center = Cartesian2.Cartesian3.clone(sphere.center, result.center);
- result.radius = sphere.radius;
- return result;
- };
- /**
- * The number of elements used to pack the object into an array.
- * @type {Number}
- */
- BoundingSphere.packedLength = 4;
- /**
- * Stores the provided instance into the provided array.
- *
- * @param {BoundingSphere} value The value to pack.
- * @param {Number[]} array The array to pack into.
- * @param {Number} [startingIndex=0] The index into the array at which to start packing the elements.
- *
- * @returns {Number[]} The array that was packed into
- */
- BoundingSphere.pack = function (value, array, startingIndex) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("value", value);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- var center = value.center;
- array[startingIndex++] = center.x;
- array[startingIndex++] = center.y;
- array[startingIndex++] = center.z;
- array[startingIndex] = value.radius;
- return array;
- };
- /**
- * Retrieves an instance from a packed array.
- *
- * @param {Number[]} array The packed array.
- * @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
- * @param {BoundingSphere} [result] The object into which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if one was not provided.
- */
- BoundingSphere.unpack = function (array, startingIndex, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- var center = result.center;
- center.x = array[startingIndex++];
- center.y = array[startingIndex++];
- center.z = array[startingIndex++];
- result.radius = array[startingIndex];
- return result;
- };
- var unionScratch = new Cartesian2.Cartesian3();
- var unionScratchCenter = new Cartesian2.Cartesian3();
- /**
- * Computes a bounding sphere that contains both the left and right bounding spheres.
- *
- * @param {BoundingSphere} left A sphere to enclose in a bounding sphere.
- * @param {BoundingSphere} right A sphere to enclose in a bounding sphere.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.union = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- var leftCenter = left.center;
- var leftRadius = left.radius;
- var rightCenter = right.center;
- var rightRadius = right.radius;
- var toRightCenter = Cartesian2.Cartesian3.subtract(
- rightCenter,
- leftCenter,
- unionScratch
- );
- var centerSeparation = Cartesian2.Cartesian3.magnitude(toRightCenter);
- if (leftRadius >= centerSeparation + rightRadius) {
- // Left sphere wins.
- left.clone(result);
- return result;
- }
- if (rightRadius >= centerSeparation + leftRadius) {
- // Right sphere wins.
- right.clone(result);
- return result;
- }
- // There are two tangent points, one on far side of each sphere.
- var halfDistanceBetweenTangentPoints =
- (leftRadius + centerSeparation + rightRadius) * 0.5;
- // Compute the center point halfway between the two tangent points.
- var center = Cartesian2.Cartesian3.multiplyByScalar(
- toRightCenter,
- (-leftRadius + halfDistanceBetweenTangentPoints) / centerSeparation,
- unionScratchCenter
- );
- Cartesian2.Cartesian3.add(center, leftCenter, center);
- Cartesian2.Cartesian3.clone(center, result.center);
- result.radius = halfDistanceBetweenTangentPoints;
- return result;
- };
- var expandScratch = new Cartesian2.Cartesian3();
- /**
- * Computes a bounding sphere by enlarging the provided sphere to contain the provided point.
- *
- * @param {BoundingSphere} sphere A sphere to expand.
- * @param {Cartesian3} point A point to enclose in a bounding sphere.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.expand = function (sphere, point, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("sphere", sphere);
- Check.Check.typeOf.object("point", point);
- //>>includeEnd('debug');
- result = BoundingSphere.clone(sphere, result);
- var radius = Cartesian2.Cartesian3.magnitude(
- Cartesian2.Cartesian3.subtract(point, result.center, expandScratch)
- );
- if (radius > result.radius) {
- result.radius = radius;
- }
- return result;
- };
- /**
- * Determines which side of a plane a sphere is located.
- *
- * @param {BoundingSphere} sphere The bounding sphere to test.
- * @param {Plane} plane The plane to test against.
- * @returns {Intersect} {@link Intersect.INSIDE} if the entire sphere is on the side of the plane
- * the normal is pointing, {@link Intersect.OUTSIDE} if the entire sphere is
- * on the opposite side, and {@link Intersect.INTERSECTING} if the sphere
- * intersects the plane.
- */
- BoundingSphere.intersectPlane = function (sphere, plane) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("sphere", sphere);
- Check.Check.typeOf.object("plane", plane);
- //>>includeEnd('debug');
- var center = sphere.center;
- var radius = sphere.radius;
- var normal = plane.normal;
- var distanceToPlane = Cartesian2.Cartesian3.dot(normal, center) + plane.distance;
- if (distanceToPlane < -radius) {
- // The center point is negative side of the plane normal
- return Intersect$1.OUTSIDE;
- } else if (distanceToPlane < radius) {
- // The center point is positive side of the plane, but radius extends beyond it; partial overlap
- return Intersect$1.INTERSECTING;
- }
- return Intersect$1.INSIDE;
- };
- /**
- * Applies a 4x4 affine transformation matrix to a bounding sphere.
- *
- * @param {BoundingSphere} sphere The bounding sphere to apply the transformation to.
- * @param {Matrix4} transform The transformation matrix to apply to the bounding sphere.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.transform = function (sphere, transform, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("sphere", sphere);
- Check.Check.typeOf.object("transform", transform);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- result.center = Matrix4.multiplyByPoint(
- transform,
- sphere.center,
- result.center
- );
- result.radius = Matrix4.getMaximumScale(transform) * sphere.radius;
- return result;
- };
- var distanceSquaredToScratch = new Cartesian2.Cartesian3();
- /**
- * Computes the estimated distance squared from the closest point on a bounding sphere to a point.
- *
- * @param {BoundingSphere} sphere The sphere.
- * @param {Cartesian3} cartesian The point
- * @returns {Number} The estimated distance squared from the bounding sphere to the point.
- *
- * @example
- * // Sort bounding spheres from back to front
- * spheres.sort(function(a, b) {
- * return Cesium.BoundingSphere.distanceSquaredTo(b, camera.positionWC) - Cesium.BoundingSphere.distanceSquaredTo(a, camera.positionWC);
- * });
- */
- BoundingSphere.distanceSquaredTo = function (sphere, cartesian) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("sphere", sphere);
- Check.Check.typeOf.object("cartesian", cartesian);
- //>>includeEnd('debug');
- var diff = Cartesian2.Cartesian3.subtract(
- sphere.center,
- cartesian,
- distanceSquaredToScratch
- );
- return Cartesian2.Cartesian3.magnitudeSquared(diff) - sphere.radius * sphere.radius;
- };
- /**
- * Applies a 4x4 affine transformation matrix to a bounding sphere where there is no scale
- * The transformation matrix is not verified to have a uniform scale of 1.
- * This method is faster than computing the general bounding sphere transform using {@link BoundingSphere.transform}.
- *
- * @param {BoundingSphere} sphere The bounding sphere to apply the transformation to.
- * @param {Matrix4} transform The transformation matrix to apply to the bounding sphere.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- *
- * @example
- * var modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(positionOnEllipsoid);
- * var boundingSphere = new Cesium.BoundingSphere();
- * var newBoundingSphere = Cesium.BoundingSphere.transformWithoutScale(boundingSphere, modelMatrix);
- */
- BoundingSphere.transformWithoutScale = function (sphere, transform, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("sphere", sphere);
- Check.Check.typeOf.object("transform", transform);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new BoundingSphere();
- }
- result.center = Matrix4.multiplyByPoint(
- transform,
- sphere.center,
- result.center
- );
- result.radius = sphere.radius;
- return result;
- };
- var scratchCartesian3 = new Cartesian2.Cartesian3();
- /**
- * The distances calculated by the vector from the center of the bounding sphere to position projected onto direction
- * plus/minus the radius of the bounding sphere.
- * <br>
- * If you imagine the infinite number of planes with normal direction, this computes the smallest distance to the
- * closest and farthest planes from position that intersect the bounding sphere.
- *
- * @param {BoundingSphere} sphere The bounding sphere to calculate the distance to.
- * @param {Cartesian3} position The position to calculate the distance from.
- * @param {Cartesian3} direction The direction from position.
- * @param {Interval} [result] A Interval to store the nearest and farthest distances.
- * @returns {Interval} The nearest and farthest distances on the bounding sphere from position in direction.
- */
- BoundingSphere.computePlaneDistances = function (
- sphere,
- position,
- direction,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("sphere", sphere);
- Check.Check.typeOf.object("position", position);
- Check.Check.typeOf.object("direction", direction);
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new Interval();
- }
- var toCenter = Cartesian2.Cartesian3.subtract(
- sphere.center,
- position,
- scratchCartesian3
- );
- var mag = Cartesian2.Cartesian3.dot(direction, toCenter);
- result.start = mag - sphere.radius;
- result.stop = mag + sphere.radius;
- return result;
- };
- var projectTo2DNormalScratch = new Cartesian2.Cartesian3();
- var projectTo2DEastScratch = new Cartesian2.Cartesian3();
- var projectTo2DNorthScratch = new Cartesian2.Cartesian3();
- var projectTo2DWestScratch = new Cartesian2.Cartesian3();
- var projectTo2DSouthScratch = new Cartesian2.Cartesian3();
- var projectTo2DCartographicScratch = new Cartesian2.Cartographic();
- var projectTo2DPositionsScratch = new Array(8);
- for (var n = 0; n < 8; ++n) {
- projectTo2DPositionsScratch[n] = new Cartesian2.Cartesian3();
- }
- var projectTo2DProjection = new GeographicProjection();
- /**
- * Creates a bounding sphere in 2D from a bounding sphere in 3D world coordinates.
- *
- * @param {BoundingSphere} sphere The bounding sphere to transform to 2D.
- * @param {Object} [projection=GeographicProjection] The projection to 2D.
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.projectTo2D = function (sphere, projection, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("sphere", sphere);
- //>>includeEnd('debug');
- projection = when.defaultValue(projection, projectTo2DProjection);
- var ellipsoid = projection.ellipsoid;
- var center = sphere.center;
- var radius = sphere.radius;
- var normal;
- if (Cartesian2.Cartesian3.equals(center, Cartesian2.Cartesian3.ZERO)) {
- // Bounding sphere is at the center. The geodetic surface normal is not
- // defined here so pick the x-axis as a fallback.
- normal = Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.UNIT_X, projectTo2DNormalScratch);
- } else {
- normal = ellipsoid.geodeticSurfaceNormal(center, projectTo2DNormalScratch);
- }
- var east = Cartesian2.Cartesian3.cross(
- Cartesian2.Cartesian3.UNIT_Z,
- normal,
- projectTo2DEastScratch
- );
- Cartesian2.Cartesian3.normalize(east, east);
- var north = Cartesian2.Cartesian3.cross(normal, east, projectTo2DNorthScratch);
- Cartesian2.Cartesian3.normalize(north, north);
- Cartesian2.Cartesian3.multiplyByScalar(normal, radius, normal);
- Cartesian2.Cartesian3.multiplyByScalar(north, radius, north);
- Cartesian2.Cartesian3.multiplyByScalar(east, radius, east);
- var south = Cartesian2.Cartesian3.negate(north, projectTo2DSouthScratch);
- var west = Cartesian2.Cartesian3.negate(east, projectTo2DWestScratch);
- var positions = projectTo2DPositionsScratch;
- // top NE corner
- var corner = positions[0];
- Cartesian2.Cartesian3.add(normal, north, corner);
- Cartesian2.Cartesian3.add(corner, east, corner);
- // top NW corner
- corner = positions[1];
- Cartesian2.Cartesian3.add(normal, north, corner);
- Cartesian2.Cartesian3.add(corner, west, corner);
- // top SW corner
- corner = positions[2];
- Cartesian2.Cartesian3.add(normal, south, corner);
- Cartesian2.Cartesian3.add(corner, west, corner);
- // top SE corner
- corner = positions[3];
- Cartesian2.Cartesian3.add(normal, south, corner);
- Cartesian2.Cartesian3.add(corner, east, corner);
- Cartesian2.Cartesian3.negate(normal, normal);
- // bottom NE corner
- corner = positions[4];
- Cartesian2.Cartesian3.add(normal, north, corner);
- Cartesian2.Cartesian3.add(corner, east, corner);
- // bottom NW corner
- corner = positions[5];
- Cartesian2.Cartesian3.add(normal, north, corner);
- Cartesian2.Cartesian3.add(corner, west, corner);
- // bottom SW corner
- corner = positions[6];
- Cartesian2.Cartesian3.add(normal, south, corner);
- Cartesian2.Cartesian3.add(corner, west, corner);
- // bottom SE corner
- corner = positions[7];
- Cartesian2.Cartesian3.add(normal, south, corner);
- Cartesian2.Cartesian3.add(corner, east, corner);
- var length = positions.length;
- for (var i = 0; i < length; ++i) {
- var position = positions[i];
- Cartesian2.Cartesian3.add(center, position, position);
- var cartographic = ellipsoid.cartesianToCartographic(
- position,
- projectTo2DCartographicScratch
- );
- projection.project(cartographic, position);
- }
- result = BoundingSphere.fromPoints(positions, result);
- // swizzle center components
- center = result.center;
- var x = center.x;
- var y = center.y;
- var z = center.z;
- center.x = z;
- center.y = x;
- center.z = y;
- return result;
- };
- /**
- * Determines whether or not a sphere is hidden from view by the occluder.
- *
- * @param {BoundingSphere} sphere The bounding sphere surrounding the occludee object.
- * @param {Occluder} occluder The occluder.
- * @returns {Boolean} <code>true</code> if the sphere is not visible; otherwise <code>false</code>.
- */
- BoundingSphere.isOccluded = function (sphere, occluder) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("sphere", sphere);
- Check.Check.typeOf.object("occluder", occluder);
- //>>includeEnd('debug');
- return !occluder.isBoundingSphereVisible(sphere);
- };
- /**
- * Compares the provided BoundingSphere componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {BoundingSphere} [left] The first BoundingSphere.
- * @param {BoundingSphere} [right] The second BoundingSphere.
- * @returns {Boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- */
- BoundingSphere.equals = function (left, right) {
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- Cartesian2.Cartesian3.equals(left.center, right.center) &&
- left.radius === right.radius)
- );
- };
- /**
- * Determines which side of a plane the sphere is located.
- *
- * @param {Plane} plane The plane to test against.
- * @returns {Intersect} {@link Intersect.INSIDE} if the entire sphere is on the side of the plane
- * the normal is pointing, {@link Intersect.OUTSIDE} if the entire sphere is
- * on the opposite side, and {@link Intersect.INTERSECTING} if the sphere
- * intersects the plane.
- */
- BoundingSphere.prototype.intersectPlane = function (plane) {
- return BoundingSphere.intersectPlane(this, plane);
- };
- /**
- * Computes the estimated distance squared from the closest point on a bounding sphere to a point.
- *
- * @param {Cartesian3} cartesian The point
- * @returns {Number} The estimated distance squared from the bounding sphere to the point.
- *
- * @example
- * // Sort bounding spheres from back to front
- * spheres.sort(function(a, b) {
- * return b.distanceSquaredTo(camera.positionWC) - a.distanceSquaredTo(camera.positionWC);
- * });
- */
- BoundingSphere.prototype.distanceSquaredTo = function (cartesian) {
- return BoundingSphere.distanceSquaredTo(this, cartesian);
- };
- /**
- * The distances calculated by the vector from the center of the bounding sphere to position projected onto direction
- * plus/minus the radius of the bounding sphere.
- * <br>
- * If you imagine the infinite number of planes with normal direction, this computes the smallest distance to the
- * closest and farthest planes from position that intersect the bounding sphere.
- *
- * @param {Cartesian3} position The position to calculate the distance from.
- * @param {Cartesian3} direction The direction from position.
- * @param {Interval} [result] A Interval to store the nearest and farthest distances.
- * @returns {Interval} The nearest and farthest distances on the bounding sphere from position in direction.
- */
- BoundingSphere.prototype.computePlaneDistances = function (
- position,
- direction,
- result
- ) {
- return BoundingSphere.computePlaneDistances(
- this,
- position,
- direction,
- result
- );
- };
- /**
- * Determines whether or not a sphere is hidden from view by the occluder.
- *
- * @param {Occluder} occluder The occluder.
- * @returns {Boolean} <code>true</code> if the sphere is not visible; otherwise <code>false</code>.
- */
- BoundingSphere.prototype.isOccluded = function (occluder) {
- return BoundingSphere.isOccluded(this, occluder);
- };
- /**
- * Compares this BoundingSphere against the provided BoundingSphere componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {BoundingSphere} [right] The right hand side BoundingSphere.
- * @returns {Boolean} <code>true</code> if they are equal, <code>false</code> otherwise.
- */
- BoundingSphere.prototype.equals = function (right) {
- return BoundingSphere.equals(this, right);
- };
- /**
- * Duplicates this BoundingSphere instance.
- *
- * @param {BoundingSphere} [result] The object onto which to store the result.
- * @returns {BoundingSphere} The modified result parameter or a new BoundingSphere instance if none was provided.
- */
- BoundingSphere.prototype.clone = function (result) {
- return BoundingSphere.clone(this, result);
- };
- /**
- * Computes the radius of the BoundingSphere.
- * @returns {Number} The radius of the BoundingSphere.
- */
- BoundingSphere.prototype.volume = function () {
- var radius = this.radius;
- return volumeConstant * radius * radius * radius;
- };
- var _supportsFullscreen;
- var _names = {
- requestFullscreen: undefined,
- exitFullscreen: undefined,
- fullscreenEnabled: undefined,
- fullscreenElement: undefined,
- fullscreenchange: undefined,
- fullscreenerror: undefined,
- };
- /**
- * Browser-independent functions for working with the standard fullscreen API.
- *
- * @namespace Fullscreen
- *
- * @see {@link http://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html|W3C Fullscreen Living Specification}
- */
- var Fullscreen = {};
- Object.defineProperties(Fullscreen, {
- /**
- * The element that is currently fullscreen, if any. To simply check if the
- * browser is in fullscreen mode or not, use {@link Fullscreen#fullscreen}.
- * @memberof Fullscreen
- * @type {Object}
- * @readonly
- */
- element: {
- get: function () {
- if (!Fullscreen.supportsFullscreen()) {
- return undefined;
- }
- return document[_names.fullscreenElement];
- },
- },
- /**
- * The name of the event on the document that is fired when fullscreen is
- * entered or exited. This event name is intended for use with addEventListener.
- * In your event handler, to determine if the browser is in fullscreen mode or not,
- * use {@link Fullscreen#fullscreen}.
- * @memberof Fullscreen
- * @type {String}
- * @readonly
- */
- changeEventName: {
- get: function () {
- if (!Fullscreen.supportsFullscreen()) {
- return undefined;
- }
- return _names.fullscreenchange;
- },
- },
- /**
- * The name of the event that is fired when a fullscreen error
- * occurs. This event name is intended for use with addEventListener.
- * @memberof Fullscreen
- * @type {String}
- * @readonly
- */
- errorEventName: {
- get: function () {
- if (!Fullscreen.supportsFullscreen()) {
- return undefined;
- }
- return _names.fullscreenerror;
- },
- },
- /**
- * Determine whether the browser will allow an element to be made fullscreen, or not.
- * For example, by default, iframes cannot go fullscreen unless the containing page
- * adds an "allowfullscreen" attribute (or prefixed equivalent).
- * @memberof Fullscreen
- * @type {Boolean}
- * @readonly
- */
- enabled: {
- get: function () {
- if (!Fullscreen.supportsFullscreen()) {
- return undefined;
- }
- return document[_names.fullscreenEnabled];
- },
- },
- /**
- * Determines if the browser is currently in fullscreen mode.
- * @memberof Fullscreen
- * @type {Boolean}
- * @readonly
- */
- fullscreen: {
- get: function () {
- if (!Fullscreen.supportsFullscreen()) {
- return undefined;
- }
- return Fullscreen.element !== null;
- },
- },
- });
- /**
- * Detects whether the browser supports the standard fullscreen API.
- *
- * @returns {Boolean} <code>true</code> if the browser supports the standard fullscreen API,
- * <code>false</code> otherwise.
- */
- Fullscreen.supportsFullscreen = function () {
- if (when.defined(_supportsFullscreen)) {
- return _supportsFullscreen;
- }
- _supportsFullscreen = false;
- var body = document.body;
- if (typeof body.requestFullscreen === "function") {
- // go with the unprefixed, standard set of names
- _names.requestFullscreen = "requestFullscreen";
- _names.exitFullscreen = "exitFullscreen";
- _names.fullscreenEnabled = "fullscreenEnabled";
- _names.fullscreenElement = "fullscreenElement";
- _names.fullscreenchange = "fullscreenchange";
- _names.fullscreenerror = "fullscreenerror";
- _supportsFullscreen = true;
- return _supportsFullscreen;
- }
- //check for the correct combination of prefix plus the various names that browsers use
- var prefixes = ["webkit", "moz", "o", "ms", "khtml"];
- var name;
- for (var i = 0, len = prefixes.length; i < len; ++i) {
- var prefix = prefixes[i];
- // casing of Fullscreen differs across browsers
- name = prefix + "RequestFullscreen";
- if (typeof body[name] === "function") {
- _names.requestFullscreen = name;
- _supportsFullscreen = true;
- } else {
- name = prefix + "RequestFullScreen";
- if (typeof body[name] === "function") {
- _names.requestFullscreen = name;
- _supportsFullscreen = true;
- }
- }
- // disagreement about whether it's "exit" as per spec, or "cancel"
- name = prefix + "ExitFullscreen";
- if (typeof document[name] === "function") {
- _names.exitFullscreen = name;
- } else {
- name = prefix + "CancelFullScreen";
- if (typeof document[name] === "function") {
- _names.exitFullscreen = name;
- }
- }
- // casing of Fullscreen differs across browsers
- name = prefix + "FullscreenEnabled";
- if (document[name] !== undefined) {
- _names.fullscreenEnabled = name;
- } else {
- name = prefix + "FullScreenEnabled";
- if (document[name] !== undefined) {
- _names.fullscreenEnabled = name;
- }
- }
- // casing of Fullscreen differs across browsers
- name = prefix + "FullscreenElement";
- if (document[name] !== undefined) {
- _names.fullscreenElement = name;
- } else {
- name = prefix + "FullScreenElement";
- if (document[name] !== undefined) {
- _names.fullscreenElement = name;
- }
- }
- // thankfully, event names are all lowercase per spec
- name = prefix + "fullscreenchange";
- // event names do not have 'on' in the front, but the property on the document does
- if (document["on" + name] !== undefined) {
- //except on IE
- if (prefix === "ms") {
- name = "MSFullscreenChange";
- }
- _names.fullscreenchange = name;
- }
- name = prefix + "fullscreenerror";
- if (document["on" + name] !== undefined) {
- //except on IE
- if (prefix === "ms") {
- name = "MSFullscreenError";
- }
- _names.fullscreenerror = name;
- }
- }
- return _supportsFullscreen;
- };
- /**
- * Asynchronously requests the browser to enter fullscreen mode on the given element.
- * If fullscreen mode is not supported by the browser, does nothing.
- *
- * @param {Object} element The HTML element which will be placed into fullscreen mode.
- * @param {Object} [vrDevice] The HMDVRDevice device.
- *
- * @example
- * // Put the entire page into fullscreen.
- * Cesium.Fullscreen.requestFullscreen(document.body)
- *
- * // Place only the Cesium canvas into fullscreen.
- * Cesium.Fullscreen.requestFullscreen(scene.canvas)
- */
- Fullscreen.requestFullscreen = function (element, vrDevice) {
- if (!Fullscreen.supportsFullscreen()) {
- return;
- }
- element[_names.requestFullscreen]({ vrDisplay: vrDevice });
- };
- /**
- * Asynchronously exits fullscreen mode. If the browser is not currently
- * in fullscreen, or if fullscreen mode is not supported by the browser, does nothing.
- */
- Fullscreen.exitFullscreen = function () {
- if (!Fullscreen.supportsFullscreen()) {
- return;
- }
- document[_names.exitFullscreen]();
- };
- //For unit tests
- Fullscreen._names = _names;
- var theNavigator;
- if (typeof navigator !== "undefined") {
- theNavigator = navigator;
- } else {
- theNavigator = {};
- }
- function extractVersion(versionString) {
- var parts = versionString.split(".");
- for (var i = 0, len = parts.length; i < len; ++i) {
- parts[i] = parseInt(parts[i], 10);
- }
- return parts;
- }
- var isChromeResult;
- var chromeVersionResult;
- function isChrome() {
- if (!when.defined(isChromeResult)) {
- isChromeResult = false;
- // Edge contains Chrome in the user agent too
- if (!isEdge()) {
- var fields = / Chrome\/([\.0-9]+)/.exec(theNavigator.userAgent);
- if (fields !== null) {
- isChromeResult = true;
- chromeVersionResult = extractVersion(fields[1]);
- }
- }
- }
- return isChromeResult;
- }
- function chromeVersion() {
- return isChrome() && chromeVersionResult;
- }
- var isSafariResult;
- var safariVersionResult;
- function isSafari() {
- if (!when.defined(isSafariResult)) {
- isSafariResult = false;
- // Chrome and Edge contain Safari in the user agent too
- if (
- !isChrome() &&
- !isEdge() &&
- / Safari\/[\.0-9]+/.test(theNavigator.userAgent)
- ) {
- var fields = / Version\/([\.0-9]+)/.exec(theNavigator.userAgent);
- if (fields !== null) {
- isSafariResult = true;
- safariVersionResult = extractVersion(fields[1]);
- }
- }
- }
- return isSafariResult;
- }
- function safariVersion() {
- return isSafari() && safariVersionResult;
- }
- var isWebkitResult;
- var webkitVersionResult;
- function isWebkit() {
- if (!when.defined(isWebkitResult)) {
- isWebkitResult = false;
- var fields = / AppleWebKit\/([\.0-9]+)(\+?)/.exec(theNavigator.userAgent);
- if (fields !== null) {
- isWebkitResult = true;
- webkitVersionResult = extractVersion(fields[1]);
- webkitVersionResult.isNightly = !!fields[2];
- }
- }
- return isWebkitResult;
- }
- function webkitVersion() {
- return isWebkit() && webkitVersionResult;
- }
- var isInternetExplorerResult;
- var internetExplorerVersionResult;
- function isInternetExplorer() {
- if (!when.defined(isInternetExplorerResult)) {
- isInternetExplorerResult = false;
- var fields;
- if (theNavigator.appName === "Microsoft Internet Explorer") {
- fields = /MSIE ([0-9]{1,}[\.0-9]{0,})/.exec(theNavigator.userAgent);
- if (fields !== null) {
- isInternetExplorerResult = true;
- internetExplorerVersionResult = extractVersion(fields[1]);
- }
- } else if (theNavigator.appName === "Netscape") {
- fields = /Trident\/.*rv:([0-9]{1,}[\.0-9]{0,})/.exec(
- theNavigator.userAgent
- );
- if (fields !== null) {
- isInternetExplorerResult = true;
- internetExplorerVersionResult = extractVersion(fields[1]);
- }
- }
- }
- return isInternetExplorerResult;
- }
- function internetExplorerVersion() {
- return isInternetExplorer() && internetExplorerVersionResult;
- }
- var isEdgeResult;
- var edgeVersionResult;
- function isEdge() {
- if (!when.defined(isEdgeResult)) {
- isEdgeResult = false;
- var fields = / Edge\/([\.0-9]+)/.exec(theNavigator.userAgent);
- if (fields !== null) {
- isEdgeResult = true;
- edgeVersionResult = extractVersion(fields[1]);
- }
- }
- return isEdgeResult;
- }
- function edgeVersion() {
- return isEdge() && edgeVersionResult;
- }
- var isFirefoxResult;
- var firefoxVersionResult;
- function isFirefox() {
- if (!when.defined(isFirefoxResult)) {
- isFirefoxResult = false;
- var fields = /Firefox\/([\.0-9]+)/.exec(theNavigator.userAgent);
- if (fields !== null) {
- isFirefoxResult = true;
- firefoxVersionResult = extractVersion(fields[1]);
- }
- }
- return isFirefoxResult;
- }
- var isWindowsResult;
- function isWindows() {
- if (!when.defined(isWindowsResult)) {
- isWindowsResult = /Windows/i.test(theNavigator.appVersion);
- }
- return isWindowsResult;
- }
- function firefoxVersion() {
- return isFirefox() && firefoxVersionResult;
- }
- var hasPointerEvents;
- function supportsPointerEvents() {
- if (!when.defined(hasPointerEvents)) {
- //While navigator.pointerEnabled is deprecated in the W3C specification
- //we still need to use it if it exists in order to support browsers
- //that rely on it, such as the Windows WebBrowser control which defines
- //PointerEvent but sets navigator.pointerEnabled to false.
- //Firefox disabled because of https://github.com/CesiumGS/cesium/issues/6372
- hasPointerEvents =
- !isFirefox() &&
- typeof PointerEvent !== "undefined" &&
- (!when.defined(theNavigator.pointerEnabled) || theNavigator.pointerEnabled);
- }
- return hasPointerEvents;
- }
- var imageRenderingValueResult;
- var supportsImageRenderingPixelatedResult;
- function supportsImageRenderingPixelated() {
- if (!when.defined(supportsImageRenderingPixelatedResult)) {
- var canvas = document.createElement("canvas");
- canvas.setAttribute(
- "style",
- "image-rendering: -moz-crisp-edges;" + "image-rendering: pixelated;"
- );
- //canvas.style.imageRendering will be undefined, null or an empty string on unsupported browsers.
- var tmp = canvas.style.imageRendering;
- supportsImageRenderingPixelatedResult = when.defined(tmp) && tmp !== "";
- if (supportsImageRenderingPixelatedResult) {
- imageRenderingValueResult = tmp;
- }
- }
- return supportsImageRenderingPixelatedResult;
- }
- function imageRenderingValue() {
- return supportsImageRenderingPixelated()
- ? imageRenderingValueResult
- : undefined;
- }
- function supportsWebP() {
- //>>includeStart('debug', pragmas.debug);
- if (!supportsWebP.initialized) {
- throw new Check.DeveloperError(
- "You must call FeatureDetection.supportsWebP.initialize and wait for the promise to resolve before calling FeatureDetection.supportsWebP"
- );
- }
- //>>includeEnd('debug');
- return supportsWebP._result;
- }
- supportsWebP._promise = undefined;
- supportsWebP._result = undefined;
- supportsWebP.initialize = function () {
- // From https://developers.google.com/speed/webp/faq#how_can_i_detect_browser_support_for_webp
- if (when.defined(supportsWebP._promise)) {
- return supportsWebP._promise;
- }
- var supportsWebPDeferred = when.when.defer();
- supportsWebP._promise = supportsWebPDeferred.promise;
- if (isEdge()) {
- // Edge's WebP support with WebGL is incomplete.
- // See bug report: https://developer.microsoft.com/en-us/microsoft-edge/platform/issues/19221241/
- supportsWebP._result = false;
- supportsWebPDeferred.resolve(supportsWebP._result);
- return supportsWebPDeferred.promise;
- }
- var image = new Image();
- image.onload = function () {
- supportsWebP._result = image.width > 0 && image.height > 0;
- supportsWebPDeferred.resolve(supportsWebP._result);
- };
- image.onerror = function () {
- supportsWebP._result = false;
- supportsWebPDeferred.resolve(supportsWebP._result);
- };
- image.src =
- "data:image/webp;base64,UklGRiIAAABXRUJQVlA4IBYAAAAwAQCdASoBAAEADsD+JaQAA3AAAAAA";
- return supportsWebPDeferred.promise;
- };
- Object.defineProperties(supportsWebP, {
- initialized: {
- get: function () {
- return when.defined(supportsWebP._result);
- },
- },
- });
- var typedArrayTypes = [];
- if (typeof ArrayBuffer !== "undefined") {
- typedArrayTypes.push(
- Int8Array,
- Uint8Array,
- Int16Array,
- Uint16Array,
- Int32Array,
- Uint32Array,
- Float32Array,
- Float64Array
- );
- if (typeof Uint8ClampedArray !== "undefined") {
- typedArrayTypes.push(Uint8ClampedArray);
- }
- if (typeof Uint8ClampedArray !== "undefined") {
- typedArrayTypes.push(Uint8ClampedArray);
- }
- }
- /**
- * A set of functions to detect whether the current browser supports
- * various features.
- *
- * @namespace FeatureDetection
- */
- var FeatureDetection = {
- isChrome: isChrome,
- chromeVersion: chromeVersion,
- isSafari: isSafari,
- safariVersion: safariVersion,
- isWebkit: isWebkit,
- webkitVersion: webkitVersion,
- isInternetExplorer: isInternetExplorer,
- internetExplorerVersion: internetExplorerVersion,
- isEdge: isEdge,
- edgeVersion: edgeVersion,
- isFirefox: isFirefox,
- firefoxVersion: firefoxVersion,
- isWindows: isWindows,
- hardwareConcurrency: when.defaultValue(theNavigator.hardwareConcurrency, 3),
- supportsPointerEvents: supportsPointerEvents,
- supportsImageRenderingPixelated: supportsImageRenderingPixelated,
- supportsWebP: supportsWebP,
- imageRenderingValue: imageRenderingValue,
- typedArrayTypes: typedArrayTypes,
- };
- /**
- * Detects whether the current browser supports the full screen standard.
- *
- * @returns {Boolean} true if the browser supports the full screen standard, false if not.
- *
- * @see Fullscreen
- * @see {@link http://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html|W3C Fullscreen Living Specification}
- */
- FeatureDetection.supportsFullscreen = function () {
- return Fullscreen.supportsFullscreen();
- };
- /**
- * Detects whether the current browser supports typed arrays.
- *
- * @returns {Boolean} true if the browser supports typed arrays, false if not.
- *
- * @see {@link http://www.khronos.org/registry/typedarray/specs/latest/|Typed Array Specification}
- */
- FeatureDetection.supportsTypedArrays = function () {
- return typeof ArrayBuffer !== "undefined";
- };
- /**
- * Detects whether the current browser supports Web Workers.
- *
- * @returns {Boolean} true if the browsers supports Web Workers, false if not.
- *
- * @see {@link http://www.w3.org/TR/workers/}
- */
- FeatureDetection.supportsWebWorkers = function () {
- return typeof Worker !== "undefined";
- };
- /**
- * Detects whether the current browser supports Web Assembly.
- *
- * @returns {Boolean} true if the browsers supports Web Assembly, false if not.
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/WebAssembly}
- */
- FeatureDetection.supportsWebAssembly = function () {
- return typeof WebAssembly !== "undefined" && !FeatureDetection.isEdge();
- };
- /**
- * A set of 4-dimensional coordinates used to represent rotation in 3-dimensional space.
- * @alias Quaternion
- * @constructor
- *
- * @param {Number} [x=0.0] The X component.
- * @param {Number} [y=0.0] The Y component.
- * @param {Number} [z=0.0] The Z component.
- * @param {Number} [w=0.0] The W component.
- *
- * @see PackableForInterpolation
- */
- function Quaternion(x, y, z, w) {
- /**
- * The X component.
- * @type {Number}
- * @default 0.0
- */
- this.x = when.defaultValue(x, 0.0);
- /**
- * The Y component.
- * @type {Number}
- * @default 0.0
- */
- this.y = when.defaultValue(y, 0.0);
- /**
- * The Z component.
- * @type {Number}
- * @default 0.0
- */
- this.z = when.defaultValue(z, 0.0);
- /**
- * The W component.
- * @type {Number}
- * @default 0.0
- */
- this.w = when.defaultValue(w, 0.0);
- }
- var fromAxisAngleScratch = new Cartesian2.Cartesian3();
- /**
- * Computes a quaternion representing a rotation around an axis.
- *
- * @param {Cartesian3} axis The axis of rotation.
- * @param {Number} angle The angle in radians to rotate around the axis.
- * @param {Quaternion} [result] The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter or a new Quaternion instance if one was not provided.
- */
- Quaternion.fromAxisAngle = function (axis, angle, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("axis", axis);
- Check.Check.typeOf.number("angle", angle);
- //>>includeEnd('debug');
- var halfAngle = angle / 2.0;
- var s = Math.sin(halfAngle);
- fromAxisAngleScratch = Cartesian2.Cartesian3.normalize(axis, fromAxisAngleScratch);
- var x = fromAxisAngleScratch.x * s;
- var y = fromAxisAngleScratch.y * s;
- var z = fromAxisAngleScratch.z * s;
- var w = Math.cos(halfAngle);
- if (!when.defined(result)) {
- return new Quaternion(x, y, z, w);
- }
- result.x = x;
- result.y = y;
- result.z = z;
- result.w = w;
- return result;
- };
- var fromRotationMatrixNext = [1, 2, 0];
- var fromRotationMatrixQuat = new Array(3);
- /**
- * Computes a Quaternion from the provided Matrix3 instance.
- *
- * @param {Matrix3} matrix The rotation matrix.
- * @param {Quaternion} [result] The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter or a new Quaternion instance if one was not provided.
- *
- * @see Matrix3.fromQuaternion
- */
- Quaternion.fromRotationMatrix = function (matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("matrix", matrix);
- //>>includeEnd('debug');
- var root;
- var x;
- var y;
- var z;
- var w;
- var m00 = matrix[Matrix3.COLUMN0ROW0];
- var m11 = matrix[Matrix3.COLUMN1ROW1];
- var m22 = matrix[Matrix3.COLUMN2ROW2];
- var trace = m00 + m11 + m22;
- if (trace > 0.0) {
- // |w| > 1/2, may as well choose w > 1/2
- root = Math.sqrt(trace + 1.0); // 2w
- w = 0.5 * root;
- root = 0.5 / root; // 1/(4w)
- x = (matrix[Matrix3.COLUMN1ROW2] - matrix[Matrix3.COLUMN2ROW1]) * root;
- y = (matrix[Matrix3.COLUMN2ROW0] - matrix[Matrix3.COLUMN0ROW2]) * root;
- z = (matrix[Matrix3.COLUMN0ROW1] - matrix[Matrix3.COLUMN1ROW0]) * root;
- } else {
- // |w| <= 1/2
- var next = fromRotationMatrixNext;
- var i = 0;
- if (m11 > m00) {
- i = 1;
- }
- if (m22 > m00 && m22 > m11) {
- i = 2;
- }
- var j = next[i];
- var k = next[j];
- root = Math.sqrt(
- matrix[Matrix3.getElementIndex(i, i)] -
- matrix[Matrix3.getElementIndex(j, j)] -
- matrix[Matrix3.getElementIndex(k, k)] +
- 1.0
- );
- var quat = fromRotationMatrixQuat;
- quat[i] = 0.5 * root;
- root = 0.5 / root;
- w =
- (matrix[Matrix3.getElementIndex(k, j)] -
- matrix[Matrix3.getElementIndex(j, k)]) *
- root;
- quat[j] =
- (matrix[Matrix3.getElementIndex(j, i)] +
- matrix[Matrix3.getElementIndex(i, j)]) *
- root;
- quat[k] =
- (matrix[Matrix3.getElementIndex(k, i)] +
- matrix[Matrix3.getElementIndex(i, k)]) *
- root;
- x = -quat[0];
- y = -quat[1];
- z = -quat[2];
- }
- if (!when.defined(result)) {
- return new Quaternion(x, y, z, w);
- }
- result.x = x;
- result.y = y;
- result.z = z;
- result.w = w;
- return result;
- };
- var scratchHPRQuaternion = new Quaternion();
- var scratchHeadingQuaternion = new Quaternion();
- var scratchPitchQuaternion = new Quaternion();
- var scratchRollQuaternion = new Quaternion();
- /**
- * Computes a rotation from the given heading, pitch and roll angles. Heading is the rotation about the
- * negative z axis. Pitch is the rotation about the negative y axis. Roll is the rotation about
- * the positive x axis.
- *
- * @param {HeadingPitchRoll} headingPitchRoll The rotation expressed as a heading, pitch and roll.
- * @param {Quaternion} [result] The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter or a new Quaternion instance if none was provided.
- */
- Quaternion.fromHeadingPitchRoll = function (headingPitchRoll, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("headingPitchRoll", headingPitchRoll);
- //>>includeEnd('debug');
- scratchRollQuaternion = Quaternion.fromAxisAngle(
- Cartesian2.Cartesian3.UNIT_X,
- headingPitchRoll.roll,
- scratchHPRQuaternion
- );
- scratchPitchQuaternion = Quaternion.fromAxisAngle(
- Cartesian2.Cartesian3.UNIT_Y,
- -headingPitchRoll.pitch,
- result
- );
- result = Quaternion.multiply(
- scratchPitchQuaternion,
- scratchRollQuaternion,
- scratchPitchQuaternion
- );
- scratchHeadingQuaternion = Quaternion.fromAxisAngle(
- Cartesian2.Cartesian3.UNIT_Z,
- -headingPitchRoll.heading,
- scratchHPRQuaternion
- );
- return Quaternion.multiply(scratchHeadingQuaternion, result, result);
- };
- var sampledQuaternionAxis = new Cartesian2.Cartesian3();
- var sampledQuaternionRotation = new Cartesian2.Cartesian3();
- var sampledQuaternionTempQuaternion = new Quaternion();
- var sampledQuaternionQuaternion0 = new Quaternion();
- var sampledQuaternionQuaternion0Conjugate = new Quaternion();
- /**
- * The number of elements used to pack the object into an array.
- * @type {Number}
- */
- Quaternion.packedLength = 4;
- /**
- * Stores the provided instance into the provided array.
- *
- * @param {Quaternion} value The value to pack.
- * @param {Number[]} array The array to pack into.
- * @param {Number} [startingIndex=0] The index into the array at which to start packing the elements.
- *
- * @returns {Number[]} The array that was packed into
- */
- Quaternion.pack = function (value, array, startingIndex) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("value", value);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- array[startingIndex++] = value.x;
- array[startingIndex++] = value.y;
- array[startingIndex++] = value.z;
- array[startingIndex] = value.w;
- return array;
- };
- /**
- * Retrieves an instance from a packed array.
- *
- * @param {Number[]} array The packed array.
- * @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
- * @param {Quaternion} [result] The object into which to store the result.
- * @returns {Quaternion} The modified result parameter or a new Quaternion instance if one was not provided.
- */
- Quaternion.unpack = function (array, startingIndex, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- //>>includeEnd('debug');
- startingIndex = when.defaultValue(startingIndex, 0);
- if (!when.defined(result)) {
- result = new Quaternion();
- }
- result.x = array[startingIndex];
- result.y = array[startingIndex + 1];
- result.z = array[startingIndex + 2];
- result.w = array[startingIndex + 3];
- return result;
- };
- /**
- * The number of elements used to store the object into an array in its interpolatable form.
- * @type {Number}
- */
- Quaternion.packedInterpolationLength = 3;
- /**
- * Converts a packed array into a form suitable for interpolation.
- *
- * @param {Number[]} packedArray The packed array.
- * @param {Number} [startingIndex=0] The index of the first element to be converted.
- * @param {Number} [lastIndex=packedArray.length] The index of the last element to be converted.
- * @param {Number[]} [result] The object into which to store the result.
- */
- Quaternion.convertPackedArrayForInterpolation = function (
- packedArray,
- startingIndex,
- lastIndex,
- result
- ) {
- Quaternion.unpack(
- packedArray,
- lastIndex * 4,
- sampledQuaternionQuaternion0Conjugate
- );
- Quaternion.conjugate(
- sampledQuaternionQuaternion0Conjugate,
- sampledQuaternionQuaternion0Conjugate
- );
- for (var i = 0, len = lastIndex - startingIndex + 1; i < len; i++) {
- var offset = i * 3;
- Quaternion.unpack(
- packedArray,
- (startingIndex + i) * 4,
- sampledQuaternionTempQuaternion
- );
- Quaternion.multiply(
- sampledQuaternionTempQuaternion,
- sampledQuaternionQuaternion0Conjugate,
- sampledQuaternionTempQuaternion
- );
- if (sampledQuaternionTempQuaternion.w < 0) {
- Quaternion.negate(
- sampledQuaternionTempQuaternion,
- sampledQuaternionTempQuaternion
- );
- }
- Quaternion.computeAxis(
- sampledQuaternionTempQuaternion,
- sampledQuaternionAxis
- );
- var angle = Quaternion.computeAngle(sampledQuaternionTempQuaternion);
- if (!when.defined(result)) {
- result = [];
- }
- result[offset] = sampledQuaternionAxis.x * angle;
- result[offset + 1] = sampledQuaternionAxis.y * angle;
- result[offset + 2] = sampledQuaternionAxis.z * angle;
- }
- };
- /**
- * Retrieves an instance from a packed array converted with {@link convertPackedArrayForInterpolation}.
- *
- * @param {Number[]} array The array previously packed for interpolation.
- * @param {Number[]} sourceArray The original packed array.
- * @param {Number} [firstIndex=0] The firstIndex used to convert the array.
- * @param {Number} [lastIndex=packedArray.length] The lastIndex used to convert the array.
- * @param {Quaternion} [result] The object into which to store the result.
- * @returns {Quaternion} The modified result parameter or a new Quaternion instance if one was not provided.
- */
- Quaternion.unpackInterpolationResult = function (
- array,
- sourceArray,
- firstIndex,
- lastIndex,
- result
- ) {
- if (!when.defined(result)) {
- result = new Quaternion();
- }
- Cartesian2.Cartesian3.fromArray(array, 0, sampledQuaternionRotation);
- var magnitude = Cartesian2.Cartesian3.magnitude(sampledQuaternionRotation);
- Quaternion.unpack(sourceArray, lastIndex * 4, sampledQuaternionQuaternion0);
- if (magnitude === 0) {
- Quaternion.clone(Quaternion.IDENTITY, sampledQuaternionTempQuaternion);
- } else {
- Quaternion.fromAxisAngle(
- sampledQuaternionRotation,
- magnitude,
- sampledQuaternionTempQuaternion
- );
- }
- return Quaternion.multiply(
- sampledQuaternionTempQuaternion,
- sampledQuaternionQuaternion0,
- result
- );
- };
- /**
- * Duplicates a Quaternion instance.
- *
- * @param {Quaternion} quaternion The quaternion to duplicate.
- * @param {Quaternion} [result] The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter or a new Quaternion instance if one was not provided. (Returns undefined if quaternion is undefined)
- */
- Quaternion.clone = function (quaternion, result) {
- if (!when.defined(quaternion)) {
- return undefined;
- }
- if (!when.defined(result)) {
- return new Quaternion(
- quaternion.x,
- quaternion.y,
- quaternion.z,
- quaternion.w
- );
- }
- result.x = quaternion.x;
- result.y = quaternion.y;
- result.z = quaternion.z;
- result.w = quaternion.w;
- return result;
- };
- /**
- * Computes the conjugate of the provided quaternion.
- *
- * @param {Quaternion} quaternion The quaternion to conjugate.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.conjugate = function (quaternion, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = -quaternion.x;
- result.y = -quaternion.y;
- result.z = -quaternion.z;
- result.w = quaternion.w;
- return result;
- };
- /**
- * Computes magnitude squared for the provided quaternion.
- *
- * @param {Quaternion} quaternion The quaternion to conjugate.
- * @returns {Number} The magnitude squared.
- */
- Quaternion.magnitudeSquared = function (quaternion) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- //>>includeEnd('debug');
- return (
- quaternion.x * quaternion.x +
- quaternion.y * quaternion.y +
- quaternion.z * quaternion.z +
- quaternion.w * quaternion.w
- );
- };
- /**
- * Computes magnitude for the provided quaternion.
- *
- * @param {Quaternion} quaternion The quaternion to conjugate.
- * @returns {Number} The magnitude.
- */
- Quaternion.magnitude = function (quaternion) {
- return Math.sqrt(Quaternion.magnitudeSquared(quaternion));
- };
- /**
- * Computes the normalized form of the provided quaternion.
- *
- * @param {Quaternion} quaternion The quaternion to normalize.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.normalize = function (quaternion, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var inverseMagnitude = 1.0 / Quaternion.magnitude(quaternion);
- var x = quaternion.x * inverseMagnitude;
- var y = quaternion.y * inverseMagnitude;
- var z = quaternion.z * inverseMagnitude;
- var w = quaternion.w * inverseMagnitude;
- result.x = x;
- result.y = y;
- result.z = z;
- result.w = w;
- return result;
- };
- /**
- * Computes the inverse of the provided quaternion.
- *
- * @param {Quaternion} quaternion The quaternion to normalize.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.inverse = function (quaternion, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var magnitudeSquared = Quaternion.magnitudeSquared(quaternion);
- result = Quaternion.conjugate(quaternion, result);
- return Quaternion.multiplyByScalar(result, 1.0 / magnitudeSquared, result);
- };
- /**
- * Computes the componentwise sum of two quaternions.
- *
- * @param {Quaternion} left The first quaternion.
- * @param {Quaternion} right The second quaternion.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.add = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = left.x + right.x;
- result.y = left.y + right.y;
- result.z = left.z + right.z;
- result.w = left.w + right.w;
- return result;
- };
- /**
- * Computes the componentwise difference of two quaternions.
- *
- * @param {Quaternion} left The first quaternion.
- * @param {Quaternion} right The second quaternion.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.subtract = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = left.x - right.x;
- result.y = left.y - right.y;
- result.z = left.z - right.z;
- result.w = left.w - right.w;
- return result;
- };
- /**
- * Negates the provided quaternion.
- *
- * @param {Quaternion} quaternion The quaternion to be negated.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.negate = function (quaternion, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = -quaternion.x;
- result.y = -quaternion.y;
- result.z = -quaternion.z;
- result.w = -quaternion.w;
- return result;
- };
- /**
- * Computes the dot (scalar) product of two quaternions.
- *
- * @param {Quaternion} left The first quaternion.
- * @param {Quaternion} right The second quaternion.
- * @returns {Number} The dot product.
- */
- Quaternion.dot = function (left, right) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- //>>includeEnd('debug');
- return (
- left.x * right.x + left.y * right.y + left.z * right.z + left.w * right.w
- );
- };
- /**
- * Computes the product of two quaternions.
- *
- * @param {Quaternion} left The first quaternion.
- * @param {Quaternion} right The second quaternion.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.multiply = function (left, right, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("left", left);
- Check.Check.typeOf.object("right", right);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var leftX = left.x;
- var leftY = left.y;
- var leftZ = left.z;
- var leftW = left.w;
- var rightX = right.x;
- var rightY = right.y;
- var rightZ = right.z;
- var rightW = right.w;
- var x = leftW * rightX + leftX * rightW + leftY * rightZ - leftZ * rightY;
- var y = leftW * rightY - leftX * rightZ + leftY * rightW + leftZ * rightX;
- var z = leftW * rightZ + leftX * rightY - leftY * rightX + leftZ * rightW;
- var w = leftW * rightW - leftX * rightX - leftY * rightY - leftZ * rightZ;
- result.x = x;
- result.y = y;
- result.z = z;
- result.w = w;
- return result;
- };
- /**
- * Multiplies the provided quaternion componentwise by the provided scalar.
- *
- * @param {Quaternion} quaternion The quaternion to be scaled.
- * @param {Number} scalar The scalar to multiply with.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.multiplyByScalar = function (quaternion, scalar, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- Check.Check.typeOf.number("scalar", scalar);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = quaternion.x * scalar;
- result.y = quaternion.y * scalar;
- result.z = quaternion.z * scalar;
- result.w = quaternion.w * scalar;
- return result;
- };
- /**
- * Divides the provided quaternion componentwise by the provided scalar.
- *
- * @param {Quaternion} quaternion The quaternion to be divided.
- * @param {Number} scalar The scalar to divide by.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.divideByScalar = function (quaternion, scalar, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- Check.Check.typeOf.number("scalar", scalar);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- result.x = quaternion.x / scalar;
- result.y = quaternion.y / scalar;
- result.z = quaternion.z / scalar;
- result.w = quaternion.w / scalar;
- return result;
- };
- /**
- * Computes the axis of rotation of the provided quaternion.
- *
- * @param {Quaternion} quaternion The quaternion to use.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- */
- Quaternion.computeAxis = function (quaternion, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var w = quaternion.w;
- if (Math.abs(w - 1.0) < _Math.CesiumMath.EPSILON6) {
- result.x = result.y = result.z = 0;
- return result;
- }
- var scalar = 1.0 / Math.sqrt(1.0 - w * w);
- result.x = quaternion.x * scalar;
- result.y = quaternion.y * scalar;
- result.z = quaternion.z * scalar;
- return result;
- };
- /**
- * Computes the angle of rotation of the provided quaternion.
- *
- * @param {Quaternion} quaternion The quaternion to use.
- * @returns {Number} The angle of rotation.
- */
- Quaternion.computeAngle = function (quaternion) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- //>>includeEnd('debug');
- if (Math.abs(quaternion.w - 1.0) < _Math.CesiumMath.EPSILON6) {
- return 0.0;
- }
- return 2.0 * Math.acos(quaternion.w);
- };
- var lerpScratch$1 = new Quaternion();
- /**
- * Computes the linear interpolation or extrapolation at t using the provided quaternions.
- *
- * @param {Quaternion} start The value corresponding to t at 0.0.
- * @param {Quaternion} end The value corresponding to t at 1.0.
- * @param {Number} t The point along t at which to interpolate.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.lerp = function (start, end, t, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("start", start);
- Check.Check.typeOf.object("end", end);
- Check.Check.typeOf.number("t", t);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- lerpScratch$1 = Quaternion.multiplyByScalar(end, t, lerpScratch$1);
- result = Quaternion.multiplyByScalar(start, 1.0 - t, result);
- return Quaternion.add(lerpScratch$1, result, result);
- };
- var slerpEndNegated = new Quaternion();
- var slerpScaledP = new Quaternion();
- var slerpScaledR = new Quaternion();
- /**
- * Computes the spherical linear interpolation or extrapolation at t using the provided quaternions.
- *
- * @param {Quaternion} start The value corresponding to t at 0.0.
- * @param {Quaternion} end The value corresponding to t at 1.0.
- * @param {Number} t The point along t at which to interpolate.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- *
- * @see Quaternion#fastSlerp
- */
- Quaternion.slerp = function (start, end, t, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("start", start);
- Check.Check.typeOf.object("end", end);
- Check.Check.typeOf.number("t", t);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var dot = Quaternion.dot(start, end);
- // The angle between start must be acute. Since q and -q represent
- // the same rotation, negate q to get the acute angle.
- var r = end;
- if (dot < 0.0) {
- dot = -dot;
- r = slerpEndNegated = Quaternion.negate(end, slerpEndNegated);
- }
- // dot > 0, as the dot product approaches 1, the angle between the
- // quaternions vanishes. use linear interpolation.
- if (1.0 - dot < _Math.CesiumMath.EPSILON6) {
- return Quaternion.lerp(start, r, t, result);
- }
- var theta = Math.acos(dot);
- slerpScaledP = Quaternion.multiplyByScalar(
- start,
- Math.sin((1 - t) * theta),
- slerpScaledP
- );
- slerpScaledR = Quaternion.multiplyByScalar(
- r,
- Math.sin(t * theta),
- slerpScaledR
- );
- result = Quaternion.add(slerpScaledP, slerpScaledR, result);
- return Quaternion.multiplyByScalar(result, 1.0 / Math.sin(theta), result);
- };
- /**
- * The logarithmic quaternion function.
- *
- * @param {Quaternion} quaternion The unit quaternion.
- * @param {Cartesian3} result The object onto which to store the result.
- * @returns {Cartesian3} The modified result parameter.
- */
- Quaternion.log = function (quaternion, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("quaternion", quaternion);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var theta = _Math.CesiumMath.acosClamped(quaternion.w);
- var thetaOverSinTheta = 0.0;
- if (theta !== 0.0) {
- thetaOverSinTheta = theta / Math.sin(theta);
- }
- return Cartesian2.Cartesian3.multiplyByScalar(quaternion, thetaOverSinTheta, result);
- };
- /**
- * The exponential quaternion function.
- *
- * @param {Cartesian3} cartesian The cartesian.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- */
- Quaternion.exp = function (cartesian, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("cartesian", cartesian);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var theta = Cartesian2.Cartesian3.magnitude(cartesian);
- var sinThetaOverTheta = 0.0;
- if (theta !== 0.0) {
- sinThetaOverTheta = Math.sin(theta) / theta;
- }
- result.x = cartesian.x * sinThetaOverTheta;
- result.y = cartesian.y * sinThetaOverTheta;
- result.z = cartesian.z * sinThetaOverTheta;
- result.w = Math.cos(theta);
- return result;
- };
- var squadScratchCartesian0 = new Cartesian2.Cartesian3();
- var squadScratchCartesian1 = new Cartesian2.Cartesian3();
- var squadScratchQuaternion0 = new Quaternion();
- var squadScratchQuaternion1 = new Quaternion();
- /**
- * Computes an inner quadrangle point.
- * <p>This will compute quaternions that ensure a squad curve is C<sup>1</sup>.</p>
- *
- * @param {Quaternion} q0 The first quaternion.
- * @param {Quaternion} q1 The second quaternion.
- * @param {Quaternion} q2 The third quaternion.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- *
- * @see Quaternion#squad
- */
- Quaternion.computeInnerQuadrangle = function (q0, q1, q2, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("q0", q0);
- Check.Check.typeOf.object("q1", q1);
- Check.Check.typeOf.object("q2", q2);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var qInv = Quaternion.conjugate(q1, squadScratchQuaternion0);
- Quaternion.multiply(qInv, q2, squadScratchQuaternion1);
- var cart0 = Quaternion.log(squadScratchQuaternion1, squadScratchCartesian0);
- Quaternion.multiply(qInv, q0, squadScratchQuaternion1);
- var cart1 = Quaternion.log(squadScratchQuaternion1, squadScratchCartesian1);
- Cartesian2.Cartesian3.add(cart0, cart1, cart0);
- Cartesian2.Cartesian3.multiplyByScalar(cart0, 0.25, cart0);
- Cartesian2.Cartesian3.negate(cart0, cart0);
- Quaternion.exp(cart0, squadScratchQuaternion0);
- return Quaternion.multiply(q1, squadScratchQuaternion0, result);
- };
- /**
- * Computes the spherical quadrangle interpolation between quaternions.
- *
- * @param {Quaternion} q0 The first quaternion.
- * @param {Quaternion} q1 The second quaternion.
- * @param {Quaternion} s0 The first inner quadrangle.
- * @param {Quaternion} s1 The second inner quadrangle.
- * @param {Number} t The time in [0,1] used to interpolate.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- *
- *
- * @example
- * // 1. compute the squad interpolation between two quaternions on a curve
- * var s0 = Cesium.Quaternion.computeInnerQuadrangle(quaternions[i - 1], quaternions[i], quaternions[i + 1], new Cesium.Quaternion());
- * var s1 = Cesium.Quaternion.computeInnerQuadrangle(quaternions[i], quaternions[i + 1], quaternions[i + 2], new Cesium.Quaternion());
- * var q = Cesium.Quaternion.squad(quaternions[i], quaternions[i + 1], s0, s1, t, new Cesium.Quaternion());
- *
- * // 2. compute the squad interpolation as above but where the first quaternion is a end point.
- * var s1 = Cesium.Quaternion.computeInnerQuadrangle(quaternions[0], quaternions[1], quaternions[2], new Cesium.Quaternion());
- * var q = Cesium.Quaternion.squad(quaternions[0], quaternions[1], quaternions[0], s1, t, new Cesium.Quaternion());
- *
- * @see Quaternion#computeInnerQuadrangle
- */
- Quaternion.squad = function (q0, q1, s0, s1, t, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("q0", q0);
- Check.Check.typeOf.object("q1", q1);
- Check.Check.typeOf.object("s0", s0);
- Check.Check.typeOf.object("s1", s1);
- Check.Check.typeOf.number("t", t);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var slerp0 = Quaternion.slerp(q0, q1, t, squadScratchQuaternion0);
- var slerp1 = Quaternion.slerp(s0, s1, t, squadScratchQuaternion1);
- return Quaternion.slerp(slerp0, slerp1, 2.0 * t * (1.0 - t), result);
- };
- var fastSlerpScratchQuaternion = new Quaternion();
- var opmu = 1.90110745351730037;
- var u = FeatureDetection.supportsTypedArrays() ? new Float32Array(8) : [];
- var v = FeatureDetection.supportsTypedArrays() ? new Float32Array(8) : [];
- var bT = FeatureDetection.supportsTypedArrays() ? new Float32Array(8) : [];
- var bD = FeatureDetection.supportsTypedArrays() ? new Float32Array(8) : [];
- for (var i = 0; i < 7; ++i) {
- var s = i + 1.0;
- var t = 2.0 * s + 1.0;
- u[i] = 1.0 / (s * t);
- v[i] = s / t;
- }
- u[7] = opmu / (8.0 * 17.0);
- v[7] = (opmu * 8.0) / 17.0;
- /**
- * Computes the spherical linear interpolation or extrapolation at t using the provided quaternions.
- * This implementation is faster than {@link Quaternion#slerp}, but is only accurate up to 10<sup>-6</sup>.
- *
- * @param {Quaternion} start The value corresponding to t at 0.0.
- * @param {Quaternion} end The value corresponding to t at 1.0.
- * @param {Number} t The point along t at which to interpolate.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter.
- *
- * @see Quaternion#slerp
- */
- Quaternion.fastSlerp = function (start, end, t, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("start", start);
- Check.Check.typeOf.object("end", end);
- Check.Check.typeOf.number("t", t);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var x = Quaternion.dot(start, end);
- var sign;
- if (x >= 0) {
- sign = 1.0;
- } else {
- sign = -1.0;
- x = -x;
- }
- var xm1 = x - 1.0;
- var d = 1.0 - t;
- var sqrT = t * t;
- var sqrD = d * d;
- for (var i = 7; i >= 0; --i) {
- bT[i] = (u[i] * sqrT - v[i]) * xm1;
- bD[i] = (u[i] * sqrD - v[i]) * xm1;
- }
- var cT =
- sign *
- t *
- (1.0 +
- bT[0] *
- (1.0 +
- bT[1] *
- (1.0 +
- bT[2] *
- (1.0 +
- bT[3] *
- (1.0 +
- bT[4] *
- (1.0 + bT[5] * (1.0 + bT[6] * (1.0 + bT[7]))))))));
- var cD =
- d *
- (1.0 +
- bD[0] *
- (1.0 +
- bD[1] *
- (1.0 +
- bD[2] *
- (1.0 +
- bD[3] *
- (1.0 +
- bD[4] *
- (1.0 + bD[5] * (1.0 + bD[6] * (1.0 + bD[7]))))))));
- var temp = Quaternion.multiplyByScalar(start, cD, fastSlerpScratchQuaternion);
- Quaternion.multiplyByScalar(end, cT, result);
- return Quaternion.add(temp, result, result);
- };
- /**
- * Computes the spherical quadrangle interpolation between quaternions.
- * An implementation that is faster than {@link Quaternion#squad}, but less accurate.
- *
- * @param {Quaternion} q0 The first quaternion.
- * @param {Quaternion} q1 The second quaternion.
- * @param {Quaternion} s0 The first inner quadrangle.
- * @param {Quaternion} s1 The second inner quadrangle.
- * @param {Number} t The time in [0,1] used to interpolate.
- * @param {Quaternion} result The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter or a new instance if none was provided.
- *
- * @see Quaternion#squad
- */
- Quaternion.fastSquad = function (q0, q1, s0, s1, t, result) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("q0", q0);
- Check.Check.typeOf.object("q1", q1);
- Check.Check.typeOf.object("s0", s0);
- Check.Check.typeOf.object("s1", s1);
- Check.Check.typeOf.number("t", t);
- Check.Check.typeOf.object("result", result);
- //>>includeEnd('debug');
- var slerp0 = Quaternion.fastSlerp(q0, q1, t, squadScratchQuaternion0);
- var slerp1 = Quaternion.fastSlerp(s0, s1, t, squadScratchQuaternion1);
- return Quaternion.fastSlerp(slerp0, slerp1, 2.0 * t * (1.0 - t), result);
- };
- /**
- * Compares the provided quaternions componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {Quaternion} [left] The first quaternion.
- * @param {Quaternion} [right] The second quaternion.
- * @returns {Boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- */
- Quaternion.equals = function (left, right) {
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- left.x === right.x &&
- left.y === right.y &&
- left.z === right.z &&
- left.w === right.w)
- );
- };
- /**
- * Compares the provided quaternions componentwise and returns
- * <code>true</code> if they are within the provided epsilon,
- * <code>false</code> otherwise.
- *
- * @param {Quaternion} [left] The first quaternion.
- * @param {Quaternion} [right] The second quaternion.
- * @param {Number} [epsilon=0] The epsilon to use for equality testing.
- * @returns {Boolean} <code>true</code> if left and right are within the provided epsilon, <code>false</code> otherwise.
- */
- Quaternion.equalsEpsilon = function (left, right, epsilon) {
- epsilon = when.defaultValue(epsilon, 0);
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- Math.abs(left.x - right.x) <= epsilon &&
- Math.abs(left.y - right.y) <= epsilon &&
- Math.abs(left.z - right.z) <= epsilon &&
- Math.abs(left.w - right.w) <= epsilon)
- );
- };
- /**
- * An immutable Quaternion instance initialized to (0.0, 0.0, 0.0, 0.0).
- *
- * @type {Quaternion}
- * @constant
- */
- Quaternion.ZERO = Object.freeze(new Quaternion(0.0, 0.0, 0.0, 0.0));
- /**
- * An immutable Quaternion instance initialized to (0.0, 0.0, 0.0, 1.0).
- *
- * @type {Quaternion}
- * @constant
- */
- Quaternion.IDENTITY = Object.freeze(new Quaternion(0.0, 0.0, 0.0, 1.0));
- /**
- * Duplicates this Quaternion instance.
- *
- * @param {Quaternion} [result] The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter or a new Quaternion instance if one was not provided.
- */
- Quaternion.prototype.clone = function (result) {
- return Quaternion.clone(this, result);
- };
- /**
- * Compares this and the provided quaternion componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {Quaternion} [right] The right hand side quaternion.
- * @returns {Boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- */
- Quaternion.prototype.equals = function (right) {
- return Quaternion.equals(this, right);
- };
- /**
- * Compares this and the provided quaternion componentwise and returns
- * <code>true</code> if they are within the provided epsilon,
- * <code>false</code> otherwise.
- *
- * @param {Quaternion} [right] The right hand side quaternion.
- * @param {Number} [epsilon=0] The epsilon to use for equality testing.
- * @returns {Boolean} <code>true</code> if left and right are within the provided epsilon, <code>false</code> otherwise.
- */
- Quaternion.prototype.equalsEpsilon = function (right, epsilon) {
- return Quaternion.equalsEpsilon(this, right, epsilon);
- };
- /**
- * Returns a string representing this quaternion in the format (x, y, z, w).
- *
- * @returns {String} A string representing this Quaternion.
- */
- Quaternion.prototype.toString = function () {
- return "(" + this.x + ", " + this.y + ", " + this.z + ", " + this.w + ")";
- };
- /**
- * Finds an item in a sorted array.
- *
- * @function
- * @param {Array} array The sorted array to search.
- * @param {*} itemToFind The item to find in the array.
- * @param {binarySearchComparator} comparator The function to use to compare the item to
- * elements in the array.
- * @returns {Number} The index of <code>itemToFind</code> in the array, if it exists. If <code>itemToFind</code>
- * does not exist, the return value is a negative number which is the bitwise complement (~)
- * of the index before which the itemToFind should be inserted in order to maintain the
- * sorted order of the array.
- *
- * @example
- * // Create a comparator function to search through an array of numbers.
- * function comparator(a, b) {
- * return a - b;
- * };
- * var numbers = [0, 2, 4, 6, 8];
- * var index = Cesium.binarySearch(numbers, 6, comparator); // 3
- */
- function binarySearch(array, itemToFind, comparator) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("array", array);
- Check.Check.defined("itemToFind", itemToFind);
- Check.Check.defined("comparator", comparator);
- //>>includeEnd('debug');
- var low = 0;
- var high = array.length - 1;
- var i;
- var comparison;
- while (low <= high) {
- i = ~~((low + high) / 2);
- comparison = comparator(array[i], itemToFind);
- if (comparison < 0) {
- low = i + 1;
- continue;
- }
- if (comparison > 0) {
- high = i - 1;
- continue;
- }
- return i;
- }
- return ~(high + 1);
- }
- /**
- * A set of Earth Orientation Parameters (EOP) sampled at a time.
- *
- * @alias EarthOrientationParametersSample
- * @constructor
- *
- * @param {Number} xPoleWander The pole wander about the X axis, in radians.
- * @param {Number} yPoleWander The pole wander about the Y axis, in radians.
- * @param {Number} xPoleOffset The offset to the Celestial Intermediate Pole (CIP) about the X axis, in radians.
- * @param {Number} yPoleOffset The offset to the Celestial Intermediate Pole (CIP) about the Y axis, in radians.
- * @param {Number} ut1MinusUtc The difference in time standards, UT1 - UTC, in seconds.
- *
- * @private
- */
- function EarthOrientationParametersSample(
- xPoleWander,
- yPoleWander,
- xPoleOffset,
- yPoleOffset,
- ut1MinusUtc
- ) {
- /**
- * The pole wander about the X axis, in radians.
- * @type {Number}
- */
- this.xPoleWander = xPoleWander;
- /**
- * The pole wander about the Y axis, in radians.
- * @type {Number}
- */
- this.yPoleWander = yPoleWander;
- /**
- * The offset to the Celestial Intermediate Pole (CIP) about the X axis, in radians.
- * @type {Number}
- */
- this.xPoleOffset = xPoleOffset;
- /**
- * The offset to the Celestial Intermediate Pole (CIP) about the Y axis, in radians.
- * @type {Number}
- */
- this.yPoleOffset = yPoleOffset;
- /**
- * The difference in time standards, UT1 - UTC, in seconds.
- * @type {Number}
- */
- this.ut1MinusUtc = ut1MinusUtc;
- }
- /**
- @license
- sprintf.js from the php.js project - https://github.com/kvz/phpjs
- Directly from https://github.com/kvz/phpjs/blob/master/functions/strings/sprintf.js
- php.js is copyright 2012 Kevin van Zonneveld.
- Portions copyright Brett Zamir (http://brett-zamir.me), Kevin van Zonneveld
- (http://kevin.vanzonneveld.net), Onno Marsman, Theriault, Michael White
- (http://getsprink.com), Waldo Malqui Silva, Paulo Freitas, Jack, Jonas
- Raoni Soares Silva (http://www.jsfromhell.com), Philip Peterson, Legaev
- Andrey, Ates Goral (http://magnetiq.com), Alex, Ratheous, Martijn Wieringa,
- Rafa? Kukawski (http://blog.kukawski.pl), lmeyrick
- (https://sourceforge.net/projects/bcmath-js/), Nate, Philippe Baumann,
- Enrique Gonzalez, Webtoolkit.info (http://www.webtoolkit.info/), Carlos R.
- L. Rodrigues (http://www.jsfromhell.com), Ash Searle
- (http://hexmen.com/blog/), Jani Hartikainen, travc, Ole Vrijenhoek,
- Erkekjetter, Michael Grier, Rafa? Kukawski (http://kukawski.pl), Johnny
- Mast (http://www.phpvrouwen.nl), T.Wild, d3x,
- http://stackoverflow.com/questions/57803/how-to-convert-decimal-to-hex-in-javascript,
- Rafa? Kukawski (http://blog.kukawski.pl/), stag019, pilus, WebDevHobo
- (http://webdevhobo.blogspot.com/), marrtins, GeekFG
- (http://geekfg.blogspot.com), Andrea Giammarchi
- (http://webreflection.blogspot.com), Arpad Ray (mailto:arpad@php.net),
- gorthaur, Paul Smith, Tim de Koning (http://www.kingsquare.nl), Joris, Oleg
- Eremeev, Steve Hilder, majak, gettimeofday, KELAN, Josh Fraser
- (http://onlineaspect.com/2007/06/08/auto-detect-a-time-zone-with-javascript/),
- Marc Palau, Martin
- (http://www.erlenwiese.de/), Breaking Par Consulting Inc
- (http://www.breakingpar.com/bkp/home.nsf/0/87256B280015193F87256CFB006C45F7),
- Chris, Mirek Slugen, saulius, Alfonso Jimenez
- (http://www.alfonsojimenez.com), Diplom@t (http://difane.com/), felix,
- Mailfaker (http://www.weedem.fr/), Tyler Akins (http://rumkin.com), Caio
- Ariede (http://caioariede.com), Robin, Kankrelune
- (http://www.webfaktory.info/), Karol Kowalski, Imgen Tata
- (http://www.myipdf.com/), mdsjack (http://www.mdsjack.bo.it), Dreamer,
- Felix Geisendoerfer (http://www.debuggable.com/felix), Lars Fischer, AJ,
- David, Aman Gupta, Michael White, Public Domain
- (http://www.json.org/json2.js), Steven Levithan
- (http://blog.stevenlevithan.com), Sakimori, Pellentesque Malesuada,
- Thunder.m, Dj (http://phpjs.org/functions/htmlentities:425#comment_134018),
- Steve Clay, David James, Francois, class_exists, nobbler, T. Wild, Itsacon
- (http://www.itsacon.net/), date, Ole Vrijenhoek (http://www.nervous.nl/),
- Fox, Raphael (Ao RUDLER), Marco, noname, Mateusz "loonquawl" Zalega, Frank
- Forte, Arno, ger, mktime, john (http://www.jd-tech.net), Nick Kolosov
- (http://sammy.ru), marc andreu, Scott Cariss, Douglas Crockford
- (http://javascript.crockford.com), madipta, Slawomir Kaniecki,
- ReverseSyntax, Nathan, Alex Wilson, kenneth, Bayron Guevara, Adam Wallner
- (http://web2.bitbaro.hu/), paulo kuong, jmweb, Lincoln Ramsay, djmix,
- Pyerre, Jon Hohle, Thiago Mata (http://thiagomata.blog.com), lmeyrick
- (https://sourceforge.net/projects/bcmath-js/this.), Linuxworld, duncan,
- Gilbert, Sanjoy Roy, Shingo, sankai, Oskar Larsson H?gfeldt
- (http://oskar-lh.name/), Denny Wardhana, 0m3r, Everlasto, Subhasis Deb,
- josh, jd, Pier Paolo Ramon (http://www.mastersoup.com/), P, merabi, Soren
- Hansen, Eugene Bulkin (http://doubleaw.com/), Der Simon
- (http://innerdom.sourceforge.net/), echo is bad, Ozh, XoraX
- (http://www.xorax.info), EdorFaus, JB, J A R, Marc Jansen, Francesco, LH,
- Stoyan Kyosev (http://www.svest.org/), nord_ua, omid
- (http://phpjs.org/functions/380:380#comment_137122), Brad Touesnard, MeEtc
- (http://yass.meetcweb.com), Peter-Paul Koch
- (http://www.quirksmode.org/js/beat.html), Olivier Louvignes
- (http://mg-crea.com/), T0bsn, Tim Wiel, Bryan Elliott, Jalal Berrami,
- Martin, JT, David Randall, Thomas Beaucourt (http://www.webapp.fr), taith,
- vlado houba, Pierre-Luc Paour, Kristof Coomans (SCK-CEN Belgian Nucleair
- Research Centre), Martin Pool, Kirk Strobeck, Rick Waldron, Brant Messenger
- (http://www.brantmessenger.com/), Devan Penner-Woelk, Saulo Vallory, Wagner
- B. Soares, Artur Tchernychev, Valentina De Rosa, Jason Wong
- (http://carrot.org/), Christoph, Daniel Esteban, strftime, Mick@el, rezna,
- Simon Willison (http://simonwillison.net), Anton Ongson, Gabriel Paderni,
- Marco van Oort, penutbutterjelly, Philipp Lenssen, Bjorn Roesbeke
- (http://www.bjornroesbeke.be/), Bug?, Eric Nagel, Tomasz Wesolowski,
- Evertjan Garretsen, Bobby Drake, Blues (http://tech.bluesmoon.info/), Luke
- Godfrey, Pul, uestla, Alan C, Ulrich, Rafal Kukawski, Yves Sucaet,
- sowberry, Norman "zEh" Fuchs, hitwork, Zahlii, johnrembo, Nick Callen,
- Steven Levithan (stevenlevithan.com), ejsanders, Scott Baker, Brian Tafoya
- (http://www.premasolutions.com/), Philippe Jausions
- (http://pear.php.net/user/jausions), Aidan Lister
- (http://aidanlister.com/), Rob, e-mike, HKM, ChaosNo1, metjay, strcasecmp,
- strcmp, Taras Bogach, jpfle, Alexander Ermolaev
- (http://snippets.dzone.com/user/AlexanderErmolaev), DxGx, kilops, Orlando,
- dptr1988, Le Torbi, James (http://www.james-bell.co.uk/), Pedro Tainha
- (http://www.pedrotainha.com), James, Arnout Kazemier
- (http://www.3rd-Eden.com), Chris McMacken, gabriel paderni, Yannoo,
- FGFEmperor, baris ozdil, Tod Gentille, Greg Frazier, jakes, 3D-GRAF, Allan
- Jensen (http://www.winternet.no), Howard Yeend, Benjamin Lupton, davook,
- daniel airton wermann (http://wermann.com.br), Atli T¨®r, Maximusya, Ryan
- W Tenney (http://ryan.10e.us), Alexander M Beedie, fearphage
- (http://http/my.opera.com/fearphage/), Nathan Sepulveda, Victor, Matteo,
- Billy, stensi, Cord, Manish, T.J. Leahy, Riddler
- (http://www.frontierwebdev.com/), Rafa? Kukawski, FremyCompany, Matt
- Bradley, Tim de Koning, Luis Salazar (http://www.freaky-media.com/), Diogo
- Resende, Rival, Andrej Pavlovic, Garagoth, Le Torbi
- (http://www.letorbi.de/), Dino, Josep Sanz (http://www.ws3.es/), rem,
- Russell Walker (http://www.nbill.co.uk/), Jamie Beck
- (http://www.terabit.ca/), setcookie, Michael, YUI Library:
- http://developer.yahoo.com/yui/docs/YAHOO.util.DateLocale.html, Blues at
- http://hacks.bluesmoon.info/strftime/strftime.js, Ben
- (http://benblume.co.uk/), DtTvB
- (http://dt.in.th/2008-09-16.string-length-in-bytes.html), Andreas, William,
- meo, incidence, Cagri Ekin, Amirouche, Amir Habibi
- (http://www.residence-mixte.com/), Luke Smith (http://lucassmith.name),
- Kheang Hok Chin (http://www.distantia.ca/), Jay Klehr, Lorenzo Pisani,
- Tony, Yen-Wei Liu, Greenseed, mk.keck, Leslie Hoare, dude, booeyOH, Ben
- Bryan
- Licensed under the MIT (MIT-LICENSE.txt) license.
- Permission is hereby granted, free of charge, to any person obtaining a
- copy of this software and associated documentation files (the
- "Software"), to deal in the Software without restriction, including
- without limitation the rights to use, copy, modify, merge, publish,
- distribute, sublicense, and/or sell copies of the Software, and to
- permit persons to whom the Software is furnished to do so, subject to
- the following conditions:
- The above copyright notice and this permission notice shall be included
- in all copies or substantial portions of the Software.
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
- OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
- IN NO EVENT SHALL KEVIN VAN ZONNEVELD BE LIABLE FOR ANY CLAIM, DAMAGES
- OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
- ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
- OTHER DEALINGS IN THE SOFTWARE.
- */
- function sprintf () {
- // http://kevin.vanzonneveld.net
- // + original by: Ash Searle (http://hexmen.com/blog/)
- // + namespaced by: Michael White (http://getsprink.com)
- // + tweaked by: Jack
- // + improved by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
- // + input by: Paulo Freitas
- // + improved by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
- // + input by: Brett Zamir (http://brett-zamir.me)
- // + improved by: Kevin van Zonneveld (http://kevin.vanzonneveld.net)
- // + improved by: Dj
- // + improved by: Allidylls
- // * example 1: sprintf("%01.2f", 123.1);
- // * returns 1: 123.10
- // * example 2: sprintf("[%10s]", 'monkey');
- // * returns 2: '[ monkey]'
- // * example 3: sprintf("[%'#10s]", 'monkey');
- // * returns 3: '[####monkey]'
- // * example 4: sprintf("%d", 123456789012345);
- // * returns 4: '123456789012345'
- var regex = /%%|%(\d+\$)?([-+\'#0 ]*)(\*\d+\$|\*|\d+)?(\.(\*\d+\$|\*|\d+))?([scboxXuideEfFgG])/g;
- var a = arguments,
- i = 0,
- format = a[i++];
- // pad()
- var pad = function (str, len, chr, leftJustify) {
- if (!chr) {
- chr = ' ';
- }
- var padding = (str.length >= len) ? '' : Array(1 + len - str.length >>> 0).join(chr);
- return leftJustify ? str + padding : padding + str;
- };
- // justify()
- var justify = function (value, prefix, leftJustify, minWidth, zeroPad, customPadChar) {
- var diff = minWidth - value.length;
- if (diff > 0) {
- if (leftJustify || !zeroPad) {
- value = pad(value, minWidth, customPadChar, leftJustify);
- } else {
- value = value.slice(0, prefix.length) + pad('', diff, '0', true) + value.slice(prefix.length);
- }
- }
- return value;
- };
- // formatBaseX()
- var formatBaseX = function (value, base, prefix, leftJustify, minWidth, precision, zeroPad) {
- // Note: casts negative numbers to positive ones
- var number = value >>> 0;
- prefix = prefix && number && {
- '2': '0b',
- '8': '0',
- '16': '0x'
- }[base] || '';
- value = prefix + pad(number.toString(base), precision || 0, '0', false);
- return justify(value, prefix, leftJustify, minWidth, zeroPad);
- };
- // formatString()
- var formatString = function (value, leftJustify, minWidth, precision, zeroPad, customPadChar) {
- if (precision != null) {
- value = value.slice(0, precision);
- }
- return justify(value, '', leftJustify, minWidth, zeroPad, customPadChar);
- };
- // doFormat()
- var doFormat = function (substring, valueIndex, flags, minWidth, _, precision, type) {
- var number;
- var prefix;
- var method;
- var textTransform;
- var value;
- if (substring == '%%') {
- return '%';
- }
- // parse flags
- var leftJustify = false,
- positivePrefix = '',
- zeroPad = false,
- prefixBaseX = false,
- customPadChar = ' ';
- var flagsl = flags.length;
- for (var j = 0; flags && j < flagsl; j++) {
- switch (flags.charAt(j)) {
- case ' ':
- positivePrefix = ' ';
- break;
- case '+':
- positivePrefix = '+';
- break;
- case '-':
- leftJustify = true;
- break;
- case "'":
- customPadChar = flags.charAt(j + 1);
- break;
- case '0':
- zeroPad = true;
- break;
- case '#':
- prefixBaseX = true;
- break;
- }
- }
- // parameters may be null, undefined, empty-string or real valued
- // we want to ignore null, undefined and empty-string values
- if (!minWidth) {
- minWidth = 0;
- } else if (minWidth == '*') {
- minWidth = +a[i++];
- } else if (minWidth.charAt(0) == '*') {
- minWidth = +a[minWidth.slice(1, -1)];
- } else {
- minWidth = +minWidth;
- }
- // Note: undocumented perl feature:
- if (minWidth < 0) {
- minWidth = -minWidth;
- leftJustify = true;
- }
- if (!isFinite(minWidth)) {
- throw new Error('sprintf: (minimum-)width must be finite');
- }
- if (!precision) {
- precision = 'fFeE'.indexOf(type) > -1 ? 6 : (type == 'd') ? 0 : undefined;
- } else if (precision == '*') {
- precision = +a[i++];
- } else if (precision.charAt(0) == '*') {
- precision = +a[precision.slice(1, -1)];
- } else {
- precision = +precision;
- }
- // grab value using valueIndex if required?
- value = valueIndex ? a[valueIndex.slice(0, -1)] : a[i++];
- switch (type) {
- case 's':
- return formatString(String(value), leftJustify, minWidth, precision, zeroPad, customPadChar);
- case 'c':
- return formatString(String.fromCharCode(+value), leftJustify, minWidth, precision, zeroPad);
- case 'b':
- return formatBaseX(value, 2, prefixBaseX, leftJustify, minWidth, precision, zeroPad);
- case 'o':
- return formatBaseX(value, 8, prefixBaseX, leftJustify, minWidth, precision, zeroPad);
- case 'x':
- return formatBaseX(value, 16, prefixBaseX, leftJustify, minWidth, precision, zeroPad);
- case 'X':
- return formatBaseX(value, 16, prefixBaseX, leftJustify, minWidth, precision, zeroPad).toUpperCase();
- case 'u':
- return formatBaseX(value, 10, prefixBaseX, leftJustify, minWidth, precision, zeroPad);
- case 'i':
- case 'd':
- number = +value || 0;
- number = Math.round(number - number % 1); // Plain Math.round doesn't just truncate
- prefix = number < 0 ? '-' : positivePrefix;
- value = prefix + pad(String(Math.abs(number)), precision, '0', false);
- return justify(value, prefix, leftJustify, minWidth, zeroPad);
- case 'e':
- case 'E':
- case 'f': // Should handle locales (as per setlocale)
- case 'F':
- case 'g':
- case 'G':
- number = +value;
- prefix = number < 0 ? '-' : positivePrefix;
- method = ['toExponential', 'toFixed', 'toPrecision']['efg'.indexOf(type.toLowerCase())];
- textTransform = ['toString', 'toUpperCase']['eEfFgG'.indexOf(type) % 2];
- value = prefix + Math.abs(number)[method](precision);
- return justify(value, prefix, leftJustify, minWidth, zeroPad)[textTransform]();
- default:
- return substring;
- }
- };
- return format.replace(regex, doFormat);
- }
- /**
- * Represents a Gregorian date in a more precise format than the JavaScript Date object.
- * In addition to submillisecond precision, this object can also represent leap seconds.
- * @alias GregorianDate
- * @constructor
- *
- * @param {Number} [year] The year as a whole number.
- * @param {Number} [month] The month as a whole number with range [1, 12].
- * @param {Number} [day] The day of the month as a whole number starting at 1.
- * @param {Number} [hour] The hour as a whole number with range [0, 23].
- * @param {Number} [minute] The minute of the hour as a whole number with range [0, 59].
- * @param {Number} [second] The second of the minute as a whole number with range [0, 60], with 60 representing a leap second.
- * @param {Number} [millisecond] The millisecond of the second as a floating point number with range [0.0, 1000.0).
- * @param {Boolean} [isLeapSecond] Whether this time is during a leap second.
- *
- * @see JulianDate#toGregorianDate
- */
- function GregorianDate(
- year,
- month,
- day,
- hour,
- minute,
- second,
- millisecond,
- isLeapSecond
- ) {
- /**
- * Gets or sets the year as a whole number.
- * @type {Number}
- */
- this.year = year;
- /**
- * Gets or sets the month as a whole number with range [1, 12].
- * @type {Number}
- */
- this.month = month;
- /**
- * Gets or sets the day of the month as a whole number starting at 1.
- * @type {Number}
- */
- this.day = day;
- /**
- * Gets or sets the hour as a whole number with range [0, 23].
- * @type {Number}
- */
- this.hour = hour;
- /**
- * Gets or sets the minute of the hour as a whole number with range [0, 59].
- * @type {Number}
- */
- this.minute = minute;
- /**
- * Gets or sets the second of the minute as a whole number with range [0, 60], with 60 representing a leap second.
- * @type {Number}
- */
- this.second = second;
- /**
- * Gets or sets the millisecond of the second as a floating point number with range [0.0, 1000.0).
- * @type {Number}
- */
- this.millisecond = millisecond;
- /**
- * Gets or sets whether this time is during a leap second.
- * @type {Boolean}
- */
- this.isLeapSecond = isLeapSecond;
- }
- /**
- * Determines if a given date is a leap year.
- *
- * @function isLeapYear
- *
- * @param {Number} year The year to be tested.
- * @returns {Boolean} True if <code>year</code> is a leap year.
- *
- * @example
- * var leapYear = Cesium.isLeapYear(2000); // true
- */
- function isLeapYear(year) {
- //>>includeStart('debug', pragmas.debug);
- if (year === null || isNaN(year)) {
- throw new Check.DeveloperError("year is required and must be a number.");
- }
- //>>includeEnd('debug');
- return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
- }
- /**
- * Describes a single leap second, which is constructed from a {@link JulianDate} and a
- * numerical offset representing the number of seconds TAI is ahead of the UTC time standard.
- * @alias LeapSecond
- * @constructor
- *
- * @param {JulianDate} [date] A Julian date representing the time of the leap second.
- * @param {Number} [offset] The cumulative number of seconds that TAI is ahead of UTC at the provided date.
- */
- function LeapSecond(date, offset) {
- /**
- * Gets or sets the date at which this leap second occurs.
- * @type {JulianDate}
- */
- this.julianDate = date;
- /**
- * Gets or sets the cumulative number of seconds between the UTC and TAI time standards at the time
- * of this leap second.
- * @type {Number}
- */
- this.offset = offset;
- }
- /**
- * Constants for time conversions like those done by {@link JulianDate}.
- *
- * @namespace TimeConstants
- *
- * @see JulianDate
- *
- * @private
- */
- var TimeConstants = {
- /**
- * The number of seconds in one millisecond: <code>0.001</code>
- * @type {Number}
- * @constant
- */
- SECONDS_PER_MILLISECOND: 0.001,
- /**
- * The number of seconds in one minute: <code>60</code>.
- * @type {Number}
- * @constant
- */
- SECONDS_PER_MINUTE: 60.0,
- /**
- * The number of minutes in one hour: <code>60</code>.
- * @type {Number}
- * @constant
- */
- MINUTES_PER_HOUR: 60.0,
- /**
- * The number of hours in one day: <code>24</code>.
- * @type {Number}
- * @constant
- */
- HOURS_PER_DAY: 24.0,
- /**
- * The number of seconds in one hour: <code>3600</code>.
- * @type {Number}
- * @constant
- */
- SECONDS_PER_HOUR: 3600.0,
- /**
- * The number of minutes in one day: <code>1440</code>.
- * @type {Number}
- * @constant
- */
- MINUTES_PER_DAY: 1440.0,
- /**
- * The number of seconds in one day, ignoring leap seconds: <code>86400</code>.
- * @type {Number}
- * @constant
- */
- SECONDS_PER_DAY: 86400.0,
- /**
- * The number of days in one Julian century: <code>36525</code>.
- * @type {Number}
- * @constant
- */
- DAYS_PER_JULIAN_CENTURY: 36525.0,
- /**
- * One trillionth of a second.
- * @type {Number}
- * @constant
- */
- PICOSECOND: 0.000000001,
- /**
- * The number of days to subtract from a Julian date to determine the
- * modified Julian date, which gives the number of days since midnight
- * on November 17, 1858.
- * @type {Number}
- * @constant
- */
- MODIFIED_JULIAN_DATE_DIFFERENCE: 2400000.5,
- };
- var TimeConstants$1 = Object.freeze(TimeConstants);
- /**
- * Provides the type of time standards which JulianDate can take as input.
- *
- * @enum {Number}
- *
- * @see JulianDate
- */
- var TimeStandard = {
- /**
- * Represents the coordinated Universal Time (UTC) time standard.
- *
- * UTC is related to TAI according to the relationship
- * <code>UTC = TAI - deltaT</code> where <code>deltaT</code> is the number of leap
- * seconds which have been introduced as of the time in TAI.
- *
- * @type {Number}
- * @constant
- */
- UTC: 0,
- /**
- * Represents the International Atomic Time (TAI) time standard.
- * TAI is the principal time standard to which the other time standards are related.
- *
- * @type {Number}
- * @constant
- */
- TAI: 1,
- };
- var TimeStandard$1 = Object.freeze(TimeStandard);
- var gregorianDateScratch = new GregorianDate();
- var daysInMonth = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
- var daysInLeapFeburary = 29;
- function compareLeapSecondDates(leapSecond, dateToFind) {
- return JulianDate.compare(leapSecond.julianDate, dateToFind.julianDate);
- }
- // we don't really need a leap second instance, anything with a julianDate property will do
- var binarySearchScratchLeapSecond = new LeapSecond();
- function convertUtcToTai(julianDate) {
- //Even though julianDate is in UTC, we'll treat it as TAI and
- //search the leap second table for it.
- binarySearchScratchLeapSecond.julianDate = julianDate;
- var leapSeconds = JulianDate.leapSeconds;
- var index = binarySearch(
- leapSeconds,
- binarySearchScratchLeapSecond,
- compareLeapSecondDates
- );
- if (index < 0) {
- index = ~index;
- }
- if (index >= leapSeconds.length) {
- index = leapSeconds.length - 1;
- }
- var offset = leapSeconds[index].offset;
- if (index > 0) {
- //Now we have the index of the closest leap second that comes on or after our UTC time.
- //However, if the difference between the UTC date being converted and the TAI
- //defined leap second is greater than the offset, we are off by one and need to use
- //the previous leap second.
- var difference = JulianDate.secondsDifference(
- leapSeconds[index].julianDate,
- julianDate
- );
- if (difference > offset) {
- index--;
- offset = leapSeconds[index].offset;
- }
- }
- JulianDate.addSeconds(julianDate, offset, julianDate);
- }
- function convertTaiToUtc(julianDate, result) {
- binarySearchScratchLeapSecond.julianDate = julianDate;
- var leapSeconds = JulianDate.leapSeconds;
- var index = binarySearch(
- leapSeconds,
- binarySearchScratchLeapSecond,
- compareLeapSecondDates
- );
- if (index < 0) {
- index = ~index;
- }
- //All times before our first leap second get the first offset.
- if (index === 0) {
- return JulianDate.addSeconds(julianDate, -leapSeconds[0].offset, result);
- }
- //All times after our leap second get the last offset.
- if (index >= leapSeconds.length) {
- return JulianDate.addSeconds(
- julianDate,
- -leapSeconds[index - 1].offset,
- result
- );
- }
- //Compute the difference between the found leap second and the time we are converting.
- var difference = JulianDate.secondsDifference(
- leapSeconds[index].julianDate,
- julianDate
- );
- if (difference === 0) {
- //The date is in our leap second table.
- return JulianDate.addSeconds(
- julianDate,
- -leapSeconds[index].offset,
- result
- );
- }
- if (difference <= 1.0) {
- //The requested date is during the moment of a leap second, then we cannot convert to UTC
- return undefined;
- }
- //The time is in between two leap seconds, index is the leap second after the date
- //we're converting, so we subtract one to get the correct LeapSecond instance.
- return JulianDate.addSeconds(
- julianDate,
- -leapSeconds[--index].offset,
- result
- );
- }
- function setComponents(wholeDays, secondsOfDay, julianDate) {
- var extraDays = (secondsOfDay / TimeConstants$1.SECONDS_PER_DAY) | 0;
- wholeDays += extraDays;
- secondsOfDay -= TimeConstants$1.SECONDS_PER_DAY * extraDays;
- if (secondsOfDay < 0) {
- wholeDays--;
- secondsOfDay += TimeConstants$1.SECONDS_PER_DAY;
- }
- julianDate.dayNumber = wholeDays;
- julianDate.secondsOfDay = secondsOfDay;
- return julianDate;
- }
- function computeJulianDateComponents(
- year,
- month,
- day,
- hour,
- minute,
- second,
- millisecond
- ) {
- // Algorithm from page 604 of the Explanatory Supplement to the
- // Astronomical Almanac (Seidelmann 1992).
- var a = ((month - 14) / 12) | 0;
- var b = year + 4800 + a;
- var dayNumber =
- (((1461 * b) / 4) | 0) +
- (((367 * (month - 2 - 12 * a)) / 12) | 0) -
- (((3 * (((b + 100) / 100) | 0)) / 4) | 0) +
- day -
- 32075;
- // JulianDates are noon-based
- hour = hour - 12;
- if (hour < 0) {
- hour += 24;
- }
- var secondsOfDay =
- second +
- (hour * TimeConstants$1.SECONDS_PER_HOUR +
- minute * TimeConstants$1.SECONDS_PER_MINUTE +
- millisecond * TimeConstants$1.SECONDS_PER_MILLISECOND);
- if (secondsOfDay >= 43200.0) {
- dayNumber -= 1;
- }
- return [dayNumber, secondsOfDay];
- }
- //Regular expressions used for ISO8601 date parsing.
- //YYYY
- var matchCalendarYear = /^(\d{4})$/;
- //YYYY-MM (YYYYMM is invalid)
- var matchCalendarMonth = /^(\d{4})-(\d{2})$/;
- //YYYY-DDD or YYYYDDD
- var matchOrdinalDate = /^(\d{4})-?(\d{3})$/;
- //YYYY-Www or YYYYWww or YYYY-Www-D or YYYYWwwD
- var matchWeekDate = /^(\d{4})-?W(\d{2})-?(\d{1})?$/;
- //YYYY-MM-DD or YYYYMMDD
- var matchCalendarDate = /^(\d{4})-?(\d{2})-?(\d{2})$/;
- // Match utc offset
- var utcOffset = /([Z+\-])?(\d{2})?:?(\d{2})?$/;
- // Match hours HH or HH.xxxxx
- var matchHours = /^(\d{2})(\.\d+)?/.source + utcOffset.source;
- // Match hours/minutes HH:MM HHMM.xxxxx
- var matchHoursMinutes = /^(\d{2}):?(\d{2})(\.\d+)?/.source + utcOffset.source;
- // Match hours/minutes HH:MM:SS HHMMSS.xxxxx
- var matchHoursMinutesSeconds =
- /^(\d{2}):?(\d{2}):?(\d{2})(\.\d+)?/.source + utcOffset.source;
- var iso8601ErrorMessage = "Invalid ISO 8601 date.";
- /**
- * Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC).
- * For increased precision, this class stores the whole number part of the date and the seconds
- * part of the date in separate components. In order to be safe for arithmetic and represent
- * leap seconds, the date is always stored in the International Atomic Time standard
- * {@link TimeStandard.TAI}.
- * @alias JulianDate
- * @constructor
- *
- * @param {Number} [julianDayNumber=0.0] The Julian Day Number representing the number of whole days. Fractional days will also be handled correctly.
- * @param {Number} [secondsOfDay=0.0] The number of seconds into the current Julian Day Number. Fractional seconds, negative seconds and seconds greater than a day will be handled correctly.
- * @param {TimeStandard} [timeStandard=TimeStandard.UTC] The time standard in which the first two parameters are defined.
- */
- function JulianDate(julianDayNumber, secondsOfDay, timeStandard) {
- /**
- * Gets or sets the number of whole days.
- * @type {Number}
- */
- this.dayNumber = undefined;
- /**
- * Gets or sets the number of seconds into the current day.
- * @type {Number}
- */
- this.secondsOfDay = undefined;
- julianDayNumber = when.defaultValue(julianDayNumber, 0.0);
- secondsOfDay = when.defaultValue(secondsOfDay, 0.0);
- timeStandard = when.defaultValue(timeStandard, TimeStandard$1.UTC);
- //If julianDayNumber is fractional, make it an integer and add the number of seconds the fraction represented.
- var wholeDays = julianDayNumber | 0;
- secondsOfDay =
- secondsOfDay +
- (julianDayNumber - wholeDays) * TimeConstants$1.SECONDS_PER_DAY;
- setComponents(wholeDays, secondsOfDay, this);
- if (timeStandard === TimeStandard$1.UTC) {
- convertUtcToTai(this);
- }
- }
- /**
- * Creates a new instance from a GregorianDate.
- *
- * @param {GregorianDate} date A GregorianDate.
- * @param {JulianDate} [result] An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter or a new instance if none was provided.
- *
- * @exception {DeveloperError} date must be a valid GregorianDate.
- */
- JulianDate.fromGregorianDate = function (date, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!(date instanceof GregorianDate)) {
- throw new Check.DeveloperError("date must be a valid GregorianDate.");
- }
- //>>includeEnd('debug');
- var components = computeJulianDateComponents(
- date.year,
- date.month,
- date.day,
- date.hour,
- date.minute,
- date.second,
- date.millisecond
- );
- if (!when.defined(result)) {
- return new JulianDate(components[0], components[1], TimeStandard$1.UTC);
- }
- setComponents(components[0], components[1], result);
- convertUtcToTai(result);
- return result;
- };
- /**
- * Creates a new instance from a JavaScript Date.
- *
- * @param {Date} date A JavaScript Date.
- * @param {JulianDate} [result] An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter or a new instance if none was provided.
- *
- * @exception {DeveloperError} date must be a valid JavaScript Date.
- */
- JulianDate.fromDate = function (date, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!(date instanceof Date) || isNaN(date.getTime())) {
- throw new Check.DeveloperError("date must be a valid JavaScript Date.");
- }
- //>>includeEnd('debug');
- var components = computeJulianDateComponents(
- date.getUTCFullYear(),
- date.getUTCMonth() + 1,
- date.getUTCDate(),
- date.getUTCHours(),
- date.getUTCMinutes(),
- date.getUTCSeconds(),
- date.getUTCMilliseconds()
- );
- if (!when.defined(result)) {
- return new JulianDate(components[0], components[1], TimeStandard$1.UTC);
- }
- setComponents(components[0], components[1], result);
- convertUtcToTai(result);
- return result;
- };
- /**
- * Creates a new instance from a from an {@link http://en.wikipedia.org/wiki/ISO_8601|ISO 8601} date.
- * This method is superior to <code>Date.parse</code> because it will handle all valid formats defined by the ISO 8601
- * specification, including leap seconds and sub-millisecond times, which discarded by most JavaScript implementations.
- *
- * @param {String} iso8601String An ISO 8601 date.
- * @param {JulianDate} [result] An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter or a new instance if none was provided.
- *
- * @exception {DeveloperError} Invalid ISO 8601 date.
- */
- JulianDate.fromIso8601 = function (iso8601String, result) {
- //>>includeStart('debug', pragmas.debug);
- if (typeof iso8601String !== "string") {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- //>>includeEnd('debug');
- //Comma and decimal point both indicate a fractional number according to ISO 8601,
- //start out by blanket replacing , with . which is the only valid such symbol in JS.
- iso8601String = iso8601String.replace(",", ".");
- //Split the string into its date and time components, denoted by a mandatory T
- var tokens = iso8601String.split("T");
- var year;
- var month = 1;
- var day = 1;
- var hour = 0;
- var minute = 0;
- var second = 0;
- var millisecond = 0;
- //Lacking a time is okay, but a missing date is illegal.
- var date = tokens[0];
- var time = tokens[1];
- var tmp;
- var inLeapYear;
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(date)) {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- var dashCount;
- //>>includeEnd('debug');
- //First match the date against possible regular expressions.
- tokens = date.match(matchCalendarDate);
- if (tokens !== null) {
- //>>includeStart('debug', pragmas.debug);
- dashCount = date.split("-").length - 1;
- if (dashCount > 0 && dashCount !== 2) {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- //>>includeEnd('debug');
- year = +tokens[1];
- month = +tokens[2];
- day = +tokens[3];
- } else {
- tokens = date.match(matchCalendarMonth);
- if (tokens !== null) {
- year = +tokens[1];
- month = +tokens[2];
- } else {
- tokens = date.match(matchCalendarYear);
- if (tokens !== null) {
- year = +tokens[1];
- } else {
- //Not a year/month/day so it must be an ordinal date.
- var dayOfYear;
- tokens = date.match(matchOrdinalDate);
- if (tokens !== null) {
- year = +tokens[1];
- dayOfYear = +tokens[2];
- inLeapYear = isLeapYear(year);
- //This validation is only applicable for this format.
- //>>includeStart('debug', pragmas.debug);
- if (
- dayOfYear < 1 ||
- (inLeapYear && dayOfYear > 366) ||
- (!inLeapYear && dayOfYear > 365)
- ) {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- //>>includeEnd('debug')
- } else {
- tokens = date.match(matchWeekDate);
- if (tokens !== null) {
- //ISO week date to ordinal date from
- //http://en.wikipedia.org/w/index.php?title=ISO_week_date&oldid=474176775
- year = +tokens[1];
- var weekNumber = +tokens[2];
- var dayOfWeek = +tokens[3] || 0;
- //>>includeStart('debug', pragmas.debug);
- dashCount = date.split("-").length - 1;
- if (
- dashCount > 0 &&
- ((!when.defined(tokens[3]) && dashCount !== 1) ||
- (when.defined(tokens[3]) && dashCount !== 2))
- ) {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- //>>includeEnd('debug')
- var january4 = new Date(Date.UTC(year, 0, 4));
- dayOfYear = weekNumber * 7 + dayOfWeek - january4.getUTCDay() - 3;
- } else {
- //None of our regular expressions succeeded in parsing the date properly.
- //>>includeStart('debug', pragmas.debug);
- throw new Check.DeveloperError(iso8601ErrorMessage);
- //>>includeEnd('debug')
- }
- }
- //Split an ordinal date into month/day.
- tmp = new Date(Date.UTC(year, 0, 1));
- tmp.setUTCDate(dayOfYear);
- month = tmp.getUTCMonth() + 1;
- day = tmp.getUTCDate();
- }
- }
- }
- //Now that we have all of the date components, validate them to make sure nothing is out of range.
- inLeapYear = isLeapYear(year);
- //>>includeStart('debug', pragmas.debug);
- if (
- month < 1 ||
- month > 12 ||
- day < 1 ||
- ((month !== 2 || !inLeapYear) && day > daysInMonth[month - 1]) ||
- (inLeapYear && month === 2 && day > daysInLeapFeburary)
- ) {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- //>>includeEnd('debug')
- //Now move onto the time string, which is much simpler.
- //If no time is specified, it is considered the beginning of the day, UTC to match Javascript's implementation.
- var offsetIndex;
- if (when.defined(time)) {
- tokens = time.match(matchHoursMinutesSeconds);
- if (tokens !== null) {
- //>>includeStart('debug', pragmas.debug);
- dashCount = time.split(":").length - 1;
- if (dashCount > 0 && dashCount !== 2 && dashCount !== 3) {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- //>>includeEnd('debug')
- hour = +tokens[1];
- minute = +tokens[2];
- second = +tokens[3];
- millisecond = +(tokens[4] || 0) * 1000.0;
- offsetIndex = 5;
- } else {
- tokens = time.match(matchHoursMinutes);
- if (tokens !== null) {
- //>>includeStart('debug', pragmas.debug);
- dashCount = time.split(":").length - 1;
- if (dashCount > 2) {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- //>>includeEnd('debug')
- hour = +tokens[1];
- minute = +tokens[2];
- second = +(tokens[3] || 0) * 60.0;
- offsetIndex = 4;
- } else {
- tokens = time.match(matchHours);
- if (tokens !== null) {
- hour = +tokens[1];
- minute = +(tokens[2] || 0) * 60.0;
- offsetIndex = 3;
- } else {
- //>>includeStart('debug', pragmas.debug);
- throw new Check.DeveloperError(iso8601ErrorMessage);
- //>>includeEnd('debug')
- }
- }
- }
- //Validate that all values are in proper range. Minutes and hours have special cases at 60 and 24.
- //>>includeStart('debug', pragmas.debug);
- if (
- minute >= 60 ||
- second >= 61 ||
- hour > 24 ||
- (hour === 24 && (minute > 0 || second > 0 || millisecond > 0))
- ) {
- throw new Check.DeveloperError(iso8601ErrorMessage);
- }
- //>>includeEnd('debug');
- //Check the UTC offset value, if no value exists, use local time
- //a Z indicates UTC, + or - are offsets.
- var offset = tokens[offsetIndex];
- var offsetHours = +tokens[offsetIndex + 1];
- var offsetMinutes = +(tokens[offsetIndex + 2] || 0);
- switch (offset) {
- case "+":
- hour = hour - offsetHours;
- minute = minute - offsetMinutes;
- break;
- case "-":
- hour = hour + offsetHours;
- minute = minute + offsetMinutes;
- break;
- case "Z":
- break;
- default:
- minute =
- minute +
- new Date(
- Date.UTC(year, month - 1, day, hour, minute)
- ).getTimezoneOffset();
- break;
- }
- }
- //ISO8601 denotes a leap second by any time having a seconds component of 60 seconds.
- //If that's the case, we need to temporarily subtract a second in order to build a UTC date.
- //Then we add it back in after converting to TAI.
- var isLeapSecond = second === 60;
- if (isLeapSecond) {
- second--;
- }
- //Even if we successfully parsed the string into its components, after applying UTC offset or
- //special cases like 24:00:00 denoting midnight, we need to normalize the data appropriately.
- //milliseconds can never be greater than 1000, and seconds can't be above 60, so we start with minutes
- while (minute >= 60) {
- minute -= 60;
- hour++;
- }
- while (hour >= 24) {
- hour -= 24;
- day++;
- }
- tmp = inLeapYear && month === 2 ? daysInLeapFeburary : daysInMonth[month - 1];
- while (day > tmp) {
- day -= tmp;
- month++;
- if (month > 12) {
- month -= 12;
- year++;
- }
- tmp =
- inLeapYear && month === 2 ? daysInLeapFeburary : daysInMonth[month - 1];
- }
- //If UTC offset is at the beginning/end of the day, minutes can be negative.
- while (minute < 0) {
- minute += 60;
- hour--;
- }
- while (hour < 0) {
- hour += 24;
- day--;
- }
- while (day < 1) {
- month--;
- if (month < 1) {
- month += 12;
- year--;
- }
- tmp =
- inLeapYear && month === 2 ? daysInLeapFeburary : daysInMonth[month - 1];
- day += tmp;
- }
- //Now create the JulianDate components from the Gregorian date and actually create our instance.
- var components = computeJulianDateComponents(
- year,
- month,
- day,
- hour,
- minute,
- second,
- millisecond
- );
- if (!when.defined(result)) {
- result = new JulianDate(components[0], components[1], TimeStandard$1.UTC);
- } else {
- setComponents(components[0], components[1], result);
- convertUtcToTai(result);
- }
- //If we were on a leap second, add it back.
- if (isLeapSecond) {
- JulianDate.addSeconds(result, 1, result);
- }
- return result;
- };
- /**
- * Creates a new instance that represents the current system time.
- * This is equivalent to calling <code>JulianDate.fromDate(new Date());</code>.
- *
- * @param {JulianDate} [result] An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter or a new instance if none was provided.
- */
- JulianDate.now = function (result) {
- return JulianDate.fromDate(new Date(), result);
- };
- var toGregorianDateScratch = new JulianDate(0, 0, TimeStandard$1.TAI);
- /**
- * Creates a {@link GregorianDate} from the provided instance.
- *
- * @param {JulianDate} julianDate The date to be converted.
- * @param {GregorianDate} [result] An existing instance to use for the result.
- * @returns {GregorianDate} The modified result parameter or a new instance if none was provided.
- */
- JulianDate.toGregorianDate = function (julianDate, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(julianDate)) {
- throw new Check.DeveloperError("julianDate is required.");
- }
- //>>includeEnd('debug');
- var isLeapSecond = false;
- var thisUtc = convertTaiToUtc(julianDate, toGregorianDateScratch);
- if (!when.defined(thisUtc)) {
- //Conversion to UTC will fail if we are during a leap second.
- //If that's the case, subtract a second and convert again.
- //JavaScript doesn't support leap seconds, so this results in second 59 being repeated twice.
- JulianDate.addSeconds(julianDate, -1, toGregorianDateScratch);
- thisUtc = convertTaiToUtc(toGregorianDateScratch, toGregorianDateScratch);
- isLeapSecond = true;
- }
- var julianDayNumber = thisUtc.dayNumber;
- var secondsOfDay = thisUtc.secondsOfDay;
- if (secondsOfDay >= 43200.0) {
- julianDayNumber += 1;
- }
- // Algorithm from page 604 of the Explanatory Supplement to the
- // Astronomical Almanac (Seidelmann 1992).
- var L = (julianDayNumber + 68569) | 0;
- var N = ((4 * L) / 146097) | 0;
- L = (L - (((146097 * N + 3) / 4) | 0)) | 0;
- var I = ((4000 * (L + 1)) / 1461001) | 0;
- L = (L - (((1461 * I) / 4) | 0) + 31) | 0;
- var J = ((80 * L) / 2447) | 0;
- var day = (L - (((2447 * J) / 80) | 0)) | 0;
- L = (J / 11) | 0;
- var month = (J + 2 - 12 * L) | 0;
- var year = (100 * (N - 49) + I + L) | 0;
- var hour = (secondsOfDay / TimeConstants$1.SECONDS_PER_HOUR) | 0;
- var remainingSeconds = secondsOfDay - hour * TimeConstants$1.SECONDS_PER_HOUR;
- var minute = (remainingSeconds / TimeConstants$1.SECONDS_PER_MINUTE) | 0;
- remainingSeconds =
- remainingSeconds - minute * TimeConstants$1.SECONDS_PER_MINUTE;
- var second = remainingSeconds | 0;
- var millisecond =
- (remainingSeconds - second) / TimeConstants$1.SECONDS_PER_MILLISECOND;
- // JulianDates are noon-based
- hour += 12;
- if (hour > 23) {
- hour -= 24;
- }
- //If we were on a leap second, add it back.
- if (isLeapSecond) {
- second += 1;
- }
- if (!when.defined(result)) {
- return new GregorianDate(
- year,
- month,
- day,
- hour,
- minute,
- second,
- millisecond,
- isLeapSecond
- );
- }
- result.year = year;
- result.month = month;
- result.day = day;
- result.hour = hour;
- result.minute = minute;
- result.second = second;
- result.millisecond = millisecond;
- result.isLeapSecond = isLeapSecond;
- return result;
- };
- /**
- * Creates a JavaScript Date from the provided instance.
- * Since JavaScript dates are only accurate to the nearest millisecond and
- * cannot represent a leap second, consider using {@link JulianDate.toGregorianDate} instead.
- * If the provided JulianDate is during a leap second, the previous second is used.
- *
- * @param {JulianDate} julianDate The date to be converted.
- * @returns {Date} A new instance representing the provided date.
- */
- JulianDate.toDate = function (julianDate) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(julianDate)) {
- throw new Check.DeveloperError("julianDate is required.");
- }
- //>>includeEnd('debug');
- var gDate = JulianDate.toGregorianDate(julianDate, gregorianDateScratch);
- var second = gDate.second;
- if (gDate.isLeapSecond) {
- second -= 1;
- }
- return new Date(
- Date.UTC(
- gDate.year,
- gDate.month - 1,
- gDate.day,
- gDate.hour,
- gDate.minute,
- second,
- gDate.millisecond
- )
- );
- };
- /**
- * Creates an ISO8601 representation of the provided date.
- *
- * @param {JulianDate} julianDate The date to be converted.
- * @param {Number} [precision] The number of fractional digits used to represent the seconds component. By default, the most precise representation is used.
- * @returns {String} The ISO8601 representation of the provided date.
- */
- JulianDate.toIso8601 = function (julianDate, precision) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(julianDate)) {
- throw new Check.DeveloperError("julianDate is required.");
- }
- //>>includeEnd('debug');
- var gDate = JulianDate.toGregorianDate(julianDate, gregorianDateScratch);
- var year = gDate.year;
- var month = gDate.month;
- var day = gDate.day;
- var hour = gDate.hour;
- var minute = gDate.minute;
- var second = gDate.second;
- var millisecond = gDate.millisecond;
- // special case - Iso8601.MAXIMUM_VALUE produces a string which we can't parse unless we adjust.
- // 10000-01-01T00:00:00 is the same instant as 9999-12-31T24:00:00
- if (
- year === 10000 &&
- month === 1 &&
- day === 1 &&
- hour === 0 &&
- minute === 0 &&
- second === 0 &&
- millisecond === 0
- ) {
- year = 9999;
- month = 12;
- day = 31;
- hour = 24;
- }
- var millisecondStr;
- if (!when.defined(precision) && millisecond !== 0) {
- //Forces milliseconds into a number with at least 3 digits to whatever the default toString() precision is.
- millisecondStr = (millisecond * 0.01).toString().replace(".", "");
- return sprintf(
- "%04d-%02d-%02dT%02d:%02d:%02d.%sZ",
- year,
- month,
- day,
- hour,
- minute,
- second,
- millisecondStr
- );
- }
- //Precision is either 0 or milliseconds is 0 with undefined precision, in either case, leave off milliseconds entirely
- if (!when.defined(precision) || precision === 0) {
- return sprintf(
- "%04d-%02d-%02dT%02d:%02d:%02dZ",
- year,
- month,
- day,
- hour,
- minute,
- second
- );
- }
- //Forces milliseconds into a number with at least 3 digits to whatever the specified precision is.
- millisecondStr = (millisecond * 0.01)
- .toFixed(precision)
- .replace(".", "")
- .slice(0, precision);
- return sprintf(
- "%04d-%02d-%02dT%02d:%02d:%02d.%sZ",
- year,
- month,
- day,
- hour,
- minute,
- second,
- millisecondStr
- );
- };
- /**
- * Duplicates a JulianDate instance.
- *
- * @param {JulianDate} julianDate The date to duplicate.
- * @param {JulianDate} [result] An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter or a new instance if none was provided. Returns undefined if julianDate is undefined.
- */
- JulianDate.clone = function (julianDate, result) {
- if (!when.defined(julianDate)) {
- return undefined;
- }
- if (!when.defined(result)) {
- return new JulianDate(
- julianDate.dayNumber,
- julianDate.secondsOfDay,
- TimeStandard$1.TAI
- );
- }
- result.dayNumber = julianDate.dayNumber;
- result.secondsOfDay = julianDate.secondsOfDay;
- return result;
- };
- /**
- * Compares two instances.
- *
- * @param {JulianDate} left The first instance.
- * @param {JulianDate} right The second instance.
- * @returns {Number} A negative value if left is less than right, a positive value if left is greater than right, or zero if left and right are equal.
- */
- JulianDate.compare = function (left, right) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(left)) {
- throw new Check.DeveloperError("left is required.");
- }
- if (!when.defined(right)) {
- throw new Check.DeveloperError("right is required.");
- }
- //>>includeEnd('debug');
- var julianDayNumberDifference = left.dayNumber - right.dayNumber;
- if (julianDayNumberDifference !== 0) {
- return julianDayNumberDifference;
- }
- return left.secondsOfDay - right.secondsOfDay;
- };
- /**
- * Compares two instances and returns <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {JulianDate} [left] The first instance.
- * @param {JulianDate} [right] The second instance.
- * @returns {Boolean} <code>true</code> if the dates are equal; otherwise, <code>false</code>.
- */
- JulianDate.equals = function (left, right) {
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- left.dayNumber === right.dayNumber &&
- left.secondsOfDay === right.secondsOfDay)
- );
- };
- /**
- * Compares two instances and returns <code>true</code> if they are within <code>epsilon</code> seconds of
- * each other. That is, in order for the dates to be considered equal (and for
- * this function to return <code>true</code>), the absolute value of the difference between them, in
- * seconds, must be less than <code>epsilon</code>.
- *
- * @param {JulianDate} [left] The first instance.
- * @param {JulianDate} [right] The second instance.
- * @param {Number} [epsilon=0] The maximum number of seconds that should separate the two instances.
- * @returns {Boolean} <code>true</code> if the two dates are within <code>epsilon</code> seconds of each other; otherwise <code>false</code>.
- */
- JulianDate.equalsEpsilon = function (left, right, epsilon) {
- epsilon = when.defaultValue(epsilon, 0);
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- Math.abs(JulianDate.secondsDifference(left, right)) <= epsilon)
- );
- };
- /**
- * Computes the total number of whole and fractional days represented by the provided instance.
- *
- * @param {JulianDate} julianDate The date.
- * @returns {Number} The Julian date as single floating point number.
- */
- JulianDate.totalDays = function (julianDate) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(julianDate)) {
- throw new Check.DeveloperError("julianDate is required.");
- }
- //>>includeEnd('debug');
- return (
- julianDate.dayNumber +
- julianDate.secondsOfDay / TimeConstants$1.SECONDS_PER_DAY
- );
- };
- /**
- * Computes the difference in seconds between the provided instance.
- *
- * @param {JulianDate} left The first instance.
- * @param {JulianDate} right The second instance.
- * @returns {Number} The difference, in seconds, when subtracting <code>right</code> from <code>left</code>.
- */
- JulianDate.secondsDifference = function (left, right) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(left)) {
- throw new Check.DeveloperError("left is required.");
- }
- if (!when.defined(right)) {
- throw new Check.DeveloperError("right is required.");
- }
- //>>includeEnd('debug');
- var dayDifference =
- (left.dayNumber - right.dayNumber) * TimeConstants$1.SECONDS_PER_DAY;
- return dayDifference + (left.secondsOfDay - right.secondsOfDay);
- };
- /**
- * Computes the difference in days between the provided instance.
- *
- * @param {JulianDate} left The first instance.
- * @param {JulianDate} right The second instance.
- * @returns {Number} The difference, in days, when subtracting <code>right</code> from <code>left</code>.
- */
- JulianDate.daysDifference = function (left, right) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(left)) {
- throw new Check.DeveloperError("left is required.");
- }
- if (!when.defined(right)) {
- throw new Check.DeveloperError("right is required.");
- }
- //>>includeEnd('debug');
- var dayDifference = left.dayNumber - right.dayNumber;
- var secondDifference =
- (left.secondsOfDay - right.secondsOfDay) / TimeConstants$1.SECONDS_PER_DAY;
- return dayDifference + secondDifference;
- };
- /**
- * Computes the number of seconds the provided instance is ahead of UTC.
- *
- * @param {JulianDate} julianDate The date.
- * @returns {Number} The number of seconds the provided instance is ahead of UTC
- */
- JulianDate.computeTaiMinusUtc = function (julianDate) {
- binarySearchScratchLeapSecond.julianDate = julianDate;
- var leapSeconds = JulianDate.leapSeconds;
- var index = binarySearch(
- leapSeconds,
- binarySearchScratchLeapSecond,
- compareLeapSecondDates
- );
- if (index < 0) {
- index = ~index;
- --index;
- if (index < 0) {
- index = 0;
- }
- }
- return leapSeconds[index].offset;
- };
- /**
- * Adds the provided number of seconds to the provided date instance.
- *
- * @param {JulianDate} julianDate The date.
- * @param {Number} seconds The number of seconds to add or subtract.
- * @param {JulianDate} result An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter.
- */
- JulianDate.addSeconds = function (julianDate, seconds, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(julianDate)) {
- throw new Check.DeveloperError("julianDate is required.");
- }
- if (!when.defined(seconds)) {
- throw new Check.DeveloperError("seconds is required.");
- }
- if (!when.defined(result)) {
- throw new Check.DeveloperError("result is required.");
- }
- //>>includeEnd('debug');
- return setComponents(
- julianDate.dayNumber,
- julianDate.secondsOfDay + seconds,
- result
- );
- };
- /**
- * Adds the provided number of minutes to the provided date instance.
- *
- * @param {JulianDate} julianDate The date.
- * @param {Number} minutes The number of minutes to add or subtract.
- * @param {JulianDate} result An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter.
- */
- JulianDate.addMinutes = function (julianDate, minutes, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(julianDate)) {
- throw new Check.DeveloperError("julianDate is required.");
- }
- if (!when.defined(minutes)) {
- throw new Check.DeveloperError("minutes is required.");
- }
- if (!when.defined(result)) {
- throw new Check.DeveloperError("result is required.");
- }
- //>>includeEnd('debug');
- var newSecondsOfDay =
- julianDate.secondsOfDay + minutes * TimeConstants$1.SECONDS_PER_MINUTE;
- return setComponents(julianDate.dayNumber, newSecondsOfDay, result);
- };
- /**
- * Adds the provided number of hours to the provided date instance.
- *
- * @param {JulianDate} julianDate The date.
- * @param {Number} hours The number of hours to add or subtract.
- * @param {JulianDate} result An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter.
- */
- JulianDate.addHours = function (julianDate, hours, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(julianDate)) {
- throw new Check.DeveloperError("julianDate is required.");
- }
- if (!when.defined(hours)) {
- throw new Check.DeveloperError("hours is required.");
- }
- if (!when.defined(result)) {
- throw new Check.DeveloperError("result is required.");
- }
- //>>includeEnd('debug');
- var newSecondsOfDay =
- julianDate.secondsOfDay + hours * TimeConstants$1.SECONDS_PER_HOUR;
- return setComponents(julianDate.dayNumber, newSecondsOfDay, result);
- };
- /**
- * Adds the provided number of days to the provided date instance.
- *
- * @param {JulianDate} julianDate The date.
- * @param {Number} days The number of days to add or subtract.
- * @param {JulianDate} result An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter.
- */
- JulianDate.addDays = function (julianDate, days, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(julianDate)) {
- throw new Check.DeveloperError("julianDate is required.");
- }
- if (!when.defined(days)) {
- throw new Check.DeveloperError("days is required.");
- }
- if (!when.defined(result)) {
- throw new Check.DeveloperError("result is required.");
- }
- //>>includeEnd('debug');
- var newJulianDayNumber = julianDate.dayNumber + days;
- return setComponents(newJulianDayNumber, julianDate.secondsOfDay, result);
- };
- /**
- * Compares the provided instances and returns <code>true</code> if <code>left</code> is earlier than <code>right</code>, <code>false</code> otherwise.
- *
- * @param {JulianDate} left The first instance.
- * @param {JulianDate} right The second instance.
- * @returns {Boolean} <code>true</code> if <code>left</code> is earlier than <code>right</code>, <code>false</code> otherwise.
- */
- JulianDate.lessThan = function (left, right) {
- return JulianDate.compare(left, right) < 0;
- };
- /**
- * Compares the provided instances and returns <code>true</code> if <code>left</code> is earlier than or equal to <code>right</code>, <code>false</code> otherwise.
- *
- * @param {JulianDate} left The first instance.
- * @param {JulianDate} right The second instance.
- * @returns {Boolean} <code>true</code> if <code>left</code> is earlier than or equal to <code>right</code>, <code>false</code> otherwise.
- */
- JulianDate.lessThanOrEquals = function (left, right) {
- return JulianDate.compare(left, right) <= 0;
- };
- /**
- * Compares the provided instances and returns <code>true</code> if <code>left</code> is later than <code>right</code>, <code>false</code> otherwise.
- *
- * @param {JulianDate} left The first instance.
- * @param {JulianDate} right The second instance.
- * @returns {Boolean} <code>true</code> if <code>left</code> is later than <code>right</code>, <code>false</code> otherwise.
- */
- JulianDate.greaterThan = function (left, right) {
- return JulianDate.compare(left, right) > 0;
- };
- /**
- * Compares the provided instances and returns <code>true</code> if <code>left</code> is later than or equal to <code>right</code>, <code>false</code> otherwise.
- *
- * @param {JulianDate} left The first instance.
- * @param {JulianDate} right The second instance.
- * @returns {Boolean} <code>true</code> if <code>left</code> is later than or equal to <code>right</code>, <code>false</code> otherwise.
- */
- JulianDate.greaterThanOrEquals = function (left, right) {
- return JulianDate.compare(left, right) >= 0;
- };
- /**
- * Duplicates this instance.
- *
- * @param {JulianDate} [result] An existing instance to use for the result.
- * @returns {JulianDate} The modified result parameter or a new instance if none was provided.
- */
- JulianDate.prototype.clone = function (result) {
- return JulianDate.clone(this, result);
- };
- /**
- * Compares this and the provided instance and returns <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {JulianDate} [right] The second instance.
- * @returns {Boolean} <code>true</code> if the dates are equal; otherwise, <code>false</code>.
- */
- JulianDate.prototype.equals = function (right) {
- return JulianDate.equals(this, right);
- };
- /**
- * Compares this and the provided instance and returns <code>true</code> if they are within <code>epsilon</code> seconds of
- * each other. That is, in order for the dates to be considered equal (and for
- * this function to return <code>true</code>), the absolute value of the difference between them, in
- * seconds, must be less than <code>epsilon</code>.
- *
- * @param {JulianDate} [right] The second instance.
- * @param {Number} [epsilon=0] The maximum number of seconds that should separate the two instances.
- * @returns {Boolean} <code>true</code> if the two dates are within <code>epsilon</code> seconds of each other; otherwise <code>false</code>.
- */
- JulianDate.prototype.equalsEpsilon = function (right, epsilon) {
- return JulianDate.equalsEpsilon(this, right, epsilon);
- };
- /**
- * Creates a string representing this date in ISO8601 format.
- *
- * @returns {String} A string representing this date in ISO8601 format.
- */
- JulianDate.prototype.toString = function () {
- return JulianDate.toIso8601(this);
- };
- /**
- * Gets or sets the list of leap seconds used throughout Cesium.
- * @memberof JulianDate
- * @type {LeapSecond[]}
- */
- JulianDate.leapSeconds = [
- new LeapSecond(new JulianDate(2441317, 43210.0, TimeStandard$1.TAI), 10), // January 1, 1972 00:00:00 UTC
- new LeapSecond(new JulianDate(2441499, 43211.0, TimeStandard$1.TAI), 11), // July 1, 1972 00:00:00 UTC
- new LeapSecond(new JulianDate(2441683, 43212.0, TimeStandard$1.TAI), 12), // January 1, 1973 00:00:00 UTC
- new LeapSecond(new JulianDate(2442048, 43213.0, TimeStandard$1.TAI), 13), // January 1, 1974 00:00:00 UTC
- new LeapSecond(new JulianDate(2442413, 43214.0, TimeStandard$1.TAI), 14), // January 1, 1975 00:00:00 UTC
- new LeapSecond(new JulianDate(2442778, 43215.0, TimeStandard$1.TAI), 15), // January 1, 1976 00:00:00 UTC
- new LeapSecond(new JulianDate(2443144, 43216.0, TimeStandard$1.TAI), 16), // January 1, 1977 00:00:00 UTC
- new LeapSecond(new JulianDate(2443509, 43217.0, TimeStandard$1.TAI), 17), // January 1, 1978 00:00:00 UTC
- new LeapSecond(new JulianDate(2443874, 43218.0, TimeStandard$1.TAI), 18), // January 1, 1979 00:00:00 UTC
- new LeapSecond(new JulianDate(2444239, 43219.0, TimeStandard$1.TAI), 19), // January 1, 1980 00:00:00 UTC
- new LeapSecond(new JulianDate(2444786, 43220.0, TimeStandard$1.TAI), 20), // July 1, 1981 00:00:00 UTC
- new LeapSecond(new JulianDate(2445151, 43221.0, TimeStandard$1.TAI), 21), // July 1, 1982 00:00:00 UTC
- new LeapSecond(new JulianDate(2445516, 43222.0, TimeStandard$1.TAI), 22), // July 1, 1983 00:00:00 UTC
- new LeapSecond(new JulianDate(2446247, 43223.0, TimeStandard$1.TAI), 23), // July 1, 1985 00:00:00 UTC
- new LeapSecond(new JulianDate(2447161, 43224.0, TimeStandard$1.TAI), 24), // January 1, 1988 00:00:00 UTC
- new LeapSecond(new JulianDate(2447892, 43225.0, TimeStandard$1.TAI), 25), // January 1, 1990 00:00:00 UTC
- new LeapSecond(new JulianDate(2448257, 43226.0, TimeStandard$1.TAI), 26), // January 1, 1991 00:00:00 UTC
- new LeapSecond(new JulianDate(2448804, 43227.0, TimeStandard$1.TAI), 27), // July 1, 1992 00:00:00 UTC
- new LeapSecond(new JulianDate(2449169, 43228.0, TimeStandard$1.TAI), 28), // July 1, 1993 00:00:00 UTC
- new LeapSecond(new JulianDate(2449534, 43229.0, TimeStandard$1.TAI), 29), // July 1, 1994 00:00:00 UTC
- new LeapSecond(new JulianDate(2450083, 43230.0, TimeStandard$1.TAI), 30), // January 1, 1996 00:00:00 UTC
- new LeapSecond(new JulianDate(2450630, 43231.0, TimeStandard$1.TAI), 31), // July 1, 1997 00:00:00 UTC
- new LeapSecond(new JulianDate(2451179, 43232.0, TimeStandard$1.TAI), 32), // January 1, 1999 00:00:00 UTC
- new LeapSecond(new JulianDate(2453736, 43233.0, TimeStandard$1.TAI), 33), // January 1, 2006 00:00:00 UTC
- new LeapSecond(new JulianDate(2454832, 43234.0, TimeStandard$1.TAI), 34), // January 1, 2009 00:00:00 UTC
- new LeapSecond(new JulianDate(2456109, 43235.0, TimeStandard$1.TAI), 35), // July 1, 2012 00:00:00 UTC
- new LeapSecond(new JulianDate(2457204, 43236.0, TimeStandard$1.TAI), 36), // July 1, 2015 00:00:00 UTC
- new LeapSecond(new JulianDate(2457754, 43237.0, TimeStandard$1.TAI), 37), // January 1, 2017 00:00:00 UTC
- ];
- /**
- * @license
- *
- * Grauw URI utilities
- *
- * See: http://hg.grauw.nl/grauw-lib/file/tip/src/uri.js
- *
- * @author Laurens Holst (http://www.grauw.nl/)
- *
- * Copyright 2012 Laurens Holst
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
- /**
- * Constructs a URI object.
- * @constructor
- * @class Implementation of URI parsing and base URI resolving algorithm in RFC 3986.
- * @param {string|URI} uri A string or URI object to create the object from.
- */
- function URI(uri) {
- if (uri instanceof URI) { // copy constructor
- this.scheme = uri.scheme;
- this.authority = uri.authority;
- this.path = uri.path;
- this.query = uri.query;
- this.fragment = uri.fragment;
- } else if (uri) { // uri is URI string or cast to string
- var c = parseRegex.exec(uri);
- this.scheme = c[1];
- this.authority = c[2];
- this.path = c[3];
- this.query = c[4];
- this.fragment = c[5];
- }
- }
- // Initial values on the prototype
- URI.prototype.scheme = null;
- URI.prototype.authority = null;
- URI.prototype.path = '';
- URI.prototype.query = null;
- URI.prototype.fragment = null;
- // Regular expression from RFC 3986 appendix B
- var parseRegex = new RegExp('^(?:([^:/?#]+):)?(?://([^/?#]*))?([^?#]*)(?:\\?([^#]*))?(?:#(.*))?$');
- /**
- * Returns the scheme part of the URI.
- * In "http://example.com:80/a/b?x#y" this is "http".
- */
- URI.prototype.getScheme = function() {
- return this.scheme;
- };
- /**
- * Returns the authority part of the URI.
- * In "http://example.com:80/a/b?x#y" this is "example.com:80".
- */
- URI.prototype.getAuthority = function() {
- return this.authority;
- };
- /**
- * Returns the path part of the URI.
- * In "http://example.com:80/a/b?x#y" this is "/a/b".
- * In "mailto:mike@example.com" this is "mike@example.com".
- */
- URI.prototype.getPath = function() {
- return this.path;
- };
- /**
- * Returns the query part of the URI.
- * In "http://example.com:80/a/b?x#y" this is "x".
- */
- URI.prototype.getQuery = function() {
- return this.query;
- };
- /**
- * Returns the fragment part of the URI.
- * In "http://example.com:80/a/b?x#y" this is "y".
- */
- URI.prototype.getFragment = function() {
- return this.fragment;
- };
- /**
- * Tests whether the URI is an absolute URI.
- * See RFC 3986 section 4.3.
- */
- URI.prototype.isAbsolute = function() {
- return !!this.scheme && !this.fragment;
- };
- ///**
- //* Extensive validation of the URI against the ABNF in RFC 3986
- //*/
- //URI.prototype.validate
- /**
- * Tests whether the URI is a same-document reference.
- * See RFC 3986 section 4.4.
- *
- * To perform more thorough comparison, you can normalise the URI objects.
- */
- URI.prototype.isSameDocumentAs = function(uri) {
- return uri.scheme == this.scheme &&
- uri.authority == this.authority &&
- uri.path == this.path &&
- uri.query == this.query;
- };
- /**
- * Simple String Comparison of two URIs.
- * See RFC 3986 section 6.2.1.
- *
- * To perform more thorough comparison, you can normalise the URI objects.
- */
- URI.prototype.equals = function(uri) {
- return this.isSameDocumentAs(uri) && uri.fragment == this.fragment;
- };
- /**
- * Normalizes the URI using syntax-based normalization.
- * This includes case normalization, percent-encoding normalization and path segment normalization.
- * XXX: Percent-encoding normalization does not escape characters that need to be escaped.
- * (Although that would not be a valid URI in the first place. See validate().)
- * See RFC 3986 section 6.2.2.
- */
- URI.prototype.normalize = function() {
- this.removeDotSegments();
- if (this.scheme)
- this.scheme = this.scheme.toLowerCase();
- if (this.authority)
- this.authority = this.authority.replace(authorityRegex, replaceAuthority).
- replace(caseRegex, replaceCase);
- if (this.path)
- this.path = this.path.replace(caseRegex, replaceCase);
- if (this.query)
- this.query = this.query.replace(caseRegex, replaceCase);
- if (this.fragment)
- this.fragment = this.fragment.replace(caseRegex, replaceCase);
- };
- var caseRegex = /%[0-9a-z]{2}/gi;
- var percentRegex = /[a-zA-Z0-9\-\._~]/;
- var authorityRegex = /(.*@)?([^@:]*)(:.*)?/;
- function replaceCase(str) {
- var dec = unescape(str);
- return percentRegex.test(dec) ? dec : str.toUpperCase();
- }
- function replaceAuthority(str, p1, p2, p3) {
- return (p1 || '') + p2.toLowerCase() + (p3 || '');
- }
- /**
- * Resolve a relative URI (this) against a base URI.
- * The base URI must be an absolute URI.
- * See RFC 3986 section 5.2
- */
- URI.prototype.resolve = function(baseURI) {
- var uri = new URI();
- if (this.scheme) {
- uri.scheme = this.scheme;
- uri.authority = this.authority;
- uri.path = this.path;
- uri.query = this.query;
- } else {
- uri.scheme = baseURI.scheme;
- if (this.authority) {
- uri.authority = this.authority;
- uri.path = this.path;
- uri.query = this.query;
- } else {
- uri.authority = baseURI.authority;
- if (this.path == '') {
- uri.path = baseURI.path;
- uri.query = this.query || baseURI.query;
- } else {
- if (this.path.charAt(0) == '/') {
- uri.path = this.path;
- uri.removeDotSegments();
- } else {
- if (baseURI.authority && baseURI.path == '') {
- uri.path = '/' + this.path;
- } else {
- uri.path = baseURI.path.substring(0, baseURI.path.lastIndexOf('/') + 1) + this.path;
- }
- uri.removeDotSegments();
- }
- uri.query = this.query;
- }
- }
- }
- uri.fragment = this.fragment;
- return uri;
- };
- /**
- * Remove dot segments from path.
- * See RFC 3986 section 5.2.4
- * @private
- */
- URI.prototype.removeDotSegments = function() {
- var input = this.path.split('/'),
- output = [],
- segment,
- absPath = input[0] == '';
- if (absPath)
- input.shift();
- var sFirst = input[0] == '' ? input.shift() : null;
- while (input.length) {
- segment = input.shift();
- if (segment == '..') {
- output.pop();
- } else if (segment != '.') {
- output.push(segment);
- }
- }
- if (segment == '.' || segment == '..')
- output.push('');
- if (absPath)
- output.unshift('');
- this.path = output.join('/');
- };
- // We don't like this function because it builds up a cache that is never cleared.
- // /**
- // * Resolves a relative URI against an absolute base URI.
- // * Convenience method.
- // * @param {String} uri the relative URI to resolve
- // * @param {String} baseURI the base URI (must be absolute) to resolve against
- // */
- // URI.resolve = function(sURI, sBaseURI) {
- // var uri = cache[sURI] || (cache[sURI] = new URI(sURI));
- // var baseURI = cache[sBaseURI] || (cache[sBaseURI] = new URI(sBaseURI));
- // return uri.resolve(baseURI).toString();
- // };
- // var cache = {};
- /**
- * Serialises the URI to a string.
- */
- URI.prototype.toString = function() {
- var result = '';
- if (this.scheme)
- result += this.scheme + ':';
- if (this.authority)
- result += '//' + this.authority;
- result += this.path;
- if (this.query)
- result += '?' + this.query;
- if (this.fragment)
- result += '#' + this.fragment;
- return result;
- };
- /**
- * @private
- */
- function appendForwardSlash(url) {
- if (url.length === 0 || url[url.length - 1] !== "/") {
- url = url + "/";
- }
- return url;
- }
- /**
- * Clones an object, returning a new object containing the same properties.
- *
- * @function
- *
- * @param {Object} object The object to clone.
- * @param {Boolean} [deep=false] If true, all properties will be deep cloned recursively.
- * @returns {Object} The cloned object.
- */
- function clone(object, deep) {
- if (object === null || typeof object !== "object") {
- return object;
- }
- deep = when.defaultValue(deep, false);
- var result = new object.constructor();
- for (var propertyName in object) {
- if (object.hasOwnProperty(propertyName)) {
- var value = object[propertyName];
- if (deep) {
- value = clone(value, deep);
- }
- result[propertyName] = value;
- }
- }
- return result;
- }
- /**
- * Merges two objects, copying their properties onto a new combined object. When two objects have the same
- * property, the value of the property on the first object is used. If either object is undefined,
- * it will be treated as an empty object.
- *
- * @example
- * var object1 = {
- * propOne : 1,
- * propTwo : {
- * value1 : 10
- * }
- * }
- * var object2 = {
- * propTwo : 2
- * }
- * var final = Cesium.combine(object1, object2);
- *
- * // final === {
- * // propOne : 1,
- * // propTwo : {
- * // value1 : 10
- * // }
- * // }
- *
- * @param {Object} [object1] The first object to merge.
- * @param {Object} [object2] The second object to merge.
- * @param {Boolean} [deep=false] Perform a recursive merge.
- * @returns {Object} The combined object containing all properties from both objects.
- *
- * @function
- */
- function combine(object1, object2, deep) {
- deep = when.defaultValue(deep, false);
- var result = {};
- var object1Defined = when.defined(object1);
- var object2Defined = when.defined(object2);
- var property;
- var object1Value;
- var object2Value;
- if (object1Defined) {
- for (property in object1) {
- if (object1.hasOwnProperty(property)) {
- object1Value = object1[property];
- if (
- object2Defined &&
- deep &&
- typeof object1Value === "object" &&
- object2.hasOwnProperty(property)
- ) {
- object2Value = object2[property];
- if (typeof object2Value === "object") {
- result[property] = combine(object1Value, object2Value, deep);
- } else {
- result[property] = object1Value;
- }
- } else {
- result[property] = object1Value;
- }
- }
- }
- }
- if (object2Defined) {
- for (property in object2) {
- if (
- object2.hasOwnProperty(property) &&
- !result.hasOwnProperty(property)
- ) {
- object2Value = object2[property];
- result[property] = object2Value;
- }
- }
- }
- return result;
- }
- /**
- * Given a relative Uri and a base Uri, returns the absolute Uri of the relative Uri.
- * @function
- *
- * @param {String} relative The relative Uri.
- * @param {String} [base] The base Uri.
- * @returns {String} The absolute Uri of the given relative Uri.
- *
- * @example
- * //absolute Uri will be "https://test.com/awesome.png";
- * var absoluteUri = Cesium.getAbsoluteUri('awesome.png', 'https://test.com');
- */
- function getAbsoluteUri(relative, base) {
- var documentObject;
- if (typeof document !== "undefined") {
- documentObject = document;
- }
- return getAbsoluteUri._implementation(relative, base, documentObject);
- }
- getAbsoluteUri._implementation = function (relative, base, documentObject) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(relative)) {
- throw new Check.DeveloperError("relative uri is required.");
- }
- //>>includeEnd('debug');
- if (!when.defined(base)) {
- if (typeof documentObject === "undefined") {
- return relative;
- }
- base = when.defaultValue(documentObject.baseURI, documentObject.location.href);
- }
- var baseUri = new URI(base);
- var relativeUri = new URI(relative);
- return relativeUri.resolve(baseUri).toString();
- };
- /**
- * Given a URI, returns the base path of the URI.
- * @function
- *
- * @param {String} uri The Uri.
- * @param {Boolean} [includeQuery = false] Whether or not to include the query string and fragment form the uri
- * @returns {String} The base path of the Uri.
- *
- * @example
- * // basePath will be "/Gallery/";
- * var basePath = Cesium.getBaseUri('/Gallery/simple.czml?value=true&example=false');
- *
- * // basePath will be "/Gallery/?value=true&example=false";
- * var basePath = Cesium.getBaseUri('/Gallery/simple.czml?value=true&example=false', true);
- */
- function getBaseUri(uri, includeQuery) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(uri)) {
- throw new Check.DeveloperError("uri is required.");
- }
- //>>includeEnd('debug');
- var basePath = "";
- var i = uri.lastIndexOf("/");
- if (i !== -1) {
- basePath = uri.substring(0, i + 1);
- }
- if (!includeQuery) {
- return basePath;
- }
- uri = new URI(uri);
- if (when.defined(uri.query)) {
- basePath += "?" + uri.query;
- }
- if (when.defined(uri.fragment)) {
- basePath += "#" + uri.fragment;
- }
- return basePath;
- }
- /**
- * Given a URI, returns the extension of the URI.
- * @function getExtensionFromUri
- *
- * @param {String} uri The Uri.
- * @returns {String} The extension of the Uri.
- *
- * @example
- * //extension will be "czml";
- * var extension = Cesium.getExtensionFromUri('/Gallery/simple.czml?value=true&example=false');
- */
- function getExtensionFromUri(uri) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(uri)) {
- throw new Check.DeveloperError("uri is required.");
- }
- //>>includeEnd('debug');
- var uriObject = new URI(uri);
- uriObject.normalize();
- var path = uriObject.path;
- var index = path.lastIndexOf("/");
- if (index !== -1) {
- path = path.substr(index + 1);
- }
- index = path.lastIndexOf(".");
- if (index === -1) {
- path = "";
- } else {
- path = path.substr(index + 1);
- }
- return path;
- }
- var blobUriRegex = /^blob:/i;
- /**
- * Determines if the specified uri is a blob uri.
- *
- * @function isBlobUri
- *
- * @param {String} uri The uri to test.
- * @returns {Boolean} true when the uri is a blob uri; otherwise, false.
- *
- * @private
- */
- function isBlobUri(uri) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.string("uri", uri);
- //>>includeEnd('debug');
- return blobUriRegex.test(uri);
- }
- var a;
- /**
- * Given a URL, determine whether that URL is considered cross-origin to the current page.
- *
- * @private
- */
- function isCrossOriginUrl(url) {
- if (!when.defined(a)) {
- a = document.createElement("a");
- }
- // copy window location into the anchor to get consistent results
- // when the port is default for the protocol (e.g. 80 for HTTP)
- a.href = window.location.href;
- // host includes both hostname and port if the port is not standard
- var host = a.host;
- var protocol = a.protocol;
- a.href = url;
- // IE only absolutizes href on get, not set
- // eslint-disable-next-line no-self-assign
- a.href = a.href;
- return protocol !== a.protocol || host !== a.host;
- }
- var dataUriRegex = /^data:/i;
- /**
- * Determines if the specified uri is a data uri.
- *
- * @function isDataUri
- *
- * @param {String} uri The uri to test.
- * @returns {Boolean} true when the uri is a data uri; otherwise, false.
- *
- * @private
- */
- function isDataUri(uri) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.string("uri", uri);
- //>>includeEnd('debug');
- return dataUriRegex.test(uri);
- }
- /**
- * @private
- */
- function loadAndExecuteScript(url) {
- var deferred = when.when.defer();
- var script = document.createElement("script");
- script.async = true;
- script.src = url;
- var head = document.getElementsByTagName("head")[0];
- script.onload = function () {
- script.onload = undefined;
- head.removeChild(script);
- deferred.resolve();
- };
- script.onerror = function (e) {
- deferred.reject(e);
- };
- head.appendChild(script);
- return deferred.promise;
- }
- /**
- * Converts an object representing a set of name/value pairs into a query string,
- * with names and values encoded properly for use in a URL. Values that are arrays
- * will produce multiple values with the same name.
- * @function objectToQuery
- *
- * @param {Object} obj The object containing data to encode.
- * @returns {String} An encoded query string.
- *
- *
- * @example
- * var str = Cesium.objectToQuery({
- * key1 : 'some value',
- * key2 : 'a/b',
- * key3 : ['x', 'y']
- * });
- *
- * @see queryToObject
- * // str will be:
- * // 'key1=some%20value&key2=a%2Fb&key3=x&key3=y'
- */
- function objectToQuery(obj) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(obj)) {
- throw new Check.DeveloperError("obj is required.");
- }
- //>>includeEnd('debug');
- var result = "";
- for (var propName in obj) {
- if (obj.hasOwnProperty(propName)) {
- var value = obj[propName];
- var part = encodeURIComponent(propName) + "=";
- if (Array.isArray(value)) {
- for (var i = 0, len = value.length; i < len; ++i) {
- result += part + encodeURIComponent(value[i]) + "&";
- }
- } else {
- result += part + encodeURIComponent(value) + "&";
- }
- }
- }
- // trim last &
- result = result.slice(0, -1);
- // This function used to replace %20 with + which is more compact and readable.
- // However, some servers didn't properly handle + as a space.
- // https://github.com/CesiumGS/cesium/issues/2192
- return result;
- }
- /**
- * Parses a query string into an object, where the keys and values of the object are the
- * name/value pairs from the query string, decoded. If a name appears multiple times,
- * the value in the object will be an array of values.
- * @function queryToObject
- *
- * @param {String} queryString The query string.
- * @returns {Object} An object containing the parameters parsed from the query string.
- *
- *
- * @example
- * var obj = Cesium.queryToObject('key1=some%20value&key2=a%2Fb&key3=x&key3=y');
- * // obj will be:
- * // {
- * // key1 : 'some value',
- * // key2 : 'a/b',
- * // key3 : ['x', 'y']
- * // }
- *
- * @see objectToQuery
- */
- function queryToObject(queryString) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(queryString)) {
- throw new Check.DeveloperError("queryString is required.");
- }
- //>>includeEnd('debug');
- var result = {};
- if (queryString === "") {
- return result;
- }
- var parts = queryString.replace(/\+/g, "%20").split(/[&;]/);
- for (var i = 0, len = parts.length; i < len; ++i) {
- var subparts = parts[i].split("=");
- var name = decodeURIComponent(subparts[0]);
- var value = subparts[1];
- if (when.defined(value)) {
- value = decodeURIComponent(value);
- } else {
- value = "";
- }
- var resultValue = result[name];
- if (typeof resultValue === "string") {
- // expand the single value to an array
- result[name] = [resultValue, value];
- } else if (Array.isArray(resultValue)) {
- resultValue.push(value);
- } else {
- result[name] = value;
- }
- }
- return result;
- }
- /**
- * State of the request.
- *
- * @enum {Number}
- */
- var RequestState = {
- /**
- * Initial unissued state.
- *
- * @type Number
- * @constant
- */
- UNISSUED: 0,
- /**
- * Issued but not yet active. Will become active when open slots are available.
- *
- * @type Number
- * @constant
- */
- ISSUED: 1,
- /**
- * Actual http request has been sent.
- *
- * @type Number
- * @constant
- */
- ACTIVE: 2,
- /**
- * Request completed successfully.
- *
- * @type Number
- * @constant
- */
- RECEIVED: 3,
- /**
- * Request was cancelled, either explicitly or automatically because of low priority.
- *
- * @type Number
- * @constant
- */
- CANCELLED: 4,
- /**
- * Request failed.
- *
- * @type Number
- * @constant
- */
- FAILED: 5,
- };
- var RequestState$1 = Object.freeze(RequestState);
- /**
- * An enum identifying the type of request. Used for finer grained logging and priority sorting.
- *
- * @enum {Number}
- */
- var RequestType = {
- /**
- * Terrain request.
- *
- * @type Number
- * @constant
- */
- TERRAIN: 0,
- /**
- * Imagery request.
- *
- * @type Number
- * @constant
- */
- IMAGERY: 1,
- /**
- * 3D Tiles request.
- *
- * @type Number
- * @constant
- */
- TILES3D: 2,
- /**
- * Other request.
- *
- * @type Number
- * @constant
- */
- OTHER: 3,
- };
- var RequestType$1 = Object.freeze(RequestType);
- /**
- * Stores information for making a request. In general this does not need to be constructed directly.
- *
- * @alias Request
- * @constructor
- * @param {Object} [options] An object with the following properties:
- * @param {String} [options.url] The url to request.
- * @param {Request.RequestCallback} [options.requestFunction] The function that makes the actual data request.
- * @param {Request.CancelCallback} [options.cancelFunction] The function that is called when the request is cancelled.
- * @param {Request.PriorityCallback} [options.priorityFunction] The function that is called to update the request's priority, which occurs once per frame.
- * @param {Number} [options.priority=0.0] The initial priority of the request.
- * @param {Boolean} [options.throttle=false] Whether to throttle and prioritize the request. If false, the request will be sent immediately. If true, the request will be throttled and sent based on priority.
- * @param {Boolean} [options.throttleByServer=false] Whether to throttle the request by server.
- * @param {RequestType} [options.type=RequestType.OTHER] The type of request.
- */
- function Request(options) {
- options = when.defaultValue(options, when.defaultValue.EMPTY_OBJECT);
- var throttleByServer = when.defaultValue(options.throttleByServer, false);
- var throttle = when.defaultValue(options.throttle, false);
- /**
- * The URL to request.
- *
- * @type {String}
- */
- this.url = options.url;
- /**
- * The function that makes the actual data request.
- *
- * @type {Request.RequestCallback}
- */
- this.requestFunction = options.requestFunction;
- /**
- * The function that is called when the request is cancelled.
- *
- * @type {Request.CancelCallback}
- */
- this.cancelFunction = options.cancelFunction;
- /**
- * The function that is called to update the request's priority, which occurs once per frame.
- *
- * @type {Request.PriorityCallback}
- */
- this.priorityFunction = options.priorityFunction;
- /**
- * Priority is a unit-less value where lower values represent higher priority.
- * For world-based objects, this is usually the distance from the camera.
- * A request that does not have a priority function defaults to a priority of 0.
- *
- * If priorityFunction is defined, this value is updated every frame with the result of that call.
- *
- * @type {Number}
- * @default 0.0
- */
- this.priority = when.defaultValue(options.priority, 0.0);
- /**
- * Whether to throttle and prioritize the request. If false, the request will be sent immediately. If true, the
- * request will be throttled and sent based on priority.
- *
- * @type {Boolean}
- * @readonly
- *
- * @default false
- */
- this.throttle = throttle;
- /**
- * Whether to throttle the request by server. Browsers typically support about 6-8 parallel connections
- * for HTTP/1 servers, and an unlimited amount of connections for HTTP/2 servers. Setting this value
- * to <code>true</code> is preferable for requests going through HTTP/1 servers.
- *
- * @type {Boolean}
- * @readonly
- *
- * @default false
- */
- this.throttleByServer = throttleByServer;
- /**
- * Type of request.
- *
- * @type {RequestType}
- * @readonly
- *
- * @default RequestType.OTHER
- */
- this.type = when.defaultValue(options.type, RequestType$1.OTHER);
- /**
- * A key used to identify the server that a request is going to. It is derived from the url's authority and scheme.
- *
- * @type {String}
- *
- * @private
- */
- this.serverKey = undefined;
- /**
- * The current state of the request.
- *
- * @type {RequestState}
- * @readonly
- */
- this.state = RequestState$1.UNISSUED;
- /**
- * The requests's deferred promise.
- *
- * @type {Object}
- *
- * @private
- */
- this.deferred = undefined;
- /**
- * Whether the request was explicitly cancelled.
- *
- * @type {Boolean}
- *
- * @private
- */
- this.cancelled = false;
- }
- /**
- * Mark the request as cancelled.
- *
- * @private
- */
- Request.prototype.cancel = function () {
- this.cancelled = true;
- };
- /**
- * Duplicates a Request instance.
- *
- * @param {Request} [result] The object onto which to store the result.
- *
- * @returns {Request} The modified result parameter or a new Resource instance if one was not provided.
- */
- Request.prototype.clone = function (result) {
- if (!when.defined(result)) {
- return new Request(this);
- }
- result.url = this.url;
- result.requestFunction = this.requestFunction;
- result.cancelFunction = this.cancelFunction;
- result.priorityFunction = this.priorityFunction;
- result.priority = this.priority;
- result.throttle = this.throttle;
- result.throttleByServer = this.throttleByServer;
- result.type = this.type;
- result.serverKey = this.serverKey;
- // These get defaulted because the cloned request hasn't been issued
- result.state = this.RequestState.UNISSUED;
- result.deferred = undefined;
- result.cancelled = false;
- return result;
- };
- /**
- * Parses the result of XMLHttpRequest's getAllResponseHeaders() method into
- * a dictionary.
- *
- * @function parseResponseHeaders
- *
- * @param {String} headerString The header string returned by getAllResponseHeaders(). The format is
- * described here: http://www.w3.org/TR/XMLHttpRequest/#the-getallresponseheaders()-method
- * @returns {Object} A dictionary of key/value pairs, where each key is the name of a header and the corresponding value
- * is that header's value.
- *
- * @private
- */
- function parseResponseHeaders(headerString) {
- var headers = {};
- if (!headerString) {
- return headers;
- }
- var headerPairs = headerString.split("\u000d\u000a");
- for (var i = 0; i < headerPairs.length; ++i) {
- var headerPair = headerPairs[i];
- // Can't use split() here because it does the wrong thing
- // if the header value has the string ": " in it.
- var index = headerPair.indexOf("\u003a\u0020");
- if (index > 0) {
- var key = headerPair.substring(0, index);
- var val = headerPair.substring(index + 2);
- headers[key] = val;
- }
- }
- return headers;
- }
- /**
- * An event that is raised when a request encounters an error.
- *
- * @constructor
- * @alias RequestErrorEvent
- *
- * @param {Number} [statusCode] The HTTP error status code, such as 404.
- * @param {Object} [response] The response included along with the error.
- * @param {String|Object} [responseHeaders] The response headers, represented either as an object literal or as a
- * string in the format returned by XMLHttpRequest's getAllResponseHeaders() function.
- */
- function RequestErrorEvent(statusCode, response, responseHeaders) {
- /**
- * The HTTP error status code, such as 404. If the error does not have a particular
- * HTTP code, this property will be undefined.
- *
- * @type {Number}
- */
- this.statusCode = statusCode;
- /**
- * The response included along with the error. If the error does not include a response,
- * this property will be undefined.
- *
- * @type {Object}
- */
- this.response = response;
- /**
- * The headers included in the response, represented as an object literal of key/value pairs.
- * If the error does not include any headers, this property will be undefined.
- *
- * @type {Object}
- */
- this.responseHeaders = responseHeaders;
- if (typeof this.responseHeaders === "string") {
- this.responseHeaders = parseResponseHeaders(this.responseHeaders);
- }
- }
- /**
- * Creates a string representing this RequestErrorEvent.
- * @memberof RequestErrorEvent
- *
- * @returns {String} A string representing the provided RequestErrorEvent.
- */
- RequestErrorEvent.prototype.toString = function () {
- var str = "Request has failed.";
- if (when.defined(this.statusCode)) {
- str += " Status Code: " + this.statusCode;
- }
- return str;
- };
- /**
- * A generic utility class for managing subscribers for a particular event.
- * This class is usually instantiated inside of a container class and
- * exposed as a property for others to subscribe to.
- *
- * @alias Event
- * @constructor
- * @example
- * MyObject.prototype.myListener = function(arg1, arg2) {
- * this.myArg1Copy = arg1;
- * this.myArg2Copy = arg2;
- * }
- *
- * var myObjectInstance = new MyObject();
- * var evt = new Cesium.Event();
- * evt.addEventListener(MyObject.prototype.myListener, myObjectInstance);
- * evt.raiseEvent('1', '2');
- * evt.removeEventListener(MyObject.prototype.myListener);
- */
- function Event() {
- this._listeners = [];
- this._scopes = [];
- this._toRemove = [];
- this._insideRaiseEvent = false;
- }
- Object.defineProperties(Event.prototype, {
- /**
- * The number of listeners currently subscribed to the event.
- * @memberof Event.prototype
- * @type {Number}
- * @readonly
- */
- numberOfListeners: {
- get: function () {
- return this._listeners.length - this._toRemove.length;
- },
- },
- });
- /**
- * Registers a callback function to be executed whenever the event is raised.
- * An optional scope can be provided to serve as the <code>this</code> pointer
- * in which the function will execute.
- *
- * @param {Function} listener The function to be executed when the event is raised.
- * @param {Object} [scope] An optional object scope to serve as the <code>this</code>
- * pointer in which the listener function will execute.
- * @returns {Event.RemoveCallback} A function that will remove this event listener when invoked.
- *
- * @see Event#raiseEvent
- * @see Event#removeEventListener
- */
- Event.prototype.addEventListener = function (listener, scope) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.func("listener", listener);
- //>>includeEnd('debug');
- this._listeners.push(listener);
- this._scopes.push(scope);
- var event = this;
- return function () {
- event.removeEventListener(listener, scope);
- };
- };
- /**
- * Unregisters a previously registered callback.
- *
- * @param {Function} listener The function to be unregistered.
- * @param {Object} [scope] The scope that was originally passed to addEventListener.
- * @returns {Boolean} <code>true</code> if the listener was removed; <code>false</code> if the listener and scope are not registered with the event.
- *
- * @see Event#addEventListener
- * @see Event#raiseEvent
- */
- Event.prototype.removeEventListener = function (listener, scope) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.func("listener", listener);
- //>>includeEnd('debug');
- var listeners = this._listeners;
- var scopes = this._scopes;
- var index = -1;
- for (var i = 0; i < listeners.length; i++) {
- if (listeners[i] === listener && scopes[i] === scope) {
- index = i;
- break;
- }
- }
- if (index !== -1) {
- if (this._insideRaiseEvent) {
- //In order to allow removing an event subscription from within
- //a callback, we don't actually remove the items here. Instead
- //remember the index they are at and undefined their value.
- this._toRemove.push(index);
- listeners[index] = undefined;
- scopes[index] = undefined;
- } else {
- listeners.splice(index, 1);
- scopes.splice(index, 1);
- }
- return true;
- }
- return false;
- };
- function compareNumber(a, b) {
- return b - a;
- }
- /**
- * Raises the event by calling each registered listener with all supplied arguments.
- *
- * @param {...Object} arguments This method takes any number of parameters and passes them through to the listener functions.
- *
- * @see Event#addEventListener
- * @see Event#removeEventListener
- */
- Event.prototype.raiseEvent = function () {
- this._insideRaiseEvent = true;
- var i;
- var listeners = this._listeners;
- var scopes = this._scopes;
- var length = listeners.length;
- for (i = 0; i < length; i++) {
- var listener = listeners[i];
- if (when.defined(listener)) {
- listeners[i].apply(scopes[i], arguments);
- }
- }
- //Actually remove items removed in removeEventListener.
- var toRemove = this._toRemove;
- length = toRemove.length;
- if (length > 0) {
- toRemove.sort(compareNumber);
- for (i = 0; i < length; i++) {
- var index = toRemove[i];
- listeners.splice(index, 1);
- scopes.splice(index, 1);
- }
- toRemove.length = 0;
- }
- this._insideRaiseEvent = false;
- };
- /**
- * Array implementation of a heap.
- *
- * @alias Heap
- * @constructor
- * @private
- *
- * @param {Object} options Object with the following properties:
- * @param {Heap.ComparatorCallback} options.comparator The comparator to use for the heap. If comparator(a, b) is less than 0, sort a to a lower index than b, otherwise sort to a higher index.
- */
- function Heap(options) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("options", options);
- Check.Check.defined("options.comparator", options.comparator);
- //>>includeEnd('debug');
- this._comparator = options.comparator;
- this._array = [];
- this._length = 0;
- this._maximumLength = undefined;
- }
- Object.defineProperties(Heap.prototype, {
- /**
- * Gets the length of the heap.
- *
- * @memberof Heap.prototype
- *
- * @type {Number}
- * @readonly
- */
- length: {
- get: function () {
- return this._length;
- },
- },
- /**
- * Gets the internal array.
- *
- * @memberof Heap.prototype
- *
- * @type {Array}
- * @readonly
- */
- internalArray: {
- get: function () {
- return this._array;
- },
- },
- /**
- * Gets and sets the maximum length of the heap.
- *
- * @memberof Heap.prototype
- *
- * @type {Number}
- */
- maximumLength: {
- get: function () {
- return this._maximumLength;
- },
- set: function (value) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number.greaterThanOrEquals("maximumLength", value, 0);
- //>>includeEnd('debug');
- var originalLength = this._length;
- if (value < originalLength) {
- var array = this._array;
- // Remove trailing references
- for (var i = value; i < originalLength; ++i) {
- array[i] = undefined;
- }
- this._length = value;
- array.length = value;
- }
- this._maximumLength = value;
- },
- },
- /**
- * The comparator to use for the heap. If comparator(a, b) is less than 0, sort a to a lower index than b, otherwise sort to a higher index.
- *
- * @memberof Heap.prototype
- *
- * @type {Heap.ComparatorCallback}
- */
- comparator: {
- get: function () {
- return this._comparator;
- },
- },
- });
- function swap(array, a, b) {
- var temp = array[a];
- array[a] = array[b];
- array[b] = temp;
- }
- /**
- * Resizes the internal array of the heap.
- *
- * @param {Number} [length] The length to resize internal array to. Defaults to the current length of the heap.
- */
- Heap.prototype.reserve = function (length) {
- length = when.defaultValue(length, this._length);
- this._array.length = length;
- };
- /**
- * Update the heap so that index and all descendants satisfy the heap property.
- *
- * @param {Number} [index=0] The starting index to heapify from.
- */
- Heap.prototype.heapify = function (index) {
- index = when.defaultValue(index, 0);
- var length = this._length;
- var comparator = this._comparator;
- var array = this._array;
- var candidate = -1;
- var inserting = true;
- while (inserting) {
- var right = 2 * (index + 1);
- var left = right - 1;
- if (left < length && comparator(array[left], array[index]) < 0) {
- candidate = left;
- } else {
- candidate = index;
- }
- if (right < length && comparator(array[right], array[candidate]) < 0) {
- candidate = right;
- }
- if (candidate !== index) {
- swap(array, candidate, index);
- index = candidate;
- } else {
- inserting = false;
- }
- }
- };
- /**
- * Resort the heap.
- */
- Heap.prototype.resort = function () {
- var length = this._length;
- for (var i = Math.ceil(length / 2); i >= 0; --i) {
- this.heapify(i);
- }
- };
- /**
- * Insert an element into the heap. If the length would grow greater than maximumLength
- * of the heap, extra elements are removed.
- *
- * @param {*} element The element to insert
- *
- * @return {*} The element that was removed from the heap if the heap is at full capacity.
- */
- Heap.prototype.insert = function (element) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("element", element);
- //>>includeEnd('debug');
- var array = this._array;
- var comparator = this._comparator;
- var maximumLength = this._maximumLength;
- var index = this._length++;
- if (index < array.length) {
- array[index] = element;
- } else {
- array.push(element);
- }
- while (index !== 0) {
- var parent = Math.floor((index - 1) / 2);
- if (comparator(array[index], array[parent]) < 0) {
- swap(array, index, parent);
- index = parent;
- } else {
- break;
- }
- }
- var removedElement;
- if (when.defined(maximumLength) && this._length > maximumLength) {
- removedElement = array[maximumLength];
- this._length = maximumLength;
- }
- return removedElement;
- };
- /**
- * Remove the element specified by index from the heap and return it.
- *
- * @param {Number} [index=0] The index to remove.
- * @returns {*} The specified element of the heap.
- */
- Heap.prototype.pop = function (index) {
- index = when.defaultValue(index, 0);
- if (this._length === 0) {
- return undefined;
- }
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.number.lessThan("index", index, this._length);
- //>>includeEnd('debug');
- var array = this._array;
- var root = array[index];
- swap(array, index, --this._length);
- this.heapify(index);
- array[this._length] = undefined; // Remove trailing reference
- return root;
- };
- function sortRequests(a, b) {
- return a.priority - b.priority;
- }
- var statistics = {
- numberOfAttemptedRequests: 0,
- numberOfActiveRequests: 0,
- numberOfCancelledRequests: 0,
- numberOfCancelledActiveRequests: 0,
- numberOfFailedRequests: 0,
- numberOfActiveRequestsEver: 0,
- lastNumberOfActiveRequests: 0,
- };
- var priorityHeapLength = 20;
- var requestHeap = new Heap({
- comparator: sortRequests,
- });
- requestHeap.maximumLength = priorityHeapLength;
- requestHeap.reserve(priorityHeapLength);
- var activeRequests = [];
- var numberOfActiveRequestsByServer = {};
- var pageUri =
- typeof document !== "undefined" ? new URI(document.location.href) : new URI();
- var requestCompletedEvent = new Event();
- /**
- * The request scheduler is used to track and constrain the number of active requests in order to prioritize incoming requests. The ability
- * to retain control over the number of requests in CesiumJS is important because due to events such as changes in the camera position,
- * a lot of new requests may be generated and a lot of in-flight requests may become redundant. The request scheduler manually constrains the
- * number of requests so that newer requests wait in a shorter queue and don't have to compete for bandwidth with requests that have expired.
- *
- * @namespace RequestScheduler
- *
- */
- function RequestScheduler() {}
- /**
- * The maximum number of simultaneous active requests. Un-throttled requests do not observe this limit.
- * @type {Number}
- * @default 50
- */
- RequestScheduler.maximumRequests = 50;
- /**
- * The maximum number of simultaneous active requests per server. Un-throttled requests or servers specifically
- * listed in {@link requestsByServer} do not observe this limit.
- * @type {Number}
- * @default 6
- */
- RequestScheduler.maximumRequestsPerServer = 6;
- /**
- * A per server key list of overrides to use for throttling instead of <code>maximumRequestsPerServer</code>
- * @type {Object}
- *
- * @example
- * RequestScheduler.requestsByServer = {
- * 'api.cesium.com:443': 18,
- * 'assets.cesium.com:443': 18
- * };
- */
- RequestScheduler.requestsByServer = {
- "api.cesium.com:443": 18,
- "assets.cesium.com:443": 18,
- };
- /**
- * Specifies if the request scheduler should throttle incoming requests, or let the browser queue requests under its control.
- * @type {Boolean}
- * @default true
- */
- RequestScheduler.throttleRequests = true;
- /**
- * When true, log statistics to the console every frame
- * @type {Boolean}
- * @default false
- * @private
- */
- RequestScheduler.debugShowStatistics = false;
- /**
- * An event that's raised when a request is completed. Event handlers are passed
- * the error object if the request fails.
- *
- * @type {Event}
- * @default Event()
- * @private
- */
- RequestScheduler.requestCompletedEvent = requestCompletedEvent;
- Object.defineProperties(RequestScheduler, {
- /**
- * Returns the statistics used by the request scheduler.
- *
- * @memberof RequestScheduler
- *
- * @type Object
- * @readonly
- * @private
- */
- statistics: {
- get: function () {
- return statistics;
- },
- },
- /**
- * The maximum size of the priority heap. This limits the number of requests that are sorted by priority. Only applies to requests that are not yet active.
- *
- * @memberof RequestScheduler
- *
- * @type {Number}
- * @default 20
- * @private
- */
- priorityHeapLength: {
- get: function () {
- return priorityHeapLength;
- },
- set: function (value) {
- // If the new length shrinks the heap, need to cancel some of the requests.
- // Since this value is not intended to be tweaked regularly it is fine to just cancel the high priority requests.
- if (value < priorityHeapLength) {
- while (requestHeap.length > value) {
- var request = requestHeap.pop();
- cancelRequest(request);
- }
- }
- priorityHeapLength = value;
- requestHeap.maximumLength = value;
- requestHeap.reserve(value);
- },
- },
- });
- function updatePriority(request) {
- if (when.defined(request.priorityFunction)) {
- request.priority = request.priorityFunction();
- }
- }
- function serverHasOpenSlots(serverKey) {
- var maxRequests = when.defaultValue(
- RequestScheduler.requestsByServer[serverKey],
- RequestScheduler.maximumRequestsPerServer
- );
- return numberOfActiveRequestsByServer[serverKey] < maxRequests;
- }
- function issueRequest(request) {
- if (request.state === RequestState$1.UNISSUED) {
- request.state = RequestState$1.ISSUED;
- request.deferred = when.when.defer();
- }
- return request.deferred.promise;
- }
- function getRequestReceivedFunction(request) {
- return function (results) {
- if (request.state === RequestState$1.CANCELLED) {
- // If the data request comes back but the request is cancelled, ignore it.
- return;
- }
- --statistics.numberOfActiveRequests;
- --numberOfActiveRequestsByServer[request.serverKey];
- requestCompletedEvent.raiseEvent();
- request.state = RequestState$1.RECEIVED;
- request.deferred.resolve(results);
- // explicitly set to undefined to ensure GC of request response data. See #8843
- request.deferred = undefined;
- };
- }
- function getRequestFailedFunction(request) {
- return function (error) {
- if (request.state === RequestState$1.CANCELLED) {
- // If the data request comes back but the request is cancelled, ignore it.
- return;
- }
- ++statistics.numberOfFailedRequests;
- --statistics.numberOfActiveRequests;
- --numberOfActiveRequestsByServer[request.serverKey];
- requestCompletedEvent.raiseEvent(error);
- request.state = RequestState$1.FAILED;
- request.deferred.reject(error);
- };
- }
- function startRequest(request) {
- var promise = issueRequest(request);
- request.state = RequestState$1.ACTIVE;
- activeRequests.push(request);
- ++statistics.numberOfActiveRequests;
- ++statistics.numberOfActiveRequestsEver;
- ++numberOfActiveRequestsByServer[request.serverKey];
- request
- .requestFunction()
- .then(getRequestReceivedFunction(request))
- .otherwise(getRequestFailedFunction(request));
- return promise;
- }
- function cancelRequest(request) {
- var active = request.state === RequestState$1.ACTIVE;
- request.state = RequestState$1.CANCELLED;
- ++statistics.numberOfCancelledRequests;
- // check that deferred has not been cleared since cancelRequest can be called
- // on a finished request, e.g. by clearForSpecs during tests
- if (when.defined(request.deferred)) {
- request.deferred.reject();
- request.deferred = undefined;
- }
- if (active) {
- --statistics.numberOfActiveRequests;
- --numberOfActiveRequestsByServer[request.serverKey];
- ++statistics.numberOfCancelledActiveRequests;
- }
- if (when.defined(request.cancelFunction)) {
- request.cancelFunction();
- }
- }
- /**
- * Sort requests by priority and start requests.
- * @private
- */
- RequestScheduler.update = function () {
- var i;
- var request;
- // Loop over all active requests. Cancelled, failed, or received requests are removed from the array to make room for new requests.
- var removeCount = 0;
- var activeLength = activeRequests.length;
- for (i = 0; i < activeLength; ++i) {
- request = activeRequests[i];
- if (request.cancelled) {
- // Request was explicitly cancelled
- cancelRequest(request);
- }
- if (request.state !== RequestState$1.ACTIVE) {
- // Request is no longer active, remove from array
- ++removeCount;
- continue;
- }
- if (removeCount > 0) {
- // Shift back to fill in vacated slots from completed requests
- activeRequests[i - removeCount] = request;
- }
- }
- activeRequests.length -= removeCount;
- // Update priority of issued requests and resort the heap
- var issuedRequests = requestHeap.internalArray;
- var issuedLength = requestHeap.length;
- for (i = 0; i < issuedLength; ++i) {
- updatePriority(issuedRequests[i]);
- }
- requestHeap.resort();
- // Get the number of open slots and fill with the highest priority requests.
- // Un-throttled requests are automatically added to activeRequests, so activeRequests.length may exceed maximumRequests
- var openSlots = Math.max(
- RequestScheduler.maximumRequests - activeRequests.length,
- 0
- );
- var filledSlots = 0;
- while (filledSlots < openSlots && requestHeap.length > 0) {
- // Loop until all open slots are filled or the heap becomes empty
- request = requestHeap.pop();
- if (request.cancelled) {
- // Request was explicitly cancelled
- cancelRequest(request);
- continue;
- }
- if (request.throttleByServer && !serverHasOpenSlots(request.serverKey)) {
- // Open slots are available, but the request is throttled by its server. Cancel and try again later.
- cancelRequest(request);
- continue;
- }
- startRequest(request);
- ++filledSlots;
- }
- updateStatistics();
- };
- /**
- * Get the server key from a given url.
- *
- * @param {String} url The url.
- * @returns {String} The server key.
- * @private
- */
- RequestScheduler.getServerKey = function (url) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.string("url", url);
- //>>includeEnd('debug');
- var uri = new URI(url).resolve(pageUri);
- uri.normalize();
- var serverKey = uri.authority;
- if (!/:/.test(serverKey)) {
- // If the authority does not contain a port number, add port 443 for https or port 80 for http
- serverKey = serverKey + ":" + (uri.scheme === "https" ? "443" : "80");
- }
- var length = numberOfActiveRequestsByServer[serverKey];
- if (!when.defined(length)) {
- numberOfActiveRequestsByServer[serverKey] = 0;
- }
- return serverKey;
- };
- /**
- * Issue a request. If request.throttle is false, the request is sent immediately. Otherwise the request will be
- * queued and sorted by priority before being sent.
- *
- * @param {Request} request The request object.
- *
- * @returns {Promise|undefined} A Promise for the requested data, or undefined if this request does not have high enough priority to be issued.
- *
- * @private
- */
- RequestScheduler.request = function (request) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("request", request);
- Check.Check.typeOf.string("request.url", request.url);
- Check.Check.typeOf.func("request.requestFunction", request.requestFunction);
- //>>includeEnd('debug');
- if (isDataUri(request.url) || isBlobUri(request.url)) {
- requestCompletedEvent.raiseEvent();
- request.state = RequestState$1.RECEIVED;
- return request.requestFunction();
- }
- ++statistics.numberOfAttemptedRequests;
- if (!when.defined(request.serverKey)) {
- request.serverKey = RequestScheduler.getServerKey(request.url);
- }
- if (
- RequestScheduler.throttleRequests &&
- request.throttleByServer &&
- !serverHasOpenSlots(request.serverKey)
- ) {
- // Server is saturated. Try again later.
- return undefined;
- }
- if (!RequestScheduler.throttleRequests || !request.throttle) {
- return startRequest(request);
- }
- if (activeRequests.length >= RequestScheduler.maximumRequests) {
- // Active requests are saturated. Try again later.
- return undefined;
- }
- // Insert into the priority heap and see if a request was bumped off. If this request is the lowest
- // priority it will be returned.
- updatePriority(request);
- var removedRequest = requestHeap.insert(request);
- if (when.defined(removedRequest)) {
- if (removedRequest === request) {
- // Request does not have high enough priority to be issued
- return undefined;
- }
- // A previously issued request has been bumped off the priority heap, so cancel it
- cancelRequest(removedRequest);
- }
- return issueRequest(request);
- };
- function updateStatistics() {
- if (!RequestScheduler.debugShowStatistics) {
- return;
- }
- if (
- statistics.numberOfActiveRequests === 0 &&
- statistics.lastNumberOfActiveRequests > 0
- ) {
- if (statistics.numberOfAttemptedRequests > 0) {
- console.log(
- "Number of attempted requests: " + statistics.numberOfAttemptedRequests
- );
- statistics.numberOfAttemptedRequests = 0;
- }
- if (statistics.numberOfCancelledRequests > 0) {
- console.log(
- "Number of cancelled requests: " + statistics.numberOfCancelledRequests
- );
- statistics.numberOfCancelledRequests = 0;
- }
- if (statistics.numberOfCancelledActiveRequests > 0) {
- console.log(
- "Number of cancelled active requests: " +
- statistics.numberOfCancelledActiveRequests
- );
- statistics.numberOfCancelledActiveRequests = 0;
- }
- if (statistics.numberOfFailedRequests > 0) {
- console.log(
- "Number of failed requests: " + statistics.numberOfFailedRequests
- );
- statistics.numberOfFailedRequests = 0;
- }
- }
- statistics.lastNumberOfActiveRequests = statistics.numberOfActiveRequests;
- }
- /**
- * For testing only. Clears any requests that may not have completed from previous tests.
- *
- * @private
- */
- RequestScheduler.clearForSpecs = function () {
- while (requestHeap.length > 0) {
- var request = requestHeap.pop();
- cancelRequest(request);
- }
- var length = activeRequests.length;
- for (var i = 0; i < length; ++i) {
- cancelRequest(activeRequests[i]);
- }
- activeRequests.length = 0;
- numberOfActiveRequestsByServer = {};
- // Clear stats
- statistics.numberOfAttemptedRequests = 0;
- statistics.numberOfActiveRequests = 0;
- statistics.numberOfCancelledRequests = 0;
- statistics.numberOfCancelledActiveRequests = 0;
- statistics.numberOfFailedRequests = 0;
- statistics.numberOfActiveRequestsEver = 0;
- statistics.lastNumberOfActiveRequests = 0;
- };
- /**
- * For testing only.
- *
- * @private
- */
- RequestScheduler.numberOfActiveRequestsByServer = function (serverKey) {
- return numberOfActiveRequestsByServer[serverKey];
- };
- /**
- * For testing only.
- *
- * @private
- */
- RequestScheduler.requestHeap = requestHeap;
- /**
- * A singleton that contains all of the servers that are trusted. Credentials will be sent with
- * any requests to these servers.
- *
- * @namespace TrustedServers
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- */
- var TrustedServers = {};
- var _servers = {};
- /**
- * Adds a trusted server to the registry
- *
- * @param {String} host The host to be added.
- * @param {Number} port The port used to access the host.
- *
- * @example
- * // Add a trusted server
- * TrustedServers.add('my.server.com', 80);
- */
- TrustedServers.add = function (host, port) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(host)) {
- throw new Check.DeveloperError("host is required.");
- }
- if (!when.defined(port) || port <= 0) {
- throw new Check.DeveloperError("port is required to be greater than 0.");
- }
- //>>includeEnd('debug');
- var authority = host.toLowerCase() + ":" + port;
- if (!when.defined(_servers[authority])) {
- _servers[authority] = true;
- }
- };
- /**
- * Removes a trusted server from the registry
- *
- * @param {String} host The host to be removed.
- * @param {Number} port The port used to access the host.
- *
- * @example
- * // Remove a trusted server
- * TrustedServers.remove('my.server.com', 80);
- */
- TrustedServers.remove = function (host, port) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(host)) {
- throw new Check.DeveloperError("host is required.");
- }
- if (!when.defined(port) || port <= 0) {
- throw new Check.DeveloperError("port is required to be greater than 0.");
- }
- //>>includeEnd('debug');
- var authority = host.toLowerCase() + ":" + port;
- if (when.defined(_servers[authority])) {
- delete _servers[authority];
- }
- };
- function getAuthority(url) {
- var uri = new URI(url);
- uri.normalize();
- // Removes username:password@ so we just have host[:port]
- var authority = uri.getAuthority();
- if (!when.defined(authority)) {
- return undefined; // Relative URL
- }
- if (authority.indexOf("@") !== -1) {
- var parts = authority.split("@");
- authority = parts[1];
- }
- // If the port is missing add one based on the scheme
- if (authority.indexOf(":") === -1) {
- var scheme = uri.getScheme();
- if (!when.defined(scheme)) {
- scheme = window.location.protocol;
- scheme = scheme.substring(0, scheme.length - 1);
- }
- if (scheme === "http") {
- authority += ":80";
- } else if (scheme === "https") {
- authority += ":443";
- } else {
- return undefined;
- }
- }
- return authority;
- }
- /**
- * Tests whether a server is trusted or not. The server must have been added with the port if it is included in the url.
- *
- * @param {String} url The url to be tested against the trusted list
- *
- * @returns {boolean} Returns true if url is trusted, false otherwise.
- *
- * @example
- * // Add server
- * TrustedServers.add('my.server.com', 81);
- *
- * // Check if server is trusted
- * if (TrustedServers.contains('https://my.server.com:81/path/to/file.png')) {
- * // my.server.com:81 is trusted
- * }
- * if (TrustedServers.contains('https://my.server.com/path/to/file.png')) {
- * // my.server.com isn't trusted
- * }
- */
- TrustedServers.contains = function (url) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(url)) {
- throw new Check.DeveloperError("url is required.");
- }
- //>>includeEnd('debug');
- var authority = getAuthority(url);
- if (when.defined(authority) && when.defined(_servers[authority])) {
- return true;
- }
- return false;
- };
- /**
- * Clears the registry
- *
- * @example
- * // Remove a trusted server
- * TrustedServers.clear();
- */
- TrustedServers.clear = function () {
- _servers = {};
- };
- var xhrBlobSupported = (function () {
- try {
- var xhr = new XMLHttpRequest();
- xhr.open("GET", "#", true);
- xhr.responseType = "blob";
- return xhr.responseType === "blob";
- } catch (e) {
- return false;
- }
- })();
- /**
- * Parses a query string and returns the object equivalent.
- *
- * @param {Uri} uri The Uri with a query object.
- * @param {Resource} resource The Resource that will be assigned queryParameters.
- * @param {Boolean} merge If true, we'll merge with the resource's existing queryParameters. Otherwise they will be replaced.
- * @param {Boolean} preserveQueryParameters If true duplicate parameters will be concatenated into an array. If false, keys in uri will take precedence.
- *
- * @private
- */
- function parseQuery(uri, resource, merge, preserveQueryParameters) {
- var queryString = uri.query;
- if (!when.defined(queryString) || queryString.length === 0) {
- return {};
- }
- var query;
- // Special case we run into where the querystring is just a string, not key/value pairs
- if (queryString.indexOf("=") === -1) {
- var result = {};
- result[queryString] = undefined;
- query = result;
- } else {
- query = queryToObject(queryString);
- }
- if (merge) {
- resource._queryParameters = combineQueryParameters(
- query,
- resource._queryParameters,
- preserveQueryParameters
- );
- } else {
- resource._queryParameters = query;
- }
- uri.query = undefined;
- }
- /**
- * Converts a query object into a string.
- *
- * @param {Uri} uri The Uri object that will have the query object set.
- * @param {Resource} resource The resource that has queryParameters
- *
- * @private
- */
- function stringifyQuery(uri, resource) {
- var queryObject = resource._queryParameters;
- var keys = Object.keys(queryObject);
- // We have 1 key with an undefined value, so this is just a string, not key/value pairs
- if (keys.length === 1 && !when.defined(queryObject[keys[0]])) {
- uri.query = keys[0];
- } else {
- uri.query = objectToQuery(queryObject);
- }
- }
- /**
- * Clones a value if it is defined, otherwise returns the default value
- *
- * @param {*} [val] The value to clone.
- * @param {*} [defaultVal] The default value.
- *
- * @returns {*} A clone of val or the defaultVal.
- *
- * @private
- */
- function defaultClone(val, defaultVal) {
- if (!when.defined(val)) {
- return defaultVal;
- }
- return when.defined(val.clone) ? val.clone() : clone(val);
- }
- /**
- * Checks to make sure the Resource isn't already being requested.
- *
- * @param {Request} request The request to check.
- *
- * @private
- */
- function checkAndResetRequest(request) {
- if (
- request.state === RequestState$1.ISSUED ||
- request.state === RequestState$1.ACTIVE
- ) {
- throw new RuntimeError.RuntimeError("The Resource is already being fetched.");
- }
- request.state = RequestState$1.UNISSUED;
- request.deferred = undefined;
- }
- /**
- * This combines a map of query parameters.
- *
- * @param {Object} q1 The first map of query parameters. Values in this map will take precedence if preserveQueryParameters is false.
- * @param {Object} q2 The second map of query parameters.
- * @param {Boolean} preserveQueryParameters If true duplicate parameters will be concatenated into an array. If false, keys in q1 will take precedence.
- *
- * @returns {Object} The combined map of query parameters.
- *
- * @example
- * var q1 = {
- * a: 1,
- * b: 2
- * };
- * var q2 = {
- * a: 3,
- * c: 4
- * };
- * var q3 = {
- * b: [5, 6],
- * d: 7
- * }
- *
- * // Returns
- * // {
- * // a: [1, 3],
- * // b: 2,
- * // c: 4
- * // };
- * combineQueryParameters(q1, q2, true);
- *
- * // Returns
- * // {
- * // a: 1,
- * // b: 2,
- * // c: 4
- * // };
- * combineQueryParameters(q1, q2, false);
- *
- * // Returns
- * // {
- * // a: 1,
- * // b: [2, 5, 6],
- * // d: 7
- * // };
- * combineQueryParameters(q1, q3, true);
- *
- * // Returns
- * // {
- * // a: 1,
- * // b: 2,
- * // d: 7
- * // };
- * combineQueryParameters(q1, q3, false);
- *
- * @private
- */
- function combineQueryParameters(q1, q2, preserveQueryParameters) {
- if (!preserveQueryParameters) {
- return combine(q1, q2);
- }
- var result = clone(q1, true);
- for (var param in q2) {
- if (q2.hasOwnProperty(param)) {
- var value = result[param];
- var q2Value = q2[param];
- if (when.defined(value)) {
- if (!Array.isArray(value)) {
- value = result[param] = [value];
- }
- result[param] = value.concat(q2Value);
- } else {
- result[param] = Array.isArray(q2Value) ? q2Value.slice() : q2Value;
- }
- }
- }
- return result;
- }
- /**
- * A resource that includes the location and any other parameters we need to retrieve it or create derived resources. It also provides the ability to retry requests.
- *
- * @alias Resource
- * @constructor
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- *
- * @example
- * function refreshTokenRetryCallback(resource, error) {
- * if (error.statusCode === 403) {
- * // 403 status code means a new token should be generated
- * return getNewAccessToken()
- * .then(function(token) {
- * resource.queryParameters.access_token = token;
- * return true;
- * })
- * .otherwise(function() {
- * return false;
- * });
- * }
- *
- * return false;
- * }
- *
- * var resource = new Resource({
- * url: 'http://server.com/path/to/resource.json',
- * proxy: new DefaultProxy('/proxy/'),
- * headers: {
- * 'X-My-Header': 'valueOfHeader'
- * },
- * queryParameters: {
- * 'access_token': '123-435-456-000'
- * },
- * retryCallback: refreshTokenRetryCallback,
- * retryAttempts: 1
- * });
- */
- function Resource(options) {
- options = when.defaultValue(options, when.defaultValue.EMPTY_OBJECT);
- if (typeof options === "string") {
- options = {
- url: options,
- };
- }
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.string("options.url", options.url);
- //>>includeEnd('debug');
- this._url = undefined;
- this._templateValues = defaultClone(options.templateValues, {});
- this._queryParameters = defaultClone(options.queryParameters, {});
- /**
- * Additional HTTP headers that will be sent with the request.
- *
- * @type {Object}
- */
- this.headers = defaultClone(options.headers, {});
- /**
- * A Request object that will be used. Intended for internal use only.
- *
- * @type {Request}
- */
- this.request = when.defaultValue(options.request, new Request());
- /**
- * A proxy to be used when loading the resource.
- *
- * @type {Proxy}
- */
- this.proxy = options.proxy;
- /**
- * Function to call when a request for this resource fails. If it returns true or a Promise that resolves to true, the request will be retried.
- *
- * @type {Function}
- */
- this.retryCallback = options.retryCallback;
- /**
- * The number of times the retryCallback should be called before giving up.
- *
- * @type {Number}
- */
- this.retryAttempts = when.defaultValue(options.retryAttempts, 0);
- this._retryCount = 0;
- var uri = new URI(options.url);
- parseQuery(uri, this, true, true);
- // Remove the fragment as it's not sent with a request
- uri.fragment = undefined;
- this._url = uri.toString();
- }
- /**
- * A helper function to create a resource depending on whether we have a String or a Resource
- *
- * @param {Resource|String} resource A Resource or a String to use when creating a new Resource.
- *
- * @returns {Resource} If resource is a String, a Resource constructed with the url and options. Otherwise the resource parameter is returned.
- *
- * @private
- */
- Resource.createIfNeeded = function (resource) {
- if (resource instanceof Resource) {
- // Keep existing request object. This function is used internally to duplicate a Resource, so that it can't
- // be modified outside of a class that holds it (eg. an imagery or terrain provider). Since the Request objects
- // are managed outside of the providers, by the tile loading code, we want to keep the request property the same so if it is changed
- // in the underlying tiling code the requests for this resource will use it.
- return resource.getDerivedResource({
- request: resource.request,
- });
- }
- if (typeof resource !== "string") {
- return resource;
- }
- return new Resource({
- url: resource,
- });
- };
- var supportsImageBitmapOptionsPromise;
- /**
- * A helper function to check whether createImageBitmap supports passing ImageBitmapOptions.
- *
- * @returns {Promise<Boolean>} A promise that resolves to true if this browser supports creating an ImageBitmap with options.
- *
- * @private
- */
- Resource.supportsImageBitmapOptions = function () {
- // Until the HTML folks figure out what to do about this, we need to actually try loading an image to
- // know if this browser supports passing options to the createImageBitmap function.
- // https://github.com/whatwg/html/pull/4248
- if (when.defined(supportsImageBitmapOptionsPromise)) {
- return supportsImageBitmapOptionsPromise;
- }
- if (typeof createImageBitmap !== "function") {
- supportsImageBitmapOptionsPromise = when.when.resolve(false);
- return supportsImageBitmapOptionsPromise;
- }
- var imageDataUri =
- "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVQImWP4////fwAJ+wP9CNHoHgAAAABJRU5ErkJggg==";
- supportsImageBitmapOptionsPromise = Resource.fetchBlob({
- url: imageDataUri,
- })
- .then(function (blob) {
- return createImageBitmap(blob, {
- imageOrientation: "flipY",
- premultiplyAlpha: "none",
- });
- })
- .then(function (imageBitmap) {
- return true;
- })
- .otherwise(function () {
- return false;
- });
- return supportsImageBitmapOptionsPromise;
- };
- Object.defineProperties(Resource, {
- /**
- * Returns true if blobs are supported.
- *
- * @memberof Resource
- * @type {Boolean}
- *
- * @readonly
- */
- isBlobSupported: {
- get: function () {
- return xhrBlobSupported;
- },
- },
- });
- Object.defineProperties(Resource.prototype, {
- /**
- * Query parameters appended to the url.
- *
- * @memberof Resource.prototype
- * @type {Object}
- *
- * @readonly
- */
- queryParameters: {
- get: function () {
- return this._queryParameters;
- },
- },
- /**
- * The key/value pairs used to replace template parameters in the url.
- *
- * @memberof Resource.prototype
- * @type {Object}
- *
- * @readonly
- */
- templateValues: {
- get: function () {
- return this._templateValues;
- },
- },
- /**
- * The url to the resource with template values replaced, query string appended and encoded by proxy if one was set.
- *
- * @memberof Resource.prototype
- * @type {String}
- */
- url: {
- get: function () {
- return this.getUrlComponent(true, true);
- },
- set: function (value) {
- var uri = new URI(value);
- parseQuery(uri, this, false);
- // Remove the fragment as it's not sent with a request
- uri.fragment = undefined;
- this._url = uri.toString();
- },
- },
- /**
- * The file extension of the resource.
- *
- * @memberof Resource.prototype
- * @type {String}
- *
- * @readonly
- */
- extension: {
- get: function () {
- return getExtensionFromUri(this._url);
- },
- },
- /**
- * True if the Resource refers to a data URI.
- *
- * @memberof Resource.prototype
- * @type {Boolean}
- */
- isDataUri: {
- get: function () {
- return isDataUri(this._url);
- },
- },
- /**
- * True if the Resource refers to a blob URI.
- *
- * @memberof Resource.prototype
- * @type {Boolean}
- */
- isBlobUri: {
- get: function () {
- return isBlobUri(this._url);
- },
- },
- /**
- * True if the Resource refers to a cross origin URL.
- *
- * @memberof Resource.prototype
- * @type {Boolean}
- */
- isCrossOriginUrl: {
- get: function () {
- return isCrossOriginUrl(this._url);
- },
- },
- /**
- * True if the Resource has request headers. This is equivalent to checking if the headers property has any keys.
- *
- * @memberof Resource.prototype
- * @type {Boolean}
- */
- hasHeaders: {
- get: function () {
- return Object.keys(this.headers).length > 0;
- },
- },
- });
- /**
- * Override Object#toString so that implicit string conversion gives the
- * complete URL represented by this Resource.
- *
- * @returns {String} The URL represented by this Resource
- */
- Resource.prototype.toString = function () {
- return this.getUrlComponent(true, true);
- };
- /**
- * Returns the url, optional with the query string and processed by a proxy.
- *
- * @param {Boolean} [query=false] If true, the query string is included.
- * @param {Boolean} [proxy=false] If true, the url is processed by the proxy object, if defined.
- *
- * @returns {String} The url with all the requested components.
- */
- Resource.prototype.getUrlComponent = function (query, proxy) {
- if (this.isDataUri) {
- return this._url;
- }
- var uri = new URI(this._url);
- if (query) {
- stringifyQuery(uri, this);
- }
- // objectToQuery escapes the placeholders. Undo that.
- var url = uri.toString().replace(/%7B/g, "{").replace(/%7D/g, "}");
- var templateValues = this._templateValues;
- url = url.replace(/{(.*?)}/g, function (match, key) {
- var replacement = templateValues[key];
- if (when.defined(replacement)) {
- // use the replacement value from templateValues if there is one...
- return encodeURIComponent(replacement);
- }
- // otherwise leave it unchanged
- return match;
- });
- if (proxy && when.defined(this.proxy)) {
- url = this.proxy.getURL(url);
- }
- return url;
- };
- /**
- * Combines the specified object and the existing query parameters. This allows you to add many parameters at once,
- * as opposed to adding them one at a time to the queryParameters property. If a value is already set, it will be replaced with the new value.
- *
- * @param {Object} params The query parameters
- * @param {Boolean} [useAsDefault=false] If true the params will be used as the default values, so they will only be set if they are undefined.
- */
- Resource.prototype.setQueryParameters = function (params, useAsDefault) {
- if (useAsDefault) {
- this._queryParameters = combineQueryParameters(
- this._queryParameters,
- params,
- false
- );
- } else {
- this._queryParameters = combineQueryParameters(
- params,
- this._queryParameters,
- false
- );
- }
- };
- /**
- * Combines the specified object and the existing query parameters. This allows you to add many parameters at once,
- * as opposed to adding them one at a time to the queryParameters property.
- *
- * @param {Object} params The query parameters
- */
- Resource.prototype.appendQueryParameters = function (params) {
- this._queryParameters = combineQueryParameters(
- params,
- this._queryParameters,
- true
- );
- };
- /**
- * Combines the specified object and the existing template values. This allows you to add many values at once,
- * as opposed to adding them one at a time to the templateValues property. If a value is already set, it will become an array and the new value will be appended.
- *
- * @param {Object} template The template values
- * @param {Boolean} [useAsDefault=false] If true the values will be used as the default values, so they will only be set if they are undefined.
- */
- Resource.prototype.setTemplateValues = function (template, useAsDefault) {
- if (useAsDefault) {
- this._templateValues = combine(this._templateValues, template);
- } else {
- this._templateValues = combine(template, this._templateValues);
- }
- };
- /**
- * Returns a resource relative to the current instance. All properties remain the same as the current instance unless overridden in options.
- *
- * @param {Object} options An object with the following properties
- * @param {String} [options.url] The url that will be resolved relative to the url of the current instance.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be combined with those of the current instance.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}). These will be combined with those of the current instance.
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The function to call when loading the resource fails.
- * @param {Number} [options.retryAttempts] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {Boolean} [options.preserveQueryParameters=false] If true, this will keep all query parameters from the current resource and derived resource. If false, derived parameters will replace those of the current resource.
- *
- * @returns {Resource} The resource derived from the current one.
- */
- Resource.prototype.getDerivedResource = function (options) {
- var resource = this.clone();
- resource._retryCount = 0;
- if (when.defined(options.url)) {
- var uri = new URI(options.url);
- var preserveQueryParameters = when.defaultValue(
- options.preserveQueryParameters,
- false
- );
- parseQuery(uri, resource, true, preserveQueryParameters);
- // Remove the fragment as it's not sent with a request
- uri.fragment = undefined;
- resource._url = uri.resolve(new URI(getAbsoluteUri(this._url))).toString();
- }
- if (when.defined(options.queryParameters)) {
- resource._queryParameters = combine(
- options.queryParameters,
- resource._queryParameters
- );
- }
- if (when.defined(options.templateValues)) {
- resource._templateValues = combine(
- options.templateValues,
- resource.templateValues
- );
- }
- if (when.defined(options.headers)) {
- resource.headers = combine(options.headers, resource.headers);
- }
- if (when.defined(options.proxy)) {
- resource.proxy = options.proxy;
- }
- if (when.defined(options.request)) {
- resource.request = options.request;
- }
- if (when.defined(options.retryCallback)) {
- resource.retryCallback = options.retryCallback;
- }
- if (when.defined(options.retryAttempts)) {
- resource.retryAttempts = options.retryAttempts;
- }
- return resource;
- };
- /**
- * Called when a resource fails to load. This will call the retryCallback function if defined until retryAttempts is reached.
- *
- * @param {Error} [error] The error that was encountered.
- *
- * @returns {Promise<Boolean>} A promise to a boolean, that if true will cause the resource request to be retried.
- *
- * @private
- */
- Resource.prototype.retryOnError = function (error) {
- var retryCallback = this.retryCallback;
- if (
- typeof retryCallback !== "function" ||
- this._retryCount >= this.retryAttempts
- ) {
- return when.when(false);
- }
- var that = this;
- return when.when(retryCallback(this, error)).then(function (result) {
- ++that._retryCount;
- return result;
- });
- };
- /**
- * Duplicates a Resource instance.
- *
- * @param {Resource} [result] The object onto which to store the result.
- *
- * @returns {Resource} The modified result parameter or a new Resource instance if one was not provided.
- */
- Resource.prototype.clone = function (result) {
- if (!when.defined(result)) {
- result = new Resource({
- url: this._url,
- });
- }
- result._url = this._url;
- result._queryParameters = clone(this._queryParameters);
- result._templateValues = clone(this._templateValues);
- result.headers = clone(this.headers);
- result.proxy = this.proxy;
- result.retryCallback = this.retryCallback;
- result.retryAttempts = this.retryAttempts;
- result._retryCount = 0;
- result.request = this.request.clone();
- return result;
- };
- /**
- * Returns the base path of the Resource.
- *
- * @param {Boolean} [includeQuery = false] Whether or not to include the query string and fragment form the uri
- *
- * @returns {String} The base URI of the resource
- */
- Resource.prototype.getBaseUri = function (includeQuery) {
- return getBaseUri(this.getUrlComponent(includeQuery), includeQuery);
- };
- /**
- * Appends a forward slash to the URL.
- */
- Resource.prototype.appendForwardSlash = function () {
- this._url = appendForwardSlash(this._url);
- };
- /**
- * Asynchronously loads the resource as raw binary data. Returns a promise that will resolve to
- * an ArrayBuffer once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @returns {Promise.<ArrayBuffer>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- * @example
- * // load a single URL asynchronously
- * resource.fetchArrayBuffer().then(function(arrayBuffer) {
- * // use the data
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.fetchArrayBuffer = function () {
- return this.fetch({
- responseType: "arraybuffer",
- });
- };
- /**
- * Creates a Resource and calls fetchArrayBuffer() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @returns {Promise.<ArrayBuffer>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.fetchArrayBuffer = function (options) {
- var resource = new Resource(options);
- return resource.fetchArrayBuffer();
- };
- /**
- * Asynchronously loads the given resource as a blob. Returns a promise that will resolve to
- * a Blob once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @returns {Promise.<Blob>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- * @example
- * // load a single URL asynchronously
- * resource.fetchBlob().then(function(blob) {
- * // use the data
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.fetchBlob = function () {
- return this.fetch({
- responseType: "blob",
- });
- };
- /**
- * Creates a Resource and calls fetchBlob() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @returns {Promise.<Blob>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.fetchBlob = function (options) {
- var resource = new Resource(options);
- return resource.fetchBlob();
- };
- /**
- * Asynchronously loads the given image resource. Returns a promise that will resolve to
- * an {@link https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap|ImageBitmap} if <code>preferImageBitmap</code> is true and the browser supports <code>createImageBitmap</code> or otherwise an
- * {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement|Image} once loaded, or reject if the image failed to load.
- *
- * @param {Object} [options] An object with the following properties.
- * @param {Boolean} [options.preferBlob=false] If true, we will load the image via a blob.
- * @param {Boolean} [options.preferImageBitmap=false] If true, image will be decoded during fetch and an <code>ImageBitmap</code> is returned.
- * @param {Boolean} [options.flipY=false] If true, image will be vertically flipped during decode. Only applies if the browser supports <code>createImageBitmap</code>.
- * @returns {Promise.<ImageBitmap>|Promise.<HTMLImageElement>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * // load a single image asynchronously
- * resource.fetchImage().then(function(image) {
- * // use the loaded image
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * // load several images in parallel
- * when.all([resource1.fetchImage(), resource2.fetchImage()]).then(function(images) {
- * // images is an array containing all the loaded images
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.fetchImage = function (options) {
- options = when.defaultValue(options, when.defaultValue.EMPTY_OBJECT);
- var preferImageBitmap = when.defaultValue(options.preferImageBitmap, false);
- var preferBlob = when.defaultValue(options.preferBlob, false);
- var flipY = when.defaultValue(options.flipY, false);
- checkAndResetRequest(this.request);
- // We try to load the image normally if
- // 1. Blobs aren't supported
- // 2. It's a data URI
- // 3. It's a blob URI
- // 4. It doesn't have request headers and we preferBlob is false
- if (
- !xhrBlobSupported ||
- this.isDataUri ||
- this.isBlobUri ||
- (!this.hasHeaders && !preferBlob)
- ) {
- return fetchImage({
- resource: this,
- flipY: flipY,
- preferImageBitmap: preferImageBitmap,
- });
- }
- var blobPromise = this.fetchBlob();
- if (!when.defined(blobPromise)) {
- return;
- }
- var supportsImageBitmap;
- var useImageBitmap;
- var generatedBlobResource;
- var generatedBlob;
- return Resource.supportsImageBitmapOptions()
- .then(function (result) {
- supportsImageBitmap = result;
- useImageBitmap = supportsImageBitmap && preferImageBitmap;
- return blobPromise;
- })
- .then(function (blob) {
- if (!when.defined(blob)) {
- return;
- }
- generatedBlob = blob;
- if (useImageBitmap) {
- return Resource.createImageBitmapFromBlob(blob, {
- flipY: flipY,
- premultiplyAlpha: false,
- });
- }
- var blobUrl = window.URL.createObjectURL(blob);
- generatedBlobResource = new Resource({
- url: blobUrl,
- });
- return fetchImage({
- resource: generatedBlobResource,
- flipY: flipY,
- preferImageBitmap: false,
- });
- })
- .then(function (image) {
- if (!when.defined(image)) {
- return;
- }
- // The blob object may be needed for use by a TileDiscardPolicy,
- // so attach it to the image.
- image.blob = generatedBlob;
- if (useImageBitmap) {
- return image;
- }
- window.URL.revokeObjectURL(generatedBlobResource.url);
- return image;
- })
- .otherwise(function (error) {
- if (when.defined(generatedBlobResource)) {
- window.URL.revokeObjectURL(generatedBlobResource.url);
- }
- // If the blob load succeeded but the image decode failed, attach the blob
- // to the error object for use by a TileDiscardPolicy.
- // In particular, BingMapsImageryProvider uses this to detect the
- // zero-length response that is returned when a tile is not available.
- error.blob = generatedBlob;
- return when.when.reject(error);
- });
- };
- /**
- * Fetches an image and returns a promise to it.
- *
- * @param {Object} [options] An object with the following properties.
- * @param {Resource} [options.resource] Resource object that points to an image to fetch.
- * @param {Boolean} [options.preferImageBitmap] If true, image will be decoded during fetch and an <code>ImageBitmap</code> is returned.
- * @param {Boolean} [options.flipY] If true, image will be vertically flipped during decode. Only applies if the browser supports <code>createImageBitmap</code>.
- *
- * @private
- */
- function fetchImage(options) {
- var resource = options.resource;
- var flipY = options.flipY;
- var preferImageBitmap = options.preferImageBitmap;
- var request = resource.request;
- request.url = resource.url;
- request.requestFunction = function () {
- var crossOrigin = false;
- // data URIs can't have crossorigin set.
- if (!resource.isDataUri && !resource.isBlobUri) {
- crossOrigin = resource.isCrossOriginUrl;
- }
- var deferred = when.when.defer();
- Resource._Implementations.createImage(
- request,
- crossOrigin,
- deferred,
- flipY,
- preferImageBitmap
- );
- return deferred.promise;
- };
- var promise = RequestScheduler.request(request);
- if (!when.defined(promise)) {
- return;
- }
- return promise.otherwise(function (e) {
- // Don't retry cancelled or otherwise aborted requests
- if (request.state !== RequestState$1.FAILED) {
- return when.when.reject(e);
- }
- return resource.retryOnError(e).then(function (retry) {
- if (retry) {
- // Reset request so it can try again
- request.state = RequestState$1.UNISSUED;
- request.deferred = undefined;
- return fetchImage({
- resource: resource,
- flipY: flipY,
- preferImageBitmap: preferImageBitmap,
- });
- }
- return when.when.reject(e);
- });
- });
- }
- /**
- * Creates a Resource and calls fetchImage() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Boolean} [options.flipY=false] Whether to vertically flip the image during fetch and decode. Only applies when requesting an image and the browser supports <code>createImageBitmap</code>.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {Boolean} [options.preferBlob=false] If true, we will load the image via a blob.
- * @param {Boolean} [options.preferImageBitmap=false] If true, image will be decoded during fetch and an <code>ImageBitmap</code> is returned.
- * @returns {Promise.<ImageBitmap>|Promise.<HTMLImageElement>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.fetchImage = function (options) {
- var resource = new Resource(options);
- return resource.fetchImage({
- flipY: options.flipY,
- preferBlob: options.preferBlob,
- preferImageBitmap: options.preferImageBitmap,
- });
- };
- /**
- * Asynchronously loads the given resource as text. Returns a promise that will resolve to
- * a String once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @returns {Promise.<String>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- * @example
- * // load text from a URL, setting a custom header
- * var resource = new Resource({
- * url: 'http://someUrl.com/someJson.txt',
- * headers: {
- * 'X-Custom-Header' : 'some value'
- * }
- * });
- * resource.fetchText().then(function(text) {
- * // Do something with the text
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest|XMLHttpRequest}
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.fetchText = function () {
- return this.fetch({
- responseType: "text",
- });
- };
- /**
- * Creates a Resource and calls fetchText() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @returns {Promise.<String>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.fetchText = function (options) {
- var resource = new Resource(options);
- return resource.fetchText();
- };
- // note: */* below is */* but that ends the comment block early
- /**
- * Asynchronously loads the given resource as JSON. Returns a promise that will resolve to
- * a JSON object once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled. This function
- * adds 'Accept: application/json,*/*;q=0.01' to the request headers, if not
- * already specified.
- *
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * resource.fetchJson().then(function(jsonData) {
- * // Do something with the JSON object
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.fetchJson = function () {
- var promise = this.fetch({
- responseType: "text",
- headers: {
- Accept: "application/json,*/*;q=0.01",
- },
- });
- if (!when.defined(promise)) {
- return undefined;
- }
- return promise.then(function (value) {
- if (!when.defined(value)) {
- return;
- }
- return JSON.parse(value);
- });
- };
- /**
- * Creates a Resource and calls fetchJson() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.fetchJson = function (options) {
- var resource = new Resource(options);
- return resource.fetchJson();
- };
- /**
- * Asynchronously loads the given resource as XML. Returns a promise that will resolve to
- * an XML Document once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @returns {Promise.<XMLDocument>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * // load XML from a URL, setting a custom header
- * Cesium.loadXML('http://someUrl.com/someXML.xml', {
- * 'X-Custom-Header' : 'some value'
- * }).then(function(document) {
- * // Do something with the document
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest|XMLHttpRequest}
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.fetchXML = function () {
- return this.fetch({
- responseType: "document",
- overrideMimeType: "text/xml",
- });
- };
- /**
- * Creates a Resource and calls fetchXML() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @returns {Promise.<XMLDocument>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.fetchXML = function (options) {
- var resource = new Resource(options);
- return resource.fetchXML();
- };
- /**
- * Requests a resource using JSONP.
- *
- * @param {String} [callbackParameterName='callback'] The callback parameter name that the server expects.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * // load a data asynchronously
- * resource.fetchJsonp().then(function(data) {
- * // use the loaded data
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.fetchJsonp = function (callbackParameterName) {
- callbackParameterName = when.defaultValue(callbackParameterName, "callback");
- checkAndResetRequest(this.request);
- //generate a unique function name
- var functionName;
- do {
- functionName = "loadJsonp" + Math.random().toString().substring(2, 8);
- } while (when.defined(window[functionName]));
- return fetchJsonp(this, callbackParameterName, functionName);
- };
- function fetchJsonp(resource, callbackParameterName, functionName) {
- var callbackQuery = {};
- callbackQuery[callbackParameterName] = functionName;
- resource.setQueryParameters(callbackQuery);
- var request = resource.request;
- request.url = resource.url;
- request.requestFunction = function () {
- var deferred = when.when.defer();
- //assign a function with that name in the global scope
- window[functionName] = function (data) {
- deferred.resolve(data);
- try {
- delete window[functionName];
- } catch (e) {
- window[functionName] = undefined;
- }
- };
- Resource._Implementations.loadAndExecuteScript(
- resource.url,
- functionName,
- deferred
- );
- return deferred.promise;
- };
- var promise = RequestScheduler.request(request);
- if (!when.defined(promise)) {
- return;
- }
- return promise.otherwise(function (e) {
- if (request.state !== RequestState$1.FAILED) {
- return when.when.reject(e);
- }
- return resource.retryOnError(e).then(function (retry) {
- if (retry) {
- // Reset request so it can try again
- request.state = RequestState$1.UNISSUED;
- request.deferred = undefined;
- return fetchJsonp(resource, callbackParameterName, functionName);
- }
- return when.when.reject(e);
- });
- });
- }
- /**
- * Creates a Resource from a URL and calls fetchJsonp() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {String} [options.callbackParameterName='callback'] The callback parameter name that the server expects.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.fetchJsonp = function (options) {
- var resource = new Resource(options);
- return resource.fetchJsonp(options.callbackParameterName);
- };
- /**
- * @private
- */
- Resource.prototype._makeRequest = function (options) {
- var resource = this;
- checkAndResetRequest(resource.request);
- var request = resource.request;
- request.url = resource.url;
- request.requestFunction = function () {
- var responseType = options.responseType;
- var headers = combine(options.headers, resource.headers);
- var overrideMimeType = options.overrideMimeType;
- var method = options.method;
- var data = options.data;
- var deferred = when.when.defer();
- var xhr = Resource._Implementations.loadWithXhr(
- resource.url,
- responseType,
- method,
- data,
- headers,
- deferred,
- overrideMimeType
- );
- if (when.defined(xhr) && when.defined(xhr.abort)) {
- request.cancelFunction = function () {
- xhr.abort();
- };
- }
- return deferred.promise;
- };
- var promise = RequestScheduler.request(request);
- if (!when.defined(promise)) {
- return;
- }
- return promise
- .then(function (data) {
- // explicitly set to undefined to ensure GC of request response data. See #8843
- request.cancelFunction = undefined;
- return data;
- })
- .otherwise(function (e) {
- request.cancelFunction = undefined;
- if (request.state !== RequestState$1.FAILED) {
- return when.when.reject(e);
- }
- return resource.retryOnError(e).then(function (retry) {
- if (retry) {
- // Reset request so it can try again
- request.state = RequestState$1.UNISSUED;
- request.deferred = undefined;
- return resource.fetch(options);
- }
- return when.when.reject(e);
- });
- });
- };
- var dataUriRegex$1 = /^data:(.*?)(;base64)?,(.*)$/;
- function decodeDataUriText(isBase64, data) {
- var result = decodeURIComponent(data);
- if (isBase64) {
- return atob(result);
- }
- return result;
- }
- function decodeDataUriArrayBuffer(isBase64, data) {
- var byteString = decodeDataUriText(isBase64, data);
- var buffer = new ArrayBuffer(byteString.length);
- var view = new Uint8Array(buffer);
- for (var i = 0; i < byteString.length; i++) {
- view[i] = byteString.charCodeAt(i);
- }
- return buffer;
- }
- function decodeDataUri(dataUriRegexResult, responseType) {
- responseType = when.defaultValue(responseType, "");
- var mimeType = dataUriRegexResult[1];
- var isBase64 = !!dataUriRegexResult[2];
- var data = dataUriRegexResult[3];
- switch (responseType) {
- case "":
- case "text":
- return decodeDataUriText(isBase64, data);
- case "arraybuffer":
- return decodeDataUriArrayBuffer(isBase64, data);
- case "blob":
- var buffer = decodeDataUriArrayBuffer(isBase64, data);
- return new Blob([buffer], {
- type: mimeType,
- });
- case "document":
- var parser = new DOMParser();
- return parser.parseFromString(
- decodeDataUriText(isBase64, data),
- mimeType
- );
- case "json":
- return JSON.parse(decodeDataUriText(isBase64, data));
- default:
- //>>includeStart('debug', pragmas.debug);
- throw new Check.DeveloperError("Unhandled responseType: " + responseType);
- //>>includeEnd('debug');
- }
- }
- /**
- * Asynchronously loads the given resource. Returns a promise that will resolve to
- * the result once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled. It's recommended that you use
- * the more specific functions eg. fetchJson, fetchBlob, etc.
- *
- * @param {Object} [options] Object with the following properties:
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {Object} [options.headers] Additional HTTP headers to send with the request, if any.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * resource.fetch()
- * .then(function(body) {
- * // use the data
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.fetch = function (options) {
- options = defaultClone(options, {});
- options.method = "GET";
- return this._makeRequest(options);
- };
- /**
- * Creates a Resource from a URL and calls fetch() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.fetch = function (options) {
- var resource = new Resource(options);
- return resource.fetch({
- // Make copy of just the needed fields because headers can be passed to both the constructor and to fetch
- responseType: options.responseType,
- overrideMimeType: options.overrideMimeType,
- });
- };
- /**
- * Asynchronously deletes the given resource. Returns a promise that will resolve to
- * the result once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @param {Object} [options] Object with the following properties:
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {Object} [options.headers] Additional HTTP headers to send with the request, if any.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * resource.delete()
- * .then(function(body) {
- * // use the data
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.delete = function (options) {
- options = defaultClone(options, {});
- options.method = "DELETE";
- return this._makeRequest(options);
- };
- /**
- * Creates a Resource from a URL and calls delete() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.data] Data that is posted with the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.delete = function (options) {
- var resource = new Resource(options);
- return resource.delete({
- // Make copy of just the needed fields because headers can be passed to both the constructor and to fetch
- responseType: options.responseType,
- overrideMimeType: options.overrideMimeType,
- data: options.data,
- });
- };
- /**
- * Asynchronously gets headers the given resource. Returns a promise that will resolve to
- * the result once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @param {Object} [options] Object with the following properties:
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {Object} [options.headers] Additional HTTP headers to send with the request, if any.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * resource.head()
- * .then(function(headers) {
- * // use the data
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.head = function (options) {
- options = defaultClone(options, {});
- options.method = "HEAD";
- return this._makeRequest(options);
- };
- /**
- * Creates a Resource from a URL and calls head() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.head = function (options) {
- var resource = new Resource(options);
- return resource.head({
- // Make copy of just the needed fields because headers can be passed to both the constructor and to fetch
- responseType: options.responseType,
- overrideMimeType: options.overrideMimeType,
- });
- };
- /**
- * Asynchronously gets options the given resource. Returns a promise that will resolve to
- * the result once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @param {Object} [options] Object with the following properties:
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {Object} [options.headers] Additional HTTP headers to send with the request, if any.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * resource.options()
- * .then(function(headers) {
- * // use the data
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.options = function (options) {
- options = defaultClone(options, {});
- options.method = "OPTIONS";
- return this._makeRequest(options);
- };
- /**
- * Creates a Resource from a URL and calls options() on it.
- *
- * @param {String|Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.options = function (options) {
- var resource = new Resource(options);
- return resource.options({
- // Make copy of just the needed fields because headers can be passed to both the constructor and to fetch
- responseType: options.responseType,
- overrideMimeType: options.overrideMimeType,
- });
- };
- /**
- * Asynchronously posts data to the given resource. Returns a promise that will resolve to
- * the result once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @param {Object} data Data that is posted with the resource.
- * @param {Object} [options] Object with the following properties:
- * @param {Object} [options.data] Data that is posted with the resource.
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {Object} [options.headers] Additional HTTP headers to send with the request, if any.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * resource.post(data)
- * .then(function(result) {
- * // use the result
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.post = function (data, options) {
- Check.Check.defined("data", data);
- options = defaultClone(options, {});
- options.method = "POST";
- options.data = data;
- return this._makeRequest(options);
- };
- /**
- * Creates a Resource from a URL and calls post() on it.
- *
- * @param {Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} options.data Data that is posted with the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.post = function (options) {
- var resource = new Resource(options);
- return resource.post(options.data, {
- // Make copy of just the needed fields because headers can be passed to both the constructor and to post
- responseType: options.responseType,
- overrideMimeType: options.overrideMimeType,
- });
- };
- /**
- * Asynchronously puts data to the given resource. Returns a promise that will resolve to
- * the result once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @param {Object} data Data that is posted with the resource.
- * @param {Object} [options] Object with the following properties:
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {Object} [options.headers] Additional HTTP headers to send with the request, if any.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * resource.put(data)
- * .then(function(result) {
- * // use the result
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.put = function (data, options) {
- Check.Check.defined("data", data);
- options = defaultClone(options, {});
- options.method = "PUT";
- options.data = data;
- return this._makeRequest(options);
- };
- /**
- * Creates a Resource from a URL and calls put() on it.
- *
- * @param {Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} options.data Data that is posted with the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.put = function (options) {
- var resource = new Resource(options);
- return resource.put(options.data, {
- // Make copy of just the needed fields because headers can be passed to both the constructor and to post
- responseType: options.responseType,
- overrideMimeType: options.overrideMimeType,
- });
- };
- /**
- * Asynchronously patches data to the given resource. Returns a promise that will resolve to
- * the result once loaded, or reject if the resource failed to load. The data is loaded
- * using XMLHttpRequest, which means that in order to make requests to another origin,
- * the server must have Cross-Origin Resource Sharing (CORS) headers enabled.
- *
- * @param {Object} data Data that is posted with the resource.
- * @param {Object} [options] Object with the following properties:
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {Object} [options.headers] Additional HTTP headers to send with the request, if any.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- *
- *
- * @example
- * resource.patch(data)
- * .then(function(result) {
- * // use the result
- * }).otherwise(function(error) {
- * // an error occurred
- * });
- *
- * @see {@link http://www.w3.org/TR/cors/|Cross-Origin Resource Sharing}
- * @see {@link http://wiki.commonjs.org/wiki/Promises/A|CommonJS Promises/A}
- */
- Resource.prototype.patch = function (data, options) {
- Check.Check.defined("data", data);
- options = defaultClone(options, {});
- options.method = "PATCH";
- options.data = data;
- return this._makeRequest(options);
- };
- /**
- * Creates a Resource from a URL and calls patch() on it.
- *
- * @param {Object} options A url or an object with the following properties
- * @param {String} options.url The url of the resource.
- * @param {Object} options.data Data that is posted with the resource.
- * @param {Object} [options.queryParameters] An object containing query parameters that will be sent when retrieving the resource.
- * @param {Object} [options.templateValues] Key/Value pairs that are used to replace template values (eg. {x}).
- * @param {Object} [options.headers={}] Additional HTTP headers that will be sent.
- * @param {Proxy} [options.proxy] A proxy to be used when loading the resource.
- * @param {Resource.RetryCallback} [options.retryCallback] The Function to call when a request for this resource fails. If it returns true, the request will be retried.
- * @param {Number} [options.retryAttempts=0] The number of times the retryCallback should be called before giving up.
- * @param {Request} [options.request] A Request object that will be used. Intended for internal use only.
- * @param {String} [options.responseType] The type of response. This controls the type of item returned.
- * @param {String} [options.overrideMimeType] Overrides the MIME type returned by the server.
- * @returns {Promise.<*>|undefined} a promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
- */
- Resource.patch = function (options) {
- var resource = new Resource(options);
- return resource.patch(options.data, {
- // Make copy of just the needed fields because headers can be passed to both the constructor and to post
- responseType: options.responseType,
- overrideMimeType: options.overrideMimeType,
- });
- };
- /**
- * Contains implementations of functions that can be replaced for testing
- *
- * @private
- */
- Resource._Implementations = {};
- function loadImageElement(url, crossOrigin, deferred) {
- var image = new Image();
- image.onload = function () {
- deferred.resolve(image);
- };
- image.onerror = function (e) {
- deferred.reject(e);
- };
- if (crossOrigin) {
- if (TrustedServers.contains(url)) {
- image.crossOrigin = "use-credentials";
- } else {
- image.crossOrigin = "";
- }
- }
- image.src = url;
- }
- Resource._Implementations.createImage = function (
- request,
- crossOrigin,
- deferred,
- flipY,
- preferImageBitmap
- ) {
- var url = request.url;
- // Passing an Image to createImageBitmap will force it to run on the main thread
- // since DOM elements don't exist on workers. We convert it to a blob so it's non-blocking.
- // See:
- // https://bugzilla.mozilla.org/show_bug.cgi?id=1044102#c38
- // https://bugs.chromium.org/p/chromium/issues/detail?id=580202#c10
- Resource.supportsImageBitmapOptions()
- .then(function (supportsImageBitmap) {
- // We can only use ImageBitmap if we can flip on decode.
- // See: https://github.com/CesiumGS/cesium/pull/7579#issuecomment-466146898
- if (!(supportsImageBitmap && preferImageBitmap)) {
- loadImageElement(url, crossOrigin, deferred);
- return;
- }
- var responseType = "blob";
- var method = "GET";
- var xhrDeferred = when.when.defer();
- var xhr = Resource._Implementations.loadWithXhr(
- url,
- responseType,
- method,
- undefined,
- undefined,
- xhrDeferred,
- undefined,
- undefined,
- undefined
- );
- if (when.defined(xhr) && when.defined(xhr.abort)) {
- request.cancelFunction = function () {
- xhr.abort();
- };
- }
- return xhrDeferred.promise
- .then(function (blob) {
- if (!when.defined(blob)) {
- deferred.reject(
- new RuntimeError.RuntimeError(
- "Successfully retrieved " +
- url +
- " but it contained no content."
- )
- );
- return;
- }
- return Resource.createImageBitmapFromBlob(blob, {
- flipY: flipY,
- premultiplyAlpha: false,
- });
- })
- .then(deferred.resolve);
- })
- .otherwise(deferred.reject);
- };
- /**
- * Wrapper for createImageBitmap
- *
- * @private
- */
- Resource.createImageBitmapFromBlob = function (blob, options) {
- Check.Check.defined("options", options);
- Check.Check.typeOf.bool("options.flipY", options.flipY);
- Check.Check.typeOf.bool("options.premultiplyAlpha", options.premultiplyAlpha);
- return createImageBitmap(blob, {
- imageOrientation: options.flipY ? "flipY" : "none",
- premultiplyAlpha: options.premultiplyAlpha ? "premultiply" : "none",
- });
- };
- function decodeResponse(loadWithHttpResponse, responseType) {
- switch (responseType) {
- case "text":
- return loadWithHttpResponse.toString("utf8");
- case "json":
- return JSON.parse(loadWithHttpResponse.toString("utf8"));
- default:
- return new Uint8Array(loadWithHttpResponse).buffer;
- }
- }
- function loadWithHttpRequest(
- url,
- responseType,
- method,
- data,
- headers,
- deferred,
- overrideMimeType
- ) {
- // Note: only the 'json' and 'text' responseTypes transforms the loaded buffer
- /* eslint-disable no-undef */
- var URL = require("url").parse(url);
- var http = URL.protocol === "https:" ? require("https") : require("http");
- var zlib = require("zlib");
- /* eslint-enable no-undef */
- var options = {
- protocol: URL.protocol,
- hostname: URL.hostname,
- port: URL.port,
- path: URL.path,
- query: URL.query,
- method: method,
- headers: headers,
- };
- http
- .request(options)
- .on("response", function (res) {
- if (res.statusCode < 200 || res.statusCode >= 300) {
- deferred.reject(
- new RequestErrorEvent(res.statusCode, res, res.headers)
- );
- return;
- }
- var chunkArray = [];
- res.on("data", function (chunk) {
- chunkArray.push(chunk);
- });
- res.on("end", function () {
- // eslint-disable-next-line no-undef
- var result = Buffer.concat(chunkArray);
- if (res.headers["content-encoding"] === "gzip") {
- zlib.gunzip(result, function (error, resultUnzipped) {
- if (error) {
- deferred.reject(
- new RuntimeError.RuntimeError("Error decompressing response.")
- );
- } else {
- deferred.resolve(decodeResponse(resultUnzipped, responseType));
- }
- });
- } else {
- deferred.resolve(decodeResponse(result, responseType));
- }
- });
- })
- .on("error", function (e) {
- deferred.reject(new RequestErrorEvent());
- })
- .end();
- }
- var noXMLHttpRequest = typeof XMLHttpRequest === "undefined";
- Resource._Implementations.loadWithXhr = function (
- url,
- responseType,
- method,
- data,
- headers,
- deferred,
- overrideMimeType
- ) {
- var dataUriRegexResult = dataUriRegex$1.exec(url);
- if (dataUriRegexResult !== null) {
- deferred.resolve(decodeDataUri(dataUriRegexResult, responseType));
- return;
- }
- if (noXMLHttpRequest) {
- loadWithHttpRequest(
- url,
- responseType,
- method,
- data,
- headers,
- deferred);
- return;
- }
- var xhr = new XMLHttpRequest();
- if (TrustedServers.contains(url)) {
- xhr.withCredentials = true;
- }
- xhr.open(method, url, true);
- if (when.defined(overrideMimeType) && when.defined(xhr.overrideMimeType)) {
- xhr.overrideMimeType(overrideMimeType);
- }
- if (when.defined(headers)) {
- for (var key in headers) {
- if (headers.hasOwnProperty(key)) {
- xhr.setRequestHeader(key, headers[key]);
- }
- }
- }
- if (when.defined(responseType)) {
- xhr.responseType = responseType;
- }
- // While non-standard, file protocol always returns a status of 0 on success
- var localFile = false;
- if (typeof url === "string") {
- localFile =
- url.indexOf("file://") === 0 ||
- (typeof window !== "undefined" && window.location.origin === "file://");
- }
- xhr.onload = function () {
- if (
- (xhr.status < 200 || xhr.status >= 300) &&
- !(localFile && xhr.status === 0)
- ) {
- deferred.reject(
- new RequestErrorEvent(
- xhr.status,
- xhr.response,
- xhr.getAllResponseHeaders()
- )
- );
- return;
- }
- var response = xhr.response;
- var browserResponseType = xhr.responseType;
- if (method === "HEAD" || method === "OPTIONS") {
- var responseHeaderString = xhr.getAllResponseHeaders();
- var splitHeaders = responseHeaderString.trim().split(/[\r\n]+/);
- var responseHeaders = {};
- splitHeaders.forEach(function (line) {
- var parts = line.split(": ");
- var header = parts.shift();
- responseHeaders[header] = parts.join(": ");
- });
- deferred.resolve(responseHeaders);
- return;
- }
- //All modern browsers will go into either the first or second if block or last else block.
- //Other code paths support older browsers that either do not support the supplied responseType
- //or do not support the xhr.response property.
- if (xhr.status === 204) {
- // accept no content
- deferred.resolve();
- } else if (
- when.defined(response) &&
- (!when.defined(responseType) || browserResponseType === responseType)
- ) {
- deferred.resolve(response);
- } else if (responseType === "json" && typeof response === "string") {
- try {
- deferred.resolve(JSON.parse(response));
- } catch (e) {
- deferred.reject(e);
- }
- } else if (
- (browserResponseType === "" || browserResponseType === "document") &&
- when.defined(xhr.responseXML) &&
- xhr.responseXML.hasChildNodes()
- ) {
- deferred.resolve(xhr.responseXML);
- } else if (
- (browserResponseType === "" || browserResponseType === "text") &&
- when.defined(xhr.responseText)
- ) {
- deferred.resolve(xhr.responseText);
- } else {
- deferred.reject(
- new RuntimeError.RuntimeError("Invalid XMLHttpRequest response type.")
- );
- }
- };
- xhr.onerror = function (e) {
- deferred.reject(new RequestErrorEvent());
- };
- xhr.send(data);
- return xhr;
- };
- Resource._Implementations.loadAndExecuteScript = function (
- url,
- functionName,
- deferred
- ) {
- return loadAndExecuteScript(url).otherwise(deferred.reject);
- };
- /**
- * The default implementations
- *
- * @private
- */
- Resource._DefaultImplementations = {};
- Resource._DefaultImplementations.createImage =
- Resource._Implementations.createImage;
- Resource._DefaultImplementations.loadWithXhr =
- Resource._Implementations.loadWithXhr;
- Resource._DefaultImplementations.loadAndExecuteScript =
- Resource._Implementations.loadAndExecuteScript;
- /**
- * A resource instance initialized to the current browser location
- *
- * @type {Resource}
- * @constant
- */
- Resource.DEFAULT = Object.freeze(
- new Resource({
- url:
- typeof document === "undefined"
- ? ""
- : document.location.href.split("?")[0],
- })
- );
- /**
- * Specifies Earth polar motion coordinates and the difference between UT1 and UTC.
- * These Earth Orientation Parameters (EOP) are primarily used in the transformation from
- * the International Celestial Reference Frame (ICRF) to the International Terrestrial
- * Reference Frame (ITRF).
- *
- * @alias EarthOrientationParameters
- * @constructor
- *
- * @param {Object} [options] Object with the following properties:
- * @param {Resource|String} [options.url] The URL from which to obtain EOP data. If neither this
- * parameter nor options.data is specified, all EOP values are assumed
- * to be 0.0. If options.data is specified, this parameter is
- * ignored.
- * @param {Object} [options.data] The actual EOP data. If neither this
- * parameter nor options.data is specified, all EOP values are assumed
- * to be 0.0.
- * @param {Boolean} [options.addNewLeapSeconds=true] True if leap seconds that
- * are specified in the EOP data but not in {@link JulianDate.leapSeconds}
- * should be added to {@link JulianDate.leapSeconds}. False if
- * new leap seconds should be handled correctly in the context
- * of the EOP data but otherwise ignored.
- *
- * @example
- * // An example EOP data file, EOP.json:
- * {
- * "columnNames" : ["dateIso8601","modifiedJulianDateUtc","xPoleWanderRadians","yPoleWanderRadians","ut1MinusUtcSeconds","lengthOfDayCorrectionSeconds","xCelestialPoleOffsetRadians","yCelestialPoleOffsetRadians","taiMinusUtcSeconds"],
- * "samples" : [
- * "2011-07-01T00:00:00Z",55743.0,2.117957047295119e-7,2.111518721609984e-6,-0.2908948,-2.956e-4,3.393695767766752e-11,3.3452143996557983e-10,34.0,
- * "2011-07-02T00:00:00Z",55744.0,2.193297093339541e-7,2.115460256837405e-6,-0.29065,-1.824e-4,-8.241832578862112e-11,5.623838700870617e-10,34.0,
- * "2011-07-03T00:00:00Z",55745.0,2.262286080161428e-7,2.1191157519929706e-6,-0.2905572,1.9e-6,-3.490658503988659e-10,6.981317007977318e-10,34.0
- * ]
- * }
- *
- * @example
- * // Loading the EOP data
- * var eop = new Cesium.EarthOrientationParameters({ url : 'Data/EOP.json' });
- * Cesium.Transforms.earthOrientationParameters = eop;
- *
- * @private
- */
- function EarthOrientationParameters(options) {
- options = when.defaultValue(options, when.defaultValue.EMPTY_OBJECT);
- this._dates = undefined;
- this._samples = undefined;
- this._dateColumn = -1;
- this._xPoleWanderRadiansColumn = -1;
- this._yPoleWanderRadiansColumn = -1;
- this._ut1MinusUtcSecondsColumn = -1;
- this._xCelestialPoleOffsetRadiansColumn = -1;
- this._yCelestialPoleOffsetRadiansColumn = -1;
- this._taiMinusUtcSecondsColumn = -1;
- this._columnCount = 0;
- this._lastIndex = -1;
- this._downloadPromise = undefined;
- this._dataError = undefined;
- this._addNewLeapSeconds = when.defaultValue(options.addNewLeapSeconds, true);
- if (when.defined(options.data)) {
- // Use supplied EOP data.
- onDataReady(this, options.data);
- } else if (when.defined(options.url)) {
- var resource = Resource.createIfNeeded(options.url);
- // Download EOP data.
- var that = this;
- this._downloadPromise = resource
- .fetchJson()
- .then(function (eopData) {
- onDataReady(that, eopData);
- })
- .otherwise(function () {
- that._dataError =
- "An error occurred while retrieving the EOP data from the URL " +
- resource.url +
- ".";
- });
- } else {
- // Use all zeros for EOP data.
- onDataReady(this, {
- columnNames: [
- "dateIso8601",
- "modifiedJulianDateUtc",
- "xPoleWanderRadians",
- "yPoleWanderRadians",
- "ut1MinusUtcSeconds",
- "lengthOfDayCorrectionSeconds",
- "xCelestialPoleOffsetRadians",
- "yCelestialPoleOffsetRadians",
- "taiMinusUtcSeconds",
- ],
- samples: [],
- });
- }
- }
- /**
- * A default {@link EarthOrientationParameters} instance that returns zero for all EOP values.
- */
- EarthOrientationParameters.NONE = Object.freeze({
- getPromiseToLoad: function () {
- return when.when.resolve();
- },
- compute: function (date, result) {
- if (!when.defined(result)) {
- result = new EarthOrientationParametersSample(0.0, 0.0, 0.0, 0.0, 0.0);
- } else {
- result.xPoleWander = 0.0;
- result.yPoleWander = 0.0;
- result.xPoleOffset = 0.0;
- result.yPoleOffset = 0.0;
- result.ut1MinusUtc = 0.0;
- }
- return result;
- },
- });
- /**
- * Gets a promise that, when resolved, indicates that the EOP data has been loaded and is
- * ready to use.
- *
- * @returns {Promise<void>} The promise.
- */
- EarthOrientationParameters.prototype.getPromiseToLoad = function () {
- return when.when(this._downloadPromise);
- };
- /**
- * Computes the Earth Orientation Parameters (EOP) for a given date by interpolating.
- * If the EOP data has not yet been download, this method returns undefined.
- *
- * @param {JulianDate} date The date for each to evaluate the EOP.
- * @param {EarthOrientationParametersSample} [result] The instance to which to copy the result.
- * If this parameter is undefined, a new instance is created and returned.
- * @returns {EarthOrientationParametersSample} The EOP evaluated at the given date, or
- * undefined if the data necessary to evaluate EOP at the date has not yet been
- * downloaded.
- *
- * @exception {RuntimeError} The loaded EOP data has an error and cannot be used.
- *
- * @see EarthOrientationParameters#getPromiseToLoad
- */
- EarthOrientationParameters.prototype.compute = function (date, result) {
- // We cannot compute until the samples are available.
- if (!when.defined(this._samples)) {
- if (when.defined(this._dataError)) {
- throw new RuntimeError.RuntimeError(this._dataError);
- }
- return undefined;
- }
- if (!when.defined(result)) {
- result = new EarthOrientationParametersSample(0.0, 0.0, 0.0, 0.0, 0.0);
- }
- if (this._samples.length === 0) {
- result.xPoleWander = 0.0;
- result.yPoleWander = 0.0;
- result.xPoleOffset = 0.0;
- result.yPoleOffset = 0.0;
- result.ut1MinusUtc = 0.0;
- return result;
- }
- var dates = this._dates;
- var lastIndex = this._lastIndex;
- var before = 0;
- var after = 0;
- if (when.defined(lastIndex)) {
- var previousIndexDate = dates[lastIndex];
- var nextIndexDate = dates[lastIndex + 1];
- var isAfterPrevious = JulianDate.lessThanOrEquals(previousIndexDate, date);
- var isAfterLastSample = !when.defined(nextIndexDate);
- var isBeforeNext =
- isAfterLastSample || JulianDate.greaterThanOrEquals(nextIndexDate, date);
- if (isAfterPrevious && isBeforeNext) {
- before = lastIndex;
- if (!isAfterLastSample && nextIndexDate.equals(date)) {
- ++before;
- }
- after = before + 1;
- interpolate(this, dates, this._samples, date, before, after, result);
- return result;
- }
- }
- var index = binarySearch(dates, date, JulianDate.compare, this._dateColumn);
- if (index >= 0) {
- // If the next entry is the same date, use the later entry. This way, if two entries
- // describe the same moment, one before a leap second and the other after, then we will use
- // the post-leap second data.
- if (index < dates.length - 1 && dates[index + 1].equals(date)) {
- ++index;
- }
- before = index;
- after = index;
- } else {
- after = ~index;
- before = after - 1;
- // Use the first entry if the date requested is before the beginning of the data.
- if (before < 0) {
- before = 0;
- }
- }
- this._lastIndex = before;
- interpolate(this, dates, this._samples, date, before, after, result);
- return result;
- };
- function compareLeapSecondDates$1(leapSecond, dateToFind) {
- return JulianDate.compare(leapSecond.julianDate, dateToFind);
- }
- function onDataReady(eop, eopData) {
- if (!when.defined(eopData.columnNames)) {
- eop._dataError =
- "Error in loaded EOP data: The columnNames property is required.";
- return;
- }
- if (!when.defined(eopData.samples)) {
- eop._dataError =
- "Error in loaded EOP data: The samples property is required.";
- return;
- }
- var dateColumn = eopData.columnNames.indexOf("modifiedJulianDateUtc");
- var xPoleWanderRadiansColumn = eopData.columnNames.indexOf(
- "xPoleWanderRadians"
- );
- var yPoleWanderRadiansColumn = eopData.columnNames.indexOf(
- "yPoleWanderRadians"
- );
- var ut1MinusUtcSecondsColumn = eopData.columnNames.indexOf(
- "ut1MinusUtcSeconds"
- );
- var xCelestialPoleOffsetRadiansColumn = eopData.columnNames.indexOf(
- "xCelestialPoleOffsetRadians"
- );
- var yCelestialPoleOffsetRadiansColumn = eopData.columnNames.indexOf(
- "yCelestialPoleOffsetRadians"
- );
- var taiMinusUtcSecondsColumn = eopData.columnNames.indexOf(
- "taiMinusUtcSeconds"
- );
- if (
- dateColumn < 0 ||
- xPoleWanderRadiansColumn < 0 ||
- yPoleWanderRadiansColumn < 0 ||
- ut1MinusUtcSecondsColumn < 0 ||
- xCelestialPoleOffsetRadiansColumn < 0 ||
- yCelestialPoleOffsetRadiansColumn < 0 ||
- taiMinusUtcSecondsColumn < 0
- ) {
- eop._dataError =
- "Error in loaded EOP data: The columnNames property must include modifiedJulianDateUtc, xPoleWanderRadians, yPoleWanderRadians, ut1MinusUtcSeconds, xCelestialPoleOffsetRadians, yCelestialPoleOffsetRadians, and taiMinusUtcSeconds columns";
- return;
- }
- var samples = (eop._samples = eopData.samples);
- var dates = (eop._dates = []);
- eop._dateColumn = dateColumn;
- eop._xPoleWanderRadiansColumn = xPoleWanderRadiansColumn;
- eop._yPoleWanderRadiansColumn = yPoleWanderRadiansColumn;
- eop._ut1MinusUtcSecondsColumn = ut1MinusUtcSecondsColumn;
- eop._xCelestialPoleOffsetRadiansColumn = xCelestialPoleOffsetRadiansColumn;
- eop._yCelestialPoleOffsetRadiansColumn = yCelestialPoleOffsetRadiansColumn;
- eop._taiMinusUtcSecondsColumn = taiMinusUtcSecondsColumn;
- eop._columnCount = eopData.columnNames.length;
- eop._lastIndex = undefined;
- var lastTaiMinusUtc;
- var addNewLeapSeconds = eop._addNewLeapSeconds;
- // Convert the ISO8601 dates to JulianDates.
- for (var i = 0, len = samples.length; i < len; i += eop._columnCount) {
- var mjd = samples[i + dateColumn];
- var taiMinusUtc = samples[i + taiMinusUtcSecondsColumn];
- var day = mjd + TimeConstants$1.MODIFIED_JULIAN_DATE_DIFFERENCE;
- var date = new JulianDate(day, taiMinusUtc, TimeStandard$1.TAI);
- dates.push(date);
- if (addNewLeapSeconds) {
- if (taiMinusUtc !== lastTaiMinusUtc && when.defined(lastTaiMinusUtc)) {
- // We crossed a leap second boundary, so add the leap second
- // if it does not already exist.
- var leapSeconds = JulianDate.leapSeconds;
- var leapSecondIndex = binarySearch(
- leapSeconds,
- date,
- compareLeapSecondDates$1
- );
- if (leapSecondIndex < 0) {
- var leapSecond = new LeapSecond(date, taiMinusUtc);
- leapSeconds.splice(~leapSecondIndex, 0, leapSecond);
- }
- }
- lastTaiMinusUtc = taiMinusUtc;
- }
- }
- }
- function fillResultFromIndex(eop, samples, index, columnCount, result) {
- var start = index * columnCount;
- result.xPoleWander = samples[start + eop._xPoleWanderRadiansColumn];
- result.yPoleWander = samples[start + eop._yPoleWanderRadiansColumn];
- result.xPoleOffset = samples[start + eop._xCelestialPoleOffsetRadiansColumn];
- result.yPoleOffset = samples[start + eop._yCelestialPoleOffsetRadiansColumn];
- result.ut1MinusUtc = samples[start + eop._ut1MinusUtcSecondsColumn];
- }
- function linearInterp(dx, y1, y2) {
- return y1 + dx * (y2 - y1);
- }
- function interpolate(eop, dates, samples, date, before, after, result) {
- var columnCount = eop._columnCount;
- // First check the bounds on the EOP data
- // If we are after the bounds of the data, return zeros.
- // The 'before' index should never be less than zero.
- if (after > dates.length - 1) {
- result.xPoleWander = 0;
- result.yPoleWander = 0;
- result.xPoleOffset = 0;
- result.yPoleOffset = 0;
- result.ut1MinusUtc = 0;
- return result;
- }
- var beforeDate = dates[before];
- var afterDate = dates[after];
- if (beforeDate.equals(afterDate) || date.equals(beforeDate)) {
- fillResultFromIndex(eop, samples, before, columnCount, result);
- return result;
- } else if (date.equals(afterDate)) {
- fillResultFromIndex(eop, samples, after, columnCount, result);
- return result;
- }
- var factor =
- JulianDate.secondsDifference(date, beforeDate) /
- JulianDate.secondsDifference(afterDate, beforeDate);
- var startBefore = before * columnCount;
- var startAfter = after * columnCount;
- // Handle UT1 leap second edge case
- var beforeUt1MinusUtc = samples[startBefore + eop._ut1MinusUtcSecondsColumn];
- var afterUt1MinusUtc = samples[startAfter + eop._ut1MinusUtcSecondsColumn];
- var offsetDifference = afterUt1MinusUtc - beforeUt1MinusUtc;
- if (offsetDifference > 0.5 || offsetDifference < -0.5) {
- // The absolute difference between the values is more than 0.5, so we may have
- // crossed a leap second. Check if this is the case and, if so, adjust the
- // afterValue to account for the leap second. This way, our interpolation will
- // produce reasonable results.
- var beforeTaiMinusUtc =
- samples[startBefore + eop._taiMinusUtcSecondsColumn];
- var afterTaiMinusUtc = samples[startAfter + eop._taiMinusUtcSecondsColumn];
- if (beforeTaiMinusUtc !== afterTaiMinusUtc) {
- if (afterDate.equals(date)) {
- // If we are at the end of the leap second interval, take the second value
- // Otherwise, the interpolation below will yield the wrong side of the
- // discontinuity
- // At the end of the leap second, we need to start accounting for the jump
- beforeUt1MinusUtc = afterUt1MinusUtc;
- } else {
- // Otherwise, remove the leap second so that the interpolation is correct
- afterUt1MinusUtc -= afterTaiMinusUtc - beforeTaiMinusUtc;
- }
- }
- }
- result.xPoleWander = linearInterp(
- factor,
- samples[startBefore + eop._xPoleWanderRadiansColumn],
- samples[startAfter + eop._xPoleWanderRadiansColumn]
- );
- result.yPoleWander = linearInterp(
- factor,
- samples[startBefore + eop._yPoleWanderRadiansColumn],
- samples[startAfter + eop._yPoleWanderRadiansColumn]
- );
- result.xPoleOffset = linearInterp(
- factor,
- samples[startBefore + eop._xCelestialPoleOffsetRadiansColumn],
- samples[startAfter + eop._xCelestialPoleOffsetRadiansColumn]
- );
- result.yPoleOffset = linearInterp(
- factor,
- samples[startBefore + eop._yCelestialPoleOffsetRadiansColumn],
- samples[startAfter + eop._yCelestialPoleOffsetRadiansColumn]
- );
- result.ut1MinusUtc = linearInterp(
- factor,
- beforeUt1MinusUtc,
- afterUt1MinusUtc
- );
- return result;
- }
- /**
- * A rotation expressed as a heading, pitch, and roll. Heading is the rotation about the
- * negative z axis. Pitch is the rotation about the negative y axis. Roll is the rotation about
- * the positive x axis.
- * @alias HeadingPitchRoll
- * @constructor
- *
- * @param {Number} [heading=0.0] The heading component in radians.
- * @param {Number} [pitch=0.0] The pitch component in radians.
- * @param {Number} [roll=0.0] The roll component in radians.
- */
- function HeadingPitchRoll(heading, pitch, roll) {
- /**
- * Gets or sets the heading.
- * @type {Number}
- * @default 0.0
- */
- this.heading = when.defaultValue(heading, 0.0);
- /**
- * Gets or sets the pitch.
- * @type {Number}
- * @default 0.0
- */
- this.pitch = when.defaultValue(pitch, 0.0);
- /**
- * Gets or sets the roll.
- * @type {Number}
- * @default 0.0
- */
- this.roll = when.defaultValue(roll, 0.0);
- }
- /**
- * Computes the heading, pitch and roll from a quaternion (see http://en.wikipedia.org/wiki/Conversion_between_quaternions_and_Euler_angles )
- *
- * @param {Quaternion} quaternion The quaternion from which to retrieve heading, pitch, and roll, all expressed in radians.
- * @param {HeadingPitchRoll} [result] The object in which to store the result. If not provided, a new instance is created and returned.
- * @returns {HeadingPitchRoll} The modified result parameter or a new HeadingPitchRoll instance if one was not provided.
- */
- HeadingPitchRoll.fromQuaternion = function (quaternion, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(quaternion)) {
- throw new Check.DeveloperError("quaternion is required");
- }
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new HeadingPitchRoll();
- }
- var test = 2 * (quaternion.w * quaternion.y - quaternion.z * quaternion.x);
- var denominatorRoll =
- 1 - 2 * (quaternion.x * quaternion.x + quaternion.y * quaternion.y);
- var numeratorRoll =
- 2 * (quaternion.w * quaternion.x + quaternion.y * quaternion.z);
- var denominatorHeading =
- 1 - 2 * (quaternion.y * quaternion.y + quaternion.z * quaternion.z);
- var numeratorHeading =
- 2 * (quaternion.w * quaternion.z + quaternion.x * quaternion.y);
- result.heading = -Math.atan2(numeratorHeading, denominatorHeading);
- result.roll = Math.atan2(numeratorRoll, denominatorRoll);
- result.pitch = -_Math.CesiumMath.asinClamped(test);
- return result;
- };
- /**
- * Returns a new HeadingPitchRoll instance from angles given in degrees.
- *
- * @param {Number} heading the heading in degrees
- * @param {Number} pitch the pitch in degrees
- * @param {Number} roll the heading in degrees
- * @param {HeadingPitchRoll} [result] The object in which to store the result. If not provided, a new instance is created and returned.
- * @returns {HeadingPitchRoll} A new HeadingPitchRoll instance
- */
- HeadingPitchRoll.fromDegrees = function (heading, pitch, roll, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(heading)) {
- throw new Check.DeveloperError("heading is required");
- }
- if (!when.defined(pitch)) {
- throw new Check.DeveloperError("pitch is required");
- }
- if (!when.defined(roll)) {
- throw new Check.DeveloperError("roll is required");
- }
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new HeadingPitchRoll();
- }
- result.heading = heading * _Math.CesiumMath.RADIANS_PER_DEGREE;
- result.pitch = pitch * _Math.CesiumMath.RADIANS_PER_DEGREE;
- result.roll = roll * _Math.CesiumMath.RADIANS_PER_DEGREE;
- return result;
- };
- /**
- * Duplicates a HeadingPitchRoll instance.
- *
- * @param {HeadingPitchRoll} headingPitchRoll The HeadingPitchRoll to duplicate.
- * @param {HeadingPitchRoll} [result] The object onto which to store the result.
- * @returns {HeadingPitchRoll} The modified result parameter or a new HeadingPitchRoll instance if one was not provided. (Returns undefined if headingPitchRoll is undefined)
- */
- HeadingPitchRoll.clone = function (headingPitchRoll, result) {
- if (!when.defined(headingPitchRoll)) {
- return undefined;
- }
- if (!when.defined(result)) {
- return new HeadingPitchRoll(
- headingPitchRoll.heading,
- headingPitchRoll.pitch,
- headingPitchRoll.roll
- );
- }
- result.heading = headingPitchRoll.heading;
- result.pitch = headingPitchRoll.pitch;
- result.roll = headingPitchRoll.roll;
- return result;
- };
- /**
- * Compares the provided HeadingPitchRolls componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {HeadingPitchRoll} [left] The first HeadingPitchRoll.
- * @param {HeadingPitchRoll} [right] The second HeadingPitchRoll.
- * @returns {Boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- */
- HeadingPitchRoll.equals = function (left, right) {
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- left.heading === right.heading &&
- left.pitch === right.pitch &&
- left.roll === right.roll)
- );
- };
- /**
- * Compares the provided HeadingPitchRolls componentwise and returns
- * <code>true</code> if they pass an absolute or relative tolerance test,
- * <code>false</code> otherwise.
- *
- * @param {HeadingPitchRoll} [left] The first HeadingPitchRoll.
- * @param {HeadingPitchRoll} [right] The second HeadingPitchRoll.
- * @param {Number} [relativeEpsilon=0] The relative epsilon tolerance to use for equality testing.
- * @param {Number} [absoluteEpsilon=relativeEpsilon] The absolute epsilon tolerance to use for equality testing.
- * @returns {Boolean} <code>true</code> if left and right are within the provided epsilon, <code>false</code> otherwise.
- */
- HeadingPitchRoll.equalsEpsilon = function (
- left,
- right,
- relativeEpsilon,
- absoluteEpsilon
- ) {
- return (
- left === right ||
- (when.defined(left) &&
- when.defined(right) &&
- _Math.CesiumMath.equalsEpsilon(
- left.heading,
- right.heading,
- relativeEpsilon,
- absoluteEpsilon
- ) &&
- _Math.CesiumMath.equalsEpsilon(
- left.pitch,
- right.pitch,
- relativeEpsilon,
- absoluteEpsilon
- ) &&
- _Math.CesiumMath.equalsEpsilon(
- left.roll,
- right.roll,
- relativeEpsilon,
- absoluteEpsilon
- ))
- );
- };
- /**
- * Duplicates this HeadingPitchRoll instance.
- *
- * @param {HeadingPitchRoll} [result] The object onto which to store the result.
- * @returns {HeadingPitchRoll} The modified result parameter or a new HeadingPitchRoll instance if one was not provided.
- */
- HeadingPitchRoll.prototype.clone = function (result) {
- return HeadingPitchRoll.clone(this, result);
- };
- /**
- * Compares this HeadingPitchRoll against the provided HeadingPitchRoll componentwise and returns
- * <code>true</code> if they are equal, <code>false</code> otherwise.
- *
- * @param {HeadingPitchRoll} [right] The right hand side HeadingPitchRoll.
- * @returns {Boolean} <code>true</code> if they are equal, <code>false</code> otherwise.
- */
- HeadingPitchRoll.prototype.equals = function (right) {
- return HeadingPitchRoll.equals(this, right);
- };
- /**
- * Compares this HeadingPitchRoll against the provided HeadingPitchRoll componentwise and returns
- * <code>true</code> if they pass an absolute or relative tolerance test,
- * <code>false</code> otherwise.
- *
- * @param {HeadingPitchRoll} [right] The right hand side HeadingPitchRoll.
- * @param {Number} [relativeEpsilon=0] The relative epsilon tolerance to use for equality testing.
- * @param {Number} [absoluteEpsilon=relativeEpsilon] The absolute epsilon tolerance to use for equality testing.
- * @returns {Boolean} <code>true</code> if they are within the provided epsilon, <code>false</code> otherwise.
- */
- HeadingPitchRoll.prototype.equalsEpsilon = function (
- right,
- relativeEpsilon,
- absoluteEpsilon
- ) {
- return HeadingPitchRoll.equalsEpsilon(
- this,
- right,
- relativeEpsilon,
- absoluteEpsilon
- );
- };
- /**
- * Creates a string representing this HeadingPitchRoll in the format '(heading, pitch, roll)' in radians.
- *
- * @returns {String} A string representing the provided HeadingPitchRoll in the format '(heading, pitch, roll)'.
- */
- HeadingPitchRoll.prototype.toString = function () {
- return "(" + this.heading + ", " + this.pitch + ", " + this.roll + ")";
- };
- /*global CESIUM_BASE_URL*/
- var cesiumScriptRegex = /((?:.*\/)|^)Cesium\.js(?:\?|\#|$)/;
- function getBaseUrlFromCesiumScript() {
- var scripts = document.getElementsByTagName("script");
- for (var i = 0, len = scripts.length; i < len; ++i) {
- var src = scripts[i].getAttribute("src");
- var result = cesiumScriptRegex.exec(src);
- if (result !== null) {
- return result[1];
- }
- }
- return undefined;
- }
- var a$1;
- function tryMakeAbsolute(url) {
- if (typeof document === "undefined") {
- //Node.js and Web Workers. In both cases, the URL will already be absolute.
- return url;
- }
- if (!when.defined(a$1)) {
- a$1 = document.createElement("a");
- }
- a$1.href = url;
- // IE only absolutizes href on get, not set
- // eslint-disable-next-line no-self-assign
- a$1.href = a$1.href;
- return a$1.href;
- }
- var baseResource;
- function getCesiumBaseUrl() {
- if (when.defined(baseResource)) {
- return baseResource;
- }
- var baseUrlString;
- if (typeof CESIUM_BASE_URL !== "undefined") {
- baseUrlString = CESIUM_BASE_URL;
- } else if (
- typeof define === "object" &&
- when.defined(define.amd) &&
- !define.amd.toUrlUndefined &&
- when.defined(require.toUrl)
- ) {
- baseUrlString = getAbsoluteUri(
- "..",
- buildModuleUrl("Core/buildModuleUrl.js")
- );
- } else {
- baseUrlString = getBaseUrlFromCesiumScript();
- }
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(baseUrlString)) {
- throw new Check.DeveloperError(
- "Unable to determine Cesium base URL automatically, try defining a global variable called CESIUM_BASE_URL."
- );
- }
- //>>includeEnd('debug');
- baseResource = new Resource({
- url: tryMakeAbsolute(baseUrlString),
- });
- baseResource.appendForwardSlash();
- return baseResource;
- }
- function buildModuleUrlFromRequireToUrl(moduleID) {
- //moduleID will be non-relative, so require it relative to this module, in Core.
- return tryMakeAbsolute(require.toUrl("../" + moduleID));
- }
- function buildModuleUrlFromBaseUrl(moduleID) {
- var resource = getCesiumBaseUrl().getDerivedResource({
- url: moduleID,
- });
- return resource.url;
- }
- var implementation;
- /**
- * Given a relative URL under the Cesium base URL, returns an absolute URL.
- * @function
- *
- * @param {String} relativeUrl The relative path.
- * @returns {String} The absolutely URL representation of the provided path.
- *
- * @example
- * var viewer = new Cesium.Viewer("cesiumContainer", {
- * imageryProvider: new Cesium.TileMapServiceImageryProvider({
- * url: Cesium.buildModuleUrl("Assets/Textures/NaturalEarthII"),
- * }),
- * baseLayerPicker: false,
- * });
- */
- function buildModuleUrl(relativeUrl) {
- if (!when.defined(implementation)) {
- //select implementation
- if (
- typeof define === "object" &&
- when.defined(define.amd) &&
- !define.amd.toUrlUndefined &&
- when.defined(require.toUrl)
- ) {
- implementation = buildModuleUrlFromRequireToUrl;
- } else {
- implementation = buildModuleUrlFromBaseUrl;
- }
- }
- var url = implementation(relativeUrl);
- return url;
- }
- // exposed for testing
- buildModuleUrl._cesiumScriptRegex = cesiumScriptRegex;
- buildModuleUrl._buildModuleUrlFromBaseUrl = buildModuleUrlFromBaseUrl;
- buildModuleUrl._clearBaseResource = function () {
- baseResource = undefined;
- };
- /**
- * Sets the base URL for resolving modules.
- * @param {String} value The new base URL.
- */
- buildModuleUrl.setBaseUrl = function (value) {
- baseResource = Resource.DEFAULT.getDerivedResource({
- url: value,
- });
- };
- /**
- * Gets the base URL for resolving modules.
- */
- buildModuleUrl.getCesiumBaseUrl = getCesiumBaseUrl;
- /**
- * An IAU 2006 XYS value sampled at a particular time.
- *
- * @alias Iau2006XysSample
- * @constructor
- *
- * @param {Number} x The X value.
- * @param {Number} y The Y value.
- * @param {Number} s The S value.
- *
- * @private
- */
- function Iau2006XysSample(x, y, s) {
- /**
- * The X value.
- * @type {Number}
- */
- this.x = x;
- /**
- * The Y value.
- * @type {Number}
- */
- this.y = y;
- /**
- * The S value.
- * @type {Number}
- */
- this.s = s;
- }
- /**
- * A set of IAU2006 XYS data that is used to evaluate the transformation between the International
- * Celestial Reference Frame (ICRF) and the International Terrestrial Reference Frame (ITRF).
- *
- * @alias Iau2006XysData
- * @constructor
- *
- * @param {Object} [options] Object with the following properties:
- * @param {Resource|String} [options.xysFileUrlTemplate='Assets/IAU2006_XYS/IAU2006_XYS_{0}.json'] A template URL for obtaining the XYS data. In the template,
- * `{0}` will be replaced with the file index.
- * @param {Number} [options.interpolationOrder=9] The order of interpolation to perform on the XYS data.
- * @param {Number} [options.sampleZeroJulianEphemerisDate=2442396.5] The Julian ephemeris date (JED) of the
- * first XYS sample.
- * @param {Number} [options.stepSizeDays=1.0] The step size, in days, between successive XYS samples.
- * @param {Number} [options.samplesPerXysFile=1000] The number of samples in each XYS file.
- * @param {Number} [options.totalSamples=27426] The total number of samples in all XYS files.
- *
- * @private
- */
- function Iau2006XysData(options) {
- options = when.defaultValue(options, when.defaultValue.EMPTY_OBJECT);
- this._xysFileUrlTemplate = Resource.createIfNeeded(
- options.xysFileUrlTemplate
- );
- this._interpolationOrder = when.defaultValue(options.interpolationOrder, 9);
- this._sampleZeroJulianEphemerisDate = when.defaultValue(
- options.sampleZeroJulianEphemerisDate,
- 2442396.5
- );
- this._sampleZeroDateTT = new JulianDate(
- this._sampleZeroJulianEphemerisDate,
- 0.0,
- TimeStandard$1.TAI
- );
- this._stepSizeDays = when.defaultValue(options.stepSizeDays, 1.0);
- this._samplesPerXysFile = when.defaultValue(options.samplesPerXysFile, 1000);
- this._totalSamples = when.defaultValue(options.totalSamples, 27426);
- this._samples = new Array(this._totalSamples * 3);
- this._chunkDownloadsInProgress = [];
- var order = this._interpolationOrder;
- // Compute denominators and X values for interpolation.
- var denom = (this._denominators = new Array(order + 1));
- var xTable = (this._xTable = new Array(order + 1));
- var stepN = Math.pow(this._stepSizeDays, order);
- for (var i = 0; i <= order; ++i) {
- denom[i] = stepN;
- xTable[i] = i * this._stepSizeDays;
- for (var j = 0; j <= order; ++j) {
- if (j !== i) {
- denom[i] *= i - j;
- }
- }
- denom[i] = 1.0 / denom[i];
- }
- // Allocate scratch arrays for interpolation.
- this._work = new Array(order + 1);
- this._coef = new Array(order + 1);
- }
- var julianDateScratch = new JulianDate(0, 0.0, TimeStandard$1.TAI);
- function getDaysSinceEpoch(xys, dayTT, secondTT) {
- var dateTT = julianDateScratch;
- dateTT.dayNumber = dayTT;
- dateTT.secondsOfDay = secondTT;
- return JulianDate.daysDifference(dateTT, xys._sampleZeroDateTT);
- }
- /**
- * Preloads XYS data for a specified date range.
- *
- * @param {Number} startDayTT The Julian day number of the beginning of the interval to preload, expressed in
- * the Terrestrial Time (TT) time standard.
- * @param {Number} startSecondTT The seconds past noon of the beginning of the interval to preload, expressed in
- * the Terrestrial Time (TT) time standard.
- * @param {Number} stopDayTT The Julian day number of the end of the interval to preload, expressed in
- * the Terrestrial Time (TT) time standard.
- * @param {Number} stopSecondTT The seconds past noon of the end of the interval to preload, expressed in
- * the Terrestrial Time (TT) time standard.
- * @returns {Promise<void>} A promise that, when resolved, indicates that the requested interval has been
- * preloaded.
- */
- Iau2006XysData.prototype.preload = function (
- startDayTT,
- startSecondTT,
- stopDayTT,
- stopSecondTT
- ) {
- var startDaysSinceEpoch = getDaysSinceEpoch(this, startDayTT, startSecondTT);
- var stopDaysSinceEpoch = getDaysSinceEpoch(this, stopDayTT, stopSecondTT);
- var startIndex =
- (startDaysSinceEpoch / this._stepSizeDays - this._interpolationOrder / 2) |
- 0;
- if (startIndex < 0) {
- startIndex = 0;
- }
- var stopIndex =
- (stopDaysSinceEpoch / this._stepSizeDays - this._interpolationOrder / 2) |
- (0 + this._interpolationOrder);
- if (stopIndex >= this._totalSamples) {
- stopIndex = this._totalSamples - 1;
- }
- var startChunk = (startIndex / this._samplesPerXysFile) | 0;
- var stopChunk = (stopIndex / this._samplesPerXysFile) | 0;
- var promises = [];
- for (var i = startChunk; i <= stopChunk; ++i) {
- promises.push(requestXysChunk(this, i));
- }
- return when.when.all(promises);
- };
- /**
- * Computes the XYS values for a given date by interpolating. If the required data is not yet downloaded,
- * this method will return undefined.
- *
- * @param {Number} dayTT The Julian day number for which to compute the XYS value, expressed in
- * the Terrestrial Time (TT) time standard.
- * @param {Number} secondTT The seconds past noon of the date for which to compute the XYS value, expressed in
- * the Terrestrial Time (TT) time standard.
- * @param {Iau2006XysSample} [result] The instance to which to copy the interpolated result. If this parameter
- * is undefined, a new instance is allocated and returned.
- * @returns {Iau2006XysSample} The interpolated XYS values, or undefined if the required data for this
- * computation has not yet been downloaded.
- *
- * @see Iau2006XysData#preload
- */
- Iau2006XysData.prototype.computeXysRadians = function (
- dayTT,
- secondTT,
- result
- ) {
- var daysSinceEpoch = getDaysSinceEpoch(this, dayTT, secondTT);
- if (daysSinceEpoch < 0.0) {
- // Can't evaluate prior to the epoch of the data.
- return undefined;
- }
- var centerIndex = (daysSinceEpoch / this._stepSizeDays) | 0;
- if (centerIndex >= this._totalSamples) {
- // Can't evaluate after the last sample in the data.
- return undefined;
- }
- var degree = this._interpolationOrder;
- var firstIndex = centerIndex - ((degree / 2) | 0);
- if (firstIndex < 0) {
- firstIndex = 0;
- }
- var lastIndex = firstIndex + degree;
- if (lastIndex >= this._totalSamples) {
- lastIndex = this._totalSamples - 1;
- firstIndex = lastIndex - degree;
- if (firstIndex < 0) {
- firstIndex = 0;
- }
- }
- // Are all the samples we need present?
- // We can assume so if the first and last are present
- var isDataMissing = false;
- var samples = this._samples;
- if (!when.defined(samples[firstIndex * 3])) {
- requestXysChunk(this, (firstIndex / this._samplesPerXysFile) | 0);
- isDataMissing = true;
- }
- if (!when.defined(samples[lastIndex * 3])) {
- requestXysChunk(this, (lastIndex / this._samplesPerXysFile) | 0);
- isDataMissing = true;
- }
- if (isDataMissing) {
- return undefined;
- }
- if (!when.defined(result)) {
- result = new Iau2006XysSample(0.0, 0.0, 0.0);
- } else {
- result.x = 0.0;
- result.y = 0.0;
- result.s = 0.0;
- }
- var x = daysSinceEpoch - firstIndex * this._stepSizeDays;
- var work = this._work;
- var denom = this._denominators;
- var coef = this._coef;
- var xTable = this._xTable;
- var i, j;
- for (i = 0; i <= degree; ++i) {
- work[i] = x - xTable[i];
- }
- for (i = 0; i <= degree; ++i) {
- coef[i] = 1.0;
- for (j = 0; j <= degree; ++j) {
- if (j !== i) {
- coef[i] *= work[j];
- }
- }
- coef[i] *= denom[i];
- var sampleIndex = (firstIndex + i) * 3;
- result.x += coef[i] * samples[sampleIndex++];
- result.y += coef[i] * samples[sampleIndex++];
- result.s += coef[i] * samples[sampleIndex];
- }
- return result;
- };
- function requestXysChunk(xysData, chunkIndex) {
- if (xysData._chunkDownloadsInProgress[chunkIndex]) {
- // Chunk has already been requested.
- return xysData._chunkDownloadsInProgress[chunkIndex];
- }
- var deferred = when.when.defer();
- xysData._chunkDownloadsInProgress[chunkIndex] = deferred;
- var chunkUrl;
- var xysFileUrlTemplate = xysData._xysFileUrlTemplate;
- if (when.defined(xysFileUrlTemplate)) {
- chunkUrl = xysFileUrlTemplate.getDerivedResource({
- templateValues: {
- "0": chunkIndex,
- },
- });
- } else {
- chunkUrl = new Resource({
- url: buildModuleUrl(
- "Assets/IAU2006_XYS/IAU2006_XYS_" + chunkIndex + ".json"
- ),
- });
- }
- when.when(chunkUrl.fetchJson(), function (chunk) {
- xysData._chunkDownloadsInProgress[chunkIndex] = false;
- var samples = xysData._samples;
- var newSamples = chunk.samples;
- var startIndex = chunkIndex * xysData._samplesPerXysFile * 3;
- for (var i = 0, len = newSamples.length; i < len; ++i) {
- samples[startIndex + i] = newSamples[i];
- }
- deferred.resolve();
- });
- return deferred.promise;
- }
- /**
- * Contains functions for transforming positions to various reference frames.
- *
- * @namespace Transforms
- */
- var Transforms = {};
- var vectorProductLocalFrame = {
- up: {
- south: "east",
- north: "west",
- west: "south",
- east: "north",
- },
- down: {
- south: "west",
- north: "east",
- west: "north",
- east: "south",
- },
- south: {
- up: "west",
- down: "east",
- west: "down",
- east: "up",
- },
- north: {
- up: "east",
- down: "west",
- west: "up",
- east: "down",
- },
- west: {
- up: "north",
- down: "south",
- north: "down",
- south: "up",
- },
- east: {
- up: "south",
- down: "north",
- north: "up",
- south: "down",
- },
- };
- var degeneratePositionLocalFrame = {
- north: [-1, 0, 0],
- east: [0, 1, 0],
- up: [0, 0, 1],
- south: [1, 0, 0],
- west: [0, -1, 0],
- down: [0, 0, -1],
- };
- var localFrameToFixedFrameCache = {};
- var scratchCalculateCartesian = {
- east: new Cartesian2.Cartesian3(),
- north: new Cartesian2.Cartesian3(),
- up: new Cartesian2.Cartesian3(),
- west: new Cartesian2.Cartesian3(),
- south: new Cartesian2.Cartesian3(),
- down: new Cartesian2.Cartesian3(),
- };
- var scratchFirstCartesian = new Cartesian2.Cartesian3();
- var scratchSecondCartesian = new Cartesian2.Cartesian3();
- var scratchThirdCartesian = new Cartesian2.Cartesian3();
- /**
- * Generates a function that computes a 4x4 transformation matrix from a reference frame
- * centered at the provided origin to the provided ellipsoid's fixed reference frame.
- * @param {String} firstAxis name of the first axis of the local reference frame. Must be
- * 'east', 'north', 'up', 'west', 'south' or 'down'.
- * @param {String} secondAxis name of the second axis of the local reference frame. Must be
- * 'east', 'north', 'up', 'west', 'south' or 'down'.
- * @return {Transforms.LocalFrameToFixedFrame} The function that will computes a
- * 4x4 transformation matrix from a reference frame, with first axis and second axis compliant with the parameters,
- */
- Transforms.localFrameToFixedFrameGenerator = function (firstAxis, secondAxis) {
- if (
- !vectorProductLocalFrame.hasOwnProperty(firstAxis) ||
- !vectorProductLocalFrame[firstAxis].hasOwnProperty(secondAxis)
- ) {
- throw new Check.DeveloperError(
- "firstAxis and secondAxis must be east, north, up, west, south or down."
- );
- }
- var thirdAxis = vectorProductLocalFrame[firstAxis][secondAxis];
- /**
- * Computes a 4x4 transformation matrix from a reference frame
- * centered at the provided origin to the provided ellipsoid's fixed reference frame.
- * @callback Transforms.LocalFrameToFixedFrame
- * @param {Cartesian3} origin The center point of the local reference frame.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if none was provided.
- */
- var resultat;
- var hashAxis = firstAxis + secondAxis;
- if (when.defined(localFrameToFixedFrameCache[hashAxis])) {
- resultat = localFrameToFixedFrameCache[hashAxis];
- } else {
- resultat = function (origin, ellipsoid, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(origin)) {
- throw new Check.DeveloperError("origin is required.");
- }
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new Matrix4();
- }
- if (
- Cartesian2.Cartesian3.equalsEpsilon(origin, Cartesian2.Cartesian3.ZERO, _Math.CesiumMath.EPSILON14)
- ) {
- // If x, y, and z are zero, use the degenerate local frame, which is a special case
- Cartesian2.Cartesian3.unpack(
- degeneratePositionLocalFrame[firstAxis],
- 0,
- scratchFirstCartesian
- );
- Cartesian2.Cartesian3.unpack(
- degeneratePositionLocalFrame[secondAxis],
- 0,
- scratchSecondCartesian
- );
- Cartesian2.Cartesian3.unpack(
- degeneratePositionLocalFrame[thirdAxis],
- 0,
- scratchThirdCartesian
- );
- } else if (
- _Math.CesiumMath.equalsEpsilon(origin.x, 0.0, _Math.CesiumMath.EPSILON14) &&
- _Math.CesiumMath.equalsEpsilon(origin.y, 0.0, _Math.CesiumMath.EPSILON14)
- ) {
- // If x and y are zero, assume origin is at a pole, which is a special case.
- var sign = _Math.CesiumMath.sign(origin.z);
- Cartesian2.Cartesian3.unpack(
- degeneratePositionLocalFrame[firstAxis],
- 0,
- scratchFirstCartesian
- );
- if (firstAxis !== "east" && firstAxis !== "west") {
- Cartesian2.Cartesian3.multiplyByScalar(
- scratchFirstCartesian,
- sign,
- scratchFirstCartesian
- );
- }
- Cartesian2.Cartesian3.unpack(
- degeneratePositionLocalFrame[secondAxis],
- 0,
- scratchSecondCartesian
- );
- if (secondAxis !== "east" && secondAxis !== "west") {
- Cartesian2.Cartesian3.multiplyByScalar(
- scratchSecondCartesian,
- sign,
- scratchSecondCartesian
- );
- }
- Cartesian2.Cartesian3.unpack(
- degeneratePositionLocalFrame[thirdAxis],
- 0,
- scratchThirdCartesian
- );
- if (thirdAxis !== "east" && thirdAxis !== "west") {
- Cartesian2.Cartesian3.multiplyByScalar(
- scratchThirdCartesian,
- sign,
- scratchThirdCartesian
- );
- }
- } else {
- ellipsoid = when.defaultValue(ellipsoid, Cartesian2.Ellipsoid.WGS84);
- ellipsoid.geodeticSurfaceNormal(origin, scratchCalculateCartesian.up);
- var up = scratchCalculateCartesian.up;
- var east = scratchCalculateCartesian.east;
- east.x = -origin.y;
- east.y = origin.x;
- east.z = 0.0;
- Cartesian2.Cartesian3.normalize(east, scratchCalculateCartesian.east);
- Cartesian2.Cartesian3.cross(up, east, scratchCalculateCartesian.north);
- Cartesian2.Cartesian3.multiplyByScalar(
- scratchCalculateCartesian.up,
- -1,
- scratchCalculateCartesian.down
- );
- Cartesian2.Cartesian3.multiplyByScalar(
- scratchCalculateCartesian.east,
- -1,
- scratchCalculateCartesian.west
- );
- Cartesian2.Cartesian3.multiplyByScalar(
- scratchCalculateCartesian.north,
- -1,
- scratchCalculateCartesian.south
- );
- scratchFirstCartesian = scratchCalculateCartesian[firstAxis];
- scratchSecondCartesian = scratchCalculateCartesian[secondAxis];
- scratchThirdCartesian = scratchCalculateCartesian[thirdAxis];
- }
- result[0] = scratchFirstCartesian.x;
- result[1] = scratchFirstCartesian.y;
- result[2] = scratchFirstCartesian.z;
- result[3] = 0.0;
- result[4] = scratchSecondCartesian.x;
- result[5] = scratchSecondCartesian.y;
- result[6] = scratchSecondCartesian.z;
- result[7] = 0.0;
- result[8] = scratchThirdCartesian.x;
- result[9] = scratchThirdCartesian.y;
- result[10] = scratchThirdCartesian.z;
- result[11] = 0.0;
- result[12] = origin.x;
- result[13] = origin.y;
- result[14] = origin.z;
- result[15] = 1.0;
- return result;
- };
- localFrameToFixedFrameCache[hashAxis] = resultat;
- }
- return resultat;
- };
- /**
- * Computes a 4x4 transformation matrix from a reference frame with an east-north-up axes
- * centered at the provided origin to the provided ellipsoid's fixed reference frame.
- * The local axes are defined as:
- * <ul>
- * <li>The <code>x</code> axis points in the local east direction.</li>
- * <li>The <code>y</code> axis points in the local north direction.</li>
- * <li>The <code>z</code> axis points in the direction of the ellipsoid surface normal which passes through the position.</li>
- * </ul>
- *
- * @function
- * @param {Cartesian3} origin The center point of the local reference frame.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if none was provided.
- *
- * @example
- * // Get the transform from local east-north-up at cartographic (0.0, 0.0) to Earth's fixed frame.
- * var center = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
- * var transform = Cesium.Transforms.eastNorthUpToFixedFrame(center);
- */
- Transforms.eastNorthUpToFixedFrame = Transforms.localFrameToFixedFrameGenerator(
- "east",
- "north"
- );
- /**
- * Computes a 4x4 transformation matrix from a reference frame with an north-east-down axes
- * centered at the provided origin to the provided ellipsoid's fixed reference frame.
- * The local axes are defined as:
- * <ul>
- * <li>The <code>x</code> axis points in the local north direction.</li>
- * <li>The <code>y</code> axis points in the local east direction.</li>
- * <li>The <code>z</code> axis points in the opposite direction of the ellipsoid surface normal which passes through the position.</li>
- * </ul>
- *
- * @function
- * @param {Cartesian3} origin The center point of the local reference frame.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if none was provided.
- *
- * @example
- * // Get the transform from local north-east-down at cartographic (0.0, 0.0) to Earth's fixed frame.
- * var center = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
- * var transform = Cesium.Transforms.northEastDownToFixedFrame(center);
- */
- Transforms.northEastDownToFixedFrame = Transforms.localFrameToFixedFrameGenerator(
- "north",
- "east"
- );
- /**
- * Computes a 4x4 transformation matrix from a reference frame with an north-up-east axes
- * centered at the provided origin to the provided ellipsoid's fixed reference frame.
- * The local axes are defined as:
- * <ul>
- * <li>The <code>x</code> axis points in the local north direction.</li>
- * <li>The <code>y</code> axis points in the direction of the ellipsoid surface normal which passes through the position.</li>
- * <li>The <code>z</code> axis points in the local east direction.</li>
- * </ul>
- *
- * @function
- * @param {Cartesian3} origin The center point of the local reference frame.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if none was provided.
- *
- * @example
- * // Get the transform from local north-up-east at cartographic (0.0, 0.0) to Earth's fixed frame.
- * var center = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
- * var transform = Cesium.Transforms.northUpEastToFixedFrame(center);
- */
- Transforms.northUpEastToFixedFrame = Transforms.localFrameToFixedFrameGenerator(
- "north",
- "up"
- );
- /**
- * Computes a 4x4 transformation matrix from a reference frame with an north-west-up axes
- * centered at the provided origin to the provided ellipsoid's fixed reference frame.
- * The local axes are defined as:
- * <ul>
- * <li>The <code>x</code> axis points in the local north direction.</li>
- * <li>The <code>y</code> axis points in the local west direction.</li>
- * <li>The <code>z</code> axis points in the direction of the ellipsoid surface normal which passes through the position.</li>
- * </ul>
- *
- * @function
- * @param {Cartesian3} origin The center point of the local reference frame.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if none was provided.
- *
- * @example
- * // Get the transform from local north-West-Up at cartographic (0.0, 0.0) to Earth's fixed frame.
- * var center = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
- * var transform = Cesium.Transforms.northWestUpToFixedFrame(center);
- */
- Transforms.northWestUpToFixedFrame = Transforms.localFrameToFixedFrameGenerator(
- "north",
- "west"
- );
- var scratchHPRQuaternion$1 = new Quaternion();
- var scratchScale$2 = new Cartesian2.Cartesian3(1.0, 1.0, 1.0);
- var scratchHPRMatrix4 = new Matrix4();
- /**
- * Computes a 4x4 transformation matrix from a reference frame with axes computed from the heading-pitch-roll angles
- * centered at the provided origin to the provided ellipsoid's fixed reference frame. Heading is the rotation from the local north
- * direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles
- * are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.
- *
- * @param {Cartesian3} origin The center point of the local reference frame.
- * @param {HeadingPitchRoll} headingPitchRoll The heading, pitch, and roll.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Transforms.LocalFrameToFixedFrame} [fixedFrameTransform=Transforms.eastNorthUpToFixedFrame] A 4x4 transformation
- * matrix from a reference frame to the provided ellipsoid's fixed reference frame
- * @param {Matrix4} [result] The object onto which to store the result.
- * @returns {Matrix4} The modified result parameter or a new Matrix4 instance if none was provided.
- *
- * @example
- * // Get the transform from local heading-pitch-roll at cartographic (0.0, 0.0) to Earth's fixed frame.
- * var center = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
- * var heading = -Cesium.Math.PI_OVER_TWO;
- * var pitch = Cesium.Math.PI_OVER_FOUR;
- * var roll = 0.0;
- * var hpr = new Cesium.HeadingPitchRoll(heading, pitch, roll);
- * var transform = Cesium.Transforms.headingPitchRollToFixedFrame(center, hpr);
- */
- Transforms.headingPitchRollToFixedFrame = function (
- origin,
- headingPitchRoll,
- ellipsoid,
- fixedFrameTransform,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("HeadingPitchRoll", headingPitchRoll);
- //>>includeEnd('debug');
- fixedFrameTransform = when.defaultValue(
- fixedFrameTransform,
- Transforms.eastNorthUpToFixedFrame
- );
- var hprQuaternion = Quaternion.fromHeadingPitchRoll(
- headingPitchRoll,
- scratchHPRQuaternion$1
- );
- var hprMatrix = Matrix4.fromTranslationQuaternionRotationScale(
- Cartesian2.Cartesian3.ZERO,
- hprQuaternion,
- scratchScale$2,
- scratchHPRMatrix4
- );
- result = fixedFrameTransform(origin, ellipsoid, result);
- return Matrix4.multiply(result, hprMatrix, result);
- };
- var scratchENUMatrix4 = new Matrix4();
- var scratchHPRMatrix3 = new Matrix3();
- /**
- * Computes a quaternion from a reference frame with axes computed from the heading-pitch-roll angles
- * centered at the provided origin. Heading is the rotation from the local north
- * direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles
- * are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.
- *
- * @param {Cartesian3} origin The center point of the local reference frame.
- * @param {HeadingPitchRoll} headingPitchRoll The heading, pitch, and roll.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Transforms.LocalFrameToFixedFrame} [fixedFrameTransform=Transforms.eastNorthUpToFixedFrame] A 4x4 transformation
- * matrix from a reference frame to the provided ellipsoid's fixed reference frame
- * @param {Quaternion} [result] The object onto which to store the result.
- * @returns {Quaternion} The modified result parameter or a new Quaternion instance if none was provided.
- *
- * @example
- * // Get the quaternion from local heading-pitch-roll at cartographic (0.0, 0.0) to Earth's fixed frame.
- * var center = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
- * var heading = -Cesium.Math.PI_OVER_TWO;
- * var pitch = Cesium.Math.PI_OVER_FOUR;
- * var roll = 0.0;
- * var hpr = new HeadingPitchRoll(heading, pitch, roll);
- * var quaternion = Cesium.Transforms.headingPitchRollQuaternion(center, hpr);
- */
- Transforms.headingPitchRollQuaternion = function (
- origin,
- headingPitchRoll,
- ellipsoid,
- fixedFrameTransform,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.typeOf.object("HeadingPitchRoll", headingPitchRoll);
- //>>includeEnd('debug');
- var transform = Transforms.headingPitchRollToFixedFrame(
- origin,
- headingPitchRoll,
- ellipsoid,
- fixedFrameTransform,
- scratchENUMatrix4
- );
- var rotation = Matrix4.getMatrix3(transform, scratchHPRMatrix3);
- return Quaternion.fromRotationMatrix(rotation, result);
- };
- var noScale = new Cartesian2.Cartesian3(1.0, 1.0, 1.0);
- var hprCenterScratch = new Cartesian2.Cartesian3();
- var ffScratch = new Matrix4();
- var hprTransformScratch = new Matrix4();
- var hprRotationScratch = new Matrix3();
- var hprQuaternionScratch = new Quaternion();
- /**
- * Computes heading-pitch-roll angles from a transform in a particular reference frame. Heading is the rotation from the local north
- * direction where a positive angle is increasing eastward. Pitch is the rotation from the local east-north plane. Positive pitch angles
- * are above the plane. Negative pitch angles are below the plane. Roll is the first rotation applied about the local east axis.
- *
- * @param {Matrix4} transform The transform
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Transforms.LocalFrameToFixedFrame} [fixedFrameTransform=Transforms.eastNorthUpToFixedFrame] A 4x4 transformation
- * matrix from a reference frame to the provided ellipsoid's fixed reference frame
- * @param {HeadingPitchRoll} [result] The object onto which to store the result.
- * @returns {HeadingPitchRoll} The modified result parameter or a new HeadingPitchRoll instance if none was provided.
- */
- Transforms.fixedFrameToHeadingPitchRoll = function (
- transform,
- ellipsoid,
- fixedFrameTransform,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- Check.Check.defined("transform", transform);
- //>>includeEnd('debug');
- ellipsoid = when.defaultValue(ellipsoid, Cartesian2.Ellipsoid.WGS84);
- fixedFrameTransform = when.defaultValue(
- fixedFrameTransform,
- Transforms.eastNorthUpToFixedFrame
- );
- if (!when.defined(result)) {
- result = new HeadingPitchRoll();
- }
- var center = Matrix4.getTranslation(transform, hprCenterScratch);
- if (Cartesian2.Cartesian3.equals(center, Cartesian2.Cartesian3.ZERO)) {
- result.heading = 0;
- result.pitch = 0;
- result.roll = 0;
- return result;
- }
- var toFixedFrame = Matrix4.inverseTransformation(
- fixedFrameTransform(center, ellipsoid, ffScratch),
- ffScratch
- );
- var transformCopy = Matrix4.setScale(transform, noScale, hprTransformScratch);
- transformCopy = Matrix4.setTranslation(
- transformCopy,
- Cartesian2.Cartesian3.ZERO,
- transformCopy
- );
- toFixedFrame = Matrix4.multiply(toFixedFrame, transformCopy, toFixedFrame);
- var quaternionRotation = Quaternion.fromRotationMatrix(
- Matrix4.getMatrix3(toFixedFrame, hprRotationScratch),
- hprQuaternionScratch
- );
- quaternionRotation = Quaternion.normalize(
- quaternionRotation,
- quaternionRotation
- );
- return HeadingPitchRoll.fromQuaternion(quaternionRotation, result);
- };
- var gmstConstant0 = 6 * 3600 + 41 * 60 + 50.54841;
- var gmstConstant1 = 8640184.812866;
- var gmstConstant2 = 0.093104;
- var gmstConstant3 = -6.2e-6;
- var rateCoef = 1.1772758384668e-19;
- var wgs84WRPrecessing = 7.2921158553e-5;
- var twoPiOverSecondsInDay = _Math.CesiumMath.TWO_PI / 86400.0;
- var dateInUtc = new JulianDate();
- /**
- * Computes a rotation matrix to transform a point or vector from True Equator Mean Equinox (TEME) axes to the
- * pseudo-fixed axes at a given time. This method treats the UT1 time standard as equivalent to UTC.
- *
- * @param {JulianDate} date The time at which to compute the rotation matrix.
- * @param {Matrix3} [result] The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter or a new Matrix3 instance if none was provided.
- *
- * @example
- * //Set the view to the inertial frame.
- * scene.postUpdate.addEventListener(function(scene, time) {
- * var now = Cesium.JulianDate.now();
- * var offset = Cesium.Matrix4.multiplyByPoint(camera.transform, camera.position, new Cesium.Cartesian3());
- * var transform = Cesium.Matrix4.fromRotationTranslation(Cesium.Transforms.computeTemeToPseudoFixedMatrix(now));
- * var inverseTransform = Cesium.Matrix4.inverseTransformation(transform, new Cesium.Matrix4());
- * Cesium.Matrix4.multiplyByPoint(inverseTransform, offset, offset);
- * camera.lookAtTransform(transform, offset);
- * });
- */
- Transforms.computeTemeToPseudoFixedMatrix = function (date, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(date)) {
- throw new Check.DeveloperError("date is required.");
- }
- //>>includeEnd('debug');
- // GMST is actually computed using UT1. We're using UTC as an approximation of UT1.
- // We do not want to use the function like convertTaiToUtc in JulianDate because
- // we explicitly do not want to fail when inside the leap second.
- dateInUtc = JulianDate.addSeconds(
- date,
- -JulianDate.computeTaiMinusUtc(date),
- dateInUtc
- );
- var utcDayNumber = dateInUtc.dayNumber;
- var utcSecondsIntoDay = dateInUtc.secondsOfDay;
- var t;
- var diffDays = utcDayNumber - 2451545;
- if (utcSecondsIntoDay >= 43200.0) {
- t = (diffDays + 0.5) / TimeConstants$1.DAYS_PER_JULIAN_CENTURY;
- } else {
- t = (diffDays - 0.5) / TimeConstants$1.DAYS_PER_JULIAN_CENTURY;
- }
- var gmst0 =
- gmstConstant0 +
- t * (gmstConstant1 + t * (gmstConstant2 + t * gmstConstant3));
- var angle = (gmst0 * twoPiOverSecondsInDay) % _Math.CesiumMath.TWO_PI;
- var ratio = wgs84WRPrecessing + rateCoef * (utcDayNumber - 2451545.5);
- var secondsSinceMidnight =
- (utcSecondsIntoDay + TimeConstants$1.SECONDS_PER_DAY * 0.5) %
- TimeConstants$1.SECONDS_PER_DAY;
- var gha = angle + ratio * secondsSinceMidnight;
- var cosGha = Math.cos(gha);
- var sinGha = Math.sin(gha);
- if (!when.defined(result)) {
- return new Matrix3(
- cosGha,
- sinGha,
- 0.0,
- -sinGha,
- cosGha,
- 0.0,
- 0.0,
- 0.0,
- 1.0
- );
- }
- result[0] = cosGha;
- result[1] = -sinGha;
- result[2] = 0.0;
- result[3] = sinGha;
- result[4] = cosGha;
- result[5] = 0.0;
- result[6] = 0.0;
- result[7] = 0.0;
- result[8] = 1.0;
- return result;
- };
- /**
- * The source of IAU 2006 XYS data, used for computing the transformation between the
- * Fixed and ICRF axes.
- * @type {Iau2006XysData}
- *
- * @see Transforms.computeIcrfToFixedMatrix
- * @see Transforms.computeFixedToIcrfMatrix
- *
- * @private
- */
- Transforms.iau2006XysData = new Iau2006XysData();
- /**
- * The source of Earth Orientation Parameters (EOP) data, used for computing the transformation
- * between the Fixed and ICRF axes. By default, zero values are used for all EOP values,
- * yielding a reasonable but not completely accurate representation of the ICRF axes.
- * @type {EarthOrientationParameters}
- *
- * @see Transforms.computeIcrfToFixedMatrix
- * @see Transforms.computeFixedToIcrfMatrix
- *
- * @private
- */
- Transforms.earthOrientationParameters = EarthOrientationParameters.NONE;
- var ttMinusTai = 32.184;
- var j2000ttDays = 2451545.0;
- /**
- * Preloads the data necessary to transform between the ICRF and Fixed axes, in either
- * direction, over a given interval. This function returns a promise that, when resolved,
- * indicates that the preload has completed.
- *
- * @param {TimeInterval} timeInterval The interval to preload.
- * @returns {Promise<void>} A promise that, when resolved, indicates that the preload has completed
- * and evaluation of the transformation between the fixed and ICRF axes will
- * no longer return undefined for a time inside the interval.
- *
- *
- * @example
- * var interval = new Cesium.TimeInterval(...);
- * when(Cesium.Transforms.preloadIcrfFixed(interval), function() {
- * // the data is now loaded
- * });
- *
- * @see Transforms.computeIcrfToFixedMatrix
- * @see Transforms.computeFixedToIcrfMatrix
- * @see when
- */
- Transforms.preloadIcrfFixed = function (timeInterval) {
- var startDayTT = timeInterval.start.dayNumber;
- var startSecondTT = timeInterval.start.secondsOfDay + ttMinusTai;
- var stopDayTT = timeInterval.stop.dayNumber;
- var stopSecondTT = timeInterval.stop.secondsOfDay + ttMinusTai;
- var xysPromise = Transforms.iau2006XysData.preload(
- startDayTT,
- startSecondTT,
- stopDayTT,
- stopSecondTT
- );
- var eopPromise = Transforms.earthOrientationParameters.getPromiseToLoad();
- return when.when.all([xysPromise, eopPromise]);
- };
- /**
- * Computes a rotation matrix to transform a point or vector from the International Celestial
- * Reference Frame (GCRF/ICRF) inertial frame axes to the Earth-Fixed frame axes (ITRF)
- * at a given time. This function may return undefined if the data necessary to
- * do the transformation is not yet loaded.
- *
- * @param {JulianDate} date The time at which to compute the rotation matrix.
- * @param {Matrix3} [result] The object onto which to store the result. If this parameter is
- * not specified, a new instance is created and returned.
- * @returns {Matrix3} The rotation matrix, or undefined if the data necessary to do the
- * transformation is not yet loaded.
- *
- *
- * @example
- * scene.postUpdate.addEventListener(function(scene, time) {
- * // View in ICRF.
- * var icrfToFixed = Cesium.Transforms.computeIcrfToFixedMatrix(time);
- * if (Cesium.defined(icrfToFixed)) {
- * var offset = Cesium.Cartesian3.clone(camera.position);
- * var transform = Cesium.Matrix4.fromRotationTranslation(icrfToFixed);
- * camera.lookAtTransform(transform, offset);
- * }
- * });
- *
- * @see Transforms.preloadIcrfFixed
- */
- Transforms.computeIcrfToFixedMatrix = function (date, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(date)) {
- throw new Check.DeveloperError("date is required.");
- }
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new Matrix3();
- }
- var fixedToIcrfMtx = Transforms.computeFixedToIcrfMatrix(date, result);
- if (!when.defined(fixedToIcrfMtx)) {
- return undefined;
- }
- return Matrix3.transpose(fixedToIcrfMtx, result);
- };
- var xysScratch = new Iau2006XysSample(0.0, 0.0, 0.0);
- var eopScratch = new EarthOrientationParametersSample(
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0
- );
- var rotation1Scratch = new Matrix3();
- var rotation2Scratch = new Matrix3();
- /**
- * Computes a rotation matrix to transform a point or vector from the Earth-Fixed frame axes (ITRF)
- * to the International Celestial Reference Frame (GCRF/ICRF) inertial frame axes
- * at a given time. This function may return undefined if the data necessary to
- * do the transformation is not yet loaded.
- *
- * @param {JulianDate} date The time at which to compute the rotation matrix.
- * @param {Matrix3} [result] The object onto which to store the result. If this parameter is
- * not specified, a new instance is created and returned.
- * @returns {Matrix3} The rotation matrix, or undefined if the data necessary to do the
- * transformation is not yet loaded.
- *
- *
- * @example
- * // Transform a point from the ICRF axes to the Fixed axes.
- * var now = Cesium.JulianDate.now();
- * var pointInFixed = Cesium.Cartesian3.fromDegrees(0.0, 0.0);
- * var fixedToIcrf = Cesium.Transforms.computeIcrfToFixedMatrix(now);
- * var pointInInertial = new Cesium.Cartesian3();
- * if (Cesium.defined(fixedToIcrf)) {
- * pointInInertial = Cesium.Matrix3.multiplyByVector(fixedToIcrf, pointInFixed, pointInInertial);
- * }
- *
- * @see Transforms.preloadIcrfFixed
- */
- Transforms.computeFixedToIcrfMatrix = function (date, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(date)) {
- throw new Check.DeveloperError("date is required.");
- }
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new Matrix3();
- }
- // Compute pole wander
- var eop = Transforms.earthOrientationParameters.compute(date, eopScratch);
- if (!when.defined(eop)) {
- return undefined;
- }
- // There is no external conversion to Terrestrial Time (TT).
- // So use International Atomic Time (TAI) and convert using offsets.
- // Here we are assuming that dayTT and secondTT are positive
- var dayTT = date.dayNumber;
- // It's possible here that secondTT could roll over 86400
- // This does not seem to affect the precision (unit tests check for this)
- var secondTT = date.secondsOfDay + ttMinusTai;
- var xys = Transforms.iau2006XysData.computeXysRadians(
- dayTT,
- secondTT,
- xysScratch
- );
- if (!when.defined(xys)) {
- return undefined;
- }
- var x = xys.x + eop.xPoleOffset;
- var y = xys.y + eop.yPoleOffset;
- // Compute XYS rotation
- var a = 1.0 / (1.0 + Math.sqrt(1.0 - x * x - y * y));
- var rotation1 = rotation1Scratch;
- rotation1[0] = 1.0 - a * x * x;
- rotation1[3] = -a * x * y;
- rotation1[6] = x;
- rotation1[1] = -a * x * y;
- rotation1[4] = 1 - a * y * y;
- rotation1[7] = y;
- rotation1[2] = -x;
- rotation1[5] = -y;
- rotation1[8] = 1 - a * (x * x + y * y);
- var rotation2 = Matrix3.fromRotationZ(-xys.s, rotation2Scratch);
- var matrixQ = Matrix3.multiply(rotation1, rotation2, rotation1Scratch);
- // Similar to TT conversions above
- // It's possible here that secondTT could roll over 86400
- // This does not seem to affect the precision (unit tests check for this)
- var dateUt1day = date.dayNumber;
- var dateUt1sec =
- date.secondsOfDay - JulianDate.computeTaiMinusUtc(date) + eop.ut1MinusUtc;
- // Compute Earth rotation angle
- // The IERS standard for era is
- // era = 0.7790572732640 + 1.00273781191135448 * Tu
- // where
- // Tu = JulianDateInUt1 - 2451545.0
- // However, you get much more precision if you make the following simplification
- // era = a + (1 + b) * (JulianDayNumber + FractionOfDay - 2451545)
- // era = a + (JulianDayNumber - 2451545) + FractionOfDay + b (JulianDayNumber - 2451545 + FractionOfDay)
- // era = a + FractionOfDay + b (JulianDayNumber - 2451545 + FractionOfDay)
- // since (JulianDayNumber - 2451545) represents an integer number of revolutions which will be discarded anyway.
- var daysSinceJ2000 = dateUt1day - 2451545;
- var fractionOfDay = dateUt1sec / TimeConstants$1.SECONDS_PER_DAY;
- var era =
- 0.779057273264 +
- fractionOfDay +
- 0.00273781191135448 * (daysSinceJ2000 + fractionOfDay);
- era = (era % 1.0) * _Math.CesiumMath.TWO_PI;
- var earthRotation = Matrix3.fromRotationZ(era, rotation2Scratch);
- // pseudoFixed to ICRF
- var pfToIcrf = Matrix3.multiply(matrixQ, earthRotation, rotation1Scratch);
- // Compute pole wander matrix
- var cosxp = Math.cos(eop.xPoleWander);
- var cosyp = Math.cos(eop.yPoleWander);
- var sinxp = Math.sin(eop.xPoleWander);
- var sinyp = Math.sin(eop.yPoleWander);
- var ttt = dayTT - j2000ttDays + secondTT / TimeConstants$1.SECONDS_PER_DAY;
- ttt /= 36525.0;
- // approximate sp value in rad
- var sp = (-47.0e-6 * ttt * _Math.CesiumMath.RADIANS_PER_DEGREE) / 3600.0;
- var cossp = Math.cos(sp);
- var sinsp = Math.sin(sp);
- var fToPfMtx = rotation2Scratch;
- fToPfMtx[0] = cosxp * cossp;
- fToPfMtx[1] = cosxp * sinsp;
- fToPfMtx[2] = sinxp;
- fToPfMtx[3] = -cosyp * sinsp + sinyp * sinxp * cossp;
- fToPfMtx[4] = cosyp * cossp + sinyp * sinxp * sinsp;
- fToPfMtx[5] = -sinyp * cosxp;
- fToPfMtx[6] = -sinyp * sinsp - cosyp * sinxp * cossp;
- fToPfMtx[7] = sinyp * cossp - cosyp * sinxp * sinsp;
- fToPfMtx[8] = cosyp * cosxp;
- return Matrix3.multiply(pfToIcrf, fToPfMtx, result);
- };
- var pointToWindowCoordinatesTemp = new Cartesian4();
- /**
- * Transform a point from model coordinates to window coordinates.
- *
- * @param {Matrix4} modelViewProjectionMatrix The 4x4 model-view-projection matrix.
- * @param {Matrix4} viewportTransformation The 4x4 viewport transformation.
- * @param {Cartesian3} point The point to transform.
- * @param {Cartesian2} [result] The object onto which to store the result.
- * @returns {Cartesian2} The modified result parameter or a new Cartesian2 instance if none was provided.
- */
- Transforms.pointToWindowCoordinates = function (
- modelViewProjectionMatrix,
- viewportTransformation,
- point,
- result
- ) {
- result = Transforms.pointToGLWindowCoordinates(
- modelViewProjectionMatrix,
- viewportTransformation,
- point,
- result
- );
- result.y = 2.0 * viewportTransformation[5] - result.y;
- return result;
- };
- /**
- * @private
- */
- Transforms.pointToGLWindowCoordinates = function (
- modelViewProjectionMatrix,
- viewportTransformation,
- point,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(modelViewProjectionMatrix)) {
- throw new Check.DeveloperError("modelViewProjectionMatrix is required.");
- }
- if (!when.defined(viewportTransformation)) {
- throw new Check.DeveloperError("viewportTransformation is required.");
- }
- if (!when.defined(point)) {
- throw new Check.DeveloperError("point is required.");
- }
- //>>includeEnd('debug');
- if (!when.defined(result)) {
- result = new Cartesian2.Cartesian2();
- }
- var tmp = pointToWindowCoordinatesTemp;
- Matrix4.multiplyByVector(
- modelViewProjectionMatrix,
- Cartesian4.fromElements(point.x, point.y, point.z, 1, tmp),
- tmp
- );
- Cartesian4.multiplyByScalar(tmp, 1.0 / tmp.w, tmp);
- Matrix4.multiplyByVector(viewportTransformation, tmp, tmp);
- return Cartesian2.Cartesian2.fromCartesian4(tmp, result);
- };
- var normalScratch = new Cartesian2.Cartesian3();
- var rightScratch = new Cartesian2.Cartesian3();
- var upScratch = new Cartesian2.Cartesian3();
- /**
- * Transform a position and velocity to a rotation matrix.
- *
- * @param {Cartesian3} position The position to transform.
- * @param {Cartesian3} velocity The velocity vector to transform.
- * @param {Ellipsoid} [ellipsoid=Ellipsoid.WGS84] The ellipsoid whose fixed frame is used in the transformation.
- * @param {Matrix3} [result] The object onto which to store the result.
- * @returns {Matrix3} The modified result parameter or a new Matrix3 instance if none was provided.
- */
- Transforms.rotationMatrixFromPositionVelocity = function (
- position,
- velocity,
- ellipsoid,
- result
- ) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(position)) {
- throw new Check.DeveloperError("position is required.");
- }
- if (!when.defined(velocity)) {
- throw new Check.DeveloperError("velocity is required.");
- }
- //>>includeEnd('debug');
- var normal = when.defaultValue(ellipsoid, Cartesian2.Ellipsoid.WGS84).geodeticSurfaceNormal(
- position,
- normalScratch
- );
- var right = Cartesian2.Cartesian3.cross(velocity, normal, rightScratch);
- if (Cartesian2.Cartesian3.equalsEpsilon(right, Cartesian2.Cartesian3.ZERO, _Math.CesiumMath.EPSILON6)) {
- right = Cartesian2.Cartesian3.clone(Cartesian2.Cartesian3.UNIT_X, right);
- }
- var up = Cartesian2.Cartesian3.cross(right, velocity, upScratch);
- Cartesian2.Cartesian3.normalize(up, up);
- Cartesian2.Cartesian3.cross(velocity, up, right);
- Cartesian2.Cartesian3.negate(right, right);
- Cartesian2.Cartesian3.normalize(right, right);
- if (!when.defined(result)) {
- result = new Matrix3();
- }
- result[0] = velocity.x;
- result[1] = velocity.y;
- result[2] = velocity.z;
- result[3] = right.x;
- result[4] = right.y;
- result[5] = right.z;
- result[6] = up.x;
- result[7] = up.y;
- result[8] = up.z;
- return result;
- };
- var swizzleMatrix = new Matrix4(
- 0.0,
- 0.0,
- 1.0,
- 0.0,
- 1.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 1.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 0.0,
- 1.0
- );
- var scratchCartographic = new Cartesian2.Cartographic();
- var scratchCartesian3Projection = new Cartesian2.Cartesian3();
- var scratchCenter = new Cartesian2.Cartesian3();
- var scratchRotation = new Matrix3();
- var scratchFromENU = new Matrix4();
- var scratchToENU = new Matrix4();
- /**
- * @private
- */
- Transforms.basisTo2D = function (projection, matrix, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(projection)) {
- throw new Check.DeveloperError("projection is required.");
- }
- if (!when.defined(matrix)) {
- throw new Check.DeveloperError("matrix is required.");
- }
- if (!when.defined(result)) {
- throw new Check.DeveloperError("result is required.");
- }
- //>>includeEnd('debug');
- var rtcCenter = Matrix4.getTranslation(matrix, scratchCenter);
- var ellipsoid = projection.ellipsoid;
- // Get the 2D Center
- var cartographic = ellipsoid.cartesianToCartographic(
- rtcCenter,
- scratchCartographic
- );
- var projectedPosition = projection.project(
- cartographic,
- scratchCartesian3Projection
- );
- Cartesian2.Cartesian3.fromElements(
- projectedPosition.z,
- projectedPosition.x,
- projectedPosition.y,
- projectedPosition
- );
- // Assuming the instance are positioned in WGS84, invert the WGS84 transform to get the local transform and then convert to 2D
- var fromENU = Transforms.eastNorthUpToFixedFrame(
- rtcCenter,
- ellipsoid,
- scratchFromENU
- );
- var toENU = Matrix4.inverseTransformation(fromENU, scratchToENU);
- var rotation = Matrix4.getMatrix3(matrix, scratchRotation);
- var local = Matrix4.multiplyByMatrix3(toENU, rotation, result);
- Matrix4.multiply(swizzleMatrix, local, result); // Swap x, y, z for 2D
- Matrix4.setTranslation(result, projectedPosition, result); // Use the projected center
- return result;
- };
- /**
- * @private
- */
- Transforms.wgs84To2DModelMatrix = function (projection, center, result) {
- //>>includeStart('debug', pragmas.debug);
- if (!when.defined(projection)) {
- throw new Check.DeveloperError("projection is required.");
- }
- if (!when.defined(center)) {
- throw new Check.DeveloperError("center is required.");
- }
- if (!when.defined(result)) {
- throw new Check.DeveloperError("result is required.");
- }
- //>>includeEnd('debug');
- var ellipsoid = projection.ellipsoid;
- var fromENU = Transforms.eastNorthUpToFixedFrame(
- center,
- ellipsoid,
- scratchFromENU
- );
- var toENU = Matrix4.inverseTransformation(fromENU, scratchToENU);
- var cartographic = ellipsoid.cartesianToCartographic(
- center,
- scratchCartographic
- );
- var projectedPosition = projection.project(
- cartographic,
- scratchCartesian3Projection
- );
- Cartesian2.Cartesian3.fromElements(
- projectedPosition.z,
- projectedPosition.x,
- projectedPosition.y,
- projectedPosition
- );
- var translation = Matrix4.fromTranslation(projectedPosition, scratchFromENU);
- Matrix4.multiply(swizzleMatrix, toENU, result);
- Matrix4.multiply(translation, result, result);
- return result;
- };
- exports.BoundingSphere = BoundingSphere;
- exports.Cartesian4 = Cartesian4;
- exports.FeatureDetection = FeatureDetection;
- exports.GeographicProjection = GeographicProjection;
- exports.Intersect = Intersect$1;
- exports.Interval = Interval;
- exports.Matrix3 = Matrix3;
- exports.Matrix4 = Matrix4;
- exports.Quaternion = Quaternion;
- exports.Resource = Resource;
- exports.Transforms = Transforms;
- exports.buildModuleUrl = buildModuleUrl;
- });
- //# sourceMappingURL=Transforms-8be64844.js.map
|