Remote Compose Storybook English GitHub

RemoteCanvas · Transforms

translate, rotate and scale blocks around a pivot.

RemoteCanvas · Transforms: документ, нарисованный плеером Remote Compose
Открыть живое интерактивное демо →

Меняйте параметры, смотрите удалённый документ, который получается, и разницу после каждого изменения.

Что это

Свободная поверхность для рисования: фигуры, линии, текст и трансформации ровно там, где вы их разместили, включая анимацию.

Подходит для

  • Графики, шкалы и кольца прогресса
  • Свои иллюстрации
  • Анимированная графика в духе циферблатов

Код

Исходник примера с импортами androidx.compose.remote. CI компилирует каждый фрагмент кода на сайте против 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.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 CanvasTransforms(degrees: Float, scale: Float, translateX: Float) {
    RemoteCanvas(modifier = RemoteModifier.size(300.rdp, 240.rdp)) {
        drawRect(
            RemotePaint {
                color = Color(0x22000000).rc
                style = RemotePaintingStyle.Stroke
                strokeWidth = 1f.rf
            },
        )
        val pivot = RemoteOffset(150f.rf, 120f.rf)
        val fill = RemotePaint { color = Color(0xFFF4511E).rc }
        // Each transform applies to the draws inside its block, innermost first.
        translate(translateX.rf, 0f.rf) {
            rotate(degrees.rf, pivot) {
                scale(scale.rf, scale.rf, pivot) {
                    drawRect(
                        fill,
                        topLeft = RemoteOffset(100f.rf, 70f.rf),
                        size = RemoteSize(100f.rf, 100f.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 Outside

creation.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)

Справочник

Другие примеры этого компонента

Ещё в разделе «Рисование»