.. default-domain:: cs
.. highlight:: csharp
.. namespace:: KRPC.Client.Services.UI

Image
=====


.. class:: Image

   A picture, or a plain colored rectangle.
   Added to a :type:`Canvas` or a :type:`Panel`.

   .. property:: RectTransform RectTransform { get; }

      The rect transform for the UI object.

      :Game Scenes: All

   .. property:: LayoutElement LayoutElement { get; }

      How much space the UI object asks a layout for.

      :Game Scenes: All


      .. note::

         Only has an effect when the object is in a panel that has a layout. A canvas is
         not inside a layout and does not have one.

   .. property:: bool Visible { get; set; }

      Whether the UI object is visible.

      :Game Scenes: All


      .. note::

         This is the object's own setting, which is what it was last set to. An object is
         only drawn when everything it is inside is visible as well, so an interface can
         be built with its parts visible, inside a panel that is not, and shown all at
         once by making that panel visible.

   .. property:: byte[] Content { get; set; }

      The picture to show, as the contents of a PNG or JPEG file. Set it to an empty
      array to show a plain rectangle instead.

      :Game Scenes: All


      .. note::

         Reading this returns what was last set, not what is on the screen, and returns
         an empty array if no picture has been set. A picture drawn with
         :meth:`Image.SetPixels` is not returned here either.

   .. function:: void SetPixels(byte[] data, int width, int height)

      Draw the picture from raw pixels rather than a file, so that a client can
      draw whatever it likes, a graph for instance, and redraw it as often as it
      likes.

      :parameters:

       * **data** -- The pixels, 4 bytes per pixel: red, green, blue and alpha, each 0 to 255. Pixels run left to right and rows run top to bottom, the way image files store them, so the array must hold width times height times 4 bytes.
       * **width** -- How many pixels wide the picture is.
       * **height** -- How many pixels tall the picture is.

      :Game Scenes: All


      .. note::

         Redrawing at an unchanged size draws into the picture already there, so a
         picture redrawn every update does not build a new one each time.

   .. function:: void UpdatePixels(byte[] data, int x, int y, int width, int height)

      Redraw part of a picture drawn with :meth:`Image.SetPixels`: a block of the
      given size, with its top left corner x pixels in from the left edge and y
      pixels down from the top. The rest of the picture is left as it is, so a
      change to a small part of a large picture, one new column of a scrolling
      graph for instance, only sends the part that changed.

      :parameters:

       * **data** -- The pixels of the block, laid out as for :meth:`Image.SetPixels`: 4 bytes per pixel, rows top to bottom, width times height times 4 bytes in all.
       * **x** -- How many pixels the block sits in from the left edge.
       * **y** -- How many pixels the block sits down from the top.
       * **width** -- How many pixels wide the block is.
       * **height** -- How many pixels tall the block is.

      :Game Scenes: All


      .. note::

         The image must already be showing a picture drawn from raw pixels, which is
         what sets the size, and the block must fit inside it. A picture loaded from
         a file cannot be redrawn this way: the file contents a client reads back
         would no longer be what is on the screen.

   .. property:: StdLib.ColorRGBA Color { get; set; }

      The color the image is tinted with, or the color of the rectangle when no
      picture is set.

      :Game Scenes: All

   .. function:: void Remove()

      Remove the UI object.


      :Game Scenes: All