Tour3DVideo

Tour3DVideo[g]

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)

Rotate around an object:

Specify a function to tour around an object:

Scope  (4)

Step Specification  (2)

Specify a list of camera positions:

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

Function  (2)

Define a function that returns the camera position:

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

Properties & Relations  (1)

Parallelize an expensive frame generation to speed up the computation:

Neat Examples  (1)

Create a tour around a 3D cellular automaton:

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

Interpolate between the points to define a trajectory:

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

Create the tour:

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

Text

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

CMS

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

APA

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

BibTeX

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

BibLaTeX

@online{reference.wolfram_2024_tour3dvideo, organization={Wolfram Research}, title={Tour3DVideo}, year={2023}, url={https://reference.wolfram.com/language/ref/Tour3DVideo.html}, note=[Accessed: 27-April-2024 ]}