@dcl/protocol 1.0.0-3583035976.commit-35d616d → 1.0.0-35899496093.commit-329ba0e

package/proto/decentraland/sdk/components/ui_canvas_information.proto

@@ -0,0 +1,30 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/border_rect.proto";
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1054;
+
+// This component is created by the renderer and used by the scenes to know the resolution of the UI canvas
+message PBUiCanvasInformation {
+  // informs the scene about the resolution used for the UI rendering
+  float device_pixel_ratio = 1;
+  // informs about the width of the canvas, in virtual pixels. this value does not change when the pixel ratio changes.
+  int32 width = 2;
+  // informs about the height of the canvas, in virtual pixels. this value does not change when the pixel ratio changes.
+  int32 height = 3;
+  // informs the sdk about the interactable area. some implementations may change
+  // this area depending on the HUD that is being shown. this value may change at
+  // any time by the Renderer to create reactive UIs. as an example, an explorer with the
+  // chat UI hidden and with no minimap could have a rect that covers the whole screen.
+  // on the contrary, if the chat UI is shown, the rect would be smaller.
+  decentraland.common.BorderRect interactable_area = 4;
+  // informs the sdk about the screen inset area (safe margins). these are the
+  // insets from each edge of the screen that are reserved by the device or
+  // platform UI (for example: the notch, status bar, home indicator, or rounded
+  // corners on mobile). scenes should avoid placing critical UI within these
+  // insets to ensure it is not occluded. on desktop this is typically (0, 0, 0, 0).
+  optional decentraland.common.BorderRect screen_inset_area = 5;
+}

package/proto/decentraland/sdk/components/ui_dropdown.proto

@@ -0,0 +1,23 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/colors.proto";
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/common/texts.proto";
+
+option (common.ecs_component_id) = 1094;
+
+message PBUiDropdown {
+  bool accept_empty = 1;
+  optional string empty_label = 2;
+  repeated string options = 3;
+  optional int32 selected_index = 4; // default=null when accept_empty==true; default=0 when accept_empty==false
+  bool disabled = 5;
+  optional decentraland.common.Color4 color = 6; // default=(0.0,0.0,0.0,1.0)
+  
+  optional common.TextAlignMode text_align = 10; // default='center'
+  optional common.Font font = 11; // default=0
+  optional int32 font_size = 12; // default=10
+  optional string font_src = 13; // a font file in the scene, or a Google Fonts family name; `font` is the fallback (default: unset)
+}

package/proto/decentraland/sdk/components/ui_dropdown_result.proto

@@ -0,0 +1,11 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1096;
+
+message PBUiDropdownResult {
+  int32 value = 1;
+}

package/proto/decentraland/sdk/components/ui_input.proto

@@ -0,0 +1,23 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/common/colors.proto";
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/common/texts.proto";
+
+option (common.ecs_component_id) = 1093;
+
+message PBUiInput {
+  string placeholder = 1;
+  optional decentraland.common.Color4 color = 2; // default=(0.0,0.0,0.0,1.0)
+  optional decentraland.common.Color4 placeholder_color = 3; // default=(0.3,0.3,0.3,1.0)
+  bool disabled = 4;
+  optional common.TextAlignMode text_align = 10; // default='center'
+  optional common.Font font = 11; // default=0
+  optional int32 font_size = 12; // default=10
+  optional string value = 13;
+  optional bool multi_line = 14; // default=false; when true, the input accepts newlines and behaves as a textarea
+  optional bool clear_on_submit = 15; // default=true; when false, the input value is preserved after pressing Enter
+  optional string font_src = 16; // a font file in the scene, or a Google Fonts family name; `font` is the fallback (default: unset)
+}

package/proto/decentraland/sdk/components/ui_input_binding.proto

@@ -0,0 +1,27 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/sdk/components/common/input_action.proto";
+option (common.ecs_component_id) = 1219;
+
+// The UiInputBinding component binds a UI entity to one or more InputActions. While the
+// element is pressed (touch or pointer) the listed actions are held down, driving both
+// the local player input and scene InputAction listeners, just like the native on-screen
+// buttons. It is typically combined with PBTouchScreenControls to replace the native
+// controls with a custom touch UI.
+//
+// Release semantics: the held actions are released as soon as the press that started them
+// ends. A renderer MUST release all actions held by this binding when any of the following
+// happens: the press/touch is lifted or cancelled, the pointer/touch leaves the element
+// (loses press ownership), the actions list changes (the previous set is released before
+// the new set is applied), the component is removed or its actions list becomes empty, the
+// UI element is hidden, disabled or removed from the tree, or the scene unloads. In short,
+// no action may remain held once the element is no longer both present and actively pressed.
+//
+// Multi-touch: the binding is a single held state, not reference-counted per pointer. The
+// actions are held while the element is pressed and released when that press ends; a second
+// simultaneous press on the same element does not stack, and does not extend the hold past
+// the first release.
+message PBUiInputBinding {
+    repeated common.InputAction actions = 1; // the input actions fired while this element is pressed
+}

package/proto/decentraland/sdk/components/ui_input_result.proto

@@ -0,0 +1,12 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+
+option (common.ecs_component_id) = 1095;
+
+message PBUiInputResult {
+  string value = 1;
+  optional bool is_submit = 2; // default: false
+}

package/proto/decentraland/sdk/components/ui_scroll_result.proto

@@ -0,0 +1,12 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+import "decentraland/common/vectors.proto";
+
+option (common.ecs_component_id) = 1202;
+
+message PBUiScrollResult {
+  decentraland.common.Vector2 value = 1;
+}

package/proto/decentraland/sdk/components/ui_text.proto

@@ -8,10 +8,20 @@ import "decentraland/sdk/components/common/texts.proto";
 
 option (common.ecs_component_id) = 1052;
 
+enum TextWrap {
+  TW_WRAP = 0;
+  TW_NO_WRAP = 1;
+}
+
+// The UiText component creates a text widget inside a UI component tree. Its position and
+// layout properties can be specified in a UiTransform component on the same Entity.
+
 message PBUiText {
-  string value = 1;
-  optional decentraland.common.Color4 color = 2; // default=(1.0,1.0,1.0,1.0)
-  optional common.TextAlignMode text_align = 3; // default='center'
-  optional common.Font font = 4; // default=0
-  optional int32 font_size = 5; // default=10
+  string value = 1;                              // the text content, tag <b> and <i> are supported
+  optional decentraland.common.Color4 color = 2; // RGBA color (default: opaque white)
+  optional common.TextAlignMode text_align = 3;  // alignment within the bounds (default: center)
+  optional common.Font font = 4;                 // font for the text (default: sans-serif)
+  optional int32 font_size = 5;                  // size of the text (default: 10)
+  optional TextWrap text_wrap = 6;               // wrap text when the border is reached (default: TW_WRAP)
+  optional string font_src = 9;                  // a font file in the scene, or a Google Fonts family name; `font` is the fallback (default: unset)
 }

package/proto/decentraland/sdk/components/ui_transform.proto

@@ -3,6 +3,8 @@ syntax = "proto3";
 package decentraland.sdk.components;
 
 import "decentraland/sdk/components/common/id.proto";
+import "decentraland/common/colors.proto";
+import "decentraland/common/vectors.proto";
 
 option (common.ecs_component_id) = 1050;
 
@@ -74,6 +76,25 @@ enum YGEdge {
   YGE_ALL = 8;
 }
 
+enum PointerFilterMode {
+  PFM_NONE = 0;
+  PFM_BLOCK = 1;
+}
+
+enum ShowScrollBar {
+  SSB_BOTH = 0;
+  SSB_ONLY_VERTICAL = 1;
+  SSB_ONLY_HORIZONTAL = 2;
+  SSB_HIDDEN = 3;
+}
+
+message ScrollPositionValue {
+  oneof value {
+    decentraland.common.Vector2 position = 1;
+    string reference = 2;
+  }
+}
+
 message PBUiTransform {
   int32 parent = 1;
   int32 right_of = 2;
@@ -138,4 +159,40 @@ message PBUiTransform {
   float padding_right = 49;
   YGUnit padding_bottom_unit = 50; // YGUnit.YGU_UNDEFINED
   float padding_bottom = 51;
+
+  optional PointerFilterMode pointer_filter = 52; // default: PointerFilterMode.PFM_NONE
+
+  // Border Width
+  optional YGUnit border_left_width_unit = 53; // YGUnit.YGU_UNDEFINED
+  optional float border_left_width = 54;
+  optional YGUnit border_top_width_unit = 55; // YGUnit.YGU_UNDEFINED
+  optional float border_top_width = 56;
+  optional YGUnit border_right_width_unit = 57; // YGUnit.YGU_UNDEFINED
+  optional float border_right_width = 58;
+  optional YGUnit border_bottom_width_unit = 59; // YGUnit.YGU_UNDEFINED
+  optional float border_bottom_width = 60;
+
+  // Border Radius
+  optional YGUnit border_top_left_radius_unit = 61; // YGUnit.YGU_UNDEFINED
+  optional float border_top_left_radius = 62;
+  optional YGUnit border_top_right_radius_unit = 63; // YGUnit.YGU_UNDEFINED
+  optional float border_top_right_radius = 64;
+  optional YGUnit border_bottom_left_radius_unit = 65; // YGUnit.YGU_UNDEFINED
+  optional float border_bottom_left_radius = 66;
+  optional YGUnit border_bottom_right_radius_unit = 67; // YGUnit.YGU_UNDEFINED
+  optional float border_bottom_right_radius = 68;
+
+  // Border Color
+  optional decentraland.common.Color4 border_top_color = 69;
+  optional decentraland.common.Color4 border_bottom_color = 70;
+  optional decentraland.common.Color4 border_left_color = 71;
+  optional decentraland.common.Color4 border_right_color = 72;
+
+  optional float opacity = 73; // default: 1
+
+  optional string element_id = 74; // reference for scroll_position. default empty
+  optional ScrollPositionValue scroll_position = 75; // default position=(0,0)
+  optional ShowScrollBar scroll_visible = 76; // default ShowScrollBar.SSB_BOTH
+
+  optional int32 z_index = 77; // default: 0 — controls render stacking order. Higher values appear in front of lower values.
 }

package/proto/decentraland/sdk/components/video_event.proto

@@ -0,0 +1,25 @@
+syntax = "proto3";
+
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1044;
+
+message PBVideoEvent {
+  uint32 timestamp = 1;     // monotonic counter
+  uint32 tick_number = 2;   // number of tick in which the event was produced, equals to EngineInfo.tick_number
+  float current_offset = 3;
+  float video_length = 4;
+  VideoState state = 5;
+}
+
+enum VideoState {
+  VS_NONE = 0;
+  VS_ERROR = 1;
+  VS_LOADING = 2;
+  VS_READY = 3;
+  VS_PLAYING = 4;
+  VS_BUFFERING = 5;
+  VS_SEEKING = 6;
+  VS_PAUSED = 7;
+}

package/proto/decentraland/sdk/components/video_player.proto

@@ -0,0 +1,24 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1043;
+
+message PBVideoPlayer {
+   // which file to load
+  string src = 1;
+
+  optional bool playing = 2; // default true
+  optional float position = 3; // default 0.0
+  optional float volume = 4; // default 1.0
+  optional float playback_rate = 5; // default 1.0
+  optional bool loop = 6; // default false
+  // either the audio will be global or spatial (default: false)
+  // global: plays the same way for every listener. It is not affected by distance, direction, or position.
+  // spatial: changes depending on where the listener is relative to the sound source
+  optional bool spatial = 7;
+  // Within the min distance the audio will cease to grow louder in volume (default: 0)
+  optional float spatial_min_distance = 8;
+  // The distance where sound either becomes inaudible or stops attenuation (default: 60)
+  optional float spatial_max_distance = 9;
+}

package/proto/decentraland/sdk/components/virtual_camera.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+package decentraland.sdk.components;
+
+import "decentraland/sdk/components/common/camera_transition.proto";
+import "decentraland/sdk/components/common/id.proto";
+option (common.ecs_component_id) = 1076;
+
+// PBVirtualCamera represents a camera to be used at some point in time during the scene execution
+// * The defaultTransition represents the transition TOWARDS this camera. If there is none, it's treated as
+// an 'instant' transition (like using speed/time = 0)
+// * The lookAtEntity defines to which entity the Camera has to look at constantly (independent from 
+// the holding entity transform).
+// * The fov defines the Field of View of the virtual camera
+message PBVirtualCamera {
+  optional common.CameraTransition default_transition = 1;
+  optional uint32 look_at_entity = 2;
+  optional float fov = 3; // default: 60
+}

package/proto/decentraland/sdk/components/visibility_component.proto

@@ -6,4 +6,11 @@ option (common.ecs_component_id) = 1081;
 
 message PBVisibilityComponent {
     optional bool visible = 1; // default=true
+    
+    // Propagation follows certain rules:
+    // - Any own visibility component takes priority
+    // - If no own visibility component, visibility is determined by visibility of the nearest parent with propagate = true
+    // - If no own component and no parent with propagate = true, visibility is "visible"
+    // - Visibility is always updated, whenever hierarchy, parent component or own component changes
+    optional bool propagate_to_children = 2; // default=false
 }

package/proto/decentraland/sdk/development/local_development.proto

@@ -0,0 +1,29 @@
+syntax = "proto3";
+
+package decentraland.sdk.development;
+
+// ts code & main.crdt updates
+message UpdateScene {
+  string scene_id = 1;
+}
+
+enum UpdateModelType {
+  UMT_CHANGE = 0;
+  UMT_REMOVE = 1;
+}
+
+// .glb & .gltf model udpates
+message UpdateModel {
+  string scene_id = 1;
+  string src = 2;
+  string hash = 3;
+  UpdateModelType type = 4;
+}
+
+message WsSceneMessage {
+  oneof message {
+    // direction: scene -> explorer
+    UpdateScene update_scene = 1;
+    UpdateModel update_model = 2;
+  }
+}