68 *
69 * @see #paintUnlock
70 */
71 public void paintLock();
72
73 /**
74 * {@code JLightweightFrame} calls this method to notify the client
75 * application that it releases the paint lock. The client application
76 * should implement the locking mechanism in order to synchronize access
77 * to the content image data, shared between {@code JLightweightFrame}
78 * and the client application.
79 *
80 * @see #paintLock
81 */
82 public void paintUnlock();
83
84 /**
85 * {@code JLightweightFrame} calls this method to notify the client
86 * application that a new data buffer has been set as a content pixel
87 * buffer. Typically this occurs when a buffer of a larger size is
88 * created in response to a content resize event. The method reports
89 * a reference to the pixel data buffer, the content image bounds
90 * within the buffer and the line stride of the buffer. These values
91 * have the following correlation.
92 * <p>
93 * The {@code width} and {@code height} matches the size of the content
94 * (the component returned from the {@link #getComponent} method). The
95 * {@code x} and {@code y} is the origin of the content, {@code (0, 0)}
96 * in the coordinate space of the content, appearing at
97 * {@code data[y * linestride + x]} in the buffer. All indices
98 * {@code data[(y + j) * linestride + (x + i)]} where
99 * {@code (0 <= i < width)} and {@code (0 <= j < height)} will represent
100 * valid pixel data, {@code (i, j)} in the coordinate space of the content.
101 *
102 * @param data the content pixel data buffer of INT_ARGB_PRE type
103 * @param x the x coordinate of the image
104 * @param y the y coordinate of the image
105 * @param width the width of the image
106 * @param height the height of the image
107 * @param linestride the line stride of the pixel buffer
108 */
109 public void imageBufferReset(int[] data,
110 int x, int y,
111 int width, int height,
112 int linestride);
113
114 /**
115 * {@code JLightweightFrame} calls this method to notify the client
116 * application that the content image bounds have been changed within the
117 * image's pixel buffer.
118 *
119 * @param x the x coordinate of the image
120 * @param y the y coordinate of the image
121 * @param width the width of the image
122 * @param height the height of the image
123 *
124 * @see #imageBufferReset
125 */
126 public void imageReshaped(int x, int y, int width, int height);
127
128 /**
129 * {@code JLightweightFrame} calls this method to notify the client
130 * application that a part of the content image, or the whole image has
131 * been updated. The method reports bounds of the rectangular dirty region.
132 * The {@code dirtyX} and {@code dirtyY} is the origin of the dirty
|
68 *
69 * @see #paintUnlock
70 */
71 public void paintLock();
72
73 /**
74 * {@code JLightweightFrame} calls this method to notify the client
75 * application that it releases the paint lock. The client application
76 * should implement the locking mechanism in order to synchronize access
77 * to the content image data, shared between {@code JLightweightFrame}
78 * and the client application.
79 *
80 * @see #paintLock
81 */
82 public void paintUnlock();
83
84 /**
85 * {@code JLightweightFrame} calls this method to notify the client
86 * application that a new data buffer has been set as a content pixel
87 * buffer. Typically this occurs when a buffer of a larger size is
88 * created in response to a content resize event.
89 * <p>
90 * When a scale factor greater than one is set on a {@code JLightweightFrame}
91 * ({@link JLightweightFrame#setScaleFactor}), an {@link OffScreenHiDPIImage}
92 * is created to server the pixel buffer.
93 * <p>
94 * The method reports a reference to the pixel data buffer, the content
95 * image bounds within the buffer and the line stride of the buffer.
96 * These values have the following correlation.
97 * The {@code width} and {@code height} matches the layout size of the content
98 * (the component returned from the {@link #getComponent} method). The
99 * {@code x} and {@code y} is the origin of the content, {@code (0, 0)}
100 * in the layout coordinate space of the content, appearing at
101 * {@code data[y * scale * linestride + x * scale]} in the buffer.
102 * A pixel with indices {@code (i, j)}, where {@code (0 <= i < width)} and
103 * {@code (0 <= j < height)}, in the layout coordinate space of the content
104 * is represented by a {@code scale^2} square of pixels in the physical
105 * coordinate space of the buffer. The top-left corner of the square has the
106 * following physical coordinate in the buffer:
107 * {@code data[(y + j) * scale * linestride + (x + i) * scale]}.
108 *
109 * @param data the content pixel data buffer of INT_ARGB_PRE type
110 * @param x the logical x coordinate of the image
111 * @param y the logical y coordinate of the image
112 * @param width the logical width of the image
113 * @param height the logical height of the image
114 * @param linestride the line stride of the pixel buffer
115 * @param scale the scale factor of the pixel buffer
116 */
117 public void imageBufferReset(int[] data,
118 int x, int y,
119 int width, int height,
120 int linestride,
121 int scale);
122
123 /**
124 * {@code JLightweightFrame} calls this method to notify the client
125 * application that the content image bounds have been changed within the
126 * image's pixel buffer.
127 *
128 * @param x the x coordinate of the image
129 * @param y the y coordinate of the image
130 * @param width the width of the image
131 * @param height the height of the image
132 *
133 * @see #imageBufferReset
134 */
135 public void imageReshaped(int x, int y, int width, int height);
136
137 /**
138 * {@code JLightweightFrame} calls this method to notify the client
139 * application that a part of the content image, or the whole image has
140 * been updated. The method reports bounds of the rectangular dirty region.
141 * The {@code dirtyX} and {@code dirtyY} is the origin of the dirty
|