unreal.MagicLeapCameraComponent

class unreal.MagicLeapCameraComponent(outer=None, name='None')

Bases: unreal.ActorComponent

The MagicLeapCameraComponent provides access to and maintains state for camera capture functionality. The connection to the device’s camera is managed internally. Users of this component are able to asynchronously capture camera images and footage to file. Alternatively, a camera image can be captured directly to texture. The user need only make the relevant asynchronous call and then register the appropriate event handlers for the operation’s completion.

C++ Source:

  • Plugin: MagicLeapCamera
  • Module: MagicLeapCamera
  • File: MagicLeapCameraComponent.h

Editor Properties: (see get_editor_property/set_editor_property)

  • asset_user_data (Array(AssetUserData)): [Read-Write] Array of user data stored with the component
  • auto_activate (bool): [Read-Write] Whether the component is activated at creation or must be explicitly activated.
  • can_ever_affect_navigation (bool): [Read-Write] Whether this component can potentially influence navigation
  • component_tags (Array(Name)): [Read-Write] Array of tags that can be used for grouping and categorizing. Can also be accessed from scripting.
  • editable_when_inherited (bool): [Read-Write] True if this component can be modified when it was inherited from a parent actor class
  • is_editor_only (bool): [Read-Write] If true, the component will be excluded from non-editor builds
  • on_capture_img_to_file (CameraCaptureImgToFileMulti): [Read-Write] On Capture Img to File
  • on_capture_img_to_texture (CameraCaptureImgToTextureMulti): [Read-Write] On Capture Img to Texture
  • on_component_activated (ActorComponentActivatedSignature): [Read-Write] Called when the component has been activated, with parameter indicating if it was from a reset
  • on_component_deactivated (ActorComponentDeactivateSignature): [Read-Write] Called when the component has been deactivated
  • on_log_message (CameraLogMessageMulti): [Read-Write] On Log Message
  • on_start_recording (CameraStartRecordingMulti): [Read-Write] On Start Recording
  • on_stop_recording (CameraStopRecordingMulti): [Read-Write] On Stop Recording
  • primary_component_tick (ActorComponentTickFunction): [Read-Write] Main tick function for the Component
  • replicates (bool): [Read-Write] Is this component currently replicating? Should the network code consider it for replication? Owning Actor must be replicating first!
capture_image_to_file_async() → bool

Initiates a capture image to file task on a separate thread. The newly created jpeg file will have an automatically generated name which is guaranteed to be unique. Upon completion, a successful operation will provide the file path of the newly created jpeg to the FCameraCaptureImgToFile event handler.:

Returns:True if the call succeeds, false otherwise.
Return type:bool
capture_image_to_texture_async() → bool

Initiates a capture image to memory task on a speparate thread. The user should register event handlers for both the success and fail events. Upon completion, a successful operation will provide a dynamically generated texture containing the captured image to the FCameraCaptureImgToTextureSuccess event handler.: The generated texture will be garbage collected when this app is destroyed.:

Returns:True if the call succeeds, false otherwise.
Return type:bool
is_capturing() → bool

Gets the capture state of the component.

Returns:True if the component is currently capturing, false otherwise.
Return type:bool
on_capture_img_to_file

(CameraCaptureImgToFileMulti) – [Read-Write] On Capture Img to File

on_capture_img_to_texture

(CameraCaptureImgToTextureMulti) – [Read-Write] On Capture Img to Texture

on_log_message

(CameraLogMessageMulti) – [Read-Write] On Log Message

on_start_recording

(CameraStartRecordingMulti) – [Read-Write] On Start Recording

on_stop_recording

(CameraStopRecordingMulti) – [Read-Write] On Stop Recording

start_recording_async() → bool

Initiates the capturing of video/audio data on a separate thread. The system will continue to record video until StopRecordingVideo is called.:

Returns:True if the call succeeds, false otherwise.
Return type:bool
stop_recording_async() → bool

Stops the recording and saves the video/audio data to an mp4 file. The newly created mp4 file will have an automatically generated name which is guaranteed to be unique.:

Returns:True if the call succeeds, false otherwise.
Return type:bool