\ i< S r SSKJrJr SSKJrJr " S S\5 r " S S\5 r " S S \5 r " S
S \5 r
" S S
\5 r " S S\5 r " S S\5 r
" S S\5 r " S S\5 rg)a
Copyright 2011-2018 Kyle Lancaster | 2019 Patrick Eisoldt
Simplekml is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see .
)Kmlablecheck)CameraLookAtc < ^ \ rS rSrSrU 4S jr\S 5 rSrU =r $ )GxTourPrimitive zQAbstract class extended by all tour types.
.. note::
Not to be used directly.
c * > [ [ U ] 5 g N)superr __init__)self __class__s Q/var/www/html/kml_chatgpt/mouzaenv/lib/python3.13/site-packages/simplekml/tour.pyr
GxTourPrimitive.__init__ s
ot-/ c U R $ )zThe id string.)_idr s r idGxTourPrimitive.id s
xxr )
__name__
__module__ __qualname____firstlineno____doc__r
propertyr __static_attributes__
__classcell__r s @r r r s! 0 r r c ^ \ rS rSrSr S
U 4S jjr\S 5 r\R S 5 r\S 5 r \ R S 5 r U 4S jr
S r U =r $ )
GxSoundCue& zSpecifies a sound to be played in a tour.
The arguments are the same as the properties. See :class:`simplekml.GxTour` for usage.
c b > [ [ U ] 5 XR S' X R S' g )Nhrefgx:delayedStart)r r# r
_kml)r r& gxdelayedstartr s r r
GxSoundCue.__init__+ s+ j$(* &'5 #$r c U R S $ )z+A string reference to a sound file to play.r& r( r s r r& GxSoundCue.href2 yy r c XR S' g )Nr& r, )r r& s r r& r- 7 &r c U R S $ )z?Double telling the number of seconds to delay playing the file.r' r, r s r r) GxSoundCue.gxdelayedstart; yy*++r c XR S' g Nr' r, r r) s r r) r2 @ '5 #$r c > SR U R 5 [ [ U ] 5 SR U R 5 /nSR U5 $ )Nzz )formatr r r# __str__joinr bufr s r r; GxSoundCue.__str__D sK '..txx8Z.0 &&txx02 wws|r r )NN)
r r r r r r
r r& setterr) r; r r r! s @r r# r# & sy
$6 ! !
[[! ! , , 6 6 r r# c r ^ \ rS rSrSr SU 4S jjr\S 5 r\R S 5 rU 4S jr Sr
U =r $ )
GxTourControlK zKAllows a tour to be paused.
The arguments are the same as the properties.
c F > [ [ U ] 5 XR S' g N gx:playMode)r rB r
r( )r
gxplaymoder s r r
GxTourControl.__init__P s
mT+-#- - r c U R S $ )zJString to pause the tour, accepts :class:`simplekml.GxPlayMode` constants.rF r, r s r rG GxTourControl.gxplaymodeU yy ''r c XR S' g rE r, )r rG s r rG rJ Z #- - r c > SR U R 5 [ [ U ] 5 SR U R 5 /nSR U5 $ )Nzzr9 )r: r r rB r; r< r= s r r; GxTourControl.__str__^ sK *11$((;]D13"))$((35 wws|r r )pause) r r r r r r
r rG r@ r; r r r! s @r rB rB K sJ
$.
( ( . . r rB c r ^ \ rS rSrSr SU 4S jjr\S 5 r\R S 5 rU 4S jr Sr
U =r $ ) GxWaite ztAllows a tour to be paused.
The arguments are the same as the properties. See :class:`simplekml.GxTour` for usage.
c F > [ [ U ] 5 XR S' g N gx:duration)r rR r
r( )r
gxdurationr s r r
GxWait.__init__j s
fd$&#- - r c U R S $ z4Double indicating how long the camera remains still.rV r, r s r rW GxWait.gxdurationo rK r c XR S' g rU r, r rW s r rW r[ t rM r c > SR U R 5 [ [ U ] 5 SR U R 5 /nSR U5 $ )Nzz
r9 )r: r r rR r; r< r= s r r; GxWait.__str__x sI #**4884VT*,l.A.A$((.KMwws|r r r ) r r r r r r
r rW r@ r; r r r! s @r rR rR e sJ
!.
( ( . . r rR c H ^ \ rS rSrSrSrSr SU 4S jjr\S 5 r \ R S 5 r \S 5 r \ R S 5 r \S
5 r \ R \
" \5 S 5 5 r \S 5 r\R \
" \5 S
5 5 rU 4S jrSrU =r$ )GxFlyTo~ zAllows unbroken flight from point to point.
The arguments are the same as the properties. See :class:`simplekml.GxTour` for usage.
bouncesmoothc > [ [ U ] 5 XR S' X R S' S U R S' S U R S' Ub X0R S' S U R S' g S U R S' X@R S' g )NrV gx:flyToModer r )r ra r
r( )r rW gxflytomodecameralookatr s r r
GxFlyTo.__init__ s
gt%'#- - $/ .! " ( " ( "(IIh "&DIIh "&DIIh "(IIh r c U R S $ rZ r, r s r rW GxFlyTo.gxduration rK r c XR S' g rU r, r] s r rW rl rM r c U R S $ )zIHow the camera behaves, accepts :class:`simplekml.GxFlyToMode` constants.rf r, r s r rg GxFlyTo.gxflytomode s yy ((r c XR S' g )Nrf r, )r rg s r rg ro s $/ .!r c U R S c& [ 5 U R S' SU R S' U R S $ )z>Camera that views the scene, accepts :class:`simplekml.Camera`r Nr )r( r r s r rh GxFlyTo.camera @ 99X &"((DIIh "&DIIh yy""r c > XR S' S U R S' g Nr r r, )r rh s r rh rr s % ( " (r c U R S c& [ 5 U R S' SU R S' U R S $ )zACamera relative to the feature, accepts :class:`simplekml.LookAt`r Nr )r( r r s r ri GxFlyTo.lookat rs r c > S U R S' XR S' g ru r, )r ri s r ri rw s # ( $ (r c > SR U R 5 [ [ U ] 5 SR U R 5 /nSR U5 $ )Nzz r9 )r: r r ra r; r< r= s r r; GxFlyTo.__str__ sK $++DHH5Wd+- ##DHH-/ wws|r r NNNN)r r r r r rc rd r
r rW r@ rg rh r r ri r r; r r r! s @r ra ra ~ s
F
F ! ! )" ( ( . . ) ) 0 0 # # ]]
6]# # # # ]]
6]% % r ra c ^ \ rS rSrSr S
U 4S jjr\S 5 r\R S 5 r\S 5 r \ R S 5 r \S 5 r
\
R S 5 r
\S
5 r \ R S 5 r S r U =r
$ )Update zAction to take when animation updates.
The arguments are the same as the properties. See :class:`simplekml.GxTour` for usage.
c > [ [ U ] 5 Uc SnXR S' X R S' X0R S' X@R S' g )Nr9
targetHrefChangeCreateDelete)r r} r
r( )r
targethrefchangecreatedeleter s r r
Update.__init__ sM
fd$& J", , $ ( $ ( $ (r c U R S $ )zThe target url.r r, r s r r Update.targethref s yy &&r c XR S' g )Nr r, )r r s r r r s ", , r c U R S $ )z.KML string representing a change in animation.r r, r s r r
Update.change yy""r c XR S' g )Nr r, )r r s r r r $ (r c U R S $ )z4KML string representing a creation during animation.r r, r s r r
Update.create r r c XR S' g )Nr r, )r r s r r r r r c U R S $ )z4KML string representing a deletion during animation.r r, r s r r
Update.delete r r c XR S' g )Nr r, )r r s r r r r r r r{ )r r r r r r
r r r@ r r r r r r! s @r r} r} s
! % ' ' - - # # ]]% % # # ]]% % # # ]]% %r r} c ^ \ rS rSrSr S U 4S jjr\S 5 r\R S 5 r\S 5 r \ R S 5 r \S 5 r
\
R \ " \ 5 S 5 5 r
U 4S
jr
S rU =r$ )
GxAnimatedUpdatei zControls changes during a tour to KML features.
The arguments are the same as the properties. See :class:`simplekml.GxTour` for usage.
c ~ > [ [ U ] 5 XR S' X R S' X0R S' g )NrV r' r} )r r r
r( )r rW r) updater s r r
GxAnimatedUpdate.__init__ s8 .0#- - '5 #$ $ (r c U R S $ rZ r, r s r rW GxAnimatedUpdate.gxduration rK r c XR S' g rU r, r] s r rW r rM r c U R S $ )z4Double of number of seconds to wait before starting.r' r, r s r r) GxAnimatedUpdate.gxdelayedstart r3 r c XR S' g r5 r, r6 s r r) r " r7 r c n U R S c [ 5 U R S' U R S $ )z%Instance of :class:`simplekml.Update`r} )r( r} r s r r GxAnimatedUpdate.update& s2 99X &"((DIIh yy""r c XR S' g )Nr} r, )r r s r r r - s % (r c > SR U R 5 [ [ U ] 5 SR U R 5 /nSR U5 $ )Nz zr9 )r: r r r r; r< r= s r r; GxAnimatedUpdate.__str__2 sL -44TXX>%t46%,,TXX68 wws|r r NNN)r r r r r r
r rW r@ r) r r r} r; r r r! s @r r r s ! $ % ( ( . . , , 6 6 # # ]]
6]% % r r c r ^ \ rS rSrSrS
U 4S jjr\" \S5 S 5 rS r S r
S r S r S
r
S rS rU =r$ )
GxPlaylisti9 zrDefines a part of a tour.
The arguments are the same as the properties. See :class:`simplekml.GxTour` for usage.
c j > [ [ U ] 5 / U l Ub U =R U-
sl g g r )r r r
gxtourprimitives)r r r s r r
GxPlaylist.__init__> s5
j$(* " ' ! !%5 5 ! (r Tc : U R R U5 g)z4Adds a :class:`simplekml.GxTourPrimitive` sub-class.N)r append)r gxtourprimitives r addgxtourprimitive GxPlaylist.addgxtourprimitiveD s
$$_5r c > [ S0 UD6nU R U5 U$ )zCreates a new :class:`simplekml.GxAnimatedUpdate` and adds it to the playlist.
Accepts the same agruments as :class:`simplekml.GxAnimatedUpdate` and returns an instance
of :class:`simplekml.GxAnimatedUpdate`
r )r r )r kwargsgxanimatedupdates r newgxanimatedupdate GxPlaylist.newgxanimatedupdateI s' ,5f5 01 r c > [ S0 UD6nU R U5 U$ )zCreates a new :class:`simplekml.GxFlyTo` and adds it to the playlist.
Accepts the same agruments as :class:`simplekml.GxFlyTo` and returns an instance
of :class:`simplekml.GxFlyTo`
r )ra r )r r gxflytos r
newgxflytoGxPlaylist.newgxflytoS s$ #F# (r c > [ S0 UD6nU R U5 U$ )zCreates a new :class:`simplekml.GxSoundCue` and adds it to the playlist.
Accepts the same agruments as :class:`simplekml.GxSoundCue` and returns an instance
of :class:`simplekml.GxSoundCue`
r )r# r )r r
gxsoundcues r
newgxsoundcueGxPlaylist.newgxsoundcue] s% )&)
+r c > [ S0 UD6nU R U5 U$ )zCreates a new :class:`simplekml.GxTourControl` and adds it to the playlist.
Accepts the same agruments as :class:`simplekml.GxTourControl` and returns an instance
of :class:`simplekml.GxTourControl`
r )rB r )r r
gxtourcontrols r newgxtourcontrolGxPlaylist.newgxtourcontrolg s% &//
. r c > [ S0 UD6nU R U5 U$ )zCreates a new :class:`simplekml.GxWait` and adds it to the playlist.
Accepts the same agruments as :class:`simplekml.GxWait` and returns an instance
of :class:`simplekml.GxWait`
r )rR r )r r gxwaits r newgxwaitGxPlaylist.newgxwaitq s$ !&! '
r c S/nU R H" nUR UR 5 5 M$ UR S5 SR U5 $ )Nz
zr9 )r r r; r< )r r> r s r r; GxPlaylist.__str__{ sJ # 4 4O JJ..0 1 5
#$wws|r )r r )r r r r r r
r r r r r r r r r; r r r! s @r r r 9 sK 6 ?D!6 "6 r r c ^ \ rS rSrSr S U 4S jjr\S 5 r\R S 5 r\S 5 r \ R S 5 r S S jr
U 4S jr S
r U =r
$ )
GxTouri a Defines a tour.
The arguments are the same as the properties.
Usage::
# Demonstrates touring with the reproduction of the tour sample in the KML Reference
# https://developers.google.com/kml/documentation/kmlreference#gxtour with the addition of GxSoundCue
import os
import simplekml
# Create an instance of kml
kml = simplekml.Kml(name="Tours", open=1)
# Create a new point and style it
pnt = kml.newpoint(name="New Zealand's Southern Alps", coords=[(170.144,-43.605)])
pnt.style.iconstyle.scale = 1.0
# Create a tour and attach a playlist to it
tour = kml.newgxtour(name="Play me!")
playlist = tour.newgxplaylist()
# Attach a gx:SoundCue to the playlist and delay playing by 2 second (sound clip is about 4 seconds long)
soundcue = playlist.newgxsoundcue()
soundcue.href = "http://simplekml.googlecode.com/hg/samples/resources/drum_roll_1.wav"
soundcue.gxdelayedstart = 2
# Attach a gx:AnimatedUpdate to the playlist
animatedupdate = playlist.newgxanimatedupdate(gxduration=6.5)
animatedupdate.update.change = '10.0'.format(pnt.style.iconstyle.id)
# Attach a gx:FlyTo to the playlist
flyto = playlist.newgxflyto(gxduration=4.1)
flyto.camera.longitude = 170.157
flyto.camera.latitude = -43.671
flyto.camera.altitude = 9700
flyto.camera.heading = -6.333
flyto.camera.tilt = 33.5
flyto.camera.roll = 0
# Attach a gx:Wait to the playlist to give the gx:AnimatedUpdate time to finish
wait = playlist.newgxwait(gxduration=2.4)
# Save to file
kml.save(os.path.splitext(__file__)[0] + ".kml")
c > [ [ U ] 5 XR S' X R S' / U l Ub U =R U-
sl g g )Nname description)r r r
r( gxplaylists)r r r r r s r r
GxTour.__init__ sN ot-/ &#. - " + #r c U R S $ )zString name of the tourr r, r s r r GxTour.name r. r c XR S' g )Nr r, )r r s r r r r0 r c U R S $ )z String description of the tour.r r, r s r r GxTour.description rK r c XR S' g )Nr r, )r r s r r r s #. - r c R [ U5 nU R R U5 U$ )z4Adds a :class:`simplekml.GxPlaylist` and returns it.)r r r )r r
gxplaylists r
newgxplaylistGxTour.newgxplaylist s' 01
+r c > S[ [ U ] 5 /nU R H" nUR UR 5 5 M$ UR S5 SR U5 $ )Nz z
r9 )r r r; r r r< )r r> r r s r r; GxTour.__str__ sY VT*,. **J JJz))+ , +
< wws|r )r r r )r r r r r r
r r r@ r r r; r r r! s @r r r s .` ! ! , ! !
[[! ! ( ( / / r r N)r simplekml.baser r simplekml.abstractviewr r r r# rB rR ra r} r r r r r r r s $ * 1
g
" " J O 4 _ 2L o L ^5%W 5%p1 1 hG G TY _ Y r