Подробное описание методов

• getPixelFormat

  PixelFormat getPixelFormat()

  Этот метод возвращает PixelFormat, в котором поверхность хранит свои пиксели, или примерно эквивалентный формат пикселей, из которого можно легко преобразовать пиксели для записи.

  Возвращает:

  PixelFormat, который лучше всего описывает базовые пиксели

• setArgb

  void setArgb​(int x,
               int y,
               int argb)

  Сохраняет данные пикселей для цвета в указанных координатах поверхности. 32-битный целочисленный параметр argb должен содержать 4 цветовые компоненты в отдельных 8-битных полях в порядке ARGB, начиная со старшего байта и заканчивая младшим.

  Параметры:

  x - координата X цвета пикселя для записи

  y - координата Y цвета пикселя для записи

  argb - информация о цвете для записи, указанная в формате, описанном типом INT_ARGB PixelFormat.

• setColor

  void setColor​(int x,
                int y,
                Color c)

  Сохраняет данные пикселей для Color в указанных координатах поверхности.

  Параметры:

  x - координата X цвета пикселя для записи

  y - координата Y цвета пикселя для записи

  c - Color для записи или null

  Исключения:

  NullPointerException - если color равно null

• setPixels

  <T extends Buffer> void setPixels​(int x,
                                    int y,
                                    int w,
                                    int h,
                                    PixelFormat<T> pixelformat,
                                    T buffer,
                                    int scanlineStride)

  Сохраняет данные пикселей из буфера в прямоугольную область поверхности. Формат пикселей в буфере определяется объектом PixelFormat, и при необходимости будет выполнено преобразование формата пикселей для сохранения данных на поверхности. Предполагается, что буфер расположен в месте, где находятся данные первого пикселя для сохранения на поверхности пикселя в location (x, y). Данные пикселей для строки будут считываться из смежных местоположений в буфере, упакованных как можно плотнее для увеличения координат X. Данные пикселей для смежных строк будут считываться со смещением друг от друга на число элементов данных буфера, определяемое scanlineStride.

  Параметры типа:

  T - тип буфера

  Параметры:

  x - координата X прямоугольной области для записи

  y - координата Y прямоугольной области для записи

  w - ширина прямоугольной области для записи

  h - высота прямоугольной области для записи

  pixelformat - объект PixelFormat, определяющий формат для считывания пикселей из буфера

  buffer - буфер типа, подходящего для указанного объекта PixelFormat

  scanlineStride - расстояние между данными пикселей для начала одной строки данных в буфере и началом следующей строки данных.

  Исключения:

  NullPointerException - если pixelformat или buffer равно null

• setPixels

  void setPixels​(int x,
                 int y,
                 int w,
                 int h,
                 PixelFormat<ByteBuffer> pixelformat,
                 byte[] buffer,
                 int offset,
                 int scanlineStride)

  Сохраняет данные пикселей из массива байтов в прямоугольную область поверхности. Формат пикселей в буфере определяется объектом PixelFormat, и при необходимости будет выполнено преобразование формата пикселей для сохранения данных на поверхности. pixelformat должен быть совместимым типом PixelFormat<ByteBuffer>. Данные для первого пикселя в местоположении (x, y) будут считаны из индекса массива, указанного параметром offset. Данные пикселей для строки будут считываться из смежных местоположений в массиве, упакованных как можно плотнее для увеличения координат X. Данные пикселей для смежных строк будут считываться со смещением друг от друга на число элементов массива байтов, определяемое scanlineStride.

  Параметры:

  x - координата X прямоугольной области для записи

  y - координата Y прямоугольной области для записи

  w - ширина прямоугольной области для записи

  h - высота прямоугольной области для записи

  pixelformat - объект PixelFormat<ByteBuffer>, определяющий байтовый формат для считывания пикселей из буфера

  buffer - массив байтов, содержащий данные пикселей для хранения

  offset - смещение в buffer для считывания данных первого пикселя

  scanlineStride - расстояние между данными пикселей для начала одной строки данных в буфере и началом следующей строки данных

  Исключения:

  NullPointerException - если pixelformat или buffer равно null

• setPixels

  void setPixels​(int x,
                 int y,
                 int w,
                 int h,
                 PixelFormat<IntBuffer> pixelformat,
                 int[] buffer,
                 int offset,
                 int scanlineStride)

  Сохраняет данные пикселей из массива int в прямоугольную область поверхности. Формат пикселей в буфере определяется объектом PixelFormat, и при необходимости будет выполнено преобразование формата пикселей для сохранения данных на поверхности. pixelformat должен быть совместимым типом PixelFormat<IntBuffer>. Данные для первого пикселя в местоположении (x, y) будут считаны из индекса массива, указанного параметром offset. Данные пикселей для строки будут считываться из смежных местоположений в массиве, упакованных как можно плотнее для увеличения координат X. Данные пикселей для смежных строк будут считываться со смещением друг от друга на число элементов массива int, определяемое scanlineStride.

  Параметры:

  x - координата X прямоугольной области для записи

  y - координата Y прямоугольной области для записи

  w - ширина прямоугольной области для записи

  h - высота прямоугольной области для записи

  pixelformat - объект PixelFormat<IntBuffer>, определяющий формат int для считывания пикселей из буфера

  buffer - массив int, содержащий данные пикселей для хранения

  offset - смещение в buffer для считывания данных первого пикселя

  scanlineStride - расстояние между данными пикселей для начала одной строки данных в буфере и началом следующей строки данных

  Исключения:

  NullPointerException - если pixelformat или buffer равно null

• setPixels

  void setPixels​(int dstx,
                 int dsty,
                 int w,
                 int h,
                 PixelReader reader,
                 int srcx,
                 int srcy)

  Сохраняет данные пикселей, полученные из экземпляра PixelReader, в прямоугольную область поверхности. Данные для пикселя на поверхности в (dstx, dsty) будут получены из reader из его местоположения (srcx, srcy). Этот метод выполняет операцию, семантически эквивалентную (хотя, вероятно, намного быстрее, чем) этому псевдокоду:

       for (int y = 0; y < h, y++) {
           for (int x = 0; x < w; x++) {
               setArgb(dstx + x, dsty + y,
                       reader.getArgb(srcx + x, srcy + y));
           }
       }
   

  Параметры:

  dstx - координата X прямоугольной области для записи

  dsty - координата Y прямоугольной области для записи

  w - ширина прямоугольной области для записи

  h - высота прямоугольной области для записи

  reader - PixelReader, используемый для получения данных пикселей для записи

  srcx - координата X данных для чтения из reader

  srcy - координата Y данных для чтения из reader

  Исключения:

  NullPointerException - если reader равно null