APIs de pincel
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Las APIs de Brush
te proporcionan las herramientas para definir el estilo visual de tus trazos. Puedes crear pinceles con diferentes colores, tamaños y familias para lograr varios estilos.
Cómo crear un pincel
Para crear un pincel, usa los métodos de fábrica Brush
, como la clase createWithColorIntArgb()
. Los métodos de fábrica te permiten establecer las siguientes propiedades:
- familia: Es el estilo del pincel, análogo a un tipo de letra o fuente en el texto.
Consulta
StockBrushes
para ver los valores disponibles de BrushFamily
.
- color: Es el color del pincel. Puedes establecer el color con un
ColorLong
o ColorInt
.
- size: Es el grosor general de los trazos creados con el pincel.
- εpsilon: Es la distancia más pequeña para la que se deben considerar dos puntos visualmente distintos para fines de geometría de generación de trazo. La proporción de puntos de epsilon y trazo controla cuánto se puede acercar un trazo sin artefactos a costa de la memoria. Un buen punto de partida para las unidades de trazo es 1 px, y un buen punto de partida para epsilon es 0.1. Los valores de épsilon más altos usan menos memoria, pero permiten un menor zoom antes de que aparezcan los artefactos triangulares. Experimenta a fin de encontrar el valor correcto para tu caso de uso.
val brush = Brush.createWithColorIntArgb(
family = StockBrushes.pressurePenLatest,
colorIntArgb = Color.Black.toArgb(),
size = 5F,
epsilon = 0.1F
)
Modificar las propiedades del pincel
Puedes crear una copia de un pincel existente con el método copy()
. Este método te permite cambiar cualquiera de las propiedades del pincel.
val redBrush = Brush.createWithColorIntArgb(
family = StockBrushes.pressurePenLatest,
colorIntArgb = Color.RED.toArgb(),
size = 5F,
epsilon = 0.1F
)
val blueBrush = redBrush.copy(colorIntArgb = Color.BLUE.toArgb())
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[null,null,["Última actualización: 2025-07-27 (UTC)"],[],[],null,["# Brush APIs\n\nThe [`Brush`](/reference/kotlin/androidx/ink/brush/Brush) APIs provide you with\nthe tools to define the visual style of your strokes. You can create brushes\nwith different colors, sizes, and families to achieve a variety of looks.\n\nCreate a brush\n--------------\n\nTo create a brush, use the [`Brush`](/reference/kotlin/androidx/ink/brush/Brush)\nfactory methods such as\n[`createWithColorIntArgb()`](/reference/kotlin/androidx/ink/brush/Brush#createWithColorIntArgb(androidx.ink.brush.BrushFamily,kotlin.Int,kotlin.Float,kotlin.Float))\nclass. The factory methods let you set the following properties:\n\n- **family** : The style of the brush, analogous to a typeface or font in text. See [`StockBrushes`](/reference/kotlin/androidx/ink/brush/StockBrushes) for available [`BrushFamily`](/reference/kotlin/androidx/ink/brush/BrushFamily) values.\n- **color** : The color of the brush. You can set the color using a [`ColorLong`](/reference/kotlin/androidx/annotation/ColorLong) or [`ColorInt`](/reference/androidx/annotation/ColorInt).\n- **size**: The overall thickness of strokes created with the brush.\n- **epsilon**: The smallest distance for which two points should be considered visually distinct for stroke generation geometry purposes. The ratio of epsilon and stroke points control how much a stroke can be zoomed in without artifacts at the cost of memory. A good starting point for stroke units is 1px, and a good starting point for epsilon is 0.1. Higher epsilon values use less memory but allow for less zoom before triangle artifacts appear; experiment to find the right value for your use case.\n\n val brush = Brush.createWithColorIntArgb(\n family = StockBrushes.pressurePenLatest,\n colorIntArgb = Color.Black.toArgb(),\n size = 5F,\n epsilon = 0.1F\n )\n\nModify brush properties\n-----------------------\n\nYou can create a copy of an existing brush using the\n[`copy()`](/reference/kotlin/androidx/ink/brush/Brush#copy(androidx.ink.brush.BrushFamily,kotlin.Float,kotlin.Float))\nmethod. This method lets you change any of the brush's properties. \n\n val redBrush = Brush.createWithColorIntArgb(\n family = StockBrushes.pressurePenLatest,\n colorIntArgb = Color.RED.toArgb(),\n size = 5F,\n epsilon = 0.1F\n )\n\n val blueBrush = redBrush.copy(colorIntArgb = Color.BLUE.toArgb())"]]