WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

Tour3DVideo
✖
Tour3DVideo

New in 14[Experimental]

✖

generates a video giving a standard tour around a 3D object g.

✖
Tour3DVideo[g,tour]

generates the named video tour.

✖
Tour3DVideo[g,steps]

generates a video tour from steps.

Details and Options

  • Tour3DVideo generates a video by navigating around a 3D object.
  • The 3D object g can be a Graphics3D, Image3D or any valid 3D region.
  • The steps specification can be any of the following:
  • {step1,step2,…}a sequence of steps
    {t1step1,…}a sequence of steps to happen at given times
    funcan arbitrary function
  • Position specification stepi can be used to specify the position of the camera:
  • {x,y,z}absolute camera position in the 3D graphics coordinate
    Scaled[{x,y,z}]camera position scaled from 0 to 1 with respect to the bounding box
    <|prop1val1,…|>an association of step properties
  • When a step is provided as an association of properties, the following keys can be specified:
  • "CameraPosition"position of the camera given as {x,y,z} or Scaled[…]
    "ViewAngle"the opening angle for the camera in radians
    "ViewVertical"direction to make vertical
    "SubjectPosition"position the camera is pointed at given as {x,y,z} or Scaled[…]
    "DwellTime"the dwell time given in seconds or other time quantity
  • The only mandatory key is "CameraPosition". If the "SubjectPosition" key is not specified, the camera will be pointing to the center of the bounding box.
  • Options to control the creation of frames are:
  • AspectRatio9/16aspect ratio to use
    DefaultDurationAutomaticsuggested duration in seconds
    InterpolationOrder1an interpolation order to use
  • To generate frames in parallel, use Parallelize[Tour3DVideo[…]].
  • By default, Tour3DVideo places the new video under the "Video" directory in $WolframDocumentsDirectory.
  • Options to control properties of the output video are:
  • BitRateAutomaticapproximate bit rate to use
    CompressionLevelAutomaticcompression level to use
    FrameRateAutomaticthe frame rate to use
    GeneratedAssetFormatAutomaticthe format of the result
    GeneratedAssetLocation$GeneratedAssetLocationthe location of the result
    OverwriteTargetFalsewhether to overwrite an existing file
    RasterSizeAutomaticraster size of the output video
    VideoEncodingAutomaticvideo encoding to use
    VideoTransparencyFalsewhether the output video should have a transparency channel

Examples

open allclose all

Basic Examples  (2)Summary of the most common use cases

Rotate around an object:

In[10]:=10
✖
https://wolfram.com/xid/0btnkxlq1wqm-pkq4nj
Out[10]=10

Specify a function to tour around an object:

In[1]:=1
✖
https://wolfram.com/xid/0btnkxlq1wqm-looxts
Out[1]=1

Scope  (4)Survey of the scope of standard use cases

Step Specification  (2)

Specify a list of camera positions:

In[6]:=6
✖
https://wolfram.com/xid/0btnkxlq1wqm-5utyta
Out[6]=6

Specify a list of associations that determine the camera and subject position:

In[1]:=1
✖
https://wolfram.com/xid/0btnkxlq1wqm-pysvfn
Out[1]=1

Function  (2)

Define a function that returns the camera position:

In[5]:=5
✖
https://wolfram.com/xid/0btnkxlq1wqm-nwjbom
Out[6]=6
In[7]:=7
✖
https://wolfram.com/xid/0btnkxlq1wqm-ru9dhm
Out[7]=7

Define a function that returns an association that fully specifies the scene:

In[1]:=1
✖
https://wolfram.com/xid/0btnkxlq1wqm-43duvh
In[2]:=2
✖
https://wolfram.com/xid/0btnkxlq1wqm-5qz2o0
Out[2]=2

Properties & Relations  (1)Properties of the function, and connections to other functions

Parallelize an expensive frame generation to speed up the computation:

In[4]:=4
✖
https://wolfram.com/xid/0btnkxlq1wqm-fhpqd1
Out[4]=4
In[5]:=5
✖
https://wolfram.com/xid/0btnkxlq1wqm-2aamhn
Out[5]=5

Neat Examples  (1)Surprising or curious use cases

Create a tour around a 3D cellular automaton:

In[1]:=1
✖
https://wolfram.com/xid/0btnkxlq1wqm-my85uk

Define a set of points around the scene and find the shortest tour between them:

In[2]:=2
✖
https://wolfram.com/xid/0btnkxlq1wqm-9qpi9k
Out[5]=5

Interpolate between the points to define a trajectory:

In[6]:=6
✖
https://wolfram.com/xid/0btnkxlq1wqm-zr4o9q
Out[7]=7

Define a function that returns the camera and subject position and the view angle at each time:

In[8]:=8
✖
https://wolfram.com/xid/0btnkxlq1wqm-ou7f4d

Create the tour:

In[9]:=9
✖
https://wolfram.com/xid/0btnkxlq1wqm-q7d3os
Out[9]=9
Wolfram Research (2024), Tour3DVideo, Wolfram Language function, https://reference.wolfram.com/language/ref/Tour3DVideo.html.
✖
Wolfram Research (2024), Tour3DVideo, Wolfram Language function, https://reference.wolfram.com/language/ref/Tour3DVideo.html.

Text

Wolfram Research (2024), Tour3DVideo, Wolfram Language function, https://reference.wolfram.com/language/ref/Tour3DVideo.html.

✖
Wolfram Research (2024), Tour3DVideo, Wolfram Language function, https://reference.wolfram.com/language/ref/Tour3DVideo.html.

CMS

Wolfram Language. 2024. "Tour3DVideo." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/Tour3DVideo.html.

✖
Wolfram Language. 2024. "Tour3DVideo." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/Tour3DVideo.html.

APA

Wolfram Language. (2024). Tour3DVideo. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Tour3DVideo.html

✖
Wolfram Language. (2024). Tour3DVideo. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Tour3DVideo.html

BibTeX

@misc{reference.wolfram_2025_tour3dvideo, author="Wolfram Research", title="{Tour3DVideo}", year="2024", howpublished="\url{https://reference.wolfram.com/language/ref/Tour3DVideo.html}", note=[Accessed: 08-March-2025 ]}

✖
@misc{reference.wolfram_2025_tour3dvideo, author="Wolfram Research", title="{Tour3DVideo}", year="2024", howpublished="\url{https://reference.wolfram.com/language/ref/Tour3DVideo.html}", note=[Accessed: 08-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_tour3dvideo, organization={Wolfram Research}, title={Tour3DVideo}, year={2024}, url={https://reference.wolfram.com/language/ref/Tour3DVideo.html}, note=[Accessed: 08-March-2025 ]}

✖
@online{reference.wolfram_2025_tour3dvideo, organization={Wolfram Research}, title={Tour3DVideo}, year={2024}, url={https://reference.wolfram.com/language/ref/Tour3DVideo.html}, note=[Accessed: 08-March-2025 ]}