package tracy-client

  1. Overview
  2. Docs
Module type
Class type

Bindings to the client

type span = int
val enter : ?cs_depth:int -> __FILE__:string -> __LINE__:int -> ?__FUNCTION__:string -> string -> span

enter ~__FILE__ ~__LINE__ name enters a span.

  • parameter __FILE__

    the filename, typically you can use __FILE__

  • parameter __LINE__

    the line number in file, typically you can use __LINE__

  • parameter __FUNCTION__

    if provided, documents the function in which the call occurs (typically you can use __FUNCTION__)

  • parameter name

    name for the span. This is what appears in Tracy on the span.

  • parameter cs_depth

    if provided, depth of call stack to capture. Using this parameter makes the capture slower but captures a stack trace.

val set_app_info : string -> unit

Set application information

val add_text : span -> string -> unit

add_text span s annotates the span with text s. This can be called several times on the same span.

val add_text_f : span -> ((('a, Stdlib.Format.formatter, unit, unit) Stdlib.format4 -> 'a) -> unit) -> unit

Formatted version of add_text.

Usage: add_text_f span (fun k -> k "some %s message! (%d/100)" "formatted" 100).

val add_value : span -> int64 -> unit

add_value span v annotates the span with a numeric value (which should be unsigned).

val set_color : span -> int -> unit

set_color span c sets the color of the span.

c is an integer that represents a color using a RGB triple as follows: 0xRRGGBB.

val with_ : ?cs_depth:int -> __FILE__:string -> __LINE__:int -> ?__FUNCTION__:string -> string -> (span -> 'a) -> 'a

Run function within a span. See enter for more details about the parameters.

val exit : span -> unit

Must be called on the same thread as enter

val name_thread : string -> unit

Give a name to the current thread

val message : string -> unit

Send a message

val message_f : ((('a, Stdlib.Format.formatter, unit, unit) Stdlib.format4 -> 'a) -> unit) -> unit

Send a formatted message. Usage: message_f (fun k -> k "hello %s %d" "world" 42)

val plot : string -> float -> unit

Innovation. Community. Security.