Remote Compose Storybook English GitHub

RemoteCanvas · drawImage

An embedded bitmap drawn at a position.

RemoteCanvas · drawImage: документ, нарисованный плеером 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.modifier.RemoteModifier
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.shaders.image
import androidx.compose.remote.creation.compose.state.RemoteImageBitmap
import androidx.compose.remote.creation.compose.state.rdp
import androidx.compose.remote.creation.compose.state.rf
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.geometry.Offset
import androidx.compose.ui.graphics.Canvas
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.ImageBitmap
import androidx.compose.ui.graphics.Paint

@Composable
@RemoteComposable
fun CanvasImage(x: Float, y: Float) {
    val image = remember {
        val bitmap = ImageBitmap(96, 96)
        Canvas(bitmap).apply {
            drawRect(0f, 0f, 96f, 96f, Paint().apply { color = Color(0xFF43A047) })
            drawCircle(Offset(48f, 48f), 30f, Paint().apply { color = Color(0xFFFFFFFF) })
        }
        RemoteImageBitmap(bitmap)
    }
    RemoteCanvas(modifier = RemoteModifier.size(300.rdp, 200.rdp)) {
        // drawImage places an embedded bitmap at a canvas position.
        drawImage(image, topLeft = RemoteOffset(x.rf, y.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)

Справочник

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

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