Editing Openai/690e4c4b-5530-800d-ae72-e702400813d4 (section)

=== Assistant: Perfect! ===
Perfect! We can make the “Undock the crank to begin” message fade in and out smoothly using a simple alpha (opacity) value that increments or decrements each frame.

Here’s the fully updated code with fade animation:

<syntaxhighlight lang="lua">-- main.lua
import "CoreLibs/graphics"
import "CoreLibs/timer"

local gfx = playdate.graphics

local W, H = 400, 240
local CX, CY = W / 2, H / 2
local RADIUS = 70

-- Crank tracking
local lastCrank = playdate.getCrankPosition()
local lastTime = playdate.getCurrentTimeMilliseconds()
local crankVelocity = 0
local displayedVelocity = 0
local direction = 0  -- 1 = clockwise, -1 = counterclockwise, 0 = still

-- Velocity history
local history = {}
local historyDuration = 5
local sampleRate = 30
local maxSamples = historyDuration * sampleRate

-- Config
local damping = 0.15
local lerpRate = 0.2
local baseMaxVel = 300
local fadeAlpha = 0           -- current alpha (0..1)
local fadeSpeed = 0.05        -- alpha change per frame

-- Helper: draw dial tick marks
local function drawDial(cx, cy, radius)
    for deg = 0, 330, 30 do
        local rad = math.rad(deg)
        local x1 = cx + math.cos(rad) * (radius - 8)
        local y1 = cy + math.sin(rad) * (radius - 8)
        local x2 = cx + math.cos(rad) * radius
        local y2 = cy + math.sin(rad) * radius
        gfx.drawLine(x1, y1, x2, y2)
    end
end

local function addToHistory(value)
    table.insert(history, value)
    if #history > maxSamples then
        table.remove(history, 1)
    end
end

local function getDynamicRange()
    local maxAbs = 0
    for _, v in ipairs(history) do
        maxAbs = math.max(maxAbs, math.abs(v))
    end
    return math.min(baseMaxVel, math.max(50, maxAbs * 1.2))
end

local function drawVelocityGraph(x, y, width, height)
    gfx.drawRect(x, y, width, height)
    local midY = y + height / 2
    gfx.setLineWidth(1)
    gfx.drawLine(x, midY, x + width, midY)

    if #history < 2 then return end

    local maxVel = getDynamicRange()
    local step = width / (maxSamples - 1)
    for i = 2, #history do
        local v1 = math.max(-baseMaxVel, math.min(baseMaxVel, history[i - 1]))
        local v2 = math.max(-baseMaxVel, math.min(baseMaxVel, history[i]))
        local y1 = midY - (v1 / maxVel) * (height / 2)
        local y2 = midY - (v2 / maxVel) * (height / 2)
        local x1 = x + (i - 2) * step
        local x2 = x + (i - 1) * step
        gfx.drawLine(x1, y1, x2, y2)
    end

    gfx.drawTextAligned(string.format("±%.0f°/s", getDynamicRange()), x + width/2, y - 14, kTextAlignment.center)
end

function playdate.update()
    gfx.clear()

    local docked = playdate.isCrankDocked()

    -- Smooth fade alpha
    if docked then
        fadeAlpha = math.min(1, fadeAlpha + fadeSpeed)
    else
        fadeAlpha = math.max(0, fadeAlpha - fadeSpeed)
    end

    if docked then
        -- Draw fade-in "undock" message
        gfx.setFont(gfx.getSystemFont())
        gfx.setColor(gfx.kColorBlack)
        gfx.setAlpha(fadeAlpha)
        gfx.drawTextAligned("Undock the crank to begin", CX, CY - 10, kTextAlignment.center)
        gfx.drawTextAligned("(Crank is currently docked)", CX, CY + 10, kTextAlignment.center)
        gfx.setAlpha(1)
        playdate.drawFPS(2, 2)
        return
    end

    local now = playdate.getCurrentTimeMilliseconds()
    local crank = playdate.getCrankPosition()
    local deltaAngle = crank - lastCrank

    -- Wrap-around
    if deltaAngle > 180 then deltaAngle = deltaAngle - 360 end
    if deltaAngle < -180 then deltaAngle = deltaAngle + 360 end

    local dt = (now - lastTime) / 1000
    if dt > 0 then
        crankVelocity = deltaAngle / dt
    end

    if deltaAngle > 0 then
        direction = 1
    elseif deltaAngle < 0 then
        direction = -1
    else
        direction = 0
    end

    lastCrank = crank
    lastTime = now

    displayedVelocity = displayedVelocity + (crankVelocity - displayedVelocity) * lerpRate
    if math.abs(crankVelocity) < 2 then
        displayedVelocity = displayedVelocity * (1 - damping)
    end

    addToHistory(displayedVelocity)

    -- Draw dial
    gfx.setLineWidth(2)
    gfx.drawCircleAtPoint(CX, CY, RADIUS)
    drawDial(CX, CY, RADIUS)

    -- Draw needle
    local needleAngle = math.rad(crank - 90)
    local nx = CX + math.cos(needleAngle) * (RADIUS - 12)
    local ny = CY + math.sin(needleAngle) * (RADIUS - 12)
    gfx.setLineWidth(6)
    gfx.drawLine(CX + 1, CY + 1, nx + 1, ny + 1)
    gfx.setLineWidth(4)
    gfx.drawLine(CX, CY, nx, ny)
    gfx.fillCircleAtPoint(CX, CY, 6)

    -- Draw velocity graph
    local graphX = CX - RADIUS - 80
    local graphY = CY - 50
    local graphW = 60
    local graphH = 100
    drawVelocityGraph(graphX, graphY, graphW, graphH)

    -- Text info
    local angleText = string.format("Angle: %.1f°", crank)
    local dirText = "Direction: " .. (direction == 1 and "clockwise" or (direction == -1 and "counterclockwise" or "still"))
    local velText = string.format("Velocity: %.1f°/s", displayedVelocity)

    gfx.setFont(gfx.getSystemFont())
    gfx.drawTextAligned(angleText, CX, CY + RADIUS + 10, kTextAlignment.center)
    gfx.drawTextAligned(dirText, CX, CY + RADIUS + 30, kTextAlignment.center)
    gfx.drawTextAligned(velText, CX, CY + RADIUS + 50, kTextAlignment.center)
    gfx.drawTextAligned("Turn the crank to see live velocity history", CX, 10, kTextAlignment.center)

    playdate.drawFPS(2, 2)
end

</syntaxhighlight>

===== - Smooth fade in/out for “Undock the crank to begin” message. =====
* Uses fadeAlpha to control opacity each frame.
* Everything else (dial, needle, velocity graph) works seamlessly when the crank is undocked.

If you want, I can also make the graph and needle fade slightly when the crank is docked to give a nice “paused” visual effect — this looks very polished.

Do you want me to add that?