droid_wrap/android/
graphics.rs

1/*
2 * Copyright (c) 2024. The RigelA open source project team and
3 * its contributors reserve all rights.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software distributed under the
10 * License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
11 * See the License for the specific language governing permissions and limitations under the License.
12 */
13
14use crate::{JObjNew, JObjRef, JType, java_class};
15
16/**
17Canvas 类包含“绘制”调用。要绘制某些内容，您需要 4 个基本组件：用于保存像素的 Bitmap、用于托管绘制调用（写入位图）的 Canvas、绘图基元（例如 Rect、Path、文本、Bitmap）和 Paint（用于描述绘图的颜色和样式）。
18
19开发者指南
20有关如何使用 Canvas 的更多信息，请阅读 Canvas 和 Drawables 开发者指南。
21*/
22#[java_class(name = "android/graphics/Canvas")]
23pub struct Canvas;
24
25/**
26Rect 保存矩形的四个整数坐标。矩形由其 4 条边（左、上、右、下）的坐标表示。这些字段可以直接访问。使用 width() 和 height() 检索矩形的宽度和高度。
27注意：大多数方法不会检查坐标是否正确排序（即左 <= 右且上 <= 下）。
28请注意，右坐标和下坐标是互斥的。这意味着在 Canvas 上绘制的未转换的 Rect 将绘制到其左坐标和上坐标所描述的列和行中，但不会绘制到其下坐标和右坐标中。
29*/
30#[java_class(name = "android/graphics/Rect")]
31pub struct Rect;
32
33//noinspection SpellCheckingInspection
34/**
35将图像流中的帧捕获为 OpenGL ES 纹理。图像流可能来自相机预览或视频解码。从 SurfaceTexture 创建的 Surface 可用作 android.hardware.camera2、android.media.MediaCodec、android.media.MediaPlayer 和 android.renderscript.Allocation API 的输出目标。
36调用 updateTexImage 时，创建 SurfaceTexture 时指定的纹理对象的内容将更新为包含图像流中的最新图像。这可能会导致跳过流的某些帧。
37在指定较旧的 android.hardware.Camera API 的输出目标时，还可以使用 SurfaceTexture 代替 SurfaceHolder。这样做会导致图像流中的所有帧都被发送到 SurfaceTexture 对象，而不是设备的显示器。
38一种典型的模式是使用 SurfaceTexture 将帧渲染到 TextureView；但是，使用纹理对象不需要 TextureView。纹理对象可以用作 OpenGL ES 着色器的一部分。
39从纹理采样时，首先应使用通过 getTransformMatrix(float[]) 查询的矩阵转换纹理坐标。每次调用 updateTexImage 时，转换矩阵可能会发生变化，因此每次更新纹理图像时都应重新查询。
40此矩阵将传统的 2D OpenGL ES 纹理坐标列向量（形式为 (s, t, 0, 1)，其中 s 和 t 位于包含区间 [0, 1] 上）转换为流式纹理中的正确采样位置。此转换可补偿图像流源的任何属性，这些属性会导致它看起来与传统的 OpenGL ES 纹理不同。
41例如，可以通过使用查询的矩阵转换列向量 (0, 0, 0, 1) 来完成从图像左下角的采样，而通过转换 (1, 1, 0, 1) 来完成从图像右上角的采样。纹理对象使用 GL_TEXTURE_EXTERNAL_OES 纹理目标，该目标由 GL_OES_EGL_image_external OpenGL ES 扩展定义。
42这限制了纹理的使用方式。每次绑定纹理时，它都必须绑定到 GL_TEXTURE_EXTERNAL_OES 目标，而不是 GL_TEXTURE_2D 目标。此外，任何从纹理采样的 OpenGL ES 2.0 着色器都必须声明其对此扩展的使用，例如使用“#extension GL_OES_EGL_image_external : require”指令。
43此类着色器还必须使用 samplerExternalOES GLSL 采样器类型访问纹理。 SurfaceTexture 对象可以在任何线程上创建。updateTexImage 只能在具有包含纹理对象的 OpenGL ES 上下文的线程上调用。帧可用回调在任意线程上调用，因此除非特别小心，否则不应直接从回调中调用 updateTexImage。
44*/
45#[java_class(name = "android/graphics/SurfaceTexture")]
46pub struct SurfaceTexture;
47
48/**
49点具有两个整数坐标
50*/
51#[java_class(name = "android/graphics/Point")]
52pub struct Point;
droid_wrap/android/graphics.rs

droid_wrap/android/
graphics.rs
