Struct RenderSessionHandle 

pub struct RenderSessionHandle { /* private fields */ }

Owner-thread render session handle bound to a retained map.

Implementations

impl RenderSessionHandle

pub fn set_feature_state( &self, selector: &FeatureStateSelector, state: &JsonValue, ) -> Result<()>

Sets per-feature state on a render source for this session.

pub fn get_feature_state( &self, selector: &FeatureStateSelector, ) -> Result<JsonValue>

Copies per-feature state from a render source in this session.

pub fn feature_state( &self, selector: &FeatureStateSelector, ) -> Result<JsonValue>

Copies per-feature state from a render source in this session.

pub fn remove_feature_state( &self, selector: &FeatureStateSelector, ) -> Result<()>

Removes per-feature state selected for this session.

pub fn query_rendered_features( &self, geometry: &RenderedQueryGeometry, options: Option<&RenderedFeatureQueryOptions>, ) -> Result<Vec<QueriedFeature>>

Queries rendered features from the latest render session state.

pub fn query_source_features( &self, source_id: &str, options: Option<&SourceFeatureQueryOptions>, ) -> Result<Vec<QueriedFeature>>

Queries source features from the latest render session state.

pub fn query_feature_extension( &self, source_id: &str, feature: &Feature, extension: &str, extension_field: &str, arguments: Option<&JsonValue>, ) -> Result<FeatureExtensionResult>

Queries a feature extension from the latest render session state.

impl RenderSessionHandle

pub fn close(self) -> Result<(), HandleOperationError<Self>>

Explicitly destroys the render session.

Native destruction errors are returned. When destruction fails, the underlying native handle remains live so a later close can retry.

pub fn is_closed(&self) -> bool

pub fn resize(&self, width: u32, height: u32, scale_factor: f64) -> Result<()>

Resizes this attached render session.

pub fn render_update(&self) -> Result<()>

Processes the latest map render update for this render target.

pub fn detach( self, ) -> Result<DetachedRenderSessionHandle, HandleOperationError<Self>>

Detaches backend-bound render resources from the map.

The native session remains live only for destruction, so successful detach consumes this handle and returns a detached close-only handle.

pub fn reduce_memory_use(&self) -> Result<()>

Asks the session renderer to release cached resources where possible.

pub fn clear_data(&self) -> Result<()>

Clears renderer data for the session.

pub fn dump_debug_logs(&self) -> Result<()>

Dumps renderer debug logs through MapLibre Native logging.

pub fn texture_image_info(&self) -> Result<TextureImageInfo>

Returns CPU readback metadata for the most recently rendered texture frame.

pub fn read_premultiplied_rgba8_into( &self, data: &mut [u8], ) -> Result<TextureImageInfo>

Reads the most recently rendered texture frame as premultiplied RGBA8.

pub fn read_premultiplied_rgba8(&self) -> Result<PremultipliedRgba8Image>

Reads the most recently rendered texture frame into owned bytes.

pub fn acquire_metal_owned_texture_frame( &self, ) -> Result<MetalOwnedTextureFrameHandle>

Acquires a borrowed Metal frame from a session-owned texture target.

pub fn acquire_vulkan_owned_texture_frame( &self, ) -> Result<VulkanOwnedTextureFrameHandle>

Acquires a borrowed Vulkan frame from a session-owned texture target.

pub fn acquire_opengl_owned_texture_frame( &self, ) -> Result<OpenGLOwnedTextureFrameHandle>

Acquires a borrowed OpenGL frame from a session-owned texture target.

Trait Implementations

impl Debug for RenderSessionHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.