Skip to main content
Version: 21 Aug 2024

ml_zi.h

Functions

Name
MLResultMLZIIsServerConfigured(bool * out_is_configured)
Checks to see if the Zero Iteration server is running and configured properly to use by a host application.
MLResultMLZISetProgramLabel(const char * in_label)
Set the human-readable label of the current project or library, to be used in UI display and diagnostic logs to indicate what is running.

Functions Documentation

MLZIIsServerConfigured

MLResult MLZIIsServerConfigured(
bool * out_is_configured
)

Checks to see if the Zero Iteration server is running and configured properly to use by a host application.

Parameters

bool *out_is_configuredPointer to a bool indicating whether the ZI server is running and is configured properly.

Returns

MLResultMLResult_InvalidParamis_configured parameter is not valid (null).
MLResultMLResult_OkIf query was successful.
MLResultMLResult_TimeoutThe ZI server could not be reached.
MLResultMLResult_UnspecifiedFailureThere was an unknown error submitting the query.

Required Permissions:

  • None

API Level:

  • 20

MLZISetProgramLabel

MLResult MLZISetProgramLabel(
const char * in_label
)

Set the human-readable label of the current project or library, to be used in UI display and diagnostic logs to indicate what is running.

Parameters

const char *in_labelPointer to a C string indicating the label to use for the running program, or NULL or "" to reset the label. The string is copied. It is interpreted as UTF-8.

Returns

MLResultMLResult_OkIf label was accepted (always).

Required Permissions:

  • None

When unset, The Lab and the ZI runtime refer to a program running under ZI by its process / executable name.

A label must be set before the program calls one of the MLGraphicsCreate() functions in order to be reflected.

API Level:

  • 20

Source code

// %BANNER_BEGIN%
// ---------------------------------------------------------------------
// %COPYRIGHT_BEGIN%
// Copyright (c) 2021 Magic Leap, Inc. All Rights Reserved.
// Use of this file is governed by the Software License Agreement,
// located here: https://www.magicleap.com/software-license-agreement-ml2
// Terms and conditions applicable to third-party materials accompanying
// this distribution may also be found in the top-level NOTICE file
// appearing herein.
// %COPYRIGHT_END%
// ---------------------------------------------------------------------
// %BANNER_END%

#pragma once

#include "ml_api.h"

ML_EXTERN_C_BEGIN

ML_API MLResult ML_CALL MLZIIsServerConfigured(bool *out_is_configured);

ML_API MLResult ML_CALL MLZISetProgramLabel(const char *in_label);

ML_EXTERN_C_END