RemoteCanvas · Strokes
Stroke width, cap and join.
Open the live, interactive demo →
Change its controls, read the remote document it produces and the diff after every change.
What it is
A free drawing surface: shapes, lines, text and transformations drawn exactly where you place them, including animated drawings.
Good for
- Charts, gauges and progress rings
- Custom illustrations
- Watch-face style animated graphics
Code
The story's source with androidx.compose.remote imports. CI compiles every snippet on this site against AndroidX.
import androidx.compose.remote.creation.compose.layout.RemoteCanvas
import androidx.compose.remote.creation.compose.layout.RemoteComposable
import androidx.compose.remote.creation.compose.layout.RemoteOffset
import androidx.compose.remote.creation.compose.layout.RemoteSize
import androidx.compose.remote.creation.compose.modifier.RemoteModifier
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.state.RemotePaint
import androidx.compose.remote.creation.compose.state.RemotePaintingStyle
import androidx.compose.remote.creation.compose.state.RemoteStrokeCap
import androidx.compose.remote.creation.compose.state.RemoteStrokeJoin
import androidx.compose.remote.creation.compose.state.rc
import androidx.compose.remote.creation.compose.state.rdp
import androidx.compose.remote.creation.compose.state.rf
import androidx.compose.runtime.Composable
import androidx.compose.ui.graphics.Color
@Composable
@RemoteComposable
fun CanvasStrokes(strokeWidth: Float, cap: RemoteStrokeCap, join: RemoteStrokeJoin) {
RemoteCanvas(modifier = RemoteModifier.size(300.rdp, 200.rdp)) {
val paint = RemotePaint {
color = Color(0xFF3949AB).rc
style = RemotePaintingStyle.Stroke
this.strokeWidth = strokeWidth.rf
strokeCap = cap
strokeJoin = join
}
drawLine(paint, RemoteOffset(30f.rf, 40f.rf), RemoteOffset(270f.rf, 40f.rf))
drawRect(paint, topLeft = RemoteOffset(40f.rf, 90f.rf), size = RemoteSize(220f.rf, 80f.rf))
}
}
API
creation.compose.layout.RemoteCanvas
void RemoteCanvas(optional RemoteModifier modifier, RemoteDrawScope.() -> Unit onDraw)creation.compose.layout.RemoteDrawScope
class RemoteDrawScope implements RemoteStateScope
void clipRect(optional RemoteFloat left, optional RemoteFloat top, optional RemoteFloat right, optional RemoteFloat bottom, RemoteDrawScope.() -> Unit block)
void drawArc(RemotePaint? paint, RemoteFloat startAngle, RemoteFloat sweepAngle, boolean useCenter, optional RemoteOffset topLeft, optional RemoteSize size)
void drawCircle(RemotePaint? paint, RemoteFloat radius, optional RemoteOffset center)
void drawImage(RemoteImageBitmap image, optional RemoteOffset topLeft, optional RemotePaint? paint)
void drawLine(RemotePaint? paint, RemoteOffset start, RemoteOffset end)
void drawOval(RemotePaint? paint, optional RemoteOffset topLeft, optional RemoteSize size)
void drawRect(RemotePaint? paint, optional RemoteOffset topLeft, optional RemoteSize size)
void drawRoundRect(RemotePaint? paint, optional RemoteOffset topLeft, optional RemoteSize size, optional RemoteOffset cornerRadius)
void drawText(RemoteString text, RemoteFloat x, RemoteFloat y, optional RemotePaint? paint)
void drawTextOnCircle(RemoteString text, RemoteFloat centerX, RemoteFloat centerY, RemoteFloat radius, RemoteFloat startAngle, RemoteFloat warpRadiusOffset, optional RemotePaint? paint, optional RemoteDrawScope.CircularAlignment alignment, optional RemoteDrawScope.CircularPlacement placement)
void rotate(RemoteFloat degrees, optional RemoteOffset pivot, RemoteDrawScope.() -> Unit block)
void scale(RemoteFloat scale, optional RemoteOffset pivot, RemoteDrawScope.() -> Unit block)
void scale(RemoteFloat scaleX, RemoteFloat scaleY, optional RemoteOffset pivot, RemoteDrawScope.() -> Unit block)
void translate(optional RemoteFloat left, optional RemoteFloat top, RemoteDrawScope.() -> Unit block)
void usePaint(RemotePaint paint, () -> Unit block)
void withTransform(RemoteDrawTransform.() -> Unit transformBlock, RemoteDrawScope.() -> Unit drawBlock)
RemoteOffset center
RemoteFloat height
RemoteLayoutDirection layoutDirection
RemoteDensity remoteDensity
RemoteSize size
RemoteFloat width
RemoteDrawScope.CircularAlignment Center
RemoteDrawScope.CircularAlignment End
RemoteDrawScope.CircularAlignment Start
RemoteDrawScope.CircularPlacement Inside
RemoteDrawScope.CircularPlacement Outsidecreation.compose.state.RemotePaint
sealed nonexhaustive interface RemotePaint
RemoteBlendMode blendMode
RemoteColor color
String? fontFeatureSettings
RemoteFontVariation.Settings? fontVariationSettings
RemoteStrokeCap strokeCap
RemoteStrokeJoin strokeJoin
RemoteFloat strokeWidth
RemotePaintingStyle style
RemoteFloat textSize
RemoteTypeface? typeface
RemotePaint.Companion Companion
operator RemotePaint invoke(optional RemotePaint.() -> Unit init)