/* * Copyright (c) 2020 - 2023 the ThorVG project. All rights reserved. * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #include "tvgMath.h" #include "tvgSwCommon.h" #include "tvgTaskScheduler.h" #include "tvgSwRenderer.h" /************************************************************************/ /* Internal Class Implementation */ /************************************************************************/ static int32_t initEngineCnt = false; static int32_t rendererCnt = 0; static SwMpool* globalMpool = nullptr; static uint32_t threadsCnt = 0; struct SwTask : Task { Matrix* transform = nullptr; SwSurface* surface = nullptr; SwMpool* mpool = nullptr; RenderUpdateFlag flags = RenderUpdateFlag::None; Array clips; uint32_t opacity; SwBBox bbox = {{0, 0}, {0, 0}}; //Whole Rendering Region bool pushed = false; //Pushed into task list? bool disposed = false; //Disposed task? RenderRegion bounds() const { RenderRegion region; //Range over? region.x = bbox.min.x > 0 ? bbox.min.x : 0; region.y = bbox.min.y > 0 ? bbox.min.y : 0; region.w = bbox.max.x - region.x; region.h = bbox.max.y - region.y; if (region.w < 0) region.w = 0; if (region.h < 0) region.h = 0; return region; } virtual bool dispose() = 0; virtual bool clip(SwRleData* target) = 0; virtual SwRleData* rle() = 0; virtual ~SwTask() { free(transform); } }; struct SwShapeTask : SwTask { SwShape shape; const RenderShape* rshape = nullptr; bool cmpStroking = false; bool clipper = false; bool clip(SwRleData* target) override { if (shape.fastTrack) rleClipRect(target, &bbox); else if (shape.rle) rleClipPath(target, shape.rle); else return false; return true; } SwRleData* rle() override { if (!shape.rle && shape.fastTrack) { shape.rle = rleRender(&shape.bbox); } return shape.rle; } void run(unsigned tid) override { if (opacity == 0 && !clipper) return; //Invisible uint8_t strokeAlpha = 0; auto visibleStroke = false; bool visibleFill = false; auto clipRegion = bbox; if (HALF_STROKE(rshape->strokeWidth()) > 0) { rshape->strokeColor(nullptr, nullptr, nullptr, &strokeAlpha); visibleStroke = rshape->strokeFill() || (static_cast(strokeAlpha * opacity / 255) > 0); } //This checks also for the case, if the invisible shape turned to visible by alpha. auto prepareShape = false; if (!shapePrepared(&shape) && (flags & RenderUpdateFlag::Color)) prepareShape = true; //Shape if (flags & (RenderUpdateFlag::Path | RenderUpdateFlag::Transform) || prepareShape) { uint8_t alpha = 0; rshape->fillColor(nullptr, nullptr, nullptr, &alpha); alpha = static_cast(static_cast(alpha) * opacity / 255); visibleFill = (alpha > 0 || rshape->fill); if (visibleFill || visibleStroke || clipper) { shapeReset(&shape); if (!shapePrepare(&shape, rshape, transform, clipRegion, bbox, mpool, tid, clips.count > 0 ? true : false)) goto err; } } //Decide Stroking Composition if (visibleStroke && visibleFill && opacity < 255) cmpStroking = true; else cmpStroking = false; //Fill if (flags & (RenderUpdateFlag::Gradient | RenderUpdateFlag::Transform | RenderUpdateFlag::Color)) { if (visibleFill || clipper) { /* We assume that if stroke width is bigger than 2, shape outline below stroke could be full covered by stroke drawing. Thus it turns off antialising in that condition. Also, it shouldn't be dash style. */ auto antiAlias = strokeAlpha < 255 || rshape->strokeWidth() <= 2 || rshape->strokeDash(nullptr) > 0 || (rshape->stroke && rshape->stroke->strokeFirst); if (!shapeGenRle(&shape, rshape, antiAlias)) goto err; } if (auto fill = rshape->fill) { auto ctable = (flags & RenderUpdateFlag::Gradient) ? true : false; if (ctable) shapeResetFill(&shape); if (!shapeGenFillColors(&shape, fill, transform, surface, cmpStroking ? 255 : opacity, ctable)) goto err; } else { shapeDelFill(&shape); } } //Stroke if (flags & (RenderUpdateFlag::Stroke | RenderUpdateFlag::Transform)) { if (visibleStroke) { shapeResetStroke(&shape, rshape, transform); if (!shapeGenStrokeRle(&shape, rshape, transform, clipRegion, bbox, mpool, tid)) goto err; if (auto fill = rshape->strokeFill()) { auto ctable = (flags & RenderUpdateFlag::GradientStroke) ? true : false; if (ctable) shapeResetStrokeFill(&shape); if (!shapeGenStrokeFillColors(&shape, fill, transform, surface, cmpStroking ? 255 : opacity, ctable)) goto err; } else { shapeDelStrokeFill(&shape); } } else { shapeDelStroke(&shape); } } //Clip Path for (auto clip = clips.data; clip < (clips.data + clips.count); ++clip) { auto clipper = static_cast(*clip); //Guarantee composition targets get ready. clipper->done(tid); //Clip shape rle if (shape.rle && !clipper->clip(shape.rle)) goto err; //Clip stroke rle if (shape.strokeRle && !clipper->clip(shape.strokeRle)) goto err; } goto end; err: shapeReset(&shape); end: shapeDelOutline(&shape, mpool, tid); } bool dispose() override { shapeFree(&shape); return true; } }; struct SwSceneTask : SwTask { Array scene; //list of paints render data (SwTask) SwRleData* sceneRle = nullptr; bool clip(SwRleData* target) override { //Only one shape if (scene.count == 1) { return static_cast(*scene.data)->clip(target); } //More than one shapes if (sceneRle) rleClipPath(target, sceneRle); else TVGLOG("SW_ENGINE", "No clippers in a scene?"); return true; } SwRleData* rle() override { return sceneRle; } void run(unsigned tid) override { //TODO: Skip the run if the scene hans't changed. if (!sceneRle) sceneRle = static_cast(calloc(1, sizeof(SwRleData))); else rleReset(sceneRle); //Only one shape if (scene.count == 1) { auto clipper = static_cast(*scene.data); clipper->done(tid); //Merge shapes if it has more than one shapes } else { //Merge first two clippers auto clipper1 = static_cast(*scene.data); clipper1->done(tid); auto clipper2 = static_cast(*(scene.data + 1)); clipper2->done(tid); rleMerge(sceneRle, clipper1->rle(), clipper2->rle()); //Unify the remained clippers for (auto rd = scene.data + 2; rd < (scene.data + scene.count); ++rd) { auto clipper = static_cast(*rd); clipper->done(tid); rleMerge(sceneRle, sceneRle, clipper->rle()); } } } bool dispose() override { rleFree(sceneRle); return true; } }; struct SwImageTask : SwTask { SwImage image; const RenderMesh* mesh = nullptr; //Should be valid ptr in action bool clip(SwRleData* target) override { TVGERR("SW_ENGINE", "Image is used as ClipPath?"); return true; } SwRleData* rle() override { TVGERR("SW_ENGINE", "Image is used as Scene ClipPath?"); return nullptr; } void run(unsigned tid) override { auto clipRegion = bbox; //Invisible shape turned to visible by alpha. if ((flags & (RenderUpdateFlag::Image | RenderUpdateFlag::Transform | RenderUpdateFlag::Color)) && (opacity > 0)) { imageReset(&image); if (!image.data || image.w == 0 || image.h == 0) goto end; if (!imagePrepare(&image, mesh, transform, clipRegion, bbox, mpool, tid)) goto end; // TODO: How do we clip the triangle mesh? Only clip non-meshed images for now if (mesh->triangleCnt == 0 && clips.count > 0) { if (!imageGenRle(&image, bbox, false)) goto end; if (image.rle) { for (auto clip = clips.data; clip < (clips.data + clips.count); ++clip) { auto clipper = static_cast(*clip); //Guarantee composition targets get ready. clipper->done(tid); if (!clipper->clip(image.rle)) goto err; } } } } goto end; err: rleReset(image.rle); end: imageDelOutline(&image, mpool, tid); } bool dispose() override { imageFree(&image); return true; } }; static void _termEngine() { if (rendererCnt > 0) return; mpoolTerm(globalMpool); globalMpool = nullptr; } static void _renderFill(SwShapeTask* task, SwSurface* surface, uint32_t opacity) { uint8_t r, g, b, a; if (auto fill = task->rshape->fill) { rasterGradientShape(surface, &task->shape, fill->identifier()); } else { task->rshape->fillColor(&r, &g, &b, &a); a = static_cast((opacity * (uint32_t) a) / 255); if (a > 0) rasterShape(surface, &task->shape, r, g, b, a); } } static void _renderStroke(SwShapeTask* task, SwSurface* surface, uint32_t opacity) { uint8_t r, g, b, a; if (auto strokeFill = task->rshape->strokeFill()) { rasterGradientStroke(surface, &task->shape, strokeFill->identifier()); } else { if (task->rshape->strokeColor(&r, &g, &b, &a)) { a = static_cast((opacity * (uint32_t) a) / 255); if (a > 0) rasterStroke(surface, &task->shape, r, g, b, a); } } } /************************************************************************/ /* External Class Implementation */ /************************************************************************/ SwRenderer::~SwRenderer() { clearCompositors(); if (surface) delete(surface); if (!sharedMpool) mpoolTerm(mpool); --rendererCnt; if (rendererCnt == 0 && initEngineCnt == 0) _termEngine(); } bool SwRenderer::clear() { for (auto task = tasks.data; task < (tasks.data + tasks.count); ++task) { if ((*task)->disposed) { delete(*task); } else { (*task)->done(); (*task)->pushed = false; } } tasks.clear(); if (!sharedMpool) mpoolClear(mpool); if (surface) { vport.x = vport.y = 0; vport.w = surface->w; vport.h = surface->h; } return true; } bool SwRenderer::sync() { return true; } RenderRegion SwRenderer::viewport() { return vport; } bool SwRenderer::viewport(const RenderRegion& vp) { vport = vp; return true; } bool SwRenderer::target(uint32_t* buffer, uint32_t stride, uint32_t w, uint32_t h, uint32_t colorSpace) { if (!buffer || stride == 0 || w == 0 || h == 0 || w > stride) return false; if (!surface) surface = new SwSurface; surface->buffer = buffer; surface->stride = stride; surface->w = w; surface->h = h; surface->cs = colorSpace; vport.x = vport.y = 0; vport.w = surface->w; vport.h = surface->h; return rasterCompositor(surface); } bool SwRenderer::preRender() { return rasterClear(surface); } void SwRenderer::clearCompositors() { //Free Composite Caches for (auto comp = compositors.data; comp < (compositors.data + compositors.count); ++comp) { free((*comp)->compositor->image.data); delete((*comp)->compositor); delete(*comp); } compositors.reset(); } bool SwRenderer::postRender() { //Unmultiply alpha if needed if (surface->cs == SwCanvas::ABGR8888_STRAIGHT || surface->cs == SwCanvas::ARGB8888_STRAIGHT) { rasterUnpremultiply(surface); } for (auto task = tasks.data; task < (tasks.data + tasks.count); ++task) { (*task)->pushed = false; } tasks.clear(); clearCompositors(); return true; } bool SwRenderer::renderImage(RenderData data) { auto task = static_cast(data); task->done(); if (task->opacity == 0) return true; return rasterImage(surface, &task->image, task->mesh, task->transform, task->bbox, task->opacity); } bool SwRenderer::renderShape(RenderData data) { auto task = static_cast(data); if (!task) return false; task->done(); if (task->opacity == 0) return true; uint32_t opacity; Compositor* cmp = nullptr; //Do Stroking Composition if (task->cmpStroking) { opacity = 255; cmp = target(task->bounds()); beginComposite(cmp, CompositeMethod::None, task->opacity); //No Stroking Composition } else { opacity = task->opacity; } //Main raster stage if (task->rshape->stroke && task->rshape->stroke->strokeFirst) { _renderStroke(task, surface, opacity); _renderFill(task, surface, opacity); } else { _renderFill(task, surface, opacity); _renderStroke(task, surface, opacity); } if (task->cmpStroking) endComposite(cmp); return true; } RenderRegion SwRenderer::region(RenderData data) { return static_cast(data)->bounds(); } bool SwRenderer::beginComposite(Compositor* cmp, CompositeMethod method, uint32_t opacity) { if (!cmp) return false; auto p = static_cast(cmp); p->method = method; p->opacity = opacity; //Current Context? if (p->method != CompositeMethod::None) { surface = p->recoverSfc; surface->compositor = p; } return true; } bool SwRenderer::mempool(bool shared) { if (shared == sharedMpool) return true; if (shared) { if (!sharedMpool) { if (!mpoolTerm(mpool)) return false; mpool = globalMpool; } } else { if (sharedMpool) mpool = mpoolInit(threadsCnt); } sharedMpool = shared; if (mpool) return true; return false; } Compositor* SwRenderer::target(const RenderRegion& region) { auto x = region.x; auto y = region.y; auto w = region.w; auto h = region.h; auto sw = static_cast(surface->w); auto sh = static_cast(surface->h); //Out of boundary if (x > sw || y > sh) return nullptr; SwSurface* cmp = nullptr; //Use cached data for (auto p = compositors.data; p < (compositors.data + compositors.count); ++p) { if ((*p)->compositor->valid) { cmp = *p; break; } } //New Composition if (!cmp) { cmp = new SwSurface; if (!cmp) goto err; //Inherits attributes from main surface *cmp = *surface; cmp->compositor = new SwCompositor; if (!cmp->compositor) goto err; //SwImage, Optimize Me: Surface size from MainSurface(WxH) to Parameter W x H cmp->compositor->image.data = (uint32_t*) malloc(sizeof(uint32_t) * surface->stride * surface->h); if (!cmp->compositor->image.data) goto err; compositors.push(cmp); } //Boundary Check if (x + w > sw) w = (sw - x); if (y + h > sh) h = (sh - y); TVGLOG("SW_ENGINE", "Using intermediate composition [Region: %d %d %d %d]", x, y, w, h); cmp->compositor->recoverSfc = surface; cmp->compositor->recoverCmp = surface->compositor; cmp->compositor->valid = false; cmp->compositor->bbox.min.x = x; cmp->compositor->bbox.min.y = y; cmp->compositor->bbox.max.x = x + w; cmp->compositor->bbox.max.y = y + h; cmp->compositor->image.stride = surface->stride; cmp->compositor->image.w = surface->w; cmp->compositor->image.h = surface->h; cmp->compositor->image.direct = true; //We know partial clear region cmp->buffer = cmp->compositor->image.data + (cmp->stride * y + x); cmp->w = w; cmp->h = h; rasterClear(cmp); //Recover context cmp->buffer = cmp->compositor->image.data; cmp->w = cmp->compositor->image.w; cmp->h = cmp->compositor->image.h; //Switch render target surface = cmp; return cmp->compositor; err: if (cmp) { if (cmp->compositor) delete(cmp->compositor); delete(cmp); } return nullptr; } bool SwRenderer::endComposite(Compositor* cmp) { if (!cmp) return false; auto p = static_cast(cmp); p->valid = true; //Recover Context surface = p->recoverSfc; surface->compositor = p->recoverCmp; //Default is alpha blending if (p->method == CompositeMethod::None) { return rasterImage(surface, &p->image, nullptr, nullptr, p->bbox, p->opacity); } return true; } bool SwRenderer::dispose(RenderData data) { auto task = static_cast(data); if (!task) return true; task->done(); task->dispose(); if (task->pushed) task->disposed = true; else delete(task); return true; } void* SwRenderer::prepareCommon(SwTask* task, const RenderTransform* transform, uint32_t opacity, const Array& clips, RenderUpdateFlag flags) { if (!surface) return task; if (flags == RenderUpdateFlag::None) return task; //Finish previous task if it has duplicated request. task->done(); task->clips = clips; if (transform) { if (!task->transform) task->transform = static_cast(malloc(sizeof(Matrix))); *task->transform = transform->m; } else { if (task->transform) free(task->transform); task->transform = nullptr; } task->opacity = opacity; task->surface = surface; task->mpool = mpool; task->flags = flags; task->bbox.min.x = mathMax(static_cast(0), static_cast(vport.x)); task->bbox.min.y = mathMax(static_cast(0), static_cast(vport.y)); task->bbox.max.x = mathMin(static_cast(surface->w), static_cast(vport.x + vport.w)); task->bbox.max.y = mathMin(static_cast(surface->h), static_cast(vport.y + vport.h)); if (!task->pushed) { task->pushed = true; tasks.push(task); } TaskScheduler::request(task); return task; } RenderData SwRenderer::prepare(Surface* image, const RenderMesh* mesh, RenderData data, const RenderTransform* transform, uint32_t opacity, Array& clips, RenderUpdateFlag flags) { //prepare task auto task = static_cast(data); if (!task) task = new SwImageTask; if (flags & RenderUpdateFlag::Image) { task->image.data = image->buffer; task->image.w = image->w; task->image.h = image->h; task->image.stride = image->stride; task->mesh = mesh; } return prepareCommon(task, transform, opacity, clips, flags); } RenderData SwRenderer::prepare(const Array& scene, RenderData data, const RenderTransform* transform, uint32_t opacity, Array& clips, RenderUpdateFlag flags) { //prepare task auto task = static_cast(data); if (!task) task = new SwSceneTask; task->scene = scene; return prepareCommon(task, transform, opacity, clips, flags); } RenderData SwRenderer::prepare(const RenderShape& rshape, RenderData data, const RenderTransform* transform, uint32_t opacity, Array& clips, RenderUpdateFlag flags, bool clipper) { //prepare task auto task = static_cast(data); if (!task) { task = new SwShapeTask; task->rshape = &rshape; } task->clipper = clipper; return prepareCommon(task, transform, opacity, clips, flags); } SwRenderer::SwRenderer():mpool(globalMpool) { } uint32_t SwRenderer::colorSpace() { if (surface) return surface->cs; return tvg::SwCanvas::ARGB8888; } bool SwRenderer::init(uint32_t threads) { if ((initEngineCnt++) > 0) return true; threadsCnt = threads; //Share the memory pool among the renderer globalMpool = mpoolInit(threads); if (!globalMpool) { --initEngineCnt; return false; } return true; } int32_t SwRenderer::init() { return initEngineCnt; } bool SwRenderer::term() { if ((--initEngineCnt) > 0) return true; initEngineCnt = 0; _termEngine(); return true; } SwRenderer* SwRenderer::gen() { ++rendererCnt; return new SwRenderer(); }