From f00c27a2264ef5fdae12f1ed8c9f7da4811d0e39 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 20 Apr 2023 14:18:57 +0300 Subject: [PATCH 001/361] Clean nanoarch --- pkg/worker/emulator/libretro/nanoarch.go | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/pkg/worker/emulator/libretro/nanoarch.go b/pkg/worker/emulator/libretro/nanoarch.go index 2bac764a..895443bf 100644 --- a/pkg/worker/emulator/libretro/nanoarch.go +++ b/pkg/worker/emulator/libretro/nanoarch.go @@ -477,9 +477,10 @@ func coreLoad(meta emulator.Metadata) { coreLib, err = loadLib(filePath) // fallback to sequential lib loader (first successfully loaded) if err != nil { + libretroLogger.Error().Err(err).Msgf("load fail: %v", filePath) coreLib, err = loadLibRollingRollingRolling(filePath) if err != nil { - libretroLogger.Fatal().Err(err).Msgf("core load: %s, %v", filePath, err) + libretroLogger.Fatal().Err(err).Msgf("core load: %s", filePath) } } @@ -540,9 +541,9 @@ func LoadGame(path string) error { if err != nil { return err } - dat := C.CString(string(bytes)) - gi.data = unsafe.Pointer(dat) - defer C.free(unsafe.Pointer(dat)) + dataPtr := unsafe.Pointer(C.CBytes(bytes)) + gi.data = dataPtr + defer C.free(dataPtr) } if ok := C.bridge_retro_load_game(retroLoadGame, &gi); !ok { From df980c5cf4c37387e2115aa20d7c7185cef600c3 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 20 Apr 2023 14:19:40 +0300 Subject: [PATCH 002/361] Update versions --- Dockerfile | 2 +- go.mod | 18 +++++++++--------- go.sum | 35 ++++++++++++++++++++--------------- 3 files changed, 30 insertions(+), 25 deletions(-) diff --git a/Dockerfile b/Dockerfile index ed312104..984caa5d 100644 --- a/Dockerfile +++ b/Dockerfile @@ -20,7 +20,7 @@ RUN apt-get -qq update && apt-get -qq install --no-install-recommends -y \ && rm -rf /var/lib/apt/lists/* # go setup layer -ARG GO=go1.20.2.linux-amd64.tar.gz +ARG GO=go1.20.3.linux-amd64.tar.gz RUN wget -q https://golang.org/dl/$GO \ && rm -rf /usr/local/go \ && tar -C /usr/local -xzf $GO \ diff --git a/go.mod b/go.mod index b4717a41..437c6bb0 100644 --- a/go.mod +++ b/go.mod @@ -12,12 +12,12 @@ require ( github.com/kkyr/fig v0.3.1 github.com/pion/interceptor v0.1.12 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v3 v3.1.59 - github.com/rs/xid v1.4.0 - github.com/rs/zerolog v1.29.0 - github.com/veandco/go-sdl2 v0.4.33 - golang.org/x/crypto v0.7.0 - golang.org/x/image v0.6.0 + github.com/pion/webrtc/v3 v3.1.60 + github.com/rs/xid v1.5.0 + github.com/rs/zerolog v1.29.1 + github.com/veandco/go-sdl2 v0.4.34 + golang.org/x/crypto v0.8.0 + golang.org/x/image v0.7.0 ) require ( @@ -37,13 +37,13 @@ require ( github.com/pion/sdp/v3 v3.0.6 // indirect github.com/pion/srtp/v2 v2.0.12 // indirect github.com/pion/stun v0.4.0 // indirect - github.com/pion/transport/v2 v2.0.2 // indirect + github.com/pion/transport/v2 v2.2.0 // indirect github.com/pion/turn/v2 v2.1.0 // indirect github.com/pion/udp/v2 v2.0.1 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.8.0 // indirect + golang.org/x/net v0.9.0 // indirect golang.org/x/sys v0.7.0 // indirect - golang.org/x/text v0.8.0 // indirect + golang.org/x/text v0.9.0 // indirect gopkg.in/yaml.v3 v3.0.1 // indirect ) diff --git a/go.sum b/go.sum index 25aa0141..7cd85fb0 100644 --- a/go.sum +++ b/go.sum @@ -2,7 +2,7 @@ github.com/VictoriaMetrics/metrics v1.23.1 h1:/j8DzeJBxSpL2qSIdqnRFLvQQhbJyJbbEi github.com/VictoriaMetrics/metrics v1.23.1/go.mod h1:rAr/llLpEnAdTehiNlUxKgnjcOuROSzpw0GvjpEbvFc= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= -github.com/coreos/go-systemd/v22 v22.3.3-0.20220203105225-a9a7ef127534/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= +github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= @@ -91,21 +91,23 @@ github.com/pion/stun v0.4.0/go.mod h1:QPsh1/SbXASntw3zkkrIk3ZJVKz4saBY2G7S10P3wC github.com/pion/transport v0.14.1 h1:XSM6olwW+o8J4SCmOBb/BpwZypkHeyM0PGFCxNQBr40= github.com/pion/transport v0.14.1/go.mod h1:4tGmbk00NeYA3rUa9+n+dzCCoKkcy3YlYb99Jn2fNnI= github.com/pion/transport/v2 v2.0.0/go.mod h1:HS2MEBJTwD+1ZI2eSXSvHJx/HnzQqRy2/LXxt6eVMHc= -github.com/pion/transport/v2 v2.0.2 h1:St+8o+1PEzPT51O9bv+tH/KYYLMNR5Vwm5Z3Qkjsywg= github.com/pion/transport/v2 v2.0.2/go.mod h1:vrz6bUbFr/cjdwbnxq8OdDDzHf7JJfGsIRkxfpZoTA0= +github.com/pion/transport/v2 v2.2.0 h1:u5lFqFHkXLMXMzai8tixZDfVjb8eOjH35yCunhPeb1c= +github.com/pion/transport/v2 v2.2.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= github.com/pion/turn/v2 v2.1.0 h1:5wGHSgGhJhP/RpabkUb/T9PdsAjkGLS6toYz5HNzoSI= github.com/pion/turn/v2 v2.1.0/go.mod h1:yrT5XbXSGX1VFSF31A3c1kCNB5bBZgk/uu5LET162qs= github.com/pion/udp/v2 v2.0.1 h1:xP0z6WNux1zWEjhC7onRA3EwwSliXqu1ElUZAQhUP54= github.com/pion/udp/v2 v2.0.1/go.mod h1:B7uvTMP00lzWdyMr/1PVZXtV3wpPIxBRd4Wl6AksXn8= -github.com/pion/webrtc/v3 v3.1.59 h1:B3YFo8q6dwBYKA2LUjWRChP59Qtt+xvv1Ul7UPDp6Zc= -github.com/pion/webrtc/v3 v3.1.59/go.mod h1:rJGgStRoFyFOWJULHLayaimsG+jIEoenhJ5MB5gIFqw= +github.com/pion/webrtc/v3 v3.1.60 h1:FLF6HT3x3CMHtPz5JbdAARfIUpMZu2YeOSzkVxaeF+k= +github.com/pion/webrtc/v3 v3.1.60/go.mod h1:65gfOgxrmszb6ec7kEiZp32QwnmDNIrJK8hgo/0niWY= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= -github.com/rs/xid v1.4.0 h1:qd7wPTDkN6KQx2VmMBLrpHkiyQwgFXRnkOLacUiaSNY= github.com/rs/xid v1.4.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg= -github.com/rs/zerolog v1.29.0 h1:Zes4hju04hjbvkVkOhdl2HpZa+0PmVwigmo8XoORE5w= -github.com/rs/zerolog v1.29.0/go.mod h1:NILgTygv/Uej1ra5XxGf82ZFSLk58MFGAUS2o6usyD0= +github.com/rs/xid v1.5.0 h1:mKX4bl4iPYJtEIxp6CYiUuLQ/8DYMoz0PUdtGgMFRVc= +github.com/rs/xid v1.5.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg= +github.com/rs/zerolog v1.29.1 h1:cO+d60CHkknCbvzEWxP0S9K6KqyTjrCNUy1LdQLCGPc= +github.com/rs/zerolog v1.29.1/go.mod h1:Le6ESbR7hc+DP6Lt1THiV8CQSdkkNrd3R0XbEgp3ZBU= github.com/sclevine/agouti v3.0.0+incompatible/go.mod h1:b4WX9W9L1sfQKXeJf1mUTLZKJ48R1S7H23Ji7oFO5Bw= github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= @@ -120,8 +122,8 @@ github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= github.com/valyala/histogram v1.2.0/go.mod h1:Hb4kBwb4UxsaNbbbh+RRz8ZR6pdodR57tzWUS3BUzXY= -github.com/veandco/go-sdl2 v0.4.33 h1:cxQ0OdUBEByHxvCyrGxy9F8WpL38Ya6hzV4n27QL84M= -github.com/veandco/go-sdl2 v0.4.33/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= +github.com/veandco/go-sdl2 v0.4.34 h1:dqbUhV/SSJ35grdYTLv3iVxtO1NzNmgzMV//hyCyypY= +github.com/veandco/go-sdl2 v0.4.34/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= @@ -130,10 +132,10 @@ golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPh golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= golang.org/x/crypto v0.5.0/go.mod h1:NK/OQwhpMQP3MwtdjgLlYHnH9ebylxKWv3e0fK+mkQU= golang.org/x/crypto v0.6.0/go.mod h1:OFC/31mSvZgRz0V1QTNCzfAI1aIRzbiufJtkMIlEp58= -golang.org/x/crypto v0.7.0 h1:AvwMYaRytfdeVt3u6mLaxYtErKYjxA2OXjJ1HHq6t3A= -golang.org/x/crypto v0.7.0/go.mod h1:pYwdfH91IfpZVANVyUOhSIPZaFoJGxTFbZhFTx+dXZU= -golang.org/x/image v0.6.0 h1:bR8b5okrPI3g/gyZakLZHeWxAR8Dn5CyxXv1hLH5g/4= -golang.org/x/image v0.6.0/go.mod h1:MXLdDR43H7cDJq5GEGXEVeeNhPgi+YYEQ2pC1byI1x0= +golang.org/x/crypto v0.8.0 h1:pd9TJtTueMTVQXzk8E2XESSMQDj/U7OUu0PqJqPXQjQ= +golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= +golang.org/x/image v0.7.0 h1:gzS29xtG1J5ybQlv0PuyfE3nmc6R4qB73m6LUUmvFuw= +golang.org/x/image v0.7.0/go.mod h1:nd/q4ef1AKKYl/4kft7g+6UyGbdiqWqTP1ZAbRoV7Rg= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= @@ -149,8 +151,9 @@ golang.org/x/net v0.1.0/go.mod h1:Cx3nUiGt4eDBEyega/BKRp+/AlGL8hYe7U9odMt2Cco= golang.org/x/net v0.5.0/go.mod h1:DivGGAXEgPSlEBzxGzZI+ZLohi+xUj054jfeKui00ws= golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= -golang.org/x/net v0.8.0 h1:Zrh2ngAOFYneWTAIAPethzeaQLuHwhuBkuV6ZiRnUaQ= golang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc= +golang.org/x/net v0.9.0 h1:aWJ/m6xSmxWBx+V0XRHTlrYrPG56jKsLdTFmsSsCzOM= +golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -186,6 +189,7 @@ golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuX golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.4.0/go.mod h1:9P2UbLfCdcvo3p/nzKvsmas4TnlujnuoV9hGgYzW1lQ= golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= +golang.org/x/term v0.6.0/go.mod h1:m6U89DPEgQRMq3DNkDClhWw02AUbt2daBVO4cn4Hv9U= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= @@ -193,8 +197,9 @@ golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ= golang.org/x/text v0.4.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.6.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= -golang.org/x/text v0.8.0 h1:57P1ETyNKtuIjB4SRd15iJxuhj8Gc416Y78H3qgMh68= golang.org/x/text v0.8.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= +golang.org/x/text v0.9.0 h1:2sjJmO8cDvYveuX97RDLsxlyUxLl+GHoLxBiRdHllBE= +golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20201224043029-2b0845dc783e/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= From 31638b08052d318bed3baeab98de928983c008e4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 20 Apr 2023 21:49:52 +0300 Subject: [PATCH 003/361] Update Docker GH Action Now it will push the master tag instead of dev for the main branch. --- .github/workflows/cd/docker-compose.yml | 2 +- .github/workflows/docker_publish.yml | 48 +++++++++++++++++++ .github/workflows/docker_publish_stable.yml | 31 ------------ .github/workflows/docker_publish_unstable.yml | 29 ----------- 4 files changed, 49 insertions(+), 61 deletions(-) create mode 100644 .github/workflows/docker_publish.yml delete mode 100644 .github/workflows/docker_publish_stable.yml delete mode 100644 .github/workflows/docker_publish_unstable.yml diff --git a/.github/workflows/cd/docker-compose.yml b/.github/workflows/cd/docker-compose.yml index 06bcca29..bc4565f0 100644 --- a/.github/workflows/cd/docker-compose.yml +++ b/.github/workflows/cd/docker-compose.yml @@ -2,7 +2,7 @@ version: "3.9" x-params: &default-params - image: ghcr.io/giongto35/cloud-game/cloud-game:${IMAGE_TAG:-dev} + image: ghcr.io/giongto35/cloud-game/cloud-game:${IMAGE_TAG:-master} network_mode: "host" privileged: true restart: always diff --git a/.github/workflows/docker_publish.yml b/.github/workflows/docker_publish.yml new file mode 100644 index 00000000..b967d415 --- /dev/null +++ b/.github/workflows/docker_publish.yml @@ -0,0 +1,48 @@ +# ---------------------------------------------------------------------------------- +# Publish Docker image from the current master branch or v* into Github repository +# ---------------------------------------------------------------------------------- + +name: docker-publish + +on: + push: + branches: + - master + tags: + - 'v*' + +jobs: + docker-publish: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - run: echo "V=$(./scripts/version.sh)" >> $GITHUB_ENV + - name: Docker meta + id: meta + uses: docker/metadata-action@v4 + with: + images: ghcr.io/${{ github.repository }}/cloud-game + tags: | + type=ref,event=branch + type=semver,pattern={{version}} + type=semver,pattern={{major}}.{{minor}} + type=semver,pattern={{major}} + - uses: docker/setup-buildx-action@v2 + - uses: docker/login-action@v2 + with: + registry: ghcr.io + username: ${{ github.repository_owner }} + password: ${{ secrets.GITHUB_TOKEN }} + - uses: docker/build-push-action@v4 + with: + build_args: VERSION=${{ env.V }} + context: . + push: true + provenance: false + sbom: false + tags: | + ${{ steps.meta.outputs.tags }} + labels: | + ${{ steps.meta.outputs.labels }} + cache-from: type=gha + cache-to: type=gha,mode=max diff --git a/.github/workflows/docker_publish_stable.yml b/.github/workflows/docker_publish_stable.yml deleted file mode 100644 index e06facac..00000000 --- a/.github/workflows/docker_publish_stable.yml +++ /dev/null @@ -1,31 +0,0 @@ -# ------------------------------------------------------------------------ -# Publish Docker image from the stable snapshot into Github repository -# ------------------------------------------------------------------------ - -name: publish-stable - -on: - push: - tags: - - 'v*' - -jobs: - docker-publish-stable: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v3 - - - run: echo "TAG=${GITHUB_REF/refs\/tags\//}" >> $GITHUB_ENV - - - run: echo "V=$(./scripts/version.sh)" >> $GITHUB_ENV - - - uses: docker/build-push-action@v1 - with: - username: ${{ github.repository_owner }} - password: ${{ secrets.GITHUB_TOKEN }} - add_git_labels: true - tags: latest,${{ env.TAG }} - build_args: VERSION=${{ env.V }} - - registry: docker.pkg.github.com - repository: ${{ github.REPOSITORY }}/cloud-game diff --git a/.github/workflows/docker_publish_unstable.yml b/.github/workflows/docker_publish_unstable.yml deleted file mode 100644 index 9b81b188..00000000 --- a/.github/workflows/docker_publish_unstable.yml +++ /dev/null @@ -1,29 +0,0 @@ -# ---------------------------------------------------------------------------- -# Publish Docker image from the current master branch into Github repository -# ---------------------------------------------------------------------------- - -name: publish-unstable - -on: - push: - branches: - - master - -jobs: - docker-publish-unstable: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v3 - - - run: echo "V=$(./scripts/version.sh)" >> $GITHUB_ENV - - - uses: docker/build-push-action@v1 - with: - username: ${{ github.repository_owner }} - password: ${{ secrets.GITHUB_TOKEN }} - add_git_labels: true - tags: dev - build_args: VERSION=${{ env.V }} - - registry: docker.pkg.github.com - repository: ${{ github.REPOSITORY }}/cloud-game From 137d1b63d8f43aba4e1458521ea00dc4627c35a6 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 20 Apr 2023 21:59:52 +0300 Subject: [PATCH 004/361] Fix build-args for Docker GHA --- .github/workflows/docker_publish.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/docker_publish.yml b/.github/workflows/docker_publish.yml index b967d415..7ba231eb 100644 --- a/.github/workflows/docker_publish.yml +++ b/.github/workflows/docker_publish.yml @@ -35,7 +35,7 @@ jobs: password: ${{ secrets.GITHUB_TOKEN }} - uses: docker/build-push-action@v4 with: - build_args: VERSION=${{ env.V }} + build-args: VERSION=${{ env.V }} context: . push: true provenance: false From b65e8dc3f379c6cf77742d87d5a3ebeff3a7eb73 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 20 Apr 2023 22:53:44 +0300 Subject: [PATCH 005/361] Use master for deploy --- .github/workflows/cd/cloudretro.io/script.env | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/cd/cloudretro.io/script.env b/.github/workflows/cd/cloudretro.io/script.env index ceebbbb6..c806ac50 100644 --- a/.github/workflows/cd/cloudretro.io/script.env +++ b/.github/workflows/cd/cloudretro.io/script.env @@ -1,5 +1,5 @@ COORDINATORS="138.68.48.200" -DOCKER_IMAGE_TAG=dev +DOCKER_IMAGE_TAG=master #DO_ADDRESS_LIST="cloud-gaming cloud-gaming-eu cloud-gaming-usw" #SPLIT_HOSTS=1 USER=root From c8eb672ecd0224e0db21e8ba724ff270c1c21ecc Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 20 Apr 2023 22:54:12 +0300 Subject: [PATCH 006/361] Fix missing return --- pkg/worker/emulator/libretro/nanoarch.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/worker/emulator/libretro/nanoarch.c b/pkg/worker/emulator/libretro/nanoarch.c index d10b8d42..52feccdb 100644 --- a/pkg/worker/emulator/libretro/nanoarch.c +++ b/pkg/worker/emulator/libretro/nanoarch.c @@ -103,7 +103,7 @@ void *bridge_retro_get_memory_data(void *f, unsigned id) { } size_t bridge_retro_serialize_size(void *f) { - ((size_t (*)(void)) f)(); + return ((size_t (*)(void)) f)(); } bool bridge_retro_serialize(void *f, void *data, size_t size) { From ee58af488db8eee96c5a90ff07f0cc78e7af30a3 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 20 Apr 2023 22:54:35 +0300 Subject: [PATCH 007/361] Advance 1 frame only with Mupen --- pkg/worker/emulator/libretro/frontend.go | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/pkg/worker/emulator/libretro/frontend.go b/pkg/worker/emulator/libretro/frontend.go index be399d98..b9640a86 100644 --- a/pkg/worker/emulator/libretro/frontend.go +++ b/pkg/worker/emulator/libretro/frontend.go @@ -141,10 +141,12 @@ func (f *Frontend) Start() { // start time for the first frame lastFrameTime = time.Now().UnixNano() - // 1 frame in order for Mupen save state load to work - f.mu.Lock() - run() - f.mu.Unlock() + // advance 1 frame for Mupen save state + if usesLibCo { + f.mu.Lock() + run() + f.mu.Unlock() + } if err := f.LoadGameState(); err != nil { f.log.Error().Err(err).Msg("couldn't load a save file") From eda90d74e68d843e6d8054f218572ace02570c60 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 21 Apr 2023 00:26:41 +0300 Subject: [PATCH 008/361] Rename C.stop (it crashes PCSX on Ubuntu) wtf omegalol --- pkg/worker/emulator/libretro/nanoarch.c | 2 +- pkg/worker/emulator/libretro/nanoarch.go | 2 +- pkg/worker/emulator/libretro/nanoarch.h | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/pkg/worker/emulator/libretro/nanoarch.c b/pkg/worker/emulator/libretro/nanoarch.c index 52feccdb..4edd73ff 100644 --- a/pkg/worker/emulator/libretro/nanoarch.c +++ b/pkg/worker/emulator/libretro/nanoarch.c @@ -233,7 +233,7 @@ void *run_loop(void *unused) { core_log_cgo(RETRO_LOG_DEBUG, "UnLibCo run loop stop\n"); } -void stop() { +void same_thread_stop() { initialized = 0; } diff --git a/pkg/worker/emulator/libretro/nanoarch.go b/pkg/worker/emulator/libretro/nanoarch.go index 895443bf..80d1433b 100644 --- a/pkg/worker/emulator/libretro/nanoarch.go +++ b/pkg/worker/emulator/libretro/nanoarch.go @@ -613,7 +613,7 @@ func nanoarchShutdown() { if nano.v.isGl { C.same_thread(C.deinit_video_cgo) } - C.same_thread(C.stop) + C.same_thread(C.same_thread_stop) }) } else { if nano.v.isGl { diff --git a/pkg/worker/emulator/libretro/nanoarch.h b/pkg/worker/emulator/libretro/nanoarch.h index 3ef0be1b..0c4b0177 100644 --- a/pkg/worker/emulator/libretro/nanoarch.h +++ b/pkg/worker/emulator/libretro/nanoarch.h @@ -38,6 +38,6 @@ void deinit_video_cgo(); void same_thread(void *f); void *same_thread_with_args2(void *f, int type, void *arg1, void *arg2); -void stop(); +void same_thread_stop(); #endif From c13099c56a10b79d56306f2bc771100c8949ad14 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 22 Apr 2023 15:11:20 +0300 Subject: [PATCH 009/361] Remove hackish way of adding ICE servers Use config files instead (k8s ConfigMap or something). --- pkg/config/coordinator/config.go | 1 - pkg/config/webrtc/config.go | 27 --------------------------- pkg/config/worker/config.go | 4 +--- 3 files changed, 1 insertion(+), 31 deletions(-) diff --git a/pkg/config/coordinator/config.go b/pkg/config/coordinator/config.go index 9d815372..7bd92fd9 100644 --- a/pkg/config/coordinator/config.go +++ b/pkg/config/coordinator/config.go @@ -48,7 +48,6 @@ func NewConfig() (conf Config) { if err != nil { panic(err) } - conf.Webrtc.AddIceServersEnv() return } diff --git a/pkg/config/webrtc/config.go b/pkg/config/webrtc/config.go index 0c9e6064..27bd664d 100644 --- a/pkg/config/webrtc/config.go +++ b/pkg/config/webrtc/config.go @@ -1,12 +1,5 @@ package webrtc -import ( - "log" - "strings" - - "github.com/giongto35/cloud-game/v3/pkg/config" -) - type Webrtc struct { DisableDefaultInterceptors bool DtlsRole byte @@ -31,23 +24,3 @@ func (w *Webrtc) HasDtlsRole() bool { return w.DtlsRole > 0 } func (w *Webrtc) HasPortRange() bool { return w.IcePorts.Min > 0 && w.IcePorts.Max > 0 } func (w *Webrtc) HasSinglePort() bool { return w.SinglePort > 0 } func (w *Webrtc) HasIceIpMap() bool { return w.IceIpMap != "" } - -func (w *Webrtc) AddIceServersEnv() { - cfg := Webrtc{IceServers: []IceServer{{}, {}, {}, {}, {}}} - _ = config.LoadConfigEnv(&cfg) - for i, ice := range cfg.IceServers { - if ice.Urls == "" { - continue - } - if strings.HasPrefix(ice.Urls, "turn:") || strings.HasPrefix(ice.Urls, "turns:") { - if ice.Username == "" || ice.Credential == "" { - log.Fatalf("TURN or TURNS servers should have both username and credential: %+v", ice) - } - } - if i > len(w.IceServers)-1 { - w.IceServers = append(w.IceServers, ice) - } else { - w.IceServers[i] = ice - } - } -} diff --git a/pkg/config/worker/config.go b/pkg/config/worker/config.go index 097fd35e..ba8d2d55 100644 --- a/pkg/config/worker/config.go +++ b/pkg/config/worker/config.go @@ -87,9 +87,7 @@ func (c *Config) expandSpecialTags() { // fixValues tries to fix some values otherwise hard to set externally. func (c *Config) fixValues() { // with ICE lite we clear ICE servers - if !c.Webrtc.IceLite { - c.Webrtc.AddIceServersEnv() - } else { + if c.Webrtc.IceLite { c.Webrtc.IceServers = []webrtc.IceServer{} } } From 8893e1e5bf678b9307df44c8945a779491ff7d95 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 22 Apr 2023 16:53:39 +0300 Subject: [PATCH 010/361] Update config manager --- cmd/coordinator/main.go | 4 +- cmd/worker/main.go | 4 +- go.mod | 8 +- go.sum | 12 ++- pkg/config/coordinator.go | 66 +++++++++++++++ pkg/config/coordinator/config.go | 59 -------------- .../{emulator/config.go => emulator.go} | 2 +- .../config_test.go => emulator_test.go} | 2 +- pkg/config/encoder/config.go | 26 ------ pkg/config/loader.go | 80 ++++++++++++++++--- pkg/config/loader_test.go | 32 ++++++++ pkg/config/monitoring/config.go | 10 --- pkg/config/{shared/config.go => shared.go} | 11 ++- pkg/config/storage/config.go | 6 -- pkg/config/{webrtc/config.go => webrtc.go} | 2 +- pkg/config/{worker/config.go => worker.go} | 75 +++++++++++------ pkg/coordinator/coordinator.go | 13 ++- pkg/coordinator/hub.go | 8 +- pkg/coordinator/user.go | 4 +- pkg/coordinator/userapi.go | 4 +- pkg/coordinator/userhandlers.go | 4 +- pkg/games/library.go | 24 ++---- pkg/games/library_test.go | 3 +- pkg/monitoring/monitoring.go | 6 +- pkg/network/httpx/options.go | 4 +- pkg/network/webrtc/factory.go | 4 +- pkg/worker/coordinator.go | 4 +- pkg/worker/coordinatorhandlers.go | 4 +- pkg/worker/emulator/libretro/frontend.go | 22 ++--- .../emulator/libretro/manager/manager.go | 10 +-- .../libretro/manager/remotehttp/manager.go | 12 +-- .../manager/remotehttp/manager_test.go | 6 +- pkg/worker/emulator/libretro/nanoarch_test.go | 3 +- pkg/worker/media.go | 6 +- pkg/worker/recording.go | 4 +- pkg/worker/room.go | 7 +- pkg/worker/room_test.go | 5 +- pkg/worker/worker.go | 6 +- 38 files changed, 319 insertions(+), 243 deletions(-) create mode 100644 pkg/config/coordinator.go delete mode 100644 pkg/config/coordinator/config.go rename pkg/config/{emulator/config.go => emulator.go} (99%) rename pkg/config/{emulator/config_test.go => emulator_test.go} (98%) delete mode 100644 pkg/config/encoder/config.go create mode 100644 pkg/config/loader_test.go delete mode 100644 pkg/config/monitoring/config.go rename pkg/config/{shared/config.go => shared.go} (73%) delete mode 100644 pkg/config/storage/config.go rename pkg/config/{webrtc/config.go => webrtc.go} (97%) rename pkg/config/{worker/config.go => worker.go} (72%) diff --git a/cmd/coordinator/main.go b/cmd/coordinator/main.go index bc1a99be..fb4b2947 100644 --- a/cmd/coordinator/main.go +++ b/cmd/coordinator/main.go @@ -1,7 +1,7 @@ package main import ( - config "github.com/giongto35/cloud-game/v3/pkg/config/coordinator" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/coordinator" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" @@ -10,7 +10,7 @@ import ( var Version = "?" func main() { - conf := config.NewConfig() + conf := config.NewCoordinatorConfig() conf.ParseFlags() log := logger.NewConsole(conf.Coordinator.Debug, "c", false) diff --git a/cmd/worker/main.go b/cmd/worker/main.go index 9c4af846..5dc60ce5 100644 --- a/cmd/worker/main.go +++ b/cmd/worker/main.go @@ -3,7 +3,7 @@ package main import ( "time" - config "github.com/giongto35/cloud-game/v3/pkg/config/worker" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" "github.com/giongto35/cloud-game/v3/pkg/worker" @@ -13,7 +13,7 @@ import ( var Version = "?" func run() { - conf := config.NewConfig() + conf := config.NewWorkerConfig() conf.ParseFlags() log := logger.NewConsole(conf.Worker.Debug, "w", false) diff --git a/go.mod b/go.mod index 437c6bb0..9e1e8f01 100644 --- a/go.mod +++ b/go.mod @@ -9,7 +9,8 @@ require ( github.com/goccy/go-json v0.10.2 github.com/gofrs/flock v0.8.1 github.com/gorilla/websocket v1.5.0 - github.com/kkyr/fig v0.3.1 + github.com/knadh/koanf/maps v0.1.1 + github.com/knadh/koanf/v2 v2.0.1 github.com/pion/interceptor v0.1.12 github.com/pion/logging v0.2.2 github.com/pion/webrtc/v3 v3.1.60 @@ -18,14 +19,16 @@ require ( github.com/veandco/go-sdl2 v0.4.34 golang.org/x/crypto v0.8.0 golang.org/x/image v0.7.0 + gopkg.in/yaml.v3 v3.0.1 ) require ( github.com/google/uuid v1.3.0 // indirect github.com/mattn/go-colorable v0.1.13 // indirect github.com/mattn/go-isatty v0.0.18 // indirect + github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/mapstructure v1.5.0 // indirect - github.com/pelletier/go-toml v1.9.5 // indirect + github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect github.com/pion/dtls/v2 v2.2.6 // indirect github.com/pion/ice/v2 v2.3.2 // indirect @@ -45,5 +48,4 @@ require ( golang.org/x/net v0.9.0 // indirect golang.org/x/sys v0.7.0 // indirect golang.org/x/text v0.9.0 // indirect - gopkg.in/yaml.v3 v3.0.1 // indirect ) diff --git a/go.sum b/go.sum index 7cd85fb0..e3de8899 100644 --- a/go.sum +++ b/go.sum @@ -34,8 +34,10 @@ github.com/google/uuid v1.3.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+ github.com/gorilla/websocket v1.5.0 h1:PPwGk2jz7EePpoHN/+ClbZu8SPxiqlu12wZP/3sWmnc= github.com/gorilla/websocket v1.5.0/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= -github.com/kkyr/fig v0.3.1 h1:GqsamO9dwY05t2xh6ubzjPPYw2It4hoWbKZEWmDxM0o= -github.com/kkyr/fig v0.3.1/go.mod h1:ItUILF8IIzgZOMhx5xpJ1W/bviQsWRKOwKXfE/tqUoA= +github.com/knadh/koanf/maps v0.1.1 h1:G5TjmUh2D7G2YWf5SQQqSiHRJEjaicvU0KpypqB3NIs= +github.com/knadh/koanf/maps v0.1.1/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= +github.com/knadh/koanf/v2 v2.0.1 h1:1dYGITt1I23x8cfx8ZnldtezdyaZtfAuRtIFOiRzK7g= +github.com/knadh/koanf/v2 v2.0.1/go.mod h1:ZeiIlIDXTE7w1lMT6UVcNiRAS2/rCeLn/GdLNvY1Dus= github.com/kr/pretty v0.1.0 h1:L/CwN0zerZDmRFUapSPitk6f+Q3+0za1rQkzVuMiMFI= github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo= github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= @@ -48,8 +50,12 @@ github.com/mattn/go-isatty v0.0.14/go.mod h1:7GGIvUiUoEMVVmxf/4nioHXj79iQHKdU27k github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM= github.com/mattn/go-isatty v0.0.18 h1:DOKFKCQ7FNG2L1rbrmstDN4QVRdS89Nkh85u68Uwp98= github.com/mattn/go-isatty v0.0.18/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= +github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= +github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= +github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= github.com/nxadm/tail v1.4.4/go.mod h1:kenIhsEOeOJmVchQTgglprH7qJGnHDVpk1VPCcaMI8A= github.com/nxadm/tail v1.4.8/go.mod h1:+ncqLTQzXmGhMZNUePPaPqPvBxHAIsmXswZKocGu+AU= github.com/onsi/ginkgo v1.6.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= @@ -59,8 +65,6 @@ github.com/onsi/ginkgo v1.16.5/go.mod h1:+E8gABHa3K6zRBolWtd+ROzc/U5bkGt0FwiG042 github.com/onsi/gomega v1.7.1/go.mod h1:XdKZgCCFLUoM/7CFJVPcG8C1xQ1AJ0vpAezJrB7JYyY= github.com/onsi/gomega v1.10.1/go.mod h1:iN09h71vgCQne3DLsj+A5owkum+a2tYe+TOCB1ybHNo= github.com/onsi/gomega v1.17.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAlGdZY= -github.com/pelletier/go-toml v1.9.5 h1:4yBQzkHv+7BHq2PQUZF3Mx0IYxG7LsP222s7Agd3ve8= -github.com/pelletier/go-toml v1.9.5/go.mod h1:u1nR/EPcESfeI/szUZKdtJ0xRNbUoANCkoOuaOx1Y+c= github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew8= github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= github.com/pion/dtls/v2 v2.2.6 h1:yXMxKr0Skd+Ub6A8UqXTRLSywskx93ooMRHsQUtd+Z4= diff --git a/pkg/config/coordinator.go b/pkg/config/coordinator.go new file mode 100644 index 00000000..78dba178 --- /dev/null +++ b/pkg/config/coordinator.go @@ -0,0 +1,66 @@ +package config + +import "flag" + +type CoordinatorConfig struct { + Coordinator Coordinator + Emulator Emulator + Recording Recording + Version Version + Webrtc Webrtc +} + +type Coordinator struct { + Analytics Analytics + Debug bool + Library Library + Monitoring Monitoring + Origin struct { + UserWs string + WorkerWs string + } + Selector string + Server Server +} + +type Library struct { + // some directory which is going to be + // the root folder for the library + BasePath string + // a list of supported file extensions + Supported []string + // a list of ignored words in the files + Ignored []string + // print some additional info + Verbose bool + // enable directory changes watch + WatchMode bool +} + +func (l Library) GetSupportedExtensions() []string { return l.Supported } + +// Analytics is optional Google Analytics +type Analytics struct { + Inject bool + Gtag string +} + +const SelectByPing = "ping" + +// allows custom config path +var coordinatorConfigPath string + +func NewCoordinatorConfig() (conf CoordinatorConfig) { + err := LoadConfig(&conf, coordinatorConfigPath) + if err != nil { + panic(err) + } + return +} + +func (c *CoordinatorConfig) ParseFlags() { + c.Coordinator.Server.WithFlags() + flag.IntVar(&c.Coordinator.Monitoring.Port, "monitoring.port", c.Coordinator.Monitoring.Port, "Monitoring server port") + flag.StringVar(&coordinatorConfigPath, "c-conf", coordinatorConfigPath, "Set custom configuration file path") + flag.Parse() +} diff --git a/pkg/config/coordinator/config.go b/pkg/config/coordinator/config.go deleted file mode 100644 index 7bd92fd9..00000000 --- a/pkg/config/coordinator/config.go +++ /dev/null @@ -1,59 +0,0 @@ -package coordinator - -import ( - "flag" - - "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/config/emulator" - "github.com/giongto35/cloud-game/v3/pkg/config/monitoring" - "github.com/giongto35/cloud-game/v3/pkg/config/shared" - "github.com/giongto35/cloud-game/v3/pkg/config/webrtc" - "github.com/giongto35/cloud-game/v3/pkg/games" -) - -type Config struct { - Coordinator Coordinator - Emulator emulator.Emulator - Recording shared.Recording - Version shared.Version - Webrtc webrtc.Webrtc -} - -type Coordinator struct { - Analytics Analytics - Debug bool - Library games.Config - Monitoring monitoring.Config - Origin struct { - UserWs string - WorkerWs string - } - Selector string - Server shared.Server -} - -// Analytics is optional Google Analytics -type Analytics struct { - Inject bool - Gtag string -} - -const SelectByPing = "ping" - -// allows custom config path -var configPath string - -func NewConfig() (conf Config) { - err := config.LoadConfig(&conf, configPath) - if err != nil { - panic(err) - } - return -} - -func (c *Config) ParseFlags() { - c.Coordinator.Server.WithFlags() - flag.IntVar(&c.Coordinator.Monitoring.Port, "monitoring.port", c.Coordinator.Monitoring.Port, "Monitoring server port") - flag.StringVar(&configPath, "c-conf", configPath, "Set custom configuration file path") - flag.Parse() -} diff --git a/pkg/config/emulator/config.go b/pkg/config/emulator.go similarity index 99% rename from pkg/config/emulator/config.go rename to pkg/config/emulator.go index 311cff5d..3880b12b 100644 --- a/pkg/config/emulator/config.go +++ b/pkg/config/emulator.go @@ -1,4 +1,4 @@ -package emulator +package config import ( "math" diff --git a/pkg/config/emulator/config_test.go b/pkg/config/emulator_test.go similarity index 98% rename from pkg/config/emulator/config_test.go rename to pkg/config/emulator_test.go index ebef77c2..d7f29803 100644 --- a/pkg/config/emulator/config_test.go +++ b/pkg/config/emulator_test.go @@ -1,4 +1,4 @@ -package emulator +package config import "testing" diff --git a/pkg/config/encoder/config.go b/pkg/config/encoder/config.go deleted file mode 100644 index f0b9426c..00000000 --- a/pkg/config/encoder/config.go +++ /dev/null @@ -1,26 +0,0 @@ -package encoder - -type Encoder struct { - Audio Audio - Video Video -} - -type Audio struct { - Frame int -} - -type Video struct { - Codec string - Concurrency int - H264 struct { - Crf uint8 - Preset string - Profile string - Tune string - LogLevel int - } - Vpx struct { - Bitrate uint - KeyframeInterval uint - } -} diff --git a/pkg/config/loader.go b/pkg/config/loader.go index ef49ab21..d75ddf0c 100644 --- a/pkg/config/loader.go +++ b/pkg/config/loader.go @@ -2,16 +2,69 @@ package config import ( "os" + "path/filepath" + "strings" - "github.com/kkyr/fig" + "github.com/knadh/koanf/maps" + "github.com/knadh/koanf/v2" + "gopkg.in/yaml.v3" ) -const EnvPrefix = "CLOUD_GAME" +const EnvPrefix = "CLOUD_GAME_" + +type File string + +func (f *File) ReadBytes() ([]byte, error) { return os.ReadFile(string(*f)) } +func (f *File) Read() (map[string]interface{}, error) { return nil, nil } + +type YAML struct{} + +func (p *YAML) Marshal(map[string]interface{}) ([]byte, error) { return nil, nil } +func (p *YAML) Unmarshal(b []byte) (map[string]interface{}, error) { + var out map[string]interface{} + if err := yaml.Unmarshal(b, &out); err != nil { + return nil, err + } + return out, nil +} + +type Env string + +func (e *Env) ReadBytes() ([]byte, error) { return nil, nil } +func (e *Env) Read() (map[string]interface{}, error) { + var keys []string + for _, k := range os.Environ() { + if strings.HasPrefix(k, string(*e)) { + keys = append(keys, k) + } + } + mp := make(map[string]interface{}) + for _, k := range keys { + parts := strings.SplitN(k, "=", 2) + n := strings.ToLower(strings.TrimPrefix(parts[0], string(*e))) + if n == "" { + continue + } + // convert VAR_VAR to VAR.VAR or if we need to preserve _ + // i.e. VAR_VAR__KEY_HAS_SLASHES to VAR.VAR.KEY_HAS_SLASHES + // with the result: VAR: { VAR: { KEY_HAS_SLASHES: '' } } } + x := strings.Index(n, "__") + var key string + if x == -1 { + key = strings.Replace(n, "_", ".", -1) + } else { + key = strings.Replace(n[:x+1], "_", ".", -1) + n[x+2:] + } + mp[key] = parts[1] + } + return maps.Unflatten(mp, "."), nil +} + +var k = koanf.New("_") // LoadConfig loads a configuration file into the given struct. // The path param specifies a custom path to the configuration file. // Reads and puts environment variables with the prefix CLOUD_GAME_. -// Params from the config should be in uppercase separated with _. func LoadConfig(config any, path string) error { dirs := []string{path} if path == "" { @@ -24,18 +77,23 @@ func LoadConfig(config any, path string) error { dirs = append(dirs, homeDir) } - if err := fig.Load(config, fig.Dirs(dirs...), fig.UseEnv(EnvPrefix)); err != nil { + for _, dir := range dirs { + f := File(filepath.Join(filepath.Clean(dir), "config.yaml")) + if _, err := os.Stat(string(f)); !os.IsNotExist(err) { + if err := k.Load(&f, &YAML{}); err != nil { + return err + } + } + } + + env := Env(EnvPrefix) + if err := k.Load(&env, nil); err != nil { return err } - // override from /home - if homeDir != "" { - _ = fig.Load(config, fig.Dirs(homeDir)) + if err := k.Unmarshal("", config); err != nil { + return err } return nil } - -func LoadConfigEnv(config any) error { - return fig.Load(config, fig.IgnoreFile(), fig.UseEnv(EnvPrefix)) -} diff --git a/pkg/config/loader_test.go b/pkg/config/loader_test.go new file mode 100644 index 00000000..c0e7a116 --- /dev/null +++ b/pkg/config/loader_test.go @@ -0,0 +1,32 @@ +package config + +import ( + "os" + "testing" +) + +func TestConfigEnv(t *testing.T) { + var out WorkerConfig + + _ = os.Setenv("CLOUD_GAME_ENCODER_AUDIO_FRAME", "33") + defer func() { _ = os.Unsetenv("CLOUD_GAME_ENCODER_AUDIO_FRAME") }() + + _ = os.Setenv("CLOUD_GAME_EMULATOR_LIBRETRO_CORES_LIST_PCSX_OPTIONS__PCSX_REARMED_DRC", "x") + defer func() { + _ = os.Unsetenv("CLOUD_GAME_EMULATOR_LIBRETRO_CORES_LIST_PCSX_OPTIONS__PCSX_REARMED_DRC") + }() + + err := LoadConfig(&out, "../../configs") + if err != nil { + t.Fatal(err) + } + + if out.Encoder.Audio.Frame != 33 { + t.Errorf("%v is not 33", out.Encoder.Audio.Frame) + } + + v := out.Emulator.Libretro.Cores.List["pcsx"].Options["pcsx_rearmed_drc"] + if v != "x" { + t.Errorf("%v is not x", v) + } +} diff --git a/pkg/config/monitoring/config.go b/pkg/config/monitoring/config.go deleted file mode 100644 index da89ead0..00000000 --- a/pkg/config/monitoring/config.go +++ /dev/null @@ -1,10 +0,0 @@ -package monitoring - -type Config struct { - Port int - URLPrefix string - MetricEnabled bool `json:"metric_enabled"` - ProfilingEnabled bool `json:"profiling_enabled"` -} - -func (c *Config) IsEnabled() bool { return c.MetricEnabled || c.ProfilingEnabled } diff --git a/pkg/config/shared/config.go b/pkg/config/shared.go similarity index 73% rename from pkg/config/shared/config.go rename to pkg/config/shared.go index 3a92cd5e..d6898089 100644 --- a/pkg/config/shared/config.go +++ b/pkg/config/shared.go @@ -1,9 +1,18 @@ -package shared +package config import "flag" type Version int +type Monitoring struct { + Port int + URLPrefix string + MetricEnabled bool `json:"metric_enabled"` + ProfilingEnabled bool `json:"profiling_enabled"` +} + +func (c *Monitoring) IsEnabled() bool { return c.MetricEnabled || c.ProfilingEnabled } + type Server struct { Address string Https bool diff --git a/pkg/config/storage/config.go b/pkg/config/storage/config.go deleted file mode 100644 index fd528c4d..00000000 --- a/pkg/config/storage/config.go +++ /dev/null @@ -1,6 +0,0 @@ -package storage - -type Storage struct { - Provider string - Key string -} diff --git a/pkg/config/webrtc/config.go b/pkg/config/webrtc.go similarity index 97% rename from pkg/config/webrtc/config.go rename to pkg/config/webrtc.go index 27bd664d..bc0b8e14 100644 --- a/pkg/config/webrtc/config.go +++ b/pkg/config/webrtc.go @@ -1,4 +1,4 @@ -package webrtc +package config type Webrtc struct { DisableDefaultInterceptors bool diff --git a/pkg/config/worker/config.go b/pkg/config/worker.go similarity index 72% rename from pkg/config/worker/config.go rename to pkg/config/worker.go index ba8d2d55..b7e580c2 100644 --- a/pkg/config/worker/config.go +++ b/pkg/config/worker.go @@ -1,4 +1,4 @@ -package worker +package config import ( "flag" @@ -8,29 +8,27 @@ import ( "path/filepath" "strings" - "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/config/emulator" - "github.com/giongto35/cloud-game/v3/pkg/config/encoder" - "github.com/giongto35/cloud-game/v3/pkg/config/monitoring" - "github.com/giongto35/cloud-game/v3/pkg/config/shared" - "github.com/giongto35/cloud-game/v3/pkg/config/storage" - "github.com/giongto35/cloud-game/v3/pkg/config/webrtc" "github.com/giongto35/cloud-game/v3/pkg/os" ) -type Config struct { - Encoder encoder.Encoder - Emulator emulator.Emulator - Recording shared.Recording - Storage storage.Storage +type WorkerConfig struct { + Encoder Encoder + Emulator Emulator + Recording Recording + Storage Storage Worker Worker - Webrtc webrtc.Webrtc - Version shared.Version + Webrtc Webrtc + Version Version +} + +type Storage struct { + Provider string + Key string } type Worker struct { Debug bool - Monitoring monitoring.Config + Monitoring Monitoring Network struct { CoordinatorAddress string Endpoint string @@ -39,15 +37,40 @@ type Worker struct { Secure bool Zone string } - Server shared.Server + Server Server Tag string } -// allows custom config path -var configPath string +type Encoder struct { + Audio Audio + Video Video +} -func NewConfig() (conf Config) { - err := config.LoadConfig(&conf, configPath) +type Audio struct { + Frame int +} + +type Video struct { + Codec string + Concurrency int + H264 struct { + Crf uint8 + Preset string + Profile string + Tune string + LogLevel int + } + Vpx struct { + Bitrate uint + KeyframeInterval uint + } +} + +// allows custom config path +var workerConfigPath string + +func NewWorkerConfig() (conf WorkerConfig) { + err := LoadConfig(&conf, workerConfigPath) if err != nil { panic(err) } @@ -59,17 +82,17 @@ func NewConfig() (conf Config) { // ParseFlags updates config values from passed runtime flags. // Define own flags with default value set to the current config param. // Don't forget to call flag.Parse(). -func (c *Config) ParseFlags() { +func (c *WorkerConfig) ParseFlags() { c.Worker.Server.WithFlags() flag.IntVar(&c.Worker.Monitoring.Port, "monitoring.port", c.Worker.Monitoring.Port, "Monitoring server port") flag.StringVar(&c.Worker.Network.CoordinatorAddress, "coordinatorhost", c.Worker.Network.CoordinatorAddress, "Worker URL to connect") flag.StringVar(&c.Worker.Network.Zone, "zone", c.Worker.Network.Zone, "Worker network zone (us, eu, etc.)") - flag.StringVar(&configPath, "w-conf", configPath, "Set custom configuration file path") + flag.StringVar(&workerConfigPath, "w-conf", workerConfigPath, "Set custom configuration file path") flag.Parse() } // expandSpecialTags replaces all the special tags in the config. -func (c *Config) expandSpecialTags() { +func (c *WorkerConfig) expandSpecialTags() { tag := "{user}" for _, dir := range []*string{&c.Emulator.Storage, &c.Emulator.Libretro.Cores.Repo.ExtLock} { if *dir == "" || !strings.Contains(*dir, tag) { @@ -85,10 +108,10 @@ func (c *Config) expandSpecialTags() { } // fixValues tries to fix some values otherwise hard to set externally. -func (c *Config) fixValues() { +func (c *WorkerConfig) fixValues() { // with ICE lite we clear ICE servers if c.Webrtc.IceLite { - c.Webrtc.IceServers = []webrtc.IceServer{} + c.Webrtc.IceServers = []IceServer{} } } diff --git a/pkg/coordinator/coordinator.go b/pkg/coordinator/coordinator.go index 82e41e0e..232f6ab1 100644 --- a/pkg/coordinator/coordinator.go +++ b/pkg/coordinator/coordinator.go @@ -4,8 +4,7 @@ import ( "html/template" "net/http" - "github.com/giongto35/cloud-game/v3/pkg/config/coordinator" - "github.com/giongto35/cloud-game/v3/pkg/config/shared" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/monitoring" @@ -13,7 +12,7 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/service" ) -func New(conf coordinator.Config, log *logger.Logger) (services service.Group) { +func New(conf config.CoordinatorConfig, log *logger.Logger) (services service.Group) { lib := games.NewLibWhitelisted(conf.Coordinator.Library, conf.Emulator, log) lib.Scan() hub := NewHub(conf, lib, log) @@ -33,7 +32,7 @@ func New(conf coordinator.Config, log *logger.Logger) (services service.Group) { return } -func NewHTTPServer(conf coordinator.Config, log *logger.Logger, fnMux func(*httpx.Mux) *httpx.Mux) (*httpx.Server, error) { +func NewHTTPServer(conf config.CoordinatorConfig, log *logger.Logger, fnMux func(*httpx.Mux) *httpx.Mux) (*httpx.Server, error) { return httpx.NewServer( conf.Coordinator.Server.GetAddr(), func(s *httpx.Server) httpx.Handler { @@ -46,7 +45,7 @@ func NewHTTPServer(conf coordinator.Config, log *logger.Logger, fnMux func(*http ) } -func index(conf coordinator.Config, log *logger.Logger) httpx.Handler { +func index(conf config.CoordinatorConfig, log *logger.Logger) httpx.Handler { const indexHTML = "./web/index.html" handler := func(tpl *template.Template, w httpx.ResponseWriter, r *httpx.Request) { @@ -56,8 +55,8 @@ func index(conf coordinator.Config, log *logger.Logger) httpx.Handler { } // render index page with some tpl values tplData := struct { - Analytics coordinator.Analytics - Recording shared.Recording + Analytics config.Analytics + Recording config.Recording }{conf.Coordinator.Analytics, conf.Recording} if err := tpl.Execute(w, tplData); err != nil { log.Fatal().Err(err).Msg("error with the analytics template file") diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index 5487b2b3..6331aef4 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -9,7 +9,7 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/api" "github.com/giongto35/cloud-game/v3/pkg/com" - "github.com/giongto35/cloud-game/v3/pkg/config/coordinator" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/logger" ) @@ -24,14 +24,14 @@ type Connection interface { } type Hub struct { - conf coordinator.Config + conf config.CoordinatorConfig launcher games.Launcher log *logger.Logger users com.NetMap[*User] workers com.NetMap[*Worker] } -func NewHub(conf coordinator.Config, lib games.GameLibrary, log *logger.Logger) *Hub { +func NewHub(conf config.CoordinatorConfig, lib games.GameLibrary, log *logger.Logger) *Hub { return &Hub{ conf: conf, users: com.NewNetMap[*User](), @@ -168,7 +168,7 @@ func (h *Hub) findWorkerFor(usr *User, q url.Values, log *logger.Logger) *Worker log.Debug().Msgf("Worker with id: %v has been found", wid) } else { switch h.conf.Coordinator.Selector { - case coordinator.SelectByPing: + case config.SelectByPing: log.Debug().Msgf("Searching fastest free worker...") if worker = h.findFastestWorker(zone, func(servers []string) (map[string]int64, error) { return usr.CheckLatency(servers) }); worker != nil { diff --git a/pkg/coordinator/user.go b/pkg/coordinator/user.go index c6841cab..711c6bac 100644 --- a/pkg/coordinator/user.go +++ b/pkg/coordinator/user.go @@ -3,7 +3,7 @@ package coordinator import ( "github.com/giongto35/cloud-game/v3/pkg/api" "github.com/giongto35/cloud-game/v3/pkg/com" - "github.com/giongto35/cloud-game/v3/pkg/config/coordinator" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/logger" ) @@ -42,7 +42,7 @@ func (u *User) Disconnect() { } } -func (u *User) HandleRequests(info HasServerInfo, launcher games.Launcher, conf coordinator.Config) chan struct{} { +func (u *User) HandleRequests(info HasServerInfo, launcher games.Launcher, conf config.CoordinatorConfig) chan struct{} { return u.ProcessPackets(func(x api.In[com.Uid]) error { payload := x.GetPayload() switch x.GetType() { diff --git a/pkg/coordinator/userapi.go b/pkg/coordinator/userapi.go index 8a02ba7d..77590062 100644 --- a/pkg/coordinator/userapi.go +++ b/pkg/coordinator/userapi.go @@ -4,7 +4,7 @@ import ( "unsafe" "github.com/giongto35/cloud-game/v3/pkg/api" - "github.com/giongto35/cloud-game/v3/pkg/config/webrtc" + "github.com/giongto35/cloud-game/v3/pkg/config" ) // CheckLatency sends a list of server addresses to the user @@ -22,7 +22,7 @@ func (u *User) CheckLatency(req api.CheckLatencyUserResponse) (api.CheckLatencyU } // InitSession signals the user that the app is ready to go. -func (u *User) InitSession(wid string, ice []webrtc.IceServer, games []string) { +func (u *User) InitSession(wid string, ice []config.IceServer, games []string) { u.Notify(api.InitSession, api.InitSessionUserResponse{ // don't do this at home Ice: *(*[]api.IceServer)(unsafe.Pointer(&ice)), diff --git a/pkg/coordinator/userhandlers.go b/pkg/coordinator/userhandlers.go index 43fa11b0..441dce08 100644 --- a/pkg/coordinator/userhandlers.go +++ b/pkg/coordinator/userhandlers.go @@ -5,7 +5,7 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/api" "github.com/giongto35/cloud-game/v3/pkg/com" - "github.com/giongto35/cloud-game/v3/pkg/config/coordinator" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" ) @@ -26,7 +26,7 @@ func (u *User) HandleWebrtcIceCandidate(rq api.WebrtcUserIceCandidate) { u.w.WebrtcIceCandidate(u.Id(), string(rq)) } -func (u *User) HandleStartGame(rq api.GameStartUserRequest, launcher games.Launcher, conf coordinator.Config) { +func (u *User) HandleStartGame(rq api.GameStartUserRequest, launcher games.Launcher, conf config.CoordinatorConfig) { // +injects game data into the original game request // the name of the game either in the `room id` field or // it's in the initial request diff --git a/pkg/games/library.go b/pkg/games/library.go index e84c8b9e..3b60041f 100644 --- a/pkg/games/library.go +++ b/pkg/games/library.go @@ -11,24 +11,10 @@ import ( "time" "github.com/fsnotify/fsnotify" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" ) -// Config is an external configuration -type Config struct { - // some directory which is going to be - // the root folder for the library - BasePath string - // a list of supported file extensions - Supported []string - // a list of ignored words in the files - Ignored []string - // print some additional info - Verbose bool - // enable directory changes watch - WatchMode bool -} - // libConf is an optimized internal library configuration type libConf struct { path string @@ -82,11 +68,11 @@ type GameMetadata struct { func (g GameMetadata) FullPath() string { return filepath.Join(g.Base, g.Path) } -func (c Config) GetSupportedExtensions() []string { return c.Supported } +func NewLib(conf config.Library, log *logger.Logger) GameLibrary { + return NewLibWhitelisted(conf, conf, log) +} -func NewLib(conf Config, log *logger.Logger) GameLibrary { return NewLibWhitelisted(conf, conf, log) } - -func NewLibWhitelisted(conf Config, filter FileExtensionWhitelist, log *logger.Logger) GameLibrary { +func NewLibWhitelisted(conf config.Library, filter FileExtensionWhitelist, log *logger.Logger) GameLibrary { hasSource := true dir, err := filepath.Abs(conf.BasePath) if err != nil { diff --git a/pkg/games/library_test.go b/pkg/games/library_test.go index f9b29f73..b9f4668c 100644 --- a/pkg/games/library_test.go +++ b/pkg/games/library_test.go @@ -3,6 +3,7 @@ package games import ( "testing" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" ) @@ -21,7 +22,7 @@ func TestLibraryScan(t *testing.T) { l := logger.NewConsole(false, "w", false) for _, test := range tests { - library := NewLib(Config{ + library := NewLib(config.Library{ BasePath: test.directory, Supported: []string{"gba", "zip", "nes"}, Ignored: []string{"neogeo", "pgm"}, diff --git a/pkg/monitoring/monitoring.go b/pkg/monitoring/monitoring.go index 7c36cdbe..a071672b 100644 --- a/pkg/monitoring/monitoring.go +++ b/pkg/monitoring/monitoring.go @@ -7,7 +7,7 @@ import ( "strconv" "github.com/VictoriaMetrics/metrics" - "github.com/giongto35/cloud-game/v3/pkg/config/monitoring" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/network/httpx" ) @@ -16,14 +16,14 @@ const debugEndpoint = "/debug/pprof" const metricsEndpoint = "/metrics" type Monitoring struct { - conf monitoring.Config + conf config.Monitoring server *httpx.Server log *logger.Logger } // New creates new monitoring service. // The tag param specifies owner label for logs. -func New(conf monitoring.Config, baseAddr string, log *logger.Logger) *Monitoring { +func New(conf config.Monitoring, baseAddr string, log *logger.Logger) *Monitoring { serv, err := httpx.NewServer( net.JoinHostPort(baseAddr, strconv.Itoa(conf.Port)), func(s *httpx.Server) httpx.Handler { diff --git a/pkg/network/httpx/options.go b/pkg/network/httpx/options.go index 3b771f86..0a30de7e 100644 --- a/pkg/network/httpx/options.go +++ b/pkg/network/httpx/options.go @@ -3,7 +3,7 @@ package httpx import ( "time" - "github.com/giongto35/cloud-game/v3/pkg/config/shared" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" ) @@ -47,7 +47,7 @@ func HttpsRedirect(redirect bool) Option { func WithPortRoll(roll bool) Option { return func(opts *Options) { opts.PortRoll = roll } } func WithZone(zone string) Option { return func(opts *Options) { opts.Zone = zone } } -func WithServerConfig(conf shared.Server) Option { +func WithServerConfig(conf config.Server) Option { return func(opts *Options) { opts.Https = conf.Https opts.HttpsCert = conf.Tls.HttpsCert diff --git a/pkg/network/webrtc/factory.go b/pkg/network/webrtc/factory.go index 802da7c0..82088166 100644 --- a/pkg/network/webrtc/factory.go +++ b/pkg/network/webrtc/factory.go @@ -4,7 +4,7 @@ import ( "fmt" "net" - conf "github.com/giongto35/cloud-game/v3/pkg/config/webrtc" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/network/socket" "github.com/pion/interceptor" @@ -19,7 +19,7 @@ type ApiFactory struct { type ModApiFun func(m *webrtc.MediaEngine, i *interceptor.Registry, s *webrtc.SettingEngine) -func NewApiFactory(conf conf.Webrtc, log *logger.Logger, mod ModApiFun) (api *ApiFactory, err error) { +func NewApiFactory(conf config.Webrtc, log *logger.Logger, mod ModApiFun) (api *ApiFactory, err error) { m := &webrtc.MediaEngine{} if err = m.RegisterDefaultCodecs(); err != nil { return diff --git a/pkg/worker/coordinator.go b/pkg/worker/coordinator.go index 7df238a6..23d19675 100644 --- a/pkg/worker/coordinator.go +++ b/pkg/worker/coordinator.go @@ -5,7 +5,7 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/api" "github.com/giongto35/cloud-game/v3/pkg/com" - "github.com/giongto35/cloud-game/v3/pkg/config/worker" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/network/webrtc" ) @@ -27,7 +27,7 @@ type coordinator struct { var connector com.Client -func newCoordinatorConnection(host string, conf worker.Worker, addr string, log *logger.Logger) (*coordinator, error) { +func newCoordinatorConnection(host string, conf config.Worker, addr string, log *logger.Logger) (*coordinator, error) { scheme := "ws" if conf.Network.Secure { scheme = "wss" diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index ad6b611a..1f827faa 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -5,14 +5,14 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/api" "github.com/giongto35/cloud-game/v3/pkg/com" - "github.com/giongto35/cloud-game/v3/pkg/config/worker" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/network/webrtc" "github.com/goccy/go-json" ) // buildConnQuery builds initial connection data query to a coordinator. -func buildConnQuery(id com.Uid, conf worker.Worker, address string) (string, error) { +func buildConnQuery(id com.Uid, conf config.Worker, address string) (string, error) { addr := conf.GetPingAddr(address) return toBase64Json(api.ConnectionRequest[com.Uid]{ Addr: addr.Hostname(), diff --git a/pkg/worker/emulator/libretro/frontend.go b/pkg/worker/emulator/libretro/frontend.go index b9640a86..92c15843 100644 --- a/pkg/worker/emulator/libretro/frontend.go +++ b/pkg/worker/emulator/libretro/frontend.go @@ -8,7 +8,7 @@ import ( "sync/atomic" "time" - conf "github.com/giongto35/cloud-game/v3/pkg/config/emulator" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" @@ -21,7 +21,7 @@ type Frontend struct { input InputState - conf conf.Emulator + conf config.Emulator storage Storage // out frame size @@ -64,7 +64,7 @@ var ( ) // NewFrontend implements Emulator interface for a Libretro frontend. -func NewFrontend(conf conf.Emulator, log *logger.Logger) (*Frontend, error) { +func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { log = log.Extend(log.With().Str("m", "Libretro")) ll := log.Extend(log.Level(logger.Level(conf.Libretro.LogLevel)).With()) SetLibretroLogger(ll) @@ -105,15 +105,15 @@ func NewFrontend(conf conf.Emulator, log *logger.Logger) (*Frontend, error) { } func (f *Frontend) LoadMetadata(emu string) { - config := f.conf.GetLibretroCoreConfig(emu) + conf := f.conf.GetLibretroCoreConfig(emu) meta := emulator.Metadata{ - AutoGlContext: config.AutoGlContext, - HasMultitap: config.HasMultitap, - HasVFR: config.VFR, - IsGlAllowed: config.IsGlAllowed, - LibPath: config.Lib, - Options: config.Options, - UsesLibCo: config.UsesLibCo, + AutoGlContext: conf.AutoGlContext, + HasMultitap: conf.HasMultitap, + HasVFR: conf.VFR, + IsGlAllowed: conf.IsGlAllowed, + LibPath: conf.Lib, + Options: conf.Options, + UsesLibCo: conf.UsesLibCo, } f.mu.Lock() coreLoad(meta) diff --git a/pkg/worker/emulator/libretro/manager/manager.go b/pkg/worker/emulator/libretro/manager/manager.go index 9f77da3c..7b01d551 100644 --- a/pkg/worker/emulator/libretro/manager/manager.go +++ b/pkg/worker/emulator/libretro/manager/manager.go @@ -1,12 +1,12 @@ package manager import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" "os" "path/filepath" "strings" - "github.com/giongto35/cloud-game/v3/pkg/config/emulator" + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" ) type Manager interface { @@ -14,10 +14,10 @@ type Manager interface { } type BasicManager struct { - Conf emulator.LibretroConfig + Conf config.LibretroConfig } -func (m BasicManager) GetInstalled() (installed []emulator.CoreInfo, err error) { +func (m BasicManager) GetInstalled() (installed []config.CoreInfo, err error) { dir := m.Conf.GetCoresStorePath() arch, err := libretro.GetCoreExt() if err != nil { @@ -32,7 +32,7 @@ func (m BasicManager) GetInstalled() (installed []emulator.CoreInfo, err error) for _, file := range files { name := file.Name() if filepath.Ext(name) == arch.LibExt { - installed = append(installed, emulator.CoreInfo{Name: strings.TrimSuffix(name, arch.LibExt)}) + installed = append(installed, config.CoreInfo{Name: strings.TrimSuffix(name, arch.LibExt)}) } } return diff --git a/pkg/worker/emulator/libretro/manager/remotehttp/manager.go b/pkg/worker/emulator/libretro/manager/remotehttp/manager.go index fe214a31..aba54880 100644 --- a/pkg/worker/emulator/libretro/manager/remotehttp/manager.go +++ b/pkg/worker/emulator/libretro/manager/remotehttp/manager.go @@ -1,11 +1,11 @@ package remotehttp import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" "os" - "github.com/giongto35/cloud-game/v3/pkg/config/emulator" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/manager" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/repo" "github.com/gofrs/flock" @@ -22,7 +22,7 @@ type Manager struct { log *logger.Logger } -func NewRemoteHttpManager(conf emulator.LibretroConfig, log *logger.Logger) Manager { +func NewRemoteHttpManager(conf config.LibretroConfig, log *logger.Logger) Manager { repoConf := conf.Cores.Repo.Main altRepoConf := conf.Cores.Repo.Secondary // used for synchronization of multiple process @@ -55,7 +55,7 @@ func NewRemoteHttpManager(conf emulator.LibretroConfig, log *logger.Logger) Mana return m } -func CheckCores(conf emulator.Emulator, log *logger.Logger) error { +func CheckCores(conf config.Emulator, log *logger.Logger) error { if !conf.Libretro.Cores.Repo.Sync { return nil } @@ -95,7 +95,7 @@ func (m *Manager) getCoreUrls(names []string, repo repo.Repository) (urls []Down return } -func (m *Manager) download(cores []emulator.CoreInfo) (failed []string) { +func (m *Manager) download(cores []config.CoreInfo) (failed []string) { if len(cores) == 0 || m.repo == nil { return } @@ -132,7 +132,7 @@ func (m *Manager) down(cores []string, repo repo.Repository) (failed []string) { } // diff returns a list of not installed cores. -func diff(declared, installed []emulator.CoreInfo) (diff []emulator.CoreInfo) { +func diff(declared, installed []config.CoreInfo) (diff []config.CoreInfo) { if len(declared) == 0 { return } diff --git a/pkg/worker/emulator/libretro/manager/remotehttp/manager_test.go b/pkg/worker/emulator/libretro/manager/remotehttp/manager_test.go index 24e333ef..02b955fa 100644 --- a/pkg/worker/emulator/libretro/manager/remotehttp/manager_test.go +++ b/pkg/worker/emulator/libretro/manager/remotehttp/manager_test.go @@ -4,7 +4,7 @@ import ( "reflect" "testing" - "github.com/giongto35/cloud-game/v3/pkg/config/emulator" + "github.com/giongto35/cloud-game/v3/pkg/config" ) func TestDiff(t *testing.T) { @@ -39,9 +39,9 @@ func TestDiff(t *testing.T) { }, } - toCoreInfo := func(names []string) (r []emulator.CoreInfo) { + toCoreInfo := func(names []string) (r []config.CoreInfo) { for _, n := range names { - r = append(r, emulator.CoreInfo{Name: n}) + r = append(r, config.CoreInfo{Name: n}) } return } diff --git a/pkg/worker/emulator/libretro/nanoarch_test.go b/pkg/worker/emulator/libretro/nanoarch_test.go index ee6d317f..8de74be3 100644 --- a/pkg/worker/emulator/libretro/nanoarch_test.go +++ b/pkg/worker/emulator/libretro/nanoarch_test.go @@ -12,7 +12,6 @@ import ( "unsafe" "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/config/worker" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" ) @@ -50,7 +49,7 @@ func GetEmulatorMock(room string, system string) *EmulatorMock { rootPath := getRootPath() configPath := rootPath + "configs/" - var conf worker.Config + var conf config.WorkerConfig if err := config.LoadConfig(&conf, configPath); err != nil { panic(err) } diff --git a/pkg/worker/media.go b/pkg/worker/media.go index ae11df8c..6754d66d 100644 --- a/pkg/worker/media.go +++ b/pkg/worker/media.go @@ -4,7 +4,7 @@ import ( "sync" "time" - conf "github.com/giongto35/cloud-game/v3/pkg/config/encoder" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" "github.com/giongto35/cloud-game/v3/pkg/worker/encoder" "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/h264" @@ -68,7 +68,7 @@ func (b *Buffer) Write(s Samples, onFull OnFull) (r int) { // GetFrameSizeFor calculates audio frame size, i.e. 48k*frame/1000*2 func GetFrameSizeFor(hz int, frame int) int { return hz * frame / 1000 * audioChannels } -func (r *Room) initAudio(frequency int, conf conf.Audio) { +func (r *Room) initAudio(frequency int, conf config.Audio) { buf := NewBuffer(GetFrameSizeFor(frequency, conf.Frame)) resample, frameLen := frequency != audioFrequency, 0 if resample { @@ -107,7 +107,7 @@ func (r *Room) initAudio(frequency int, conf conf.Audio) { } // initVideo processes videoFrames images with an encoder (codec) then pushes the result to WebRTC. -func (r *Room) initVideo(width, height int, conf conf.Video) { +func (r *Room) initVideo(width, height int, conf config.Video) { var enc encoder.Encoder var err error diff --git a/pkg/worker/recording.go b/pkg/worker/recording.go index 9d1e7654..c912c16c 100644 --- a/pkg/worker/recording.go +++ b/pkg/worker/recording.go @@ -1,7 +1,7 @@ package worker import ( - "github.com/giongto35/cloud-game/v3/pkg/config/worker" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" "github.com/giongto35/cloud-game/v3/pkg/worker/recorder" ) @@ -11,7 +11,7 @@ type RecordingRoom struct { rec *recorder.Recording } -func WithRecording(room GamingRoom, rec bool, recUser string, game string, conf worker.Config) *RecordingRoom { +func WithRecording(room GamingRoom, rec bool, recUser string, game string, conf config.WorkerConfig) *RecordingRoom { rr := &RecordingRoom{GamingRoom: room, rec: recorder.NewRecording( recorder.Meta{UserName: recUser}, room.GetLog(), diff --git a/pkg/worker/room.go b/pkg/worker/room.go index eba8227c..16846951 100644 --- a/pkg/worker/room.go +++ b/pkg/worker/room.go @@ -4,8 +4,7 @@ import ( "time" "github.com/giongto35/cloud-game/v3/pkg/com" - conf "github.com/giongto35/cloud-game/v3/pkg/config/emulator" - "github.com/giongto35/cloud-game/v3/pkg/config/worker" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" @@ -42,7 +41,7 @@ type Room struct { log *logger.Logger } -func NewRoom(id string, game games.GameMetadata, onClose func(*Room), conf worker.Config, log *logger.Logger) *Room { +func NewRoom(id string, game games.GameMetadata, onClose func(*Room), conf config.WorkerConfig, log *logger.Logger) *Room { if id == "" { id = games.GenerateRoomID(game.Name) } @@ -110,7 +109,7 @@ func (r *Room) EnableAutosave(periodSec int) { } } -func (r *Room) whatsFrame(conf conf.Emulator) (ww int, hh int) { +func (r *Room) whatsFrame(conf config.Emulator) (ww int, hh int) { w, h := r.emulator.GetFrameSize() // nwidth, nheight are the WebRTC output size var nwidth, nheight int diff --git a/pkg/worker/room_test.go b/pkg/worker/room_test.go index 374fa468..0dc73d4c 100644 --- a/pkg/worker/room_test.go +++ b/pkg/worker/room_test.go @@ -17,7 +17,6 @@ import ( "time" "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/config/worker" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" @@ -206,7 +205,7 @@ func dumpCanvas(frame *image2.Frame, name string, caption string, path string) { func getRoomMock(cfg roomMockConfig) roomMock { cfg.game.Path = cfg.gamesPath + cfg.game.Path - var conf worker.Config + var conf config.WorkerConfig if err := config.LoadConfig(&conf, whereIsConfigs); err != nil { panic(err) } @@ -249,7 +248,7 @@ func getRoomMock(cfg roomMockConfig) roomMock { // fixEmulators makes absolute game paths in global GameList and passes GL context config. // hack: emulator paths should be absolute and visible to the tests. -func fixEmulators(config *worker.Config, autoGlContext bool) { +func fixEmulators(config *config.WorkerConfig, autoGlContext bool) { rootPath := getRootPath() config.Emulator.Libretro.Cores.Paths.Libs = diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 46d25926..0af214cb 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -3,7 +3,7 @@ package worker import ( "time" - "github.com/giongto35/cloud-game/v3/pkg/config/worker" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/monitoring" "github.com/giongto35/cloud-game/v3/pkg/network/httpx" @@ -13,7 +13,7 @@ import ( type Worker struct { address string - conf worker.Config + conf config.WorkerConfig cord *coordinator log *logger.Logger router Router @@ -23,7 +23,7 @@ type Worker struct { const retry = 10 * time.Second -func New(conf worker.Config, log *logger.Logger, done chan struct{}) (services service.Group) { +func New(conf config.WorkerConfig, log *logger.Logger, done chan struct{}) (services service.Group) { if err := remotehttp.CheckCores(conf.Emulator, log); err != nil { log.Error().Err(err).Msg("cores sync error") } From e10490adda9727123c167f2419a5576c16f6a861 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 23 Apr 2023 13:41:40 +0300 Subject: [PATCH 011/361] Remove ca-certificates from the Docker image --- scripts/install.sh | 1 - 1 file changed, 1 deletion(-) diff --git a/scripts/install.sh b/scripts/install.sh index e9b0df42..c1ffce9e 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -9,7 +9,6 @@ fi apt-get -qq update apt-get -qq install --no-install-recommends -y \ - ca-certificates \ libvpx7 \ libx264-164 \ libopus0 \ From 3bd32715cb4b22d8a20cf40bb7c2529ea1c33009 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 23 Apr 2023 19:55:39 +0300 Subject: [PATCH 012/361] Remove unused fonts --- web/css/main.css | 27 +++++++-------------------- web/fonts/6809 chargen.ttf | Bin 286972 -> 0 bytes web/fonts/6809-Chargen.woff2 | Bin 0 -> 32960 bytes web/fonts/8-Bit-Madness.ttf | Bin 9764 -> 0 bytes web/fonts/Roboto-Regular.ttf | Bin 171272 -> 0 bytes web/fonts/Roboto-Thin.ttf | Bin 171500 -> 0 bytes 6 files changed, 7 insertions(+), 20 deletions(-) delete mode 100644 web/fonts/6809 chargen.ttf create mode 100644 web/fonts/6809-Chargen.woff2 delete mode 100644 web/fonts/8-Bit-Madness.ttf delete mode 100644 web/fonts/Roboto-Regular.ttf delete mode 100644 web/fonts/Roboto-Thin.ttf diff --git a/web/css/main.css b/web/css/main.css index 8b169e92..9b9e8ebb 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -1,3 +1,8 @@ +@font-face { + font-family: '6809'; + src: url('/static/fonts/6809-Chargen.woff2'); +} + html { /* force full size for Firefox */ width: 100%; @@ -20,10 +25,6 @@ body { width: 556px; height: 286px; - /*-webkit-box-shadow: inset 0px 0px 2px 2px rgba(219, 222, 222, 1);*/ - /*-moz-box-shadow: inset 0px 0px 2px 2px rgba(219, 222, 222, 1);*/ - /*box-shadow: inset 0px 0px 2px 2px rgba(219, 222, 222, 1);*/ - position: absolute; top: 50%; left: 50%; @@ -515,7 +516,6 @@ body { height: 36px; background-color: #FFCF9E; opacity: 0.75; - font-family: 'Roboto'; top: 50%; left: 0; @@ -534,16 +534,6 @@ body { } -@font-face { - font-family: 'Roboto'; /*a name to be used later*/ - src: url('/static/fonts/Roboto-Regular.ttf'); /*URL to font*/ -} - -@font-face { - font-family: '6809'; /*a name to be used later*/ - src: url('/static/fonts/6809 chargen.ttf'); /*URL to font*/ -} - .menu-item { display: block; position: relative; @@ -551,9 +541,8 @@ body { width: 100%; height: 36px; /* 35 + 1 border = 36px */ - font-family: '6809'; + font-family: '6809', monospace; font-size: 19px; - /* border-top: 1px dashed blue; */ } .menu-item div { @@ -565,8 +554,6 @@ body { top: 5px; width: 226px; height: 25px; - - /* background-color: yellow; */ } .menu-item div span { @@ -663,7 +650,7 @@ body { display: block; margin-top: 10px; text-align: center; - font-family: 'Roboto'; + font-family: 'Arial', sans-serif; font-size: 15px; color: #bababa; diff --git a/web/fonts/6809 chargen.ttf b/web/fonts/6809 chargen.ttf deleted file mode 100644 index bb8160875b6d3b067afb6329e84c5a20128786bf..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 286972 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

F+^ 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
`lOYzn!}uhh`ncSU7W=SrjmzAy5G|@swIcNa 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 diff --git a/web/fonts/6809-Chargen.woff2 b/web/fonts/6809-Chargen.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..57531aad23f91c0a76458dd1f0368ca0839da34d GIT binary patch literal 32960 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 z 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 diff --git a/web/fonts/Roboto-Thin.ttf b/web/fonts/Roboto-Thin.ttf deleted file mode 100644 index 4e797cf7ef9758a9209fae4e0b07e6b186b2c69d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 171500 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 z zOo9(|yc~T#`9gAaa!s<9|6w*K-$!rt!{m;{?EBxD{D`&HceC!b#EW?FXq5N*jkXGV zB}v}ncf!A#=&fE&USqs5d;f2mmYdH$hjSorx+_=VdZCjVgQueL?ie@0O-AoD#WlKS zH&-sjFZ%kThj!V3Hs@P%gWM?JmYZawWF?1Ar!)1~Ui8*3x1iIx4gJjz(A8`~FLO7V zn5}4C?nlG&p!`f8mPgRCJSxAG$7C4@8|pbfqt+b>JRbnNAqzw`i?J`(<|NcQhTqM!GBj>q$d{0_gX0*?L(+v+07e7p;Mndp&Ryhn4Xa&NC51Z~zUv)S{*$HAQ!Pfm z0LMjl_@Ouoerm;rr z#Y{BH&xXnKhL;yZdNf{1m;N&_D_;V3FvG25R(vqhf#GQ7$04WpU~_V<|0K{e$Zlnjx#>>5V47Trv^OTQV?=BfAg9h>vjA^ryz&tcSK zgOnV11k5{W+LEW~tCkmih|y&2%^C_|C+kU!rW=6i)3}Rp7y1ONVS49>xyqqSAO<}g zxyxF~c!bp$A@=7Mi+;tP^eQ0y5ooma4LS4>Ms+!#7$@Y=b{S>sfmyU&)>`&VJJc|d z|27he{AYDf`L8q7-LBqQuGJ}r*2>EL7BGv}%BVUP*r8ts#⪼1irKO40j0qy1+I1 zZ{TyXFWl)rLYkDHo(eI~gqZ&fF|oFL4UZ1T$}8ok7ee}%Li$@RR@VWuXz8t`%G<@B zM-Hu+(N8U*zZuvm#@!vd0T}7Oolq$ky=~Xtg?m^}?Lq@(Y13z!3Gux{{0}Xj!?>t6 zVE!v$$|mLyA-fKt4;Mm57D8w@i7jn)_?6XDfSvLv zutWb9xT!Ry&IXgy1;8$y3(Vr#+o<_Cu%j&H956Zl7`2r1fLZ<^wUlQ8%Tq1_lhY-@ zE*_z>&xGOP<4 z!}vCiRX^CBVWkhgN|*&5#4M;8y~s4?KDMrJ9^;hFd4?xz*pE!EWdAVppU<+o$UHrM zgc;D)jAQGP>#>ruoqa6#%)g`HkRW5mQ=CZ+Bi2?IR^XqlGEG^aW1|LB9+8%t6S zC$@%KH-J~SnKbB?32h-{l&CY_wvgRvR`L}>h1xmuN9ky>Qryyj+gyfwIpFXyS!jbH zteZK~JUA9G)nG=5r4d?nT1gClPs_=y?m0!K$fsR!%VJX1u=48&p6O^> zKF(#E@-x?B*{mp#C9+hEHqTRTk_$`9AAwJtIWk{n$#j`1Gi0vJmNR9Zv`V8i$y8~U z7T)_qWT99OW~BlW#Y7g#BG%n3lV#|iuU7jbym&uK)azs!_%G_0^cuZZ7U^33GG(<; zS`#Ion+%eLl-Wp$k}q+(%;&9ERtmJ7Swh)tsG0+JmilotFOCP2%jPDOmr~3ZV#&J<=H^lghJGJn{TBSAVMZ3*sJ(9JL z%`uDov4$(W1CcZ0Y~E=p+QYSJ43K=f>)drj-{bD3)CM`67Ea3$R^wH>d)<%SJ;c19 o8QozrO#Y5E#T0{h3dbj(#4GJ8IYB1MB$+HH%1M-LZNiiKBS^I^fB*mh From 9bb0c151a9e6b922ec9d8b9cb111f944c92dda75 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 23 Apr 2023 20:49:29 +0300 Subject: [PATCH 013/361] Compress apps for Docker --- Dockerfile | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Dockerfile b/Dockerfile index 984caa5d..168d6b58 100644 --- a/Dockerfile +++ b/Dockerfile @@ -17,6 +17,7 @@ RUN apt-get -qq update && apt-get -qq install --no-install-recommends -y \ make \ pkg-config \ wget \ + upx \ && rm -rf /var/lib/apt/lists/* # go setup layer @@ -38,6 +39,9 @@ COPY Makefile . COPY scripts/version.sh scripts/version.sh ARG VERSION RUN GIT_VERSION=${VERSION} make build +# compress +RUN find ${BUILD_PATH}/bin/* | xargs strip --strip-unneeded +RUN find ${BUILD_PATH}/bin/* | xargs upx --best --lzma # base image FROM ubuntu:lunar From ece1efad16c8c431d8b99bc619001c6816974325 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 23 Apr 2023 23:51:38 +0300 Subject: [PATCH 014/361] Add optional static linking with vpx, x264, opus --- Dockerfile | 2 +- pkg/worker/encoder/h264/libx264.go | 1 + pkg/worker/encoder/opus/opus.go | 1 + pkg/worker/encoder/vpx/libvpx.go | 1 + scripts/install.sh | 20 ++++++++++++++------ 5 files changed, 18 insertions(+), 7 deletions(-) diff --git a/Dockerfile b/Dockerfile index 168d6b58..1b203c63 100644 --- a/Dockerfile +++ b/Dockerfile @@ -49,7 +49,7 @@ ARG BUILD_PATH WORKDIR /usr/local/share/cloud-game COPY scripts/install.sh install.sh -RUN bash install.sh && \ +RUN bash install.sh x11-only && \ rm -rf /var/lib/apt/lists/* install.sh COPY --from=build ${BUILD_PATH}/bin/ ./ diff --git a/pkg/worker/encoder/h264/libx264.go b/pkg/worker/encoder/h264/libx264.go index ac6d944d..dfec2be8 100644 --- a/pkg/worker/encoder/h264/libx264.go +++ b/pkg/worker/encoder/h264/libx264.go @@ -3,6 +3,7 @@ package h264 /* #cgo pkg-config: x264 +#cgo static LDFLAGS: -l:libx264.a #include "stdint.h" #include "x264.h" diff --git a/pkg/worker/encoder/opus/opus.go b/pkg/worker/encoder/opus/opus.go index 7d42b6c8..2fd4a0bb 100644 --- a/pkg/worker/encoder/opus/opus.go +++ b/pkg/worker/encoder/opus/opus.go @@ -2,6 +2,7 @@ package opus /* #cgo pkg-config: opus +#cgo static LDFLAGS: -l:libopus.a #include diff --git a/pkg/worker/encoder/vpx/libvpx.go b/pkg/worker/encoder/vpx/libvpx.go index 7db5a2e6..468e4d8d 100644 --- a/pkg/worker/encoder/vpx/libvpx.go +++ b/pkg/worker/encoder/vpx/libvpx.go @@ -2,6 +2,7 @@ package vpx /* #cgo pkg-config: vpx +#cgo static LDFLAGS: -l:libvpx.a #include "vpx/vpx_encoder.h" #include "vpx/vpx_image.h" diff --git a/scripts/install.sh b/scripts/install.sh index c1ffce9e..edfb14b5 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -1,5 +1,7 @@ #!/usr/bin/env bash +deps="$1" + echo This script should install application dependencies for Debian-based systems if [ $(id -u) -ne 0 ] then @@ -8,11 +10,17 @@ then fi apt-get -qq update -apt-get -qq install --no-install-recommends -y \ - libvpx7 \ - libx264-164 \ - libopus0 \ - libgl1-mesa-dri \ - xvfb +if [ "$deps" = "x11-only" ]; then + apt-get -qq install --no-install-recommends -y \ + libgl1-mesa-dri \ + xvfb +else + apt-get -qq install --no-install-recommends -y \ + libvpx7 \ + libx264-164 \ + libopus0 \ + libgl1-mesa-dri \ + xvfb +fi apt-get clean apt-get autoremove From 62fc68e88b4b859f12c42c83862bc13154c4911a Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 24 Apr 2023 00:16:00 +0300 Subject: [PATCH 015/361] Add optional static linking with vpx, x264, opus --- Dockerfile | 2 +- Makefile | 3 ++- pkg/worker/encoder/h264/libx264.go | 2 +- pkg/worker/encoder/opus/opus.go | 2 +- pkg/worker/encoder/vpx/libvpx.go | 2 +- 5 files changed, 6 insertions(+), 5 deletions(-) diff --git a/Dockerfile b/Dockerfile index 1b203c63..ce75b1b7 100644 --- a/Dockerfile +++ b/Dockerfile @@ -38,7 +38,7 @@ COPY cmd ./cmd COPY Makefile . COPY scripts/version.sh scripts/version.sh ARG VERSION -RUN GIT_VERSION=${VERSION} make build +RUN GIT_VERSION=${VERSION} make GO_TAGS=static,st build # compress RUN find ${BUILD_PATH}/bin/* | xargs strip --strip-unneeded RUN find ${BUILD_PATH}/bin/* | xargs upx --best --lzma diff --git a/Makefile b/Makefile index af45bf55..8341821d 100644 --- a/Makefile +++ b/Makefile @@ -4,6 +4,7 @@ ROOT = ${REPO_ROOT}/${PROJECT} CGO_CFLAGS='-g -O3 -funroll-loops' CGO_LDFLAGS='-g -O3' +GO_TAGS=static fmt: @goimports -w cmd pkg tests @@ -21,7 +22,7 @@ build: mkdir -p bin/ go build -ldflags "-w -s -X 'main.Version=$(GIT_VERSION)'" -o bin/ ./cmd/coordinator CGO_CFLAGS=${CGO_CFLAGS} CGO_LDFLAGS=${CGO_LDFLAGS} \ - go build -buildmode=exe -tags static \ + go build -buildmode=exe $(if $(GO_TAGS),-tags $(GO_TAGS),) \ -ldflags "-w -s -X 'main.Version=$(GIT_VERSION)'" $(EXT_WFLAGS) \ -o bin/ ./cmd/worker diff --git a/pkg/worker/encoder/h264/libx264.go b/pkg/worker/encoder/h264/libx264.go index dfec2be8..9b1d9ba2 100644 --- a/pkg/worker/encoder/h264/libx264.go +++ b/pkg/worker/encoder/h264/libx264.go @@ -3,7 +3,7 @@ package h264 /* #cgo pkg-config: x264 -#cgo static LDFLAGS: -l:libx264.a +#cgo st LDFLAGS: -l:libx264.a #include "stdint.h" #include "x264.h" diff --git a/pkg/worker/encoder/opus/opus.go b/pkg/worker/encoder/opus/opus.go index 2fd4a0bb..95b111f1 100644 --- a/pkg/worker/encoder/opus/opus.go +++ b/pkg/worker/encoder/opus/opus.go @@ -2,7 +2,7 @@ package opus /* #cgo pkg-config: opus -#cgo static LDFLAGS: -l:libopus.a +#cgo st LDFLAGS: -l:libopus.a #include diff --git a/pkg/worker/encoder/vpx/libvpx.go b/pkg/worker/encoder/vpx/libvpx.go index 468e4d8d..23ca371a 100644 --- a/pkg/worker/encoder/vpx/libvpx.go +++ b/pkg/worker/encoder/vpx/libvpx.go @@ -2,7 +2,7 @@ package vpx /* #cgo pkg-config: vpx -#cgo static LDFLAGS: -l:libvpx.a +#cgo st LDFLAGS: -l:libvpx.a #include "vpx/vpx_encoder.h" #include "vpx/vpx_image.h" From 229cd4044ca4cf4eb156a096b4f8c45201613192 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 24 Apr 2023 14:16:25 +0300 Subject: [PATCH 016/361] Fix broken warning in the wrtc js module --- web/js/network/webrtc.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/js/network/webrtc.js b/web/js/network/webrtc.js index 218e9e75..4a3d3605 100644 --- a/web/js/network/webrtc.js +++ b/web/js/network/webrtc.js @@ -85,7 +85,7 @@ const webrtc = (() => { case 'gathering': log.info('[rtc] ice gathering'); timeForIceGathering = setTimeout(() => { - log.warning(`[rtc] ice gathering was aborted due to timeout ${ICE_TIMEOUT}ms`); + log.warn(`[rtc] ice gathering was aborted due to timeout ${ICE_TIMEOUT}ms`); // sendCandidates(); }, ICE_TIMEOUT); break; From 494979cf383c2de386bddf28ad105de4590d592f Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 26 Apr 2023 20:08:20 +0300 Subject: [PATCH 017/361] Optimize images --- web/css/main.css | 14 ++------------ web/css/ui.css | 2 -- web/img/background.jpg | Bin 141633 -> 89792 bytes web/img/help_overlay.png | Bin 9424 -> 7453 bytes web/img/screen_background5.png | Bin 21336 -> 15120 bytes web/img/ui/FramePlayerIndex.png | Bin 2322 -> 1570 bytes web/img/ui/FrameTEXT.png | Bin 918 -> 640 bytes web/img/ui/Help.png | Bin 3971 -> 2019 bytes web/img/ui/bg.png | Bin 372145 -> 0 bytes web/img/ui/bong full.png | Bin 10010 -> 6611 bytes web/img/ui/bong.png | Bin 1289 -> 1059 bytes web/img/ui/bt A.png | Bin 5086 -> 3534 bytes web/img/ui/bt B.png | Bin 5400 -> 3480 bytes web/img/ui/bt LOAD.png | Bin 3224 -> 2396 bytes web/img/ui/bt MOVE EMPTY.png | Bin 9912 -> 5063 bytes web/img/ui/bt MOVE.png | Bin 15016 -> 9051 bytes web/img/ui/bt OPTIONS.png | Bin 3947 -> 2515 bytes web/img/ui/bt PlayerIndex.png | Bin 1857 -> 1183 bytes web/img/ui/bt QUIT.png | Bin 2059 -> 1476 bytes web/img/ui/bt REC.png | Bin 3837 -> 1979 bytes web/img/ui/bt SAVE.png | Bin 3697 -> 2667 bytes web/img/ui/bt SELECT.png | Bin 2573 -> 1861 bytes web/img/ui/bt SHARE.png | Bin 2777 -> 2009 bytes web/img/ui/bt START.png | Bin 2613 -> 1883 bytes web/img/ui/bt X.png | Bin 5162 -> 3556 bytes web/img/ui/bt Y.png | Bin 4964 -> 3355 bytes web/img/ui/frame.png | Bin 3084 -> 2678 bytes web/js/gui/gui.js | 5 ++++- web/js/workerManager.js | 20 +++++++++++++------- 29 files changed, 19 insertions(+), 22 deletions(-) delete mode 100644 web/img/ui/bg.png diff --git a/web/css/main.css b/web/css/main.css index 9b9e8ebb..294a800e 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -31,20 +31,10 @@ body { margin-right: -50%; transform: translate(-50%, -50%); - background-image: url('/static/img/ui/bg.png'); - background-repeat: no-repeat; - background-size: 100% 100%; -} - -#ui-emulator-bg { - width: 100%; - height: 100%; - display: block; - position: absolute; - - background-image: url('/static/img/ui/bg.png'); + background-image: url('/static/img/ui/bg.jpg'); background-repeat: no-repeat; background-size: 100% 100%; + border-radius: 22px; } #help-overlay { diff --git a/web/css/ui.css b/web/css/ui.css index 227a6ec2..41f70879 100644 --- a/web/css/ui.css +++ b/web/css/ui.css @@ -139,8 +139,6 @@ z-index: 1; position: relative; - opacity: .95; - cursor: default; } diff --git a/web/img/background.jpg b/web/img/background.jpg index 68df6eecdffe17d738bcdecb426285b58d752a06..1f726014792ee979ab5f5a2b131e9da3870aff2f 100644 GIT binary patch literal 89792 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

{TP>^;o5K`Sfrp{pK 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

LDstV_pCn$Pu=5sZ3i3}YOO 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 E)@_xfwL`MNzjG&H9l+{`oq`j%GvBzveik^GEu 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Ⓢ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 E+3-}RasU7T diff --git a/web/img/help_overlay.png b/web/img/help_overlay.png index 20c006d258f0f8d01c4f57ce454cc8f214eb418c..256d32378227923aa3e287af80078cc10d155528 100644 GIT binary patch literal 7453 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 literal 9424 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 GgZ~erIMk&8 diff --git a/web/img/screen_background5.png b/web/img/screen_background5.png index 6222bea896f47bf648579bebc9305773dc534eb3..f1017218e7575dc8561371753a45575733762878 100644 GIT binary patch literal 15120 zcmW+-cRZWl_YZ1sV$?3JSy9!Bnx9g%Myr$mn{R$ zWeaDkx*PyN&1+)xO!x9p6L6)F8lVASxnSbIVCA^rXTP|{DGcCcqM^CaY<0 zo(Wudh+NnUivxK10K69FDwNvlz|s0F>io~0D%62R{G*G z|Aj8!g{z1PfK?X2n*_Li5q9n3^9@D7l?!PuDFD+o0MmuDa1nsx;;r}vROo{K+C_n+ z3qa^1QQ{&}{4L-b93Xtb#ij@lZ~zDf19;dkC2fV$08%2f097iQM^smy0|Zq7B9Z`J z4{FAI0H-N{Z;Xml55SQFkhuvEkfNqC1JFYO0@eV=b{eJz0JAQDG2jaIArDgm^_2!r zzydX0B-ND^YU*NutRsN62Eg^1n%V(y=a8O}LPJ|hN9_&Zl;Qw5QBhaYQNtJjIvjuj z209dgvk$_u}2f&p8)jU*4VLst_Q97f=S^*1HBU zWdT?L6i^ye<+rH68PLp%(DaK_FWsSSxk2T^3D5&v50wCnsM6Re0-gY5pGpJvbm;MB zG&?uwT3l#a)Tn2vt}Q&KJxpTFFrzl*2ebo3Qnjf?L_`vlsGf@edY{t0(Wf48rUwFn zhZanSN{l~jX=?%3$j&s9l9C%Jx(!$6`EbVLAf~er-U5K=sSDePAA^E|!qCuAety2a zy?s(rlCQ5X7K^1&C`Lv`8X6ksb_6^Cpi=Yb!To0e6KllrC*1di=r_&XJ-^XAd^8Xf zF*Hqn;2;h!pe1r8x5&9@aPbs~Q$39kNNE2O(avAMzC9Z$AabOYU8-bL+(hZE{!zNl zzV&D4V|i86QSDrHv4*iIP*t)ieQ@njD+12`fmQfl^~9H1dTkG)^TYtc;jb#$IeSF# z`rITx$W03JM%UQj@{U=k{#dUWNj>gCMvvafA?|p6;$Mhb#s?5YT>-r{Vk*xVjT<(HA(nNLVQ zh91n?KE>(sDa$1Z2b}tvJj$M}%r72i%L1A7msu*8Z+z_9V?RIhrn*Y<>8nIyWj9K5EoYNI`TE|`TB9U3^uR$u7mLJSF`266_ z$Ef>%ce?j9pto-ldg)T5q41x2HGe0+YWWT**@Rgk$7y=7Kr?Jcjs8{P0~haCqHJ$+ zrlhH60ifZ+KfbOq&e10>f%Ald&#gT}3WQ3>-++TH@*j1B^L`ttIAtzG-y{{3C|qdD@Lde{kTQDVk}n6BV+}Fw`t9NmUM9?bI5I+YeE!EqTsTh8smpmP zQxu_w{lHaqG?Bs6Drg#)X#416hV+bp@KvUZL`@&Rb7uVC%GXmMtGMymeN(8SKfl7W zxGnH*0yk83v=iKldNXr-qT%1pdVO?p>^!Zf#u}$hf$6I-4*$$b*=biV6(PC($igw- zq{;pk)T-74Q7&jpecG0$kk<#5%}hhhOMQLst4TQVY#9H<+y@U(LpI^xI!->!#Vr|3 z|1;NSfbu@@I)gL{Q$~jVOQAS>sTei=*3t4WXm;{;T0I>;@ePm)<9wDe)sW!7Y(F<) z#KCtWLb$u`0i=w6QudcD>d=od>B&72llQ4ZWNvBOLyrqx{`iM&=6{7w+CfMC@1b8t zXJtHM{k>MQYb&|9Y+2R?yH}PkH*hk$a^2*bdJ)z^8a-RaJ2tyt z%G7aw)u{vtMl|Z7_I8tC2Bk|yv>U+Y_=Uj0XFm5RXjnb}22%N+|17r{`i-tv{TdSG z#+y;^ncOcgJ~;wFHS&za#&2PNb?y`I<`Ah^ zA=?%=UL9t(nvWOeLW-)HuBpuw==<~KYJ3KBO3}PsJ=P@AB1vxdNnS?6U|mh0>G$K+ zys(9?f%^AE&!<0utNr<q}M#Og#Iq22c%SJ>5TiWf>jHsf|5YcPB+UW~+2 zS#1kvjJr)=i(uCGXJ0%^y;#L_fSmd6r0pyFVM_s^KJ=`4a_Jwr<;?ytUCo zRovcCJo;b5%eS0@prG|pkFP+-pT`VVe}dlMcvZ~=PKOmuPKDUj;!Tz%cH%Xz^*iDF z7|UG)$@h4n3C2N!NjC2a#{h>94QT_wrnXjb-+=zN}j4HFVfz{&x;`CSf4TfQXGbWf2zAwGm%iMZ6j zI`Ng{WoHa=hHO1P3l|i+3Tv;o%&|Ef=9b6ZpWe{QPN#35&$j#t)FCw_w)O;@S08^b z?aL;cIY=PY%Ha>8I-@VAIJZrriww&UUZK0|?T%Mz81a>;830 zUT%LueGqstr19iMH*Ry4<3`^+7XAY2d7{x7C>U<2DWQ9S9WoyuuC4gu5#WP)1ZzKu zo^3B-K2W}nrN+D%o&++Y1HO#wrj14P-@xi!8a6lSbAlBg#pAF7kmg{5Fk_gb7Np^a z9g5$VQpYht1~t5*<}P0_RzjaSo|Q2a)5976P zKjFdH#y6-MyJvCV?}GV$%{x{lnoFe_KlHfp%3f#-x!qcW)9R_^KV1XuPhY%|og}`)h`Dzx7X+uLh=*adZudxG#J3 zp7WLuFcQM|a4S5F{G-- zI95?^=d-sa0Adk_2qeHc{Bv2eG|*$b>fI%@5>U9I6b7e_YQreTN89^_u6RH6k$^h_ zAuH`MHXjnna%#jDNB7dfDDbJcedDd0Nt!v&Pl*X;2S3Bnte{QRDEINnZwm0i$?^cw z5|)Q+YH)#n;GPZ{zoFVp0mdJlB zPp8KzdQV`tClj~U5KWrx3x)iLw1nfU<@P=;(e`Zj?oane`$vqP`r1WL2Ez`YAwzad zS=xI{rkAhwx|?Ov^TqU$lZ5`9)RD~m>k~m5p!6eI3i6U%s62{&`z@Br1o0voGA=zq-73n!l;G&RrB% zvx-|)y^d)h+E&~oY!`>$iyTTlAMt&+q-GfKo`&Ywb%OF?f8!tf)Zwe_&DMT%EYc_2 zCmSipR+ydxC&_;bwNpa}KIt*sJ?x=UFX@YUcw^bB9-dEsMh7FyA zrGY(#+0=DJoRdAY5l2@Sr*%g?G;R|&eP;%Uy;bh*v+O1Y8d^xLnWnS(x12T}@n?Nb zi2y7o)4uPy#%_DxFZPbAc*9!?y|s^E3G9xKO3DP}{BguuhE>7&Hy8C>5LI;@wR&97RL%L(BzRKk1 z?>x4BfnRvyS}+yAN!f>`w=`$I8wwk z-8e%RviTtvtcU;6k8+t-Hz2-nMCJ~9PRgYgTC%AvR9bCHD}>r{tXA@D^wcl(HNQox zp)H;A<9C%A;D*>90+Loiu6uLIz}BPr9`xQC@oo~jTGuE0qajjmKP{vAW4bJ1wvb8b zI&S-;f#CF7>K;0N2}kCFl>v2>XKuch`)FvW`07ZYJVp@a@P#8Oi2mL!7wn%lXTH#5 zdCcS|2O+*!-aSZjd%tJfb9@h2PzoO7pWB7}=w|pameuWhlm9_$pCKX<@1p!sEdlL> zD!~N4j%eTKKe(qB+O^Is3@avcSV2CP91W~VrN2_~iQ%xqm`+^2)i-uKNkqrI@TtNcmu$`))&WtUUY$GwkP zfb;phCqU`)Wp|tZvUqGS=_~w@g`&u}@wh ze{cO?S0D_hQvPF-!XMnpMqy5X4DQK$I@O37DrQaVkHY4V$r-MtfwpT_aaXoJcg+JCO zoFsv115CsQ$n&yoE}I{~9jT7r^h{Q5dW&mOD4%4lu;9ps2nt<`uFuv>yT(_ZDP;md zPDguxW-S@O_mQRe?Vq^e9=ybNf{xL`zMEIdSzC+ zZ0DkmLkKNUmF0t!tag=4ESElD<1mk9Qeodi@2)QwjX#PS&8-rc{OV%^%a=ns`EbI7 zFlnD0POm$MXKh@(>#w{k?a8yj0+oNEgLs~*U=n44e5Oe=ndsqG*yLS`*j;KQeI`2S zraHK)-0x3WEw`<@7ItVzlAS&~pk@GX7j_;|?Z;?w9N;Zx#`;h`GronOBxX_G2Z)a` z9+7{yBWu}9(|$8jSV%)CHNDEM7ccjv(bjXUVgGg9D!QA@n!EE>KkcSI^rPv`Z&t-m z-m-ghT{)N?#@38(*{UOwmE*#jB0z5m!o!&zF+HeXelS<}FU+Fe@h%ANE6cxE5cbs> zpoqy<&%I5wPq3=c&eiU>&BLg(^ke6`r)}G|-m*Qk3b4o6e@8|v?5)V1K{Dri$=ucE+JYZISLGAJuUKyraWmnje*J_fPAMb>8qa`)VzQ zZ4S)Z8u?^5*!)lOm`OG9;5YEtK6B@%x;pL(WK$fc`Fis4Dzty{zdw62=xx?*74#ge z{xA2!p49iUUb*LAmh_dEx_*u!D7$ zx?O3C{G;udRm6aJBJ(WHH&gEbyYtpm1;@nqR~I=+NPNc>A=nG2=!9prc+N=T5a1s4 zUN-4P%gq_?X3j!0NAHjim?v{{{kr}z{H2|z`~g!3_lbTlc=65VFQdhRK9G2E3?O;J z&!rgDpyN_{hl%Jt&HkeqJxF%D&!ta^*GA_{6K4OFcw7sLK-67HOL4ID85c;;R@Zln z8fXm85?8VHx7~isMZ6eBclr84m##~eMyIWac<;#8dvHNMIWQRrj0DTh=tC#L=qYZq)` zrEU$%W`i{suRa$3V_>^EHKH)7cMz?ke;_Y$i4fDWcfV;umtIM9#4o3vYFY)6DYo3{ zYg*t(0b6|CcbrN`k95Y*HrQEA`3UlmiA&k{O!nbfPqCl;=}0N=J&S3d`;2?pzIcnI zy&3WiU2nT{)+^CRp}-6BOUcR|m(*sFBd^Oy8a)=cb0!m>^JIddwPYgHMh||%W zjC$Z-{SWoQUwqq4KxoSNcJ#a1Ontr!ACjlKn!)rBWg zBJnGC_P^t?xkOtOYqk z{jn4oPgj^;eItHfnFaHoXTkIPa&IGP@Jc_DenI=`3xbA5Lw__!7o2S4*b}6E&xI^W z)65a&_cm-^*kiw%{p`@ln5)-@#P6SJZqAw*Q;=&$%wjn2#(hVvoYu|?_r~?NraQ0$ z+gVi9!Fhvzm?`XNmsyzi7mam;=}lNbcGtD;g=3f4 z{;hOZe@mnUi*9-_ZacO_kVtH*`9o*>J$+uevLS5&8JDDnp}`r1h{|$qV67Rxs(PSOe)UrfqH$-*6yKy7TFeGVRIq$C4DF_dy`*(3+jJPcyP)WfpF0gso^X{_Zx?jP*10A z*h3H0m#$mlEhP+HGtd`zxa@Ug;%$7TlaZJe3LW^!R78!5zW(g(9N z^K}P)cdplQo4&7A9N`&q z=d98iz{VU2y9Vu(!WXM3$Pnygvi+-HDBHepoU^J~g{RGO7JkB{kZ|ibcFhBPfUN>s z+AAg&J{bZK{uM*T##}SAx#QiI%Vit*x4}+jFhW^%htDtvv70+bW-aO(8NQ>OU(GYd zx2cxg6iVIK7;6mbD1*d3vL2s&@$R22)YmUCIoM0mP|>IVO>ITIPB?qnyTHslstIZ2 zV-b9CuOV{XAC|Ozjvg1S#MNWRz*i9o@CsFC4zLve~=rxa$Kk}J#&QE?9KNqXpUj3+w=;Z)s zcR5vgGj}aY@%8=NzQH6UDH%pWdEya`rx||^YSN_3kI-F^8ek;f>mWf8Awqzte6%|$ z{;I}}>h$;pNBSJsB!w-|5wfWlyqx<>S#?xT!3_HOVCOlS!*)`Rz;b{bFBwT-7T9#P#$X-Z1qMKj7I$Tc>=eRx(ue|*J)*Y9{{q5en3eZQ$Qek!% zrDWkx;8{Fs?K${xUs1Z<21)Lr**HGvoBLCs**e=?3U@$UZ&`Q3j?qla=6Ht0sfC*U zk)1Yp*P}z2(>}X`FOK95DA$}5%AA?Bp2Bl=bg4l;GkNBvr}cYQiNLMk z3u#`bfU@TtPbCqcH*>sHU>SvDS9jsG9nkZPb`;_6fyQ-Uo9B#2T3zB+<&3Qo&@f3& z%F}nc;=Op|;d)l?5IABu6m~+lxZOi2G=vCSL&!HQ8~Vu5|8={Dp_*`p_Sc`psvTEU zo9`Xd{QP47IA_2rlw|1FJRc1W+j{L!8vuJLlG`ZQ(dGAI;!Vb;qnMO)aQ<(Ve%MTYpxKc-J_gg!=H1U zvyG#3j{n4$)!1*tx9Iz;N4vr#VO+bKqrXlZNCW*?8@_r^Q|FoLTDcPhPy0N|f&Fd` z=+i*qYP^$`_Pu>EZyWjjGCF0MpyG-*He3=O>S~~|MRP# z<9+kQzRVqNuL4Ttaov5E>1KD=NKE-!sUzY?9B6Z<|9ms+Ks7Ty= zcP~%vYr{2NMBTDL@aw%Hnp88$thVsWa#n?$px*LF{j>zI3gYLy%`mfrg+rkYhH=>4mXXc*6a}O!@(f^dfAE4qOY;f_PeE5 z>y0ly;}+_~0{oweEYB=mfxRS3{P6ZA?iZP`AUSQoMD6dNVoDPGjM-=urf~)kpA80< zd8<)n4gIjw`#ZmB7n@lE*ex|X*>D01?onZkMc}IZUmpBfv%8jW9b&3$Cr`c1w?aO%xtd%6#L(loTPwh;Yh~WNW}FgI_cVsGcW87XeW#ukKD)RQ;0X&aOb}b1>tk!|GUFh8vClDhMG8Mket(2Y!FlM_mrp-&yXq zQQJNzI9xZ&)LiMUW(@1cO2XCRCbJdc4ossrfL+Nnpz`lq`M;d-j#Vq!2SpT2xS|dy zK)y^4wbgvHiAQt>?^X*Ur<5`CBxh;J!W}r|)6-~^nCn=*=G^l5(VuCdg*M!^bcieH zql*7>cT^kf=>oK9Y=t1nh}WYNxQXv_zC3V?wlkBt%(Q4d=~U)-W>l;MB(aWb(D-{v zQbG?~cEZTnohM(qDQ9yw1UZkMQ6GRpV$j*rn`-$}82#AyuBNYukLb~alcFSdKZ>2` ztaxowo+SWV;%hjZ`O_R<@KgS}EK1$JI(x!(E5F9~-bUQquzPl63(pyVS} z$9x?tVO<+tcN?Sl7t>ERy>4Rxj|Cz<+I~2(Ym%%+8pHGavIw! z4Luk!$Ik}6GcUzPV8XLl6S(=>&NNhkSwV6{967~@8~p?m-QC*ogAvoyp+zu2iFyZ? zj}99)yI*nU+Ynbuwp;aD(e|_jf&y?FjMPo_-9e_5eVxaaTOp^k z6&rjzobQijp7$7?TeZ@`RY>c!ySFlD*Q&!7PS-Cjz47f964*t zy=InI>!tCzcwA$3fYOswo@S2kJSjeJsO27i>pyGj1qKRSv(d9vlKF(wZyth~x^P0X}0og+!D z4;&N2#BJYbB-;#%sL6{Yg<$sLL`4>xq@GM+ zsosaB+S9Dfy!jP<|Hh><8KA$Hxv8&teE?a%A7==FRI!qI-MKJB1+Vf-;8;z9Zd!AD zH6>2}ZLfPS3h(WC%rrk=0UE%4>5@&OaA8AS78@5jNDH4;M_)l%F&`GO6BQ;#Z%YIC zWE28dK&YObg@Yf1;4s+r2V^H~iFY_;4^Bz{byq7w5}7Q9rPLWeU4{NM$MQ6@s=!et z7ZK9U+5aI!q^Cv>R8(uP?AN&vrN9#HN9=aR=;ky3@DS(C&V7$gIX(V_5uS!pWUfBC zF61`QP^!JmNXE*k6j@6CPQ8nODN{E8j+0`w|Mi*2bn0voR7~b8MYS&D-uu30_jbK? zUH-R4*u&kPB!(eg5Mt(hXJa$u{)j!A`3<_;L-PZ+#M4Qd_e-s7@gv2f-7eP_iw^n3 z0j(_Dt=%q;@+umsH_nkuyQ#blO|8}~GC72uPz%IfRiChV+^DsqE=op>J(@k~wr zEyS)%!hidPdD50u@?gz0ZZfE;{r#5oQ8Y{-k@-SGPv4+0BV%xwsdUBYkJqrXjX}8p zt{#)W*aHdY)9@`{WR%~s__XdG!S||-ohwoBYKQOx)dLh~9O+UulOJ~oup9DYaqWdz z#NJ>1s@N(T;Y3y6;BWGxv1-=kqb>el@6a@xC>3(9-jSGZ@Tpn08^bEklPju=pEM*3265G)e6XSubbddw<2B3dLUL zMw7xFr#BB4B_~ZwNICbSdF06vl9LOT~ZcH(3jdj zo?R&)EXbX_NVEHSAf#F=)=@L|n?s1#hZR%X&1ivp?DCXOK~+9wUWWT9@YV8h99UgD zGeE0}3Lm(t9EXHTSesxYt)jDT0ZS9Is#zxmW_!W@lt;~F5?Bupj|jftJiWe`)?==o z<|}adUkWakQ`ncpcH6Oi21U@-Pidsi-V|`9GjU&%*a%f-OB*YN3L#2lF+5nAB(<9! zq|qvGo%ea^5L#$&S8(3S;(JHY$%@J5Y{_5mAtVsDbOL0WPy5o-dd8utlMjhed6u=7 z9$qOSU7;GKJv3#%ggLMh@3F-l((=Kcw%;lOpb8Ehpf;zv#B7NBRG6mJmBnE;Ix3?V z)poYtR2aVeXpK3MQj?y7?q{7$HgS`EUc_r<-UT{}2s)&$vDeI_D||Dixb3qlKPYE9 z?BwJ295&AXs6A=6@Mk3|Hc8IINxI#Gdr^5_piteK)X4MByqY79mT-&mx;c@J5FE?g z(1n`p4U+fJ>j7-2ZVs4q_XcHbcaAi8M}MJx-?pBeI}F268NKVJwNaI+g%Do}2qi~I zDe+de@+J|#3^@A1^?jrl(ypLarme0&!>m;wh7$IZzk^TDjvmnPd1VDmhlQt+VtS{N zk8ufI5iEo&@Hvy4S=7HA%*<8f@4!vwu`hM79cuaBS>3;1r1LgTG)h}JTfYBo@6=LM z+VJ0dQYYld5@o&^0cyKjUibQ>Nc7jNvki-)` zSK4@-^DZ?Y1)Z_b`AG4HXYx8d<#Wbla}vi(qQh+>4>qa4Lh|!yaNA5x`CCKOyCvww z>PzFx{2OO4>6WDq-0{E`*b~FYOn%&&aGovVA~}yxrS0VWso!qh_P|{5G`1Kf7TjT#SCWzd>C*!qe_SMnajDtJ(Q<)d9bjVYwtr zypm_hMHD$O`SD_Iq~QS;#gVN%4%vyZqfeqv(10w@H(rO6j%{kKnsa+u!fuY z5;Qgl&|jO@!6O0XY5(?aeJ$JEHI~BQf1tjgkk0>9nEagfyM5g;&oZ#Qj@2SSdLik=QQQW>8gfH;6Ro=g zTAO9In?l95YGiu08H>n&68FwJ5sE_@9$V(L7UCb;?GM9PF}}7BeP%P##jp?IRTp_< zQU@A9GPijD#z~N?zxxgGTlFrpx2LlwCn3au2HMV`cXyD<1k%X922jvtHg&^adjHj0 zeOWl9OCn<`rT(d?Q<|W`6phl{yU8K9>ChO5{YMqg9>C2W#?*t51vU_JitiEQ3oDV< zcq!F?NA0(`Z=ILd8E>0(H*BX}))KS;_;?b1MPG$HOW6(=XPocMb7E`ozpv>S(Y*9G zp?#GsSo|jDhu8F9Z;BT&r$fizdhW(eV0`@ouMmZjk&2`j$V>Nc(ot056`J-4K{&z) z3|XGc4^(9~5}g*+KWq{uv&Ar;9r6@;pnI28x5v4}MzC!bL%z!SuCkbIg1D*rcn(wk z^z|*1EfaR@FtH_>bL@8>89Ia0=u~NqJ98zzg;)XI!I7b3(PO{cg_1S($Du*0PH~hLt(tteSE6sZ8@Tq95z^n4*%8) zRa;_(6F}SY;{sL{e!3?R^Q*&N_!dS7l-hAJ%e24gS_2NI)hRVUjvC#z-0wrYFcX2{ zJn@Eh+_f0a<*(^6L6l<=dea1fPqz%gsL7(_VK4btooWv@REln2o%3J&5p+ix_W2!oe zIT(Axws`DEOY|oPndRd@-qN`-pU@Gdnh`eyu>Z`DLja zJ%0wu(vGLObnwrXOFCh+t3PMA3oZX-110(_LXKmx?@bDA__lI7lDQDUx%#x=Zt*dx zM{(i*Ge>*J33N{Q=Sm|jPvSv`qW5Hx?ZP!(=p7~V1m~hprfZ~||56z1vI+K;J_k*c zbr#@hQtGuK-aCLUoQCu0_SEfaZzjz{0 z4Qv^gF})C;jj^A-Yj{u^JW_2 zq|h73|EfQ|F|o*5$S+lAP*L|lM!D;91H`-5n-dp%zTOe@Vb_Nf z84VFSj}$du2yEC;*(Li2a*i>QEX3Y0Ho0HwA_lgX+%iBoCi`<9-p9hf@=tYtx=!ev zRS7(pt$r#Ss z@{^VM`;HXzhaXq;hwru=E(ZUniANRSuH%fz;i<3zf)Px4MZpb29latCX z#%gX>zvw`(2zYr%KP_2d_9|6|pw|}WN;|G+jGB@e>2EW}tee}*`o3IvdTW;iGfec~HC;1m;ibtY zEPq27&7IZh8C7hXWjZ`k^qQ1w1ajZ(JY}vo{{anA<)T3(Wjmbkn;HdXMd;zp2h>&d zF9Cd7Ls&J6vqA*jop-s*kwH=(&Nz@d?)~p+Kz4Is;aD_3@t?Eg`zsihr*XbdEv(~J zI~*1d#BA#o4fV4fbU!*Y&NjnxMl_O-pZQTMY!t&plr>Rpud|#dOW$xO$(p}7}w^)KlVq9@pckc<-Xb+OTEV#j)ey zLBNroK1*cKbN&LFWG=eNk1nMBFlH~|-nMWU=3O0GR ze366PX7k;MkU%)LPPr=(;_}-Qhcrvf#>p60PHR{_*G9f0wi;N_U`$X{IR~TBb6l|4RRm&er1dQfwt#mrE*|+^J z!ZG@n%%4X%1+p(Ws=o_*4*;rFk(|E=#8tR*iVEbxAdU6R&J8Nd#`=)!(OJwjJ>})&A>oZxa zn$7JBfHCNdExS5`dKaHGv*-^0CF{(mocsAL@nWd+D!Ky??^cUgW1!!hVzv1 z5;@k_pK2!As0;kYO@DlrCbWy7Tk8S5J{La_uU`G|U#^|sVf)50-Tpeh#|T}R-k8yD zIRAe2p)~l%V~tJa)7m2DuuaqzzE_3(?g{~#MCvhH>9l4|!8o{jEq7@BHG(V?rOk@J z-bZ=M{)F$BqZDBuN8C5)t4<_j?YMrZ0#4EpzkGiyX>p#xF&(2oI7IejsfRZ)@AcYD z{F5bMR||7o>%GEW{T_dT#Z;s@T*dcz%zIFH>Cqh2SH8_O&>y{Lm(>oLP75>t9aVmu ziKYPSThzo9gNoCaP+4`QKD8p?2~6 z8?nDW%a1Dzb>BNkyarLf;1g2~|6K1%L#^-g5E9CzZZvxoDn`w4m7amOj@);Dcd+bw z(i2+)&;RDq4HflcGc&lpjyaA{#Rkh*{HDt`B0a2dzsLuksAU2k&PwV~r>zNx{wr2| iVmW*JHj5Sj5PX|1@JhR(&*jlpz$4wq5763n5&sAH82n%W literal 21336 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 XPuT$eDlchScq{;G3w!f=Q$PB@2F1JR literal 2322 zcmcIlc{J2}8y`!Gnv2NI%*5>To6Rto8D?h~Lk&rxvZSJLXI#{EVm-% zB5td#D~*zpktl#l!;`5*Gjk%%97`l&34jS2gTWI_ zF<285QzRBgpqOC^L@r-QHm4KFRAXafBo=RG#lRBDSbzkB!O#REhsQU?fJ`cj%Qr=1 zPs--p2jAmua0b9Z02uGJ4 z)=V1&0%5}!qOdpy%SIw~rL%0Awropl1{oX`Alk4wwgMpvN5B9?dx^81Si-Y+;0Wyr zR5JpZLbIR?9KDply{1ePF>$S4#F28UA)i|xQ8Cq}qScR^H1cMK5f*(%MGot{%n@5!9$ z>`zQtXY!rlY8{FDKK1 z#Rb!c8f}xfxC6qOubSVPbZ;UB2M_TE8se$xuz#sef62>B<$9`7?v*bk>CQmHuOmkW ztD$1`vjcC-1<1|D)v84=&C16!%I^`q&Vx-4N}3zO{rv+Yi{@IU;o}~2Q}5=p|7^{f zsOnRPj4b4=_9s$f28)7s4#PK|&JBJV_ig4w-?*$lZ01@l|L<&?xzT_Oqt-TQx%&I7 z*aj)8rPt^SS3dpn-NAtQ&bi#y%6ox*u=tUMyn6p($+emdFSnmQ#p%n=62Wk zc!qvow>6|~k{LIVdo9N6Ltt%dkL#?M5SahH{K9tWN}+Uz^dcu_`S|0nzJO@TqPkxo zsk-%P!+L&QdwK?q=i}rV8zu|aXjkec_Z#_d+L}=O0RH@vj%-2o`PsM9pnJa5nkv`Q zow_skdB)x++nz4RzZJbaDxscb^p}+x@aHeSe)VMApETWL5Y&J{hG!_kL6#UQSD`~X zSMNyE`LVU;B6``!o-})uGw#Qy&uRD`0kz$W6*1eKkJAGiBUSVTfaI}C2&&$pXS#C4 zXMErEa?GKWL;EXEWaK2$dxs{%oQ@5T{1T-&roI&vn5zym`?UT@xD>aC{nJGKUEoGH z0o8Ql)brZ_$(fbYukg4Xe3@7(P!4LvE6KALg60z4e=ztf@M)^md}i7@l)XL8P}cD# zAlhvjKSBJNw+jgtbyGFcTHJ3WbG5b9XNtodY3KJrZHm&<(?3==UF`_dRp{h!&N3iZXWR5s|FAJkdEHv2 z1fIPv_6!Z(KYr|J0NYzx$AmV$FgT*|dFl5i*A^YWhR@NgXW8cuzHuynVHon&MRdG7 zlGeP&=t;CYm`EK=bu3oG3r#W}`j~loUn+<)s%GjC?s0XH(1y7nZO36|U;UK--pksa zx*_Pxx5CDaZf{;xSCrQq3qgW`aM@F@Zg0hhbNjh=_~_W!*i!G3s^z)U*jsgcJJ~2T*1Di+@y9#?c^D#5S}A` z@KBRo@;J5O?&K0I0g3Jn)8r=m*Xv{T8qZ)VG3uiD4SH&5fo3v9ANhX?z=qM425r32 z9z864hV|E}^D)68A#KcWD#(klMa>i80aj-= z#(*37TSj?OW{zCWEIIW^O+kq19Jh(P`X1XkwWG4inZvyr0@Z46_DHf9s17ALa>r=; zsp(tVA4Wxcdk5s+OiJ_K`rbX3hZ@nYQHxmF72JF%?onNBw_9N85=E3%b%5G6ZRB1k zfD6X>#kJ7cx|nyK{RlY=zq`Y&a6+|-=z1M`eNJw8#(Gb6r!?kvVc(Bq9rL!`Y`MMS zzjuT1PJi>2dhu{*rSg4HUS8wR6RWx;@Rd>GIDXqo?6S%fNfHCaY>8z=sI)OYb3HRY zi(ip$;GT3JYXk46-}|8j2+Lik0e}*cyfpm-wZqZqe(A@fp{*~4k~{lC^OH3J*ZFI! zUdLplQT>v*7U~-mdF#CUi=ptJ@<-44d{jgzCZ|*H6UvH~1Deh1jpIiep{%xS z#O9~v{Rh1>8Oc@6vk`fnl$)KiZc&dMcBMhG)-wkIc_hWNw?Zj34Ptm)!CJfu@GG4c z*XNxbN#Q9?`2~cj-712#&?a)4)Tmxo-Xkrrk)h-I99DHr8e9Bk@C8xe#|M!(NJV$; H{1g5Sni#uH diff --git a/web/img/ui/FrameTEXT.png b/web/img/ui/FrameTEXT.png index 185fe2e20c6c4cd878d339d476d5e48ebb768bec..a08997da6949b53090ae1cfb30955aa6c9ab322b 100644 GIT binary patch literal 640 zcmeAS@N?(olHy`uVBq!ia0y~yU~B@ieK?qbWcWsh(?BXMz$e5NNGmI=0Fkz#vAULy znuZn-X=v-}7?}VOL`qpj6~R_k0V)HELqy;tkb%qwD$vx`S5Z*~8l|ePv9xgYA)rk% zB|(0{3_sVujgS#$`88w4>&xrfE6lmxK6!k3T1Tb%qpjEKOJ#sgUF+%M7*cWT?RC$f z*A4=%7njEssqfsrP-XVt{7=nxY$9!p%-6dW-rYPDnzq#B>eiP@lfP6e2B1-g^U*&_>{c4s|c1=EC?P7A?H1uqhi`nWgN3Grp#_qb--o+%Axm0@Fgp)q+ zKgp@>bbIv%2YNeH_CFpAxTJ6 zu`ztDCFdR^U5^J_!@Zc+FO3qan0sa7f!8{3JsxbCx<#q+a$wLzmK#@E<7Am~r1olV zW|+L@iUz;I$*=1;H)NCq>oW69n`*aaKJ%jLxYylXu_Cd-nOe{Fy0lK0F3)+@;PGnN zmGZ8~W(rMjH(uyJxBRJHvXtDibKg#1juigSu*5N6q3!zc)I$ztaD0e0s!~{ B_{0DJ literal 918 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 z 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

Rm|ET{{zq&z|{=0 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%0A~H(izYv&@)heZOKfnz?ZS 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�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�ZxjEM%kBus`3`t1B=LDH9Wt?l)5 z{=T~%d@_Mi^<}zb3@wLozax{UI`JL#Ez|h>|Mb7hCwAdWi}Qt2-&&sdNTmYPbpL#t z>aw}+$2X>SfiIZeKK+;1zg)N!cmwzdZ%3wmg^7>!5tC_-vCX{9*IF*qsmRVtDz|cB z!d~7!Rw@${P@&$xB_H1=D&z|QEq?*te*Zsj{6m2PT;@)p8E=a)#U=Sw_f2D%;0vYV z|LyV_>gYigc>6dRq5KDYLw3ATYvaGa{6nj&9?uunC|oAU?X~i`Ls_a*o$A)`1S{`T z-A!8LC07;VAYZ3J#5)!$xC-{4|Bz<@(5l1BD%6xGG-q;GjI>_9UITKyRgwPgkH3EP z(G7PyeD%Av}ZqW)%b0eEc1Z;jU*_4kc$lBMl` z!UeL;e^D*@a|2#k353Yg)dMk z$=~wCl`mgPNu?nNTIE2Cs?ew{zp;z?&F;$^g%`?Od9CFa!i?L!49eAH_3iB~f6n!m zz5rC1gacpw+x}muv<$P8oMf%iW^S)u-oAMW(0bu&c#3kH%y|0?OazWvLtn^+dTaSl ze^YWRP*=N9ry2)F(d5EM2V@oX2@-X2*;=X>^iO{*r4p!!N~MR&beUdXbtyn=KqGLY z;ea|m5wYCa4{A3H5?*Gig=Nxc&~om#_ik>OR7%!d=0c{?5IL5%UXFiK%}q7sL?E}2 zKT3^9I8C()=IdLbix&WAj>m8#L#-1pbL?~@5I1x^l$j11p0+lggeoeqsw|V%Tb2y3e%yc6ex5NgNj`W6LSJpr-R!03|*v5t>p%^ zEapX%1))Z6Gy*O2TF-~(_3h9w6GNVCBLmtZ+&C2~HLcdMi9T{Wa=Db>C^?#Bmm0C)Qv^v7K9ZXJYlL0>ikLq!>}r7bYK;$;b4A6#^=|mZb<)W zhtSx7-Y!#x#nv|41fl`7B>@WRTA?l!K2Nix=8a3)jj{w}PzpBdTUW6L9JII#i^x{? zaqs+5RmBrIV-Lk|Th0eWWN(&Z!mDQ+8V%a_I%jI6O;&004a*WwsLY~|dE<=cZQj_a zPpr+fM&5k^qY2^tOI6N8;EbU@P$BDdzA%1z5=Yb7!)B7}TkCn6Yo6$#y{1nOe&$Rv z>Ws}KOk*Jctat zs2QkmH3Mmbmt{m?8n7aSe&rv__kF@ivKjNV-z3os3~wfK*{l8)|HwbxKZt)QHU=1vcWehY{!xRQTQvK$6UE498Ef`_03GI>6dIjNzC}1yH(Bf1N5a#euse z1d5Q^Zw$krP$c{Hw?7TfJm~`B>*f9wM$%+|Lq)>>x&BF74qmo3OAIqzZyySAx-ov| z0l!1mdodJ85nWRD7)%8Te*N;L#8EvJz#&L%R#(!?G|=^1_}BDxj%A7gR3@HOj%W|s zEBYSrrFQ7RrWAKkfg=S}+?z#yg;pffhuifn~+8lkC5PR*L;8C~Yjg#wJ{B!nEV*AQR2#D+nM9VVaM}vt;FA&lL z8ThI$3pGxgTg##`f;ck0yk^>7TZ@kQqkJxV1k7wlC@zWCAtASAgkidi|B#{*0!Ml* z&TT+HsX3NI8xagoP|amRt03il+Yh&97X~uv?iuN~E3?j>*lc{fy+E1Mhc3%&ng|M- zLBnO^Mpe{>IQ;UFr)PvIKKg8}W8@krba&JJC*qB`YgaRhX}yB&=G%AuTwN_rXuib5 zJ=EFa*Y&{0%x*2mq`m7_Jla?vOK2JDJR>{OZS@?jNf`iq-1{)@?n{e@sPk%je9cW4 znDA5Pi)}Vi8tW(LBk~^{BH5W9*Yfy0`rdEy z+R)NTiE;hQ+!_bStu;o`00gr&_dUzOeq3Su@VCEQ7=W2Q%2{pMrI;-ey=+O{!KAyz zy(9n4OkhyNE~Fp#S@iH!lRyK1ev%e*dN{h@M7?|T8qS$CFz!Ae8!S(Vv@s%q5k_3! z6qclV?PmENtl+ja$EXQg!_z0)G@O|U(>1+n3mE0%f>kC z7yrl-R>0Q25uJMxb!}u?-YIS4YS1#Lk#WHHvZ4Ya8{V)p0RTQ+tVl9jOW zE$gh8k=-55`5@xZ2H1M#vz0gyX5G|lQ};Ct+i+y2KE z+dav8ivAGmn-?|JJHtnYU1IbcLPJ)cEdy*e<{&kQ`nh02aJkygmnTP|H=P3&CL zL=>n9KE`D`Ft4M?hwMOa@9#DAS1V2{Z_BaC9@JqTei7MB5RcZdA!}Oastigovhk^; z<%nfIaDcb$X*H4oxg=cS;4mH62d%K#3VxHd>V76%pm%!O9UP*~-jQkU>G5{_1RsE> z$Dl=eJlzHxpoRSBVTWtmPB&Mb=tE!q6NEi({i3uEq;Ww|=a$KkA&}Q^aAO=9nhf0a z;g(Oxs%E5|a$*#Axqu`sBhTI9^@gxjFk}VM%c6fQ{BC^TC&&W3l}fexv~F?u@aVZ_ zo%Ihcg>qDK5j#F$VTU%Au!rvHc0mxEgc&IM40g3K+g++{U5?HlZ)X&9HbwOvlPw!E zetZK$BiMQh3$@RVWP>g5@I*qGZJ)mP^`;xx1q`j3e-`T3lF=d5Vkq|`y0>o`12RJ< zotKM8Y=e%JKF2Y!+EhM>hpA=Tl29h@@ukrGVlo+aLJ!e;%Ee|O2Wqmh6othYK^FG? zkt(mAb)}`)NS(hr&`zm0h|@5vQqz!iVd8szB=^h_`t5~$L}YtV#XN14^oz~!aY%&3 zhvZT6IQt?Tkor1Cy;a{xQIgn}wq7rB)B@=B`sAwW=sLIDI7Dslb+P4>rfOy!_G!=e zZ}w=0nGG#}CK(#hbi*GE=#*dC%=$wx0`-R-n=+7g<^Q;EZ||nJH_JCzu?~_Y||+{QqjT(Z(xS)9b-mJ7@_k< zXYZx3pHn5+7(zN*WX_(H#`c84Jxo~KSM~3zNJsvY0;CY= zAFA&aoNK>**a|kZSN|N`5>I2fcm!-^{Re4pyTWcZrV6xk(iswowik8How^e#pRoQ# zpeMx*;%ZCR9AQ50Qo@7j*K_sljsU~<+``eQePxmhc{?L6j@#GuogKTH(8k|nou>D; z%c$C5Dh&@cw)dMI3N0S(IcY0fe1{|QTYR}o@!(t@y^4k~!z$r)Fk$QR%F%)@9<0W5Ljb#hJwf%~-nqRuKMhCst z-;bB%5qqerkXvpM00^{4LVs>#+EZ&J0IgU4dTip@FZ&@sfy_?y7Tp)*C!qKo5_W4j zW{cnSOhe-&*{g>K#j0R(qPj|kJM zn=LT9I;j2#E)k9_YpUs4?Y@nr#-APMG`bOh*6C`LAwRcD(i+1`#^n#c{J2cCvCT5x;~;%juekpo zV4=DgUFfOl0Z%&3iu7s64tWd{j|xpu|#HTY~ZN1ZvN31My7X$0BoIoZP-)9Q{WWO z-+!iX^6?|Dv)DqdM?Gionry2ej@Q5Z?!%7P{^2<9KgXh5lyc7dCVB${T%>%4yA6Q< zjPi;peE)i{*&cpr9a`{OWe(cisVmzi62uU?$aUvD-cH7Mgr!g^1T0wsGQE7xd#2|2xCo1o5NkpkJA6hoCHMWF-s%5kF&fz}vH+tC_3_v#EmCVGliW z5+v)+E)%fGk&qeo?HcQl$xqitO}6tlp6S5S!BcjUj#jYmwq+W#MY(+8k0w_he?EvE)~&j;W=TcqNP zj?j5T+_W=Vb~D8kXbi%Xf#yni*ZSXfK^qtvq9j?cj2MR?ho!mO^IWmtO7`?U2d2e{ z9PDzlXBbTHUA`28b{(jeimC5Mh>fxI8qyInf1KTJ5d8z=UZY6yd=;R*rtg99Dhx0| z^gcIBWKsrC$~5*^q*ZpQY=_}1Bl7pcMG$}1-iz^|wekKc3c|L1OcG?FsJS^hIr(F%z1gg@iz+&Ez+2-UX^R!d%CjzzkA%JbCw6hjJo|?G{ z)A)sif#YecpMO~5I3E4?#wB$+$u@8Y+&Om;_(OHzuAluXv5nWphys9a7dGML&%gVK z$T6T%D_nDpXnStML8O-J{fD0wqcw~p*mQvncY84-Xz9BM^0n;D3!#og>WdZ;Uq>q^ zWxrcbrz-w*#@I5Q3d7ncH6FAPK+(bKt7Xvz#Cu_@+U-&MM_BLfNGm(>N4%G^1*7g= zjPr;ZnWA9oD9rv}duO)fHqv9^4+&M-Zuk4YQvmVRzpy= zFsPdTALWyDew;etdLD1vqZH@%(=75xIlG98Q;SWD$T}hoc^8R%yH@j#1EDb&G6$GB z%nUgQw9QQCSXg6_{aH{Qn)+Q>oP7af>aYp1?V3naL*^<9j0+6MA(+Qev=IOXdtufF z!0_$I-v>5BQjn<40v+luS|?;#Nv(Pfe0rVQZBm}*rxxMHW@tQI4)S@QY+p;(BQ#AJ zF3 zPJ~ZZr~$byiWEvd&3c(02e~HRO*A6lc(^?Rb)#0`YP&7~7ieROYQJP|e*FnzOof-n z;wCq#LRA3dWm1ie)c`69*JhuDiwr3Z$)5J|BC%Nig`NE<%!p38{x-wrTm55L+~Q6H ztptF9mxXKxs{j1;g>AU>Of1bhy;DsNwbVWth$a^S&?^3?Ra*5rv0T7F?k5g-W0V%l z8f1rhe2!-Sg&G<-?KbWcWIz|HbAOZ2Z|NoPcfa{K{e}!@^BLtET2i;ixtq1@$mPOG+idtcUpI;Wz(`am?QtZk2LY8{;@>r*#W4*)L7)nL)_ z?C3o3-%up8%q!!Uh2lIGECACsfI`CVB*sGHEVW^_%dze{GQnBrf_3#G6HLja}pQVhPJ#xA`q4Ui{`RbA$kIm@1Ooarc@0 z1TH@!j%Y51!QH!ze#eg1x{cmN11udXm)ut-;9b{25EE_Fngsx;Bx)rQ(W_G@;nT`B z*6>{KIvEmXSW6hcomUQuv4P+Yc?a`x6KVSX{ohk%2`T>@J-uRxR~8V`KmNBvf%Flb z)BY3f=l=<>;805e?JyC9XT!oOB+B6xwN89j=QVSVvKn9Q(z={nP+a9KR_}4GC#ze= zK4S<7U-T9jt0Aa>Q1YwHo}IFr(nh;e29zPtBS9}R`RAB5aT2TVbO&rcQFOD_zGn9-#k9pJ?&sVF5A;`_@6>}8v!5&J_SpV z{_(FbW#f|rUJ6iXhBypVN{7uQ;cCd*_zBO_jKl=o3}=hR&qaj@}()aG&zm~@+qfK2g&7*0Kw7a;GKJA zGyIy>Wq#&rw%vzkqd`M>esPmrt6V@3x_aFrQ8shB2?m_`pU-Vsnwb;?OKKb1>!feGIjHW$IE zr9QVxjkl(c3HNKO^p`wqp^i0%xs6f3)A^8fELZpi)B$NV8IQ(R#$z@DZIJ(i1ZqED zaDkw2+O-ixrlHZSo-FVgW5{pa7BtbIJgdFFr4DceZE_G>7}Ocn)^*77%(gE)LT?iN z`0B`4t>T&IZX&DFm}F`0)IpwKD7`ea^weU97@3-Um;BeR5a;0rnpO5Se-fs(VhW-d}uP3r0V}xI9334i72}8yuMK71lXk(Ts!e#&DR$Vj5rHy3=#@rYSMULo@ud~ z+Q1_H0Ky;}8vPT_lCTl~h_Q%`f9tCFKYSP05CH187iSsL@cqlHd!yMQR>^Fg_V%;z zJmYO<=yg2+u+&1bmuMIN2}yWkbXR^O$DtwXiJaU>kK`@3G|zS2rg`*E;R`+FKWM(i zPWG#Gndu<20&6yO*(F3Gt~V`dlk)cKKAinTbh>0pf$DxWf=tt!`0uY?y zzzS;pR{YCfW!?5~lb@#x@>I&mwV+5Kz~x;yX_AdI4~FV*NB>QW$CteC1!&m=Q0uON zBH4tW@(Q15&U6!eR(3i#-g>?+e7VSsv$q3)d{##J+ly-Ew=Mzh6Ta|M6$PfhqcMP@ z9iG;St^FlksO)PoDvdnsGO5FGK%={8YU+!8pp-Ljvj^-ki4HVjaww zq-d+2F=(^Df6fY!V+67S>zWL{`C0{qi|1@lS;%Eo&p@A+SsIV;l z_fu|H;L@~7Z&m(Fz%eVpwxFTB(By;UtijJ54%H*&8z5iY|1}Chm+OMM_yjp?fI2t@ zEQ&3kFIzhx$B(SSVN&yyH=S~8;y<-ET`<(m=VdoY+uSZy%Vu3e;G1WH4>X|E4Iu4lhCWy zdu_?G44YHlA`%kd;%3jgrlg_bQc2d^pKXEt$%=Hd^ViRBU8}*! zr52z9rBa|4uBQOnlnXaMjJ@k)^%S1K(A>S{n`OTNM#P%6Cw~1r2&^?;|K>V%VIyyY z`m@$bv^=~HVi^Zkpojwv2=U$i+YYaXc}5pD8!%xj$rKdk0FHO}vKYaa&;HemaBRes z{{QCIt;TRMO_vQ?Lmu_6ZE^A|G+*^`@0H`IJ0a6b(5I_Mo*J%MuZ5{`ckOv*I}cZ<$I1bDchN_tTK1Ka;sa~w zlN_y7!KgqRrS{mOuE@W;ELV3KP3H4U~-=13G<-qH<^TKHddml%3FKJ!!W!d_s&Osm{ zow4}E14UnMzFIQrgIazqCB!b1I$$G`EzF!#8^s~4s z>0d-0Dm5UQj1K{D_*c<~%#_0+k3kl%iH6A47i(%)T;pMBMCPz*><#k zZu0u~x4L)xtOkI8&M3;AXmPL+1`!6f<=UvfUZ-BuJ`33RDEp*<03NOXNM~YV>q`Z? zLjwl@UW$Uw9T*eq=}>BH4_&uAB!029O>f*HzW&-GI`v=7J;*S3DgLj&X%Ggn`xfw|uzwP}%($M2=Zty}!}P@cF>6MSvkf`^&`b)$qPIv0tdH|+}xj!ht_Vl+qqf9ehc(nujVI4h$W>!{NKs;KXK2&4=QxSK&sNZV4BkuO5U7PfD2zZ}( z(tvk}a;gzE0Pacv?95T@Xl90C@cFcUjdk5|-k12_=Y{&>QQK&bBAOp!T7|`)PNX-_ zim=Bfcn^=TxSuTlz}^1QUhU-v1VKbZhj;rwd6b>e(9eW&00000NkvXXu0mjfNfIH- diff --git a/web/img/ui/bong full.png b/web/img/ui/bong full.png index 8304178eafc67122925619541e85ada50bb713c6..d31d7afad1c9cef15624762e0f8c71c3c63321c0 100644 GIT binary patch literal 6611 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 z z>HB+b$~^PBrXQfb-$N=4M4Xzp)~vZHNS(D}U`$JsgHSvneWA4Bk>Za10EN$YDbLrA zWKhADCRDOnOeD+Mw-Z~rm=y8yE98kvORJN&t z1#FAl%H!C8BpLgAM*Xemvs3mylccNiN!-KP&c9?Hq|P=%?7(Q|`B(G0L=8ocy7&Au zp%Ste=>!CA_oUfsy|vyo=ap~LX^SD61(Va|Gxv4VblPI4v^3~Fb(kf8VpP~zKdkdd z8n4ZtthKMirja!Zk>n=XMcwNMV?dpfl@Y2En?{y2bXCaCm#15{g(ua+=cK_Cf|Z`3 zZcH)}lFN7!hV-H#Rm(Em}6T%CUYX4Yj9tLtjL;B+l<Q0U zw%UH5&0#b$>Fs#G$x|=z39EDTk0=DB<=jPP6H=JM!k6emd5#%_`73-mx_m!^nyS)1gBl4`4*kRk>IpbGKlYe}}u$@B^XHkfs z@D}RMpC;{VQS2pIGT)J_WqrJy*5CB;C0Lh(7du0GE_%1Z@~9EvQ%sP}L3r)!e8R?a zVvx0W>}$u(B4pBB@b9cHO$a%Lk{S{n!!@&jah>~|-uyC88=uKkIezu~(#P@+ON~u3 ziXtRyaBP)`%ff6m3?2vZS*H_kg1$Z|kV`+V^zpN-<(G1MA!R>5(mfQI#!8?y()n^< zU}>o3o?lZ#N5W%R$Cqi;v+nKAPa1;WN4b~}rJ3|WuTJq@W%h^Z%!H(L<`(6-JKVnn zOTD$bQHZTWrtpkbVf%?kqwCee^fnufayX7Oj#$WTj-o~PUN^k<@`N(~Yc=ojn&nR4 zJkhLITaYQzt-=Jh8N$Ou^IqbeZ(LD~^v6p<;|)f3RUJuOUiTrHUv&=>%ts~RPPfN< z`Q0N{!>)#XaU@Z0%uDAo3G(~t0CvdMA$zn&UyWlc%!g~~{@2T`VS3MK_sxz4RQ4?z z*Mn56ho}bcU}j4q`>}v9f#)!4g=hVuoAs4a-_{ zb@&szG4@V4kZz$KZby_}USSm#Jp9JkbB8V)W;FH4^gt~pYCC$EyO zeQCiXiS*Fy1dh-nT#vugUyYdtf{4%xa{{v1r3HVV?$Y84Ul$uqo%Ao7{!XnHN5vUD zVz*9zcNs^IIx#djL@~Qp^<*Hu_6cf!_m7?ai|SGX;7A3&yhU(p`J{BWDJ_CaQ6JB-%WlQzobCO6)p3o=%E^W22nEZZ5EJzL&jy^~Ufyns zpvmJqKJw}Kf>|JSMZ`*M&P~s%iN|Ph@gw-tIg+4};@O>(c!#V-@`5+6>bh)@**GVt zIC+t#L@{bVpAU!IZ`mDKbQ|<3EMoL8$Z_y73_!5a3aAzvSBr!M5>c=v(|dsN_Jm^zS1(7!2dZ#5dJ_YR=*L(oaa6siap1Iq^ZG%T z2`j(4cVJ%d`agevrQh^?G7^s%<1cV`BD1c(NjGorHd9=S79&$OM78)jUU5Bh=9E?90c`xSfEJ zmVo3Omii8bY~w*98>ho)M$dTK;G=gNiW9*aeIMUxI&}Z-e)Vyt2k@EE=eV==R`6!A znEvrWa~MQ_@l*2Dv@g^dCRc8u9Xc7hj}5(R6@J_>;C0WZm~!yY%j)XOgHFzTM~%k! z*L8~FGHsGUcQGcEc_a_!xI`b!Ep7ZNH z;x`9F57DH>87?#f9sdRMCYQ@R?OS^AZDGtC{B!;uB<}M5x=4js=F@YTLW^80Rc_HT znRLWr@%&-b&!LWg453G*@HL)QK(;*V6;mpcFT8{Od7XbIB$r*`#( ZSh>~S6$YD{1i$u)Objga8+F~{{|}acD^~yj literal 10010 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 Yh$E5!S3djSzuh2YC6y#9#f$_057#8p%K!iX diff --git a/web/img/ui/bong.png b/web/img/ui/bong.png index b9e2d4731acc8d61ac4e78bc8a99aa979418af4e..348948425584c12a9bd54f1353963e744ddcfcc7 100644 GIT binary patch delta 993 zcmV<710MW|3Zn>+BnviBOjJd2ad7|u0Fgm3e*k{i$^ZZW5_D2dQ(*uIS13*}4L(9h zIwKw!Q#cdbAwiY^00W9iL_t(|+U%JLZiFxlMSpf6B*6VITT!NBV1{XmS!}8A1W(qt z9XU`3qK9OCtQ*%E0|3T!uBoH9Y0&CGj*ZCRxOXrBwh*_xm#LejZ3KWaniQKMRfKc>Cods`cNRveMdz*bK_-(luLWC!2deX-lQE0~=f}lMXc)QHLUF7K3A^e)AmBYY<_WSX&EO5aMck53U`%?J=HG>{y$Htpdx?D~ ztsAhW(X+IaLO+)pQVRWCYKSQ`U|*!!7aC~R(k%qguB2~2f|XD$r8CPX=^B$C(#)TC zOZ>C6W_0QJgwvC>oHm?W5pvpaf25kFgNQa9G2vTU$TnPTMTknrBOefzjz>NqX?Fa~ z5AZvaex`p&3)w6aZjv4#ia{xe8hDSP2i7N=jk67eMH+CUbbv5|0`FtkJCcHw_y3Gn zko54Fs1&62A>b6Wpx4rb(Ga!|M+S%+9zcSyB|c&yZsGwR!d@OD5v)I2f8J9=z=?NF z197_raA5mMyG;ji3lT6frT_WotGqk8fe;3wAga+c#s{|iqa_RI_aOpgdF`bt?E_~u zx_gj^3wex_7bfy*N}B|`{gu!anakpW0E)XVL8Lrq_hi6U(!E^hJ@JIKpT z=v$L|k&9Hwav-wsO1gebf4i8_nIHevE|7Khk4-Q7R$cWJzyQBkR?ghl1MsODG|N~`K_R+9dET1S5aSHLaNCtW-U P00000NkvXXu0mjf!-UY6 delta 1111 zcmV-d1gQI?2#E@iBn7lkOjJdYF%<(xa7>XgE|EYVkw71jKp&An5q}P7LS_H}06cV3 zPE%nBS6?_I2>?z$Ck#nbLnu2i4_O5nTs=YrEegjk@0kLM$>&q zHpx^TZE#+-^n4Op0N0%LVoKtogt;b||o*dKNM9;GDrR>Z-^umTu*$bD@ zbrn9Q*4;p-Ch)aM>UFecz~>C@Rdid1@5$|#(8+>=08$Fc=h3=~fKv5m(V-{;D;jzZ z{ca+_%=c%|!GD@>s;{C$0h*u1)ceij>{})IsS>ZK$G=}9`c}v|Inc#54sroKx-gM z`#`HqXn*yD9ve((V|+wULDlq#j&PwPM|6}69X+BAF0}C%9ap%}O8kJ{fvnvDy=O!3 z4``DOZ645THuU-p$pjlZk;E2sZL#4)Z(#AEEyVcHF|7E|D^&Q<6@>ZFVRZP=9d!B7 zT_pI>38eYZX()VXLNaZXKOU6-5Gnu5qx^88{C^my{Dq0~S5wL_0hC|2D8JZJK0=^; zSVQ?(jPd~_=c8WAhw7BCFDPFWQNEJneECWFnwj#2KIPE~%0nug$AKshUQr%#<2+1A zd2EyNfGp=xWXeO|l*j8iFEUVG8R5K~LwOB~^1>PC)jrBgl$_U9DK7?dUcsik?9Mq> zfPZs<1Ldd;&Y>if<6k%j?Qo7Xq8uK@Ii`zqAR6cBIm#h_oZ}QZ2Ul{A2<05cN;&qH zbHFg?C}+;0*_`9aIS0XWj@;*5Za}(5f^%U9=V}zrB{Zb#emEB^ajvi;T^7cobpU|M?b`o=&yUt%N;&NHp>--#x~+=J?~wFWo}vQ+%ttKYvolmZYD3 ddG~1@{U3AD^aTgRx_AHp002ovPDHLkV1l)b6ukfd diff --git a/web/img/ui/bt A.png b/web/img/ui/bt A.png index 63c644c2427b5cf74371749548208987d1522bff..9b01b8d9cecee79f925e14557371c3288c2aa755 100644 GIT binary patch delta 3470 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 literal 5086 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 diff --git a/web/img/ui/bt B.png b/web/img/ui/bt B.png index 7458ebd1f0a80f4bb02dc741492d7001e9264e20..4ec8a61610ef4f92ec0affc2ee83f634177c938a 100644 GIT binary patch delta 3421 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 diff --git a/web/img/ui/bt LOAD.png b/web/img/ui/bt LOAD.png index 0e999820ec8e5fd3f81669431bd2986559c94629..074cdb5d81900d26970fb44b415a26ded47f963e 100644 GIT binary patch delta 2333 zcmV+&3F7vc8Qc<(BL)EHP)t-skufJK0RaI3000000000000000001K+BQi2FI5;>d zDJdKr926833kwSf2ndle6@M--FCQNtIXXHhC@4QbKv7XqI5;?HXlOn@K07-*adB}$ zLP9e$GZYaKKtMn}Jv~N7Mjjj-C?_XOO-(Q`FhoQ|IXO8>N=isbNHjDwBqJj%D=Qip z7*0=5E-fuKHZ~X*7G7UpWoBktT3TacV<8|QQ&dz|R#s_gX%-X|ZhvlWxn&V#0DDvC6H_RS6d z3SkHHQ2}R0s()I>s3THI=#XZkd0>Br;1-=`1(XmqPKFLuB8CpxX-X}A2@wtl&jqMT z?9i!7K!+@U9t^{e5Zs~@I3h)?@LuYe)M=jQrwO$CTBXKb=mmvw%Se zVjAZRLWmf3PD6P#=-st3bJnjuMB;>(MK(1rd zgDTkr?}1!HobXrOx!Vwrmk=@P#bFN~F+}e$#GSwpcLGD)2@G*3ez9)`ORj=I6#X1i zQV+ue5q}0`l#Pr0|No2zdQfo|v$C1u>~evwRG$DzRjeYAP(>i2ia&fZaEf5Q+wiQ(=@svGaMd>% zCX9J=tZLITbQ*Dr@Lj-Pyy121<(=az&iU6m>3^Ad>;QIA^{f#GNJTil;e2z^W6u{c zPLfhNjbh;*+MTeT2mG{;UycI@jVQn=!cKH!vbhJ(g)|RE*a}e(BL(*-6WR$$H>7a= zp{k_7K_domikL{dL8eo#J7?ugSo;klv$U?$&5qd`7SktAB^ zx7U4iLFA%#i-l@|hnO!!3@ZnX2)0B~BIKxICn1ULRHIC@qOJeoma!Ki;31uz#@i`N z1Z5%DkZ3r9k_Z;B>W}w;S%$1CT+W|Q(0_>FY${5Gm{TVs(abE)+lJ})kPF1Tlh_9DM)xX_C4dE6nuL>L%s8g-Q1C`vS<~uZs}o1pB#F{7!H@ z{%$mKIPWIHd4VSl1#ONjVs{aCS(%i@)1H$0oJH&{LgLDF!@|R<$RhR@0nMmlbxaW6 zWf41zD4_8g++1FU4qC7_{qr%4_hi#gj49vVRRglxHm! zkAOBuRCUJtJ^~YhxQO0ekjdbMobY;nM5+BcN?`&|6C97KYS(m&Hv$uaxQMP95aSuE z`2%(GPT!;Sr*)Lhi*2xAZZO-bUgB#x1a7RUi%{Z8=vQ}YqHnx!dW;g<8?bRlcX0Z= zt*SUD-s3hNSC5q(O8Vs~mDQDb`}{)^+TVv%4PA&VeF7D0q8f(Tgz5wZv(WD!KjB8c$W-kt3x4nqMLW`D+e_QX*rODTwp zIU=e=kRme81@He>V+UD-+Uo?jIo~V%au!+k!4RIn5T3vgp1=^Ez!08z2oYn5CptgO zp*tH_UpCWc=631~8={b+!4OZ=Hl{-_WMPNKmiDO4kJ*j?UjEhqFbs`lSz0wsbMolo z$2qxn08phFvxCKtb$?y^a8zK9PGH!<;=`!@&S-E+Ji!N8!>E0-kfH>D?)?v%mRk^| zkR}6R`9_0L^g0Py2!Djyx(Rbsbi#DyR%q;UmKb7}FlJ(^p4t-+~c8Zz=fL==QnXh0Lw zf`&o#5W<$&CCeVrg!*N&a~)g=60yD9u5nRJNUyhY&m!VNIP8$qbfrr`6Daj6rTKvo z!-a5opfb71&#Z_%|9!ERyt<%3KvLgA4J9 zvxN$?H~9;VM!sdCS}>R4O9&_8EGQOeG)2I8L_Yfm)~GyitKUl_00000NkvXXu0mjf D)%X_} literal 3224 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 UR+h7FgL5B1G$WZlH1SUUFM@M#QUCw| diff --git a/web/img/ui/bt MOVE EMPTY.png b/web/img/ui/bt MOVE EMPTY.png index 2a40d66f5c2ba0880146ea864f860c5b6f62058b..533de3643c5e87d0b6cbf5d2178aa229fb7ba5d6 100644 GIT binary patch delta 5027 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 literal 9912 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

Q@7K`VL?fZ|T`GJYhUdm5&=rW5L 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

-7t0EhX!BuQ0HQ+mJfBEs`PXm)gAnSFxGR$?A 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 literal 1857 zcmd_r`#+O=902fVvmrFM#Uf;+iDrxqv55^E#>Q;I%yMn6$)%HAx}1_OCsdX$4mwFX zr6WX=%1J0)Ug@xMJ&uHS(7Mp&e77IYPv<{4@7MEuzn|y({d}J1^SquPo}wU@&q@s= z4G4l(GJI(qFh_wiOkD+xslDn$5Cm@t@(-c=r1^uD{{t8d23G>Xzwe7gA`u9Lnv$lb zCYZsfr>Cc_t!-#%h(e)sbaX&qW@ZK!(P*@ZiODJ@3k!?&I2^ddU@+$9=Brn)HZn58 z+u4D@dcy`HkqEZ%cswYyx3{;pw#H(yj!sSvM4}ymU}a^6!{O-O-XH-4zP`RLuC639 znaN~=OgDFTu+9n$bZ~HRadF{txjY_^Kp=o!M@Pp^n>KmTXwf2(lamvLN+pp{_l zBO?3*0vJptnM`&DKpEib>I$*}HwAZhcM3qIQazM5Zw7@5US8ma3UoSXNx{d*$Jdtu zfJXv;et!N+0ZJ?u=uIIgD2T1Z;c$Y3gF`|>K(AbGC}@|@=ZA%D0m8#UZ$P9#Ac#^D z3Wd=MB9Uk-5Tg_u8ylw-uaE#FDu~76q-2E@AT>1&NLR?n$mnCY$AGVRdIyIU48h050G_X-55oMX^7ha?Qo4fUp2 z(9x=+9r)KNZTi_~oLL@+%U9@WqK^pe@0>$=Ch^zKLvEIOcAbY2aPxEt-E!P7H@U6# z@?#g z)YLv0Prdc{_-UvSwU9N;(odG-DbCkER>rb zY31i5HW*YNqzRUrGG0-a-wg7$*wnt>c~G5^BYQsSUD!kx!pdjg{5iXzw$8Sv&LrDV zXr6`UPp6{t*_F>ycc0BV7D)YkRO^1trMlD}>0omd&6u9F7JDqNQeIe}mwA?J; z#*%UR(pb{e*uJ1DZcPvGZht73i(F55GFRGJ-M^Qj{3z7bcu@8$EFLfjXs=6X^yST9C#O@qbnu& zl=(U%i1~l?Zc-hJ*_pbQww>Tv)8bE@uRNb^+nC%OI2^BQth2GWtZ1_F1+y}_#Gvo~ zl`uE6$biBh5=*v;lQ@L3Z7+0pk3-W_iBFDwUs^*afM^L!?1K=hgDuS`j{f5~}YRDn{Ktci>Lm z1a?UbmA||lXF{s5FAl;@%rCBl4%hW~mD*hNg7R)2>RQ%?TG%&HPi9GzBhcuB<4qpk zaESL@ep(2L`_fSbm-~Jn{cZyj%4gDU)ki}NPJRk(U+n33kL<2CZT&Pcnb2y0If$!H zLqXT;O1`Fa23kqgI(tVBkZn5VWSAal>D+R$bz-}eCz6S} zl-njFww_N3xs+QH*VZ|+{fzlK3aNooncv=G8ZcmbbtxdOzfqF4fLj{>e12lS=KUUN zp8nr=JKF|7cTEp>z$a$%Wgj}SmuK!_WoOYlPs(z1d3L8J9=3m#@BJvd+OJ*nSM+0T h;mD%4PV3Z{d*6Fwj7yeC#!ZU90)x(?{pu;)^AAQNtmFUy diff --git a/web/img/ui/bt QUIT.png b/web/img/ui/bt QUIT.png index 86f2d0e0e2493de9c1158d47c80d08e529a8f9b8..62878bc3e9cb680fd6aac62bf429e14960a7bf3f 100644 GIT binary patch delta 1411 zcmV-}1$_F85X1|RBL)E8P)t-skx?m;U=4pWGczYACjkKg00000001B$AT>5N6ciK- z3kwJc2mk;8000000000004*&oR#sLyIyx5@7a<`bL`6kMM@LanQ9eFCI5;?HXlOw~ zLOVM-zK5)BN-H&&zNC00eGHL_t(| z+U(NnYJ)HUhT*hJJRdi8uIH6*5iNfcsaTZ!3enK}zoDfo8x;ooHxlr@f`^X}Kxm=> z$XgJiErjr49DpdXJ!2+qhG*G6Kqefs&BTfwZ7yk1q^%q`HmprBf&*m7ESI;QzP_g~ znyY($cn1f8=QJdjw@cp(db)6QD?#vw4GgW2*)7}Kb90aS>M*-$r4 zQ!ez4sS+ELb5oY(&b1I!iH&~;!R|860BW&G-F02@68mbgaV@0PvukhFVz)(ARZotE z)ME1@%d*Fn7plb`iqq+I)QmtaHm{DNXa*+sfAqzkPwZct*c1EDCiW*gb+GC%2t)z& zcN|biJ5D2&L?xU4{};U&hZ;o4Yrv3&cQtpq$mtN$*@x-u&OS_MclLi_I=izE)7hPU zn47W3$L#Dd4A#w$F|T3R0%b4eml-NCug2^V%>Hrkg&W?~`oQ6TPzf|-^Rc{nrWn7w z6EB&adojyrHL@xDwVG{k6Dg%=a>1^0c7I64b5Cw?)4kbFp@3p~e&X7B)t*gQTxd>gx;L9&ZB;xQ@6LY~C7TzW{nySJ>^KMl zVK~{tX3u))1N5Mi#keYBkVrLL`u=uBX&sGI&5r) zQwbc4!aJc2n%sFDJ##*Gj#ITbZgK9)zbEEAK#!e|-Q#hi1`ApZ3XdDHG4(tY?dtXC zV|Q*v^)&uijgx=&N-N&1=EmdaV`G8M1~pnTg{76it717=kF!_b0H2=#u(7~4!(G+t zJ{Y&a<;K*vNvUb|x)88eG-isTFs#7>5dY7e3A!jWIFDyRU?cZNaGN@h8->(I*!n%# znG}Dq>vlCu-zcTOC-5Eg`KLEvBO4ceWp`UIzTLazGn6qP>yrd^>Sd<6gu3vllM5!)`FVg4vXUgdJn{gkq%VH>>5Km$>yl=&=r0HmCqTsS RM~46a002ovPDHLkV1iq1hDHDY delta 1908 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 C7Gqri literal 3837 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 diff --git a/web/img/ui/bt SAVE.png b/web/img/ui/bt SAVE.png index 0e8bb08e4ff72bbbec70c14146b5140cbde344ad..9db4f68ac414dc996510ce3dab59ad50f8029aae 100644 GIT binary patch literal 2667 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 diff --git a/web/img/ui/bt SELECT.png b/web/img/ui/bt SELECT.png index 12ced4c4eea3e877c3c70c9b1be31027ff17a1bb..d9006eac6a07bf48f11b01ad37b118ed96b89676 100644 GIT binary patch delta 1764 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 blSTgn1-2!i-s_}{00000NkvXXu0mjf^0r^w diff --git a/web/img/ui/bt SHARE.png b/web/img/ui/bt SHARE.png index 60691834dc4a83e7ff55c42ddf7dc3fd274407bd..89db69def36a9d0d832c7b52e5727c56521f4a6d 100644 GIT binary patch delta 1932 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 SAl8@w00000s=WYIw2t;5D*X^9v(0- zFb@w8A0Qx6QBeW{0y#N3BO@bMS62)S3@Iro9UUD#Jv}uwHDO_4R#sLM6B9>AM=GcqzLCnrr!O;1oz6%!LkNl83AJ4i@K9UB`L6%{8Y zCNM8ABqJjn8h;u?LqjkyFgrRrL`6k3Gc!R!K^7Dg8W(0DTo0BmxGJS4K%NODzsMCN-I->67#4zv20=)BKd{()+OIzx(0*`M>kw{PPubP!RwC2XaY7K~#9!?VRa% z5=juiNq>UTO^hZQZ(Z;E)~M^f_kGWdnXoV!V7PAxgwq59I^U=wo3x-IUl{&tj~YHwLMwExs@kUgC#K5ArVT=K zYJCBQWuajgQ|8$tu=B3ATD!8TGO<1J4s(ieMLJpOcQGk*hmC7ix;hJpO9}coQ)#Hr z2*+k3Le&Uoi_x!Ss!VLB!OV2V$A3ni`DHRw%oug|r_3g{oiefw`QkT1ub>R~P28h* z)-5n)9~7!S8wt2wskC+lQ)ObSQ;}$_izX=?$0-L%B#rU3nYC!u;RQrz1)T;b2u>e& zn7YGRQ-hRHl_JMyj7yAq1yki=>r>q$x?V~+S~Ae@a$*mOLSqpRfnOQ?e1DJefG%rG zmak1IO>x#uN|`DX+hp)60fKd4U_b!}vy8d)m_}J>ETsnc{bFYRdSmty*f>s_mMkSr zm5Hr3(tsL%tpeawmnEx^86~$9$#vmWZSLWBu%Rg{gfotmG*u?HdxjF43WA?7kCnvs zbj!F-JzO(ACM%4M^}ts*vwv6#>>5Ql`qqPWD3MUMgHzp$m@HCEVz|9Kev%0URp+Di51i)i@yJNGVh0VpGsZZ0-~r z)6_%yV7>y+l63_vyaXJJz<~EE?++GMRq*doR>D;I8z98CET-A;*neSWW=#)OD`4x? z5C}^EER(@mNL3%O@S9B~uty;_DI0Se`qNAw<6>^xN@KfY;Ptb6BsLyvD$6cZ9hOf_u@ihTS$0QQ4RBC-}uibpdR1Ia#n8|Y@twi4K~F@HLN!r;&$q<#nB{_^$2AhvD%k1O+K>uw|(XpKF zXS|PK*khPnM2B)Wz%DjZO6uTtXMJ8NY!+PW6Ovmd`st!$y@~^$1^Xpj7^K%;G`L%X zSmm%;38{K|2CNzGfU)RUgZDv(;fO`dY50*!E`^I=E9SAvVt+$<0B4=@tBZ~0G?>5? z(-TZbpIw)e24=7avhPk+Ic(hIUJi62KBayb%!FICHeXf4S1=pZzXo%16 zi;U&z_EYaJJbyk7+pj6`kdi^Ft>Di+#?qJ>T>d>Y8B z+OpAr^hW54I7w{6WFdQJ>?}7M+EQ*FJ6L2anEc_mM#T&74DsQ7Rerh`BhHHWHaOgn zvVfuA<%+ny@cbk%GDYE~B=8Z%^4AGGn+E2nYT>#wFP!9n5Ecb;8a0nWB(}p+A@ph zW5FEFVaiT-j;VjWZwKW$>no9aQqaRz_z&9%NdBxsTN)5shK#;E)lBRn0(e1F?;%Rg zYvdrXTYm@SnvnQMv4|~Vi`XKzh%I7^*dn%wEnvHL@;(QZ*PY z%~K!y43XM9qYn}eA|uE0D;-e;0Zd+* z?LtG#Ibnr5Y3q@yp5?Zi$8KDIw;o`1S6^IRtokCNwJy=DEc!PiXY&n3CBNwa0000< LMFvhpu0mjfdtp-y diff --git a/web/img/ui/bt X.png b/web/img/ui/bt X.png index f1631c1298e9c207fb5a90d03f1f787b4c23421a..d3fbf8f04b629e66435345e592583de934a327f7 100644 GIT binary patch delta 3511 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 Tc~AKHM?_?(XR7-K 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 b|9+TbWb&&BFNN&ipG8J6bG=#})Z_mFoOPoc diff --git a/web/img/ui/frame.png b/web/img/ui/frame.png index f48c51291959d796df037bea84bd2c86e2be1842..3cec1c8811a7546c4ecf3985b9ccb6d9c7055932 100644 GIT binary patch literal 2678 zcmeAS@N?(olHy`uVBq!ia0y~yV3uKEV0zEN3>3Ms!q^f>*#!86xGHGt35rX~Yw3!~ zDTvC*Nh+zzX=qC*C`qfR3rk7MsAHyUWOG*Qkp`m$^N-97(k&+<4;K=%@ypr^| z?BvRX7>06>aBdrI>9Qe*{gypX3tIw8>H^LV)d$Ihwc^j<2R4(nr0x^V5mBw)b{m?_Rt%5 z0^6O-n~f5#eqMPyaQWkc^`Cyr^+jGTXfT|0{Lj3;m!FDO@*Xb@p2*gtRd^FQLJrfe{bqfd20i1z=P$D4e)o)x>*B zu}#L{NrNIgk7dFMMrS^Wq5~6{sU(y%pN|D(6U)zN{|%0oN2q2nH62ONEHq!RP&bSS zT2GZ&5kQUeg*1t7ntKJ!7c@+{wDgJ~YFsGN(k?1zXoOR5EN5l}Wo^fQ*MxHd_;{&b zcp&VeSz>KQ^MxUe%0b$Cr4P*)2Zv%Yd&Ewb1C*XPK5d_u&|H*3wW?@qyuPPUlY@w> zt834sBlrJ(ztxa7y^Q7ZyeGEIWd)B_GZgq1G+H#UJz|jRV8-A)tba5?yRXwCA@aU| zxXh=nB=Rqjrm?RL~iX( zm&x9~+rC`1^1uSS>iE#S_kQ2!_5~fk#H^;flvlRz&6`INk9RCz92541v3lClJ0af- zu2>wqadgS$!hH9Q49k3O?v=KZ(LBC!r`MLgJ#r0}^ZU0cuDewvVFPYgkuQ=>xGbY!F$>p91d)(1}*(yu!AoH`9S#8@M_C-88F{%2=MAic{5-*sn z5;5)DktM6zU&wGq(p&1*F)35Nwa&io>!h!g$RrneEOp4C?NG zdYyAmGCo_XyYKM@8#i_dvn(m80<{9zbc;6oe#Z4hc1g^1JfFjV-)z4*} HQ$iB}u4tvB literal 3084 zcmeH}eN@xe8ONh^y0QZ}*C{U{5eQHLWnxhR0cxvg3I-8SUP3@fjDRG(h47LX*Pc~c zLO6s01tV;QT7)DNF(3pIx+xKaIBJs!Awh_el7tt5Bof~CLpRs0{NavgXaDq^&pG$p z@9*B{KKHrzxxeSLQ>fz>=C2;76AMXfSvtIehY?dU=Q8(63CuiFW3!r*kF&N^#)GX4o)@> zFdN60INLhC#KjH<;A-dmE*QWCV6Q!Zs~Z61UH1+4x;Z7!e>^?Jt-aL* z#33U4G%9?{RlBhfPX6cP=3T6CZ~`qhn%YqCpAl@30_{c`EYgk%-)p z>Cux6u&n&k@!8Qrwxh#G*Z-DtzxzvR&n=JSYrCF6-><2ftNDV7D`L}ci#};^ zE5{y2;1Lfl-wVlnr>7_@6bsWXAfCzbl~?ck20cbkj&jMe!-4&OuIXC-YpanE=Zw-# zk14xM;|kMr4cYTja$-86y?r5cj54P!8XPvasTM;Ubog>IkmvaiVbtSc&__fIc49_*yg}MqH z{VN&fp%wC5KAVYli;bMVKWaoVji#apkcsDW$C%jYiq7wEE~eK{peyo*kH?E18DV(` zpe~}b>v^niq_|N=V_047Ma>-JDsm8#8n0x8#WE>#dQo5X%1qtzAworPF)yg(CL^n{ zybC|5)GU!g+h9v`MxnU6i`GF*VykX`U&xPSxfj>-D?4;D9+BZIHI{kPR&Y!Y?ci-T z5ToLZmF2rQ)mw(7odfXmq^J31%CfF?Q9P%EqY9ARc??Kb?CQqPpv0r-n##n4*fcr zJrZXpCafoe(+E8ehlc_~82hTuSb5kXy~+kZuw1|7&<8Ko22(66{rQuNr0w`Lr>fR`2=G&3@L|K}jnb^zxU4pWPrR)^UO$Q_ zDzbu^e3IX`e*Ni!X-PrxR9GAee|=J?R0pW_QTw@CBav996v@>xuD`b_N>XfvYW;)j z)BwDoR>m1KD3MA*bin$U8rc~X8A+0`;SUw4vn&-tqUa_Y2B-wNAWdEY8(T{myb5P3 zMasUeMK)yEukTAsR6^i+Q9yxMD~MAI$jl{|RLtrWj@g}=byDUf!bBqbjZaxgIp77S zR%4n_%ufqt3I+Yu6l0=4WT1OkLtuO7|FPK&E*nmf>e38{W*Hw!3^MG=fF;vzxF)Ji zUgMo|3tE{4Ie25ZwLoxfc_;`&W3rI}YqeHPthPf}8B+n-w%ygvzSYp(+&wD_-6C9_ z1!p|b=a#~jS-~ZF?S}l(K3?epw@FpPX&X_m?ysR3eXTMmrl<1=WWGFA(U>)@@_hVO zTLez4ga`!Bm*WFYGEE5N{M{>1#P#=PX3un7V5v@!MmeVODmig|KDy>kDP?tj!s`gP zIZ!~;=Z0%kfizVSP^Vp5P+vJz!`>wnLu-U&l_ourOj}-)Sk2bVD4OSARDpM|p~daF j16uuzX>#G~+Ep{-0K$V-+Q|gUS`hLW>L~YvgpdCYe~z(= diff --git a/web/js/gui/gui.js b/web/js/gui/gui.js index 361fe72b..0d14ebff 100644 --- a/web/js/gui/gui.js +++ b/web/js/gui/gui.js @@ -43,7 +43,7 @@ const gui = (() => { return el; } - const panel = (root, title = '', cc = '', content, buttons = []) => { + const panel = (root, title = '', cc = '', content, buttons = [], onToggle) => { const state = { shown: false, loading: false, @@ -99,6 +99,9 @@ const gui = (() => { function toggle(show) { state.shown = show; + if (onToggle) { + onToggle(state.shown, _root) + } if (state.shown) { gui.show(_root); } else { diff --git a/web/js/workerManager.js b/web/js/workerManager.js index 4601530e..d8fe4d18 100644 --- a/web/js/workerManager.js +++ b/web/js/workerManager.js @@ -7,13 +7,19 @@ const workerManager = (() => { _class = 'server-list', trigger = document.getElementById('w'), panel = gui.panel(document.getElementById(id), 'WORKERS', 'server-list', null, [ - { - caption: '⟳', - cl: ['bold'], - handler: utils.debounce(handleReload, 1000), - title: 'Reload server data', - } - ]), + { + caption: '⟳', + cl: ['bold'], + handler: utils.debounce(handleReload, 1000), + title: 'Reload server data', + } + ], + // hack not transparent jpeg corners :_; + ((br) => (state, el) => { + state ? el.parentElement.style.borderRadius = '0px' : + br ? el.parentElement.style.borderRadius = br : + br = window.getComputedStyle(el.parentElement).borderRadius + })()), index = ((i = 1) => ({v: () => i++, r: () => i = 1}))(), // caption -- the field caption // renderer -- an arbitrary DOM output for the field From b6d6e464ed696b2856d57d05a160a6f9a3327ceb Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 26 Apr 2023 20:11:08 +0300 Subject: [PATCH 018/361] Optimize images --- web/img/ui/bg.jpg | Bin 0 -> 69282 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 web/img/ui/bg.jpg diff --git a/web/img/ui/bg.jpg b/web/img/ui/bg.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d396a3ff18a1f0691788c8f7c45159e3f9271a36 GIT binary patch literal 69282 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 Date: Wed, 26 Apr 2023 23:07:13 +0300 Subject: [PATCH 019/361] Add ca-certificates to the images --- scripts/install.sh | 1 + 1 file changed, 1 insertion(+) diff --git a/scripts/install.sh b/scripts/install.sh index edfb14b5..9a3c7219 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -16,6 +16,7 @@ if [ "$deps" = "x11-only" ]; then xvfb else apt-get -qq install --no-install-recommends -y \ + ca-certificates \ libvpx7 \ libx264-164 \ libopus0 \ From d9def73096cd490a408cee5f15260e79b62e0b82 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 26 Apr 2023 23:07:13 +0300 Subject: [PATCH 020/361] Add ca-certificates to the images --- scripts/install.sh | 2 ++ 1 file changed, 2 insertions(+) diff --git a/scripts/install.sh b/scripts/install.sh index edfb14b5..550fbc37 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -12,10 +12,12 @@ fi apt-get -qq update if [ "$deps" = "x11-only" ]; then apt-get -qq install --no-install-recommends -y \ + ca-certificates \ libgl1-mesa-dri \ xvfb else apt-get -qq install --no-install-recommends -y \ + ca-certificates \ libvpx7 \ libx264-164 \ libopus0 \ From 7455ad3f4731b8870ac78cb5830e999735c9276e Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 26 Apr 2023 23:27:00 +0300 Subject: [PATCH 021/361] Update deployment to cloudretro.io --- .github/workflows/cd/cloudretro.io/config.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/cd/cloudretro.io/config.yaml b/.github/workflows/cd/cloudretro.io/config.yaml index 91f06f93..4479466d 100644 --- a/.github/workflows/cd/cloudretro.io/config.yaml +++ b/.github/workflows/cd/cloudretro.io/config.yaml @@ -6,7 +6,7 @@ coordinator: address: https: true tls: - domain: usw.cloudretro.io + domain: cloudretro.io analytics: inject: true gtag: UA-145078282-1 @@ -14,8 +14,8 @@ coordinator: worker: debug: true network: - coordinatorAddress: usw.cloudretro.io - publicAddress: usw.cloudretro.io + coordinatorAddress: cloudretro.io + publicAddress: cloudretro.io secure: true server: https: true From ea3263ca6c0c2640174797f1319e9442649d1b4d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 27 Apr 2023 12:24:07 +0300 Subject: [PATCH 022/361] Remove unselected --- web/css/main.css | 11 ++--------- web/index.html | 34 +++++++++++++++++----------------- 2 files changed, 19 insertions(+), 26 deletions(-) diff --git a/web/css/main.css b/web/css/main.css index 294a800e..b038620b 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -35,6 +35,8 @@ body { background-repeat: no-repeat; background-size: 100% 100%; border-radius: 22px; + + user-select: none; } #help-overlay { @@ -432,15 +434,6 @@ body { } } - -*.unselectable { - -moz-user-select: -moz-none; - -khtml-user-select: none; - -webkit-user-select: none; - -ms-user-select: none; - user-select: none; -} - #room-txt { position: absolute; width: 59px; diff --git a/web/index.html b/web/index.html index d6f83333..13f4060d 100644 --- a/web/index.html +++ b/web/index.html @@ -51,46 +51,46 @@

-
-
-
+
+
+
- player choice + player choice
-
-
-
+
+
+
-
-
-
-
+
+
+
+
-
+
- + -
Oh my god
+
Oh my god
-
+
{{if .Recording.Enabled}} -
+ class="record-user"> +
{{end}}
-
+
Pus-w4G)g32{?Hb3$B>!i8qErxs) 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 z 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 Date: Thu, 27 Apr 2023 16:14:44 +0300 Subject: [PATCH 032/361] Speedup item pick --- web/css/main.css | 8 +++----- web/js/gameList.js | 34 ++++++++++++++++------------------ 2 files changed, 19 insertions(+), 23 deletions(-) diff --git a/web/css/main.css b/web/css/main.css index bf2ddf6d..051dde01 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -532,14 +532,12 @@ body { .menu-item div .pick { overflow: unset; +} + +.text-move { animation: horizontally 4s linear infinite alternate; } -.menu-item div .pick-over { - overflow: unset; -} - - @-moz-keyframes horizontally { 0% { transform: translateX(0%); diff --git a/web/js/gameList.js b/web/js/gameList.js index 3408d4f9..d755f32d 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -27,15 +27,19 @@ const gameList = (() => { .join(''); }; + let pickItems; + const show = () => { render(); menuItemChoice.style.display = "block"; + pickItems = listBox.querySelectorAll(`.menu-item span`); pickGame(); }; const pickDelayMs = 150 + let picking = false - const pickGame = (index, hold) => { + const pickGame = (index) => { let idx = undefined !== index ? index : gameIndex; // check boundaries @@ -48,21 +52,18 @@ const gameList = (() => { menuTop = MENU_TOP_POSITION - idx * 36; listBox.style['top'] = `${menuTop}px`; - const cl = hold ? 'pick-over' : 'pick' - let pick = listBox.querySelectorAll('.menu-item .pick, .menu-item .pick-over')[0]; - - setTimeout(() => { // overflow marquee - if (pick) { - pick.classList.remove('pick'); - pick.classList.remove('pick-over') - } - listBox.querySelectorAll(`.menu-item span`)[idx].classList.add(cl); - }, 50) - + let pick = listBox.querySelectorAll('.menu-item .pick')[0]; + if (pick) { + pick.classList.remove('pick', 'text-move'); + } + const i = pickItems[idx]; + setTimeout(() => i.classList.add('pick'), 50) + !picking && i.classList.add('text-move') gameIndex = idx; }; const startGamePickerTimer = (upDirection) => { + picking = true if (gamePickTimer !== null) return; const shift = upDirection ? -1 : 1; pickGame(gameIndex + shift); @@ -75,15 +76,12 @@ const gameList = (() => { }; const stopGamePickerTimer = () => { + picking = false + pickItems[gameIndex] && pickItems[gameIndex].classList.add('text-move') + if (gamePickTimer === null) return; clearInterval(gamePickTimer); gamePickTimer = null; - - const pick = listBox.querySelectorAll('.menu-item .pick-over')[0]; - if (pick) { - pick.classList.remove('pick-over'); - pick.classList.add('pick'); - } }; const onMenuPressed = (newPosition) => { From f7d8a5dc5014ee1db7cf483502348ba6ef9aadd5 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 27 Apr 2023 16:27:05 +0300 Subject: [PATCH 033/361] Revert opts z-index --- web/css/main.css | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/css/main.css b/web/css/main.css index 051dde01..a6717463 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -372,7 +372,7 @@ body { background-image: url('/static/img/ui/bt OPTIONS.png'); opacity: .7; - z-index: 1; + z-index: 0; } #lights-holder { From 2add701c3979792b8e3a896d3c842e95a6ed990e Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 27 Apr 2023 19:50:07 +0300 Subject: [PATCH 034/361] Update game picker interface --- web/js/gameList.js | 66 ++++++++++++++++++++++++---------------------- 1 file changed, 34 insertions(+), 32 deletions(-) diff --git a/web/js/gameList.js b/web/js/gameList.js index d755f32d..cd68c3f5 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -13,57 +13,58 @@ const gameList = (() => { const menuItemChoice = document.getElementById('menu-item-choice'); const MENU_TOP_POSITION = 102; + const MENU_SELECT_THRESHOLD_MS = 180; let menuTop = MENU_TOP_POSITION; + let menuInSelection = false; + const MENU_TRANSITION_DEFAULT = `top ${MENU_SELECT_THRESHOLD_MS}ms`; + + listBox.style.transition = MENU_TRANSITION_DEFAULT; + + let gamesElList; const setGames = (gameList) => { - games = gameList.sort((a, b) => a > b ? 1 : -1); + games = gameList !== null ? gameList.sort((a, b) => a > b ? 1 : -1) : []; }; const render = () => { log.debug('[games] load game menu'); - listBox.innerHTML = games .map(game => `
${game}
`) .join(''); }; - let pickItems; - const show = () => { render(); + gamesElList = listBox.querySelectorAll(`.menu-item span`); menuItemChoice.style.display = "block"; - pickItems = listBox.querySelectorAll(`.menu-item span`); pickGame(); }; - const pickDelayMs = 150 - let picking = false + const bounds = (i = gameIndex) => (i % games.length + games.length) % games.length + const clearPrev = () => { + let prev = gamesElList[gameIndex] + if (prev) { + prev.classList.remove('pick', 'text-move'); + } + } const pickGame = (index) => { - let idx = undefined !== index ? index : gameIndex; + clearPrev() + gameIndex = bounds(index) - // check boundaries - // cycle - if (idx < 0) idx = games.length - 1; - if (idx >= games.length) idx = 0; + const i = gamesElList[gameIndex]; + if (i) { + setTimeout(() => i.classList.add('pick'), 50) + !menuInSelection && i.classList.add('text-move') + } // transition menu box - listBox.style['transition'] = `top ${pickDelayMs}ms`; - menuTop = MENU_TOP_POSITION - idx * 36; - listBox.style['top'] = `${menuTop}px`; - - let pick = listBox.querySelectorAll('.menu-item .pick')[0]; - if (pick) { - pick.classList.remove('pick', 'text-move'); - } - const i = pickItems[idx]; - setTimeout(() => i.classList.add('pick'), 50) - !picking && i.classList.add('text-move') - gameIndex = idx; + menuTop = MENU_TOP_POSITION - gameIndex * 36; + listBox.style.top = `${menuTop}px`; }; const startGamePickerTimer = (upDirection) => { - picking = true + menuInSelection = true if (gamePickTimer !== null) return; const shift = upDirection ? -1 : 1; pickGame(gameIndex + shift); @@ -72,12 +73,12 @@ const gameList = (() => { // keep rolling the game list if the button is pressed gamePickTimer = setInterval(() => { pickGame(gameIndex + shift, true); - }, pickDelayMs); + }, MENU_SELECT_THRESHOLD_MS); }; const stopGamePickerTimer = () => { - picking = false - pickItems[gameIndex] && pickItems[gameIndex].classList.add('text-move') + menuInSelection = false + gamesElList[gameIndex] && gamesElList[gameIndex].classList.add('text-move') if (gamePickTimer === null) return; clearInterval(gamePickTimer); @@ -85,14 +86,15 @@ const gameList = (() => { }; const onMenuPressed = (newPosition) => { - listBox.style['transition'] = ''; - listBox.style['top'] = `${menuTop - newPosition}px`; + clearPrev() + listBox.style.transition = ''; + listBox.style.top = `${menuTop - newPosition}px`; }; const onMenuReleased = (position) => { + listBox.style.transition = MENU_TRANSITION_DEFAULT menuTop -= position; - const index = Math.round((menuTop - MENU_TOP_POSITION) / -36); - pickGame(index); + pickGame(Math.round((menuTop - MENU_TOP_POSITION) / -36)); }; event.sub(MENU_PRESSED, onMenuPressed); From 3175747ee5782007800fd801d4b3d4ade7e271cc Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Tue, 2 May 2023 00:20:07 +0300 Subject: [PATCH 035/361] Update README.md --- README.md | 25 ++++++++----------------- 1 file changed, 8 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 58734c9b..c6963e80 100644 --- a/README.md +++ b/README.md @@ -10,10 +10,9 @@ on generic solution for cloudgaming Discord: [Join Us](https://discord.gg/sXRQZa2zeP) -## Announcement -**Due to the current economic recession, i'm unable to keep demo server. Google Stadia also shutdown the Cloud service because of high cost and low adoption. I still believe Cloud Gaming is a brilliant idea and it should keep getting more investment. I open source my works so that everyone can experience self-hosting cloud gaming service to hold this spirit. You can check the rest of idea in the wiki** +![screenshot](https://user-images.githubusercontent.com/846874/235532552-8c8253df-aa8d-48c9-a58e-3f54e284f86e.jpg) -## Try the service at **[cloudretro.io](https://cloudretro.io)** +## Try it at **[cloudretro.io](https://cloudretro.io)** Direct play an existing game: **[Pokemon Emerald](https://cloudretro.io/?id=1bd37d4b5dfda87c___Pokemon%20-%20Emerald%20Version%20(U))** ## Introduction @@ -92,10 +91,11 @@ the service on `localhost:8000`. ## Configuration -The configuration parameters are stored in the [`configs/config.yaml`](configs/config.yaml) file which is shared for all -application instances on the same host system. It is possible to specify individual configuration files for each -instance as well as override some parameters, for that purpose, please refer to the list of command-line options of the -apps. +The default configuration file is stored in the [`pkg/configs/config.yaml`](pkg/config/config.yaml) file. +This configuration file will be embedded into the applications and loaded automatically during startup. +In order to override (change) the default parameters you can specify environment variables with the `CLOUD_GAME_` prefix +(except list params), or place a custom `config.yaml` file into one of these places: just near the application or in the `configs` folder, +`.cr` folder in user's home, or specify own directory with `-w-conf` application param (`worker -w-conf /usr/conf`). ## Deployment @@ -106,15 +106,11 @@ application [installed](https://docs.docker.com/compose/install/). ## Technical documents +- [Design document v2](DESIGNv2.md) - [webrtchacks Blog: Open Source Cloud Gaming with WebRTC](https://webrtchacks.com/open-source-cloud-gaming-with-webrtc/) - [Wiki (outdated)](https://github.com/giongto35/cloud-game/wiki) - - [Code Pointer Wiki](https://github.com/giongto35/cloud-game/wiki/Code-Deep-Dive) -| High level | Worker internal | -| :----------------------------------: | :-----------------------------------------: | -| ![screenshot](docs/img/overview.png) | ![screenshot](docs/img/worker-internal.png) | - ## FAQ - [FAQ](https://github.com/giongto35/cloud-game/wiki/FAQ) @@ -131,11 +127,6 @@ By clicking these deep link, you can join the game directly and play it together And you can host the new game by yourself by accessing [cloudretro.io](https://cloudretro.io) and click "share" button to generate a permanent link to your game. -

-
-Synchronize a game session on multiple devices -

- ## Credits We are very much thankful to [everyone](https://github.com/giongto35/cloud-game/graphs/contributors) we've been lucky to From 73639eeb642b6da31b1c5ac18961145107bc7c13 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 2 May 2023 11:25:51 +0300 Subject: [PATCH 036/361] Clean docs --- .dockerignore | 2 +- DESIGNv2.md | 79 +++++++++++++++++++++++++++++++++++ docs/DESIGNv2.md | 25 ----------- docs/img/coordinator.png | Bin 14730 -> 0 bytes docs/img/multiplatform.png | Bin 355726 -> 0 bytes docs/img/overview.png | Bin 16331 -> 0 bytes docs/img/worker-internal.png | Bin 19990 -> 0 bytes 7 files changed, 80 insertions(+), 26 deletions(-) create mode 100644 DESIGNv2.md delete mode 100644 docs/DESIGNv2.md delete mode 100644 docs/img/coordinator.png delete mode 100644 docs/img/multiplatform.png delete mode 100644 docs/img/overview.png delete mode 100644 docs/img/worker-internal.png diff --git a/.dockerignore b/.dockerignore index 3cb82b19..d85038cf 100644 --- a/.dockerignore +++ b/.dockerignore @@ -11,8 +11,8 @@ Dockerfile LICENSE README.md +DESIGNv2.md bin/ -docs/ release/ assets/games/ diff --git a/DESIGNv2.md b/DESIGNv2.md new file mode 100644 index 00000000..838677f5 --- /dev/null +++ b/DESIGNv2.md @@ -0,0 +1,79 @@ +# Cloud Gaming Service Design Document + +Cloud Gaming Service contains multiple workers for gaming streams and a coordinator for distributing traffic and pairing +up connections. + +## Coordinator + +Coordinator is a web-frontend, load balancer and signalling server for WebRTC. + +``` + WORKERS + ┌──────────────────────────────────┐ + │ │ + │ REGION 1 REGION 2 REGION N │ + │ (US) (DE) (XX) │ + │ ┌──────┐ ┌──────┐ ┌──────┐ | + COORDINATOR │ │WORKER│ │WORKER│ │WORKER│ | +┌───────────┐ │ └──────┘ └──────┘ └──────┘ | +│ │ ───────────────────────HEALTH────────────────────► │ • • • | +│ HTTP/WS │ ◄─────────────────────REG/DEREG─────────────────── │ • • • | +│┌─────────┐│ │ • • • | +│| |│ USER │ ┌──────┐* ┌──────┐ ┌──────┐ | +│└─────────┘│ ┌──────┐ │ │WORKER│ │WORKER│ │WORKER│ | +│ │ ◄──(1)CONNECT───────── │ │ ────(3)SELECT────► │ └──────┘ └──────┘ └──────┘ | +│ │ ───(2)LIST WORKERS───► │ │ ◄───(4)STREAM───── │ │ +└───────────┘ └──────┘ │ * MULTIPLAYER │ + │ ┌──────┐────► ONE GAME │ + │ ┌───►│WORKER│◄──┐ │ + │ │ └──────┘ │ │ + │ │ ▲ ▲ │ │ + │ ┌┴─┐ │ │ ┌┴─┐ | + │ │U1│ ┌─┴┐ ┌┴─┐ │U4│ | + │ └──┘ │U2│ │U3│ └──┘ | + │ └──┘ └──┘ | + │ | + └──────────────────────────────────┘ +``` + +- (1) A user opens the main page of the app in the browser, i.e. connects to the coordinator. +- (2) The coordinator searches and serves a list of most suitable workers to the user. +- (3) The user proceeds with latency check of each worker from the list, then coordinator collects user-to-worker + latency data and picks the best candidate. +- (4) The coordinator sets up peer-to-peer connection between a worker and the user based on the WebRTC protocol and a + game hosted on the worker is streamed to the user. + +## Worker + +Worker is responsible for running and streaming games to users. + +``` + WORKER +┌─────────────────────────────────────────────────────────────────┐ +│ EMULATOR WEBRTC │ BROWSER +│ ┌─────────────────┐ ENCODER ┌────────┐ │ ┌──────────┐ +│ │ │ ┌─────────┐ | DMUX | | ───RTP──► | WEBRTC | +│ │ AUDIO SAMPLES │ ──PCM──► │ │ ──OPUS──► │ ┌──► │ │ ◄──SCTP── | | +│ │ VIDEO FRAMES │ ──RGB──► │ │ ──H264──► │ └──► | | └──────────┘ COORDINATOR +│ │ │ └─────────┘ │ │ │ • ┌─────────────┐ +│ │ │ | MUX | | ───TCP──────── • ───────► | WEBSOCKET | +│ │ │ │ ┌── │ │ • └─────────────┘ +| | | BINARY | ▼ | | BROWSER +│ │ INPUT STATE │ ◄───────────────────────────── │ • │ │ ┌──────────┐ +│ │ │ │ ▲ │ │ ───RTP──► | WEBRTC | +│ └─────────────────┘ HTTP/WS | └── | │ ◄──SCTP── │ │ +│ ┌─────────┐ └────────┘ │ └──────────┘ +| | | | +| └─────────┘ | +└─────────────────────────────────────────────────────────────────┘ +``` + +- After coordinator matches the most appropriate server (peer 1) to the user (peer 2), a WebRTC peer-to-peer handshake + will be conducted. The coordinator will help initiate the session between the two peers over a WebSocket connection. +- The worker either spawns new rooms running game emulators or connects users to existing rooms. +- Raw image and audio streams from the emulator are captured and encoded to a WebRTC-supported streaming format. Next, + these stream are piped out (dmux) to all users in the room. +- On the other hand, input from players is sent to the worker over WebRTC DataChannel. The game logic on the emulator + will be updated based on the input stream of all players, for that each stream is multiplexed (mux) into one. +- Game states (saves) are stored in cloud storage, so all distributed workers can keep game states in sync and players + can continue their games where they left off. diff --git a/docs/DESIGNv2.md b/docs/DESIGNv2.md deleted file mode 100644 index f6ade821..00000000 --- a/docs/DESIGNv2.md +++ /dev/null @@ -1,25 +0,0 @@ -# Web-based Cloud Gaming Service Design Document - -Web-based Cloud Gaming Service contains multiple workers for gaming stream and a coordinator (Coordinator) for distributing traffic and pairing up connection. - -## Worker - -Worker is responsible for streaming game to frontend -![worker](img/worker-internal.png) - -- After Coordinator matches the most appropriate server to the user, webRTC peer-to-peer handshake will be conducted. The coordinator will exchange the signature (WebRTC Session Remote Description) between two peers over Web Socket connection. -- On worker, each user session will spawn a new room running a gaming emulator. Image stream and audio stream from emulator is captured and encoded to WebRTC streaming format. We applied Vp8 for Video compression and Opus for audio compression to ensure the smoothest experience. After finish encoded, these stream is then piped out to user and observers joining that room. -- On the other hand, input from users is sent to workers over WebRTC DataChannel. Game logic on the emulator will be updated based on the input stream. -- Game state is stored in cloud storage, so all workers can collaborate and keep the same understanding with each other. It allows user can continue from the saved state in the next time. - -## Coordinator - -Coordinator is loadbalancer and coordinator, which is in charge of picking the most suitable workers for a user. Every time a user connects to Coordinator, it will collect all the metric from all workers, i.e free CPU resources and latency from worker to user. Coordinator will decide the best candidate based on the metric and setup peer-to-peer connection between worker and user based on WebRTC protocol - -![Architecture](img/coordinator.png) - -1. A user connected to Coordinator . -2. Coordinator will find the most suitable worker to serve the user. -3. Coordinator collects all latencies from workers to users as well as CPU usage on each machine. -4. Coordinator setup peer-to-peer handshake between worker and user by exchanging Session Description Protocol. -5. A game is hosted on worker and streamed to the user. diff --git a/docs/img/coordinator.png b/docs/img/coordinator.png deleted file mode 100644 index 55eebeb442ebe676b3f8f2bff6a92fb8c20b6f0c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14730 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 diff --git a/docs/img/multiplatform.png b/docs/img/multiplatform.png deleted file mode 100644 index 40fcf4f1b2b266babd6f9fe50a321290d7ba896e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 355726 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 BEiM26 diff --git a/docs/img/overview.png b/docs/img/overview.png deleted file mode 100644 index aa7ef1df6e0f735d5dc2880ec581269d8b3e0a2f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 16331 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 diff --git a/docs/img/worker-internal.png b/docs/img/worker-internal.png deleted file mode 100644 index 63c89d7c29fcac663e1d65a6d4a0cca7ab3b2453..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19990 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 Date: Tue, 2 May 2023 23:22:54 +0300 Subject: [PATCH 037/361] Remove the hack involving the /static route --- pkg/coordinator/coordinator.go | 47 +++++++++++----------- pkg/network/httpx/server.go | 6 +-- web/css/main.css | 72 +++++++++++++++++----------------- web/index.html | 54 ++++++++++++------------- web/js/stream/stream.js | 2 +- 5 files changed, 90 insertions(+), 91 deletions(-) diff --git a/pkg/coordinator/coordinator.go b/pkg/coordinator/coordinator.go index 232f6ab1..7a8fb200 100644 --- a/pkg/coordinator/coordinator.go +++ b/pkg/coordinator/coordinator.go @@ -3,6 +3,7 @@ package coordinator import ( "html/template" "net/http" + "strings" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" @@ -35,11 +36,7 @@ func New(conf config.CoordinatorConfig, log *logger.Logger) (services service.Gr func NewHTTPServer(conf config.CoordinatorConfig, log *logger.Logger, fnMux func(*httpx.Mux) *httpx.Mux) (*httpx.Server, error) { return httpx.NewServer( conf.Coordinator.Server.GetAddr(), - func(s *httpx.Server) httpx.Handler { - return fnMux(s.Mux(). - Handle("/", index(conf, log)). - Static("/static/", "./web")) - }, + func(s *httpx.Server) httpx.Handler { return fnMux(s.Mux().Handle("/", index(conf, log))) }, httpx.WithServerConfig(conf.Coordinator.Server), httpx.WithLogger(log), ) @@ -48,35 +45,39 @@ func NewHTTPServer(conf config.CoordinatorConfig, log *logger.Logger, fnMux func func index(conf config.CoordinatorConfig, log *logger.Logger) httpx.Handler { const indexHTML = "./web/index.html" + indexTpl := template.Must(template.ParseFiles(indexHTML)) + + // render index page with some tpl values + tplData := struct { + Analytics config.Analytics + Recording config.Recording + }{conf.Coordinator.Analytics, conf.Recording} + handler := func(tpl *template.Template, w httpx.ResponseWriter, r *httpx.Request) { - if r.URL.Path != "/" { - httpx.NotFound(w) - return - } - // render index page with some tpl values - tplData := struct { - Analytics config.Analytics - Recording config.Recording - }{conf.Coordinator.Analytics, conf.Recording} if err := tpl.Execute(w, tplData); err != nil { log.Fatal().Err(err).Msg("error with the analytics template file") } } + h := httpx.FileServer("./web") + if conf.Coordinator.Debug { log.Info().Msgf("Using auto-reloading index.html") return httpx.HandlerFunc(func(w httpx.ResponseWriter, r *httpx.Request) { - tpl, _ := template.ParseFiles(indexHTML) - handler(tpl, w, r) + if r.URL.Path == "/" || strings.HasSuffix(r.URL.Path, "/index.html") { + tpl := template.Must(template.ParseFiles(indexHTML)) + handler(tpl, w, r) + return + } + h.ServeHTTP(w, r) }) } - indexTpl, err := template.ParseFiles(indexHTML) - if err != nil { - log.Fatal().Err(err).Msg("error with the HTML index page") - } - - return httpx.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) { - handler(indexTpl, writer, request) + return httpx.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if r.URL.Path == "/" || strings.HasSuffix(r.URL.Path, "/index.html") { + handler(indexTpl, w, r) + return + } + h.ServeHTTP(w, r) }) } diff --git a/pkg/network/httpx/server.go b/pkg/network/httpx/server.go index f09fb246..b98f8e79 100644 --- a/pkg/network/httpx/server.go +++ b/pkg/network/httpx/server.go @@ -57,10 +57,6 @@ func (m *Mux) ServeHTTP(w ResponseWriter, r *Request) { m.ServeMux.ServeHTTP(w, func NotFound(w ResponseWriter) { http.Error(w, "404 page not found", http.StatusNotFound) } -func (m *Mux) Static(prefix string, path string) *Mux { - return m.Handle(m.prefix+prefix, http.StripPrefix(prefix, http.FileServer(http.Dir(path)))) -} - func NewServer(address string, handler func(*Server) Handler, options ...Option) (*Server, error) { opts := &Options{ Https: false, @@ -194,3 +190,5 @@ func (s *Server) redirection() (*Server, error) { s.log.Info().Str("addr", addr).Msg("Start HTTPS redirect server") return srv, err } + +func FileServer(dir string) http.Handler { return http.FileServer(http.Dir(dir)) } diff --git a/web/css/main.css b/web/css/main.css index a6717463..38eae42a 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -1,6 +1,6 @@ @font-face { font-family: '6809'; - src: url('/static/fonts/6809-Chargen.woff2'); + src: url('/fonts/6809-Chargen.woff2'); } html { @@ -10,7 +10,7 @@ html { } body { - background-image: url('/static/img/background.jpg'); + background-image: url('/img/background.jpg'); background-repeat: repeat; align-items: center; @@ -31,7 +31,7 @@ body { margin-right: -50%; transform: translate(-50%, -50%); - background-image: url('/static/img/ui/bg.jpg'); + background-image: url('/img/ui/bg.jpg'); background-repeat: no-repeat; background-size: 100% 100%; border-radius: 22px; @@ -60,7 +60,7 @@ body { height: 100%; position: absolute; - background-image: url('/static/img/help_overlay.png'); + background-image: url('/img/help_overlay.png'); background-repeat: no-repeat; background-size: 100% 100%; } @@ -74,12 +74,12 @@ body { top: 155px; left: 22px; background-size: contain; - background-image: url('/static/img/ui/bt MOVE.png'); + background-image: url('/img/ui/bt MOVE.png'); z-index: 1; } .dpad-empty { - background-image: url('/static/img/ui/bt MOVE EMPTY.png') !important; + background-image: url('/img/ui/bt MOVE EMPTY.png') !important; } #guide-txt { @@ -105,13 +105,13 @@ body { pointer-events: none; opacity: 0.5; - background-image: url('/static/img/ui/bong.png'); + background-image: url('/img/ui/bong.png'); } .bong-full { opacity: 1.0 !important; - background-image: url('/static/img/ui/bong full.png') !important; + background-image: url('/img/ui/bong full.png') !important; } .dpad { @@ -124,13 +124,13 @@ body { #player-index { background-repeat: no-repeat; background-size: contain; - background-image: url('/static/img/ui/bt PlayerIndex.png'); + background-image: url('/img/ui/bt PlayerIndex.png'); } #btn-up { top: 18px; left: 50%; - border-bottom: 0px; + border-bottom: 0; border-radius: 3px; transform: translateX(-50%); } @@ -138,7 +138,7 @@ body { #btn-down { bottom: 18px; left: 50%; - border-top: 0px; + border-top: 0; border-radius: 3px; transform: translateX(-50%); } @@ -147,7 +147,7 @@ body { #btn-left { left: 18px; top: 50%; - border-right: 0px; + border-right: 0; border-radius: 3px; transform: translateY(-50%); } @@ -155,7 +155,7 @@ body { #btn-right { right: 18px; top: 50%; - border-left: 0px; + border-left: 0; border-radius: 3px; transform: translateY(-50%); } @@ -176,7 +176,7 @@ body { border-radius: 5px 5px 5px 5px; - box-shadow: 0px 0px 2px 2px rgba(25, 25, 25, 1); + box-shadow: 0 0 2px 2px rgba(25, 25, 25, 1); } #color-button-holder { @@ -210,28 +210,28 @@ body { } #btn-help { - padding-top: 0px; + padding-top: 0; width: 20px; height: 28px; top: 16px; left: 23px; - background-image: url('/static/img/ui/Help.png'); + background-image: url('/img/ui/Help.png'); } #btn-load { top: 20px; left: 435px; - background-image: url('/static/img/ui/bt LOAD.png'); + background-image: url('/img/ui/bt LOAD.png'); } #btn-save { top: 60px; left: 435px; - background-image: url('/static/img/ui/bt SAVE.png'); + background-image: url('/img/ui/bt SAVE.png'); } #btn-join { @@ -240,7 +240,7 @@ body { left: 22px; height: 25px; - background-image: url('/static/img/ui/bt SHARE.png'); + background-image: url('/img/ui/bt SHARE.png'); } #btn-quit { @@ -249,7 +249,7 @@ body { left: 75px; height: 25px; - background-image: url('/static/img/ui/bt QUIT.png'); + background-image: url('/img/ui/bt QUIT.png'); } #btn-rec { @@ -258,7 +258,7 @@ body { left: 373px; height: 9px; - background-image: url('/static/img/ui/bt REC.png'); + background-image: url('/img/ui/bt REC.png'); } .record { @@ -278,7 +278,7 @@ body { border-right-style: hidden; border-left-style: hidden; border-bottom-style: hidden; - background-image: url(/static/img/ui/FrameTEXT.png); + background-image: url('/img/ui/FrameTEXT.png'); background-size: cover; } @@ -312,7 +312,7 @@ body { left: 435px; height: 25px; - background-image: url('/static/img/ui/bt SELECT.png'); + background-image: url('/img/ui/bt SELECT.png'); } #btn-start { @@ -320,7 +320,7 @@ body { top: 100px; left: 489px; - background-image: url('/static/img/ui/bt START.png'); + background-image: url('/img/ui/bt START.png'); } #btn-a { @@ -329,7 +329,7 @@ body { transform: translateY(-50%); - background-image: url('/static/img/ui/bt A.png'); + background-image: url('/img/ui/bt A.png'); } @@ -339,7 +339,7 @@ body { transform: translateX(-50%); - background-image: url('/static/img/ui/bt B.png'); + background-image: url('/img/ui/bt B.png'); } #btn-x { @@ -347,7 +347,7 @@ body { left: 50%; transform: translateX(-50%); - background-image: url('/static/img/ui/bt X.png'); + background-image: url('/img/ui/bt X.png'); } @@ -356,7 +356,7 @@ body { left: 0; transform: translateY(-50%); - background-image: url('/static/img/ui/bt Y.png'); + background-image: url('/img/ui/bt Y.png'); } #btn-settings { @@ -369,7 +369,7 @@ body { padding: 0; transform: translateY(-50%); - background-image: url('/static/img/ui/bt OPTIONS.png'); + background-image: url('/img/ui/bt OPTIONS.png'); opacity: .7; z-index: 0; @@ -420,7 +420,7 @@ body { top: 48px; left: 23px; color: #bababa; - padding-left: 0px; + padding-left: 0; border-radius: 6px; outline: none; @@ -429,7 +429,7 @@ body { border-left-style: hidden; border-bottom-style: hidden; - background-image: url('/static/img/ui/FrameTEXT.png'); + background-image: url('/img/ui/FrameTEXT.png'); background-size: cover; } @@ -465,7 +465,7 @@ body { width: 256px; height: 240px; - background-image: url('/static/img/screen_background5.png'); + background-image: url('/img/screen_background5.png'); background-size: cover; z-index: 1; } @@ -638,7 +638,7 @@ body { background-color: transparent; background-repeat: no-repeat; background-size: contain; - background-image: url('/static/img/ui/FramePlayerIndex.png'); + background-image: url('/img/ui/FramePlayerIndex.png'); } /* Mouse-over effects */ @@ -657,7 +657,7 @@ body { background-color: transparent; background-repeat: no-repeat; background-size: contain; - background-image: url('/static/img/ui/bt PlayerIndex.png'); + background-image: url('/img/ui/bt PlayerIndex.png'); } .slider::-moz-range-thumb { @@ -666,11 +666,11 @@ body { height: 25px; /* Slider handle height */ cursor: pointer; /* Cursor on hover */ - border: 0px; + border: 0; background-color: transparent; background-repeat: no-repeat; background-size: contain; - background-image: url('/static/img/ui/bt PlayerIndex.png'); + background-image: url('/img/ui/bt PlayerIndex.png'); } * { diff --git a/web/index.html b/web/index.html index c18f1f4e..1a895c16 100644 --- a/web/index.html +++ b/web/index.html @@ -15,8 +15,8 @@ - - + + Cloud Retro @@ -115,32 +115,32 @@

- - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + - + {{if .Analytics.Inject}} diff --git a/web/js/stream/stream.js b/web/js/stream/stream.js index 9766236c..64e65a16 100644 --- a/web/js/stream/stream.js +++ b/web/js/stream/stream.js @@ -9,7 +9,7 @@ const stream = (() => { let options = { volume: 0.5, - poster: '/static/img/screen_loading.gif', + poster: '/img/screen_loading.gif', mirrorMode: null, mirrorUpdateRate: 1 / 60, }, From 63e3a7f6bde111d2bc4890b1ec3c21932e281a8d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 10 May 2023 22:08:01 +0300 Subject: [PATCH 038/361] Read YAML keys in lowercase internally --- cmd/coordinator/main.go | 5 ++-- cmd/worker/main.go | 4 +-- configs/config.yaml | 38 ++++++++++++----------- pkg/config/loader.go | 63 +++++++++++++++++++++++++++++++-------- pkg/config/loader_test.go | 26 ++++++++++++++++ 5 files changed, 101 insertions(+), 35 deletions(-) diff --git a/cmd/coordinator/main.go b/cmd/coordinator/main.go index fb4b2947..a6e8fdbf 100644 --- a/cmd/coordinator/main.go +++ b/cmd/coordinator/main.go @@ -14,11 +14,10 @@ func main() { conf.ParseFlags() log := logger.NewConsole(conf.Coordinator.Debug, "c", false) - log.Info().Msgf("version %s", Version) - log.Info().Msgf("conf version: %v", conf.Version) + log.Info().Msgf("conf: v%v", conf.Version) if log.GetLevel() < logger.InfoLevel { - log.Debug().Msgf("config: %+v", conf) + log.Debug().Msgf("conf: %+v", conf) } c := coordinator.New(conf, log) c.Start() diff --git a/cmd/worker/main.go b/cmd/worker/main.go index 5dc60ce5..a697b4f4 100644 --- a/cmd/worker/main.go +++ b/cmd/worker/main.go @@ -18,9 +18,9 @@ func run() { log := logger.NewConsole(conf.Worker.Debug, "w", false) log.Info().Msgf("version %s", Version) - log.Info().Msgf("conf version: %v", conf.Version) + log.Info().Msgf("conf: v%v", conf.Version) if log.GetLevel() < logger.InfoLevel { - log.Debug().Msgf("config: %+v", conf) + log.Debug().Msgf("conf: %+v", conf) } done := os.ExpectTermination() diff --git a/configs/config.yaml b/configs/config.yaml index a0fe7051..cd8c2f1a 100644 --- a/configs/config.yaml +++ b/configs/config.yaml @@ -1,3 +1,4 @@ +LOL123L: yolo # # Application configuration file # @@ -179,7 +180,8 @@ emulator: # their tick rate (1/system FPS), but OpenGL cores like N64 may have significant # frame rendering time inconsistencies. In general, VFR for CFR cores leads to # noticeable video stutter (with the current frame rendering time calculations). - # - options ([]string) a list of Libretro core options for tweaking + # - options ([]string) a list of Libretro core options for tweaking. + # All keys of the options should be in the double quotes in order to preserve upper-case symbols. list: gba: lib: mgba_libretro @@ -191,8 +193,8 @@ emulator: folder: psx # see: https://github.com/libretro/pcsx_rearmed/blob/master/frontend/libretro_core_options.h options: - pcsx_rearmed_drc: enabled - pcsx_rearmed_display_internal_fps: disabled + "pcsx_rearmed_drc": enabled + "pcsx_rearmed_display_internal_fps": disabled # MAME core requires additional manual setup, please read: # https://docs.libretro.com/library/fbneo/ mame: @@ -213,21 +215,21 @@ emulator: vfr: true # see: https://github.com/libretro/mupen64plus-libretro-nx/blob/master/libretro/libretro_core_options.h options: - mupen64plus-169screensize: 640x360 - mupen64plus-43screensize: 320x240 - mupen64plus-EnableCopyColorToRDRAM: Off - mupen64plus-EnableCopyDepthToRDRAM: Off - mupen64plus-EnableEnhancedTextureStorage: True - mupen64plus-EnableFBEmulation: True - mupen64plus-EnableLegacyBlending: True - mupen64plus-FrameDuping: False - mupen64plus-MaxTxCacheSize: 8000 - mupen64plus-ThreadedRenderer: False - mupen64plus-cpucore: dynamic_recompiler - mupen64plus-pak1: memory - mupen64plus-rdp-plugin: gliden64 - mupen64plus-rsp-plugin: hle - mupen64plus-astick-sensitivity: 100 + "mupen64plus-169screensize": 640x360 + "mupen64plus-43screensize": 320x240 + "mupen64plus-EnableCopyColorToRDRAM": Off + "mupen64plus-EnableCopyDepthToRDRAM": Off + "mupen64plus-EnableEnhancedTextureStorage": True + "mupen64plus-EnableFBEmulation": True + "mupen64plus-EnableLegacyBlending": True + "mupen64plus-FrameDuping": False + "mupen64plus-MaxTxCacheSize": 8000 + "mupen64plus-ThreadedRenderer": False + "mupen64plus-cpucore": dynamic_recompiler + "mupen64plus-pak1": memory + "mupen64plus-rdp-plugin": gliden64 + "mupen64plus-rsp-plugin": hle + "mupen64plus-astick-sensitivity": 100 encoder: audio: diff --git a/pkg/config/loader.go b/pkg/config/loader.go index d75ddf0c..3ba6c3df 100644 --- a/pkg/config/loader.go +++ b/pkg/config/loader.go @@ -12,33 +12,72 @@ import ( const EnvPrefix = "CLOUD_GAME_" +type Kv = map[string]any +type Bytes []byte + +func (b *Bytes) ReadBytes() ([]byte, error) { return *b, nil } +func (b *Bytes) Read() (Kv, error) { return nil, nil } + type File string -func (f *File) ReadBytes() ([]byte, error) { return os.ReadFile(string(*f)) } -func (f *File) Read() (map[string]interface{}, error) { return nil, nil } +func (f *File) ReadBytes() ([]byte, error) { return os.ReadFile(string(*f)) } +func (f *File) Read() (Kv, error) { return nil, nil } type YAML struct{} -func (p *YAML) Marshal(map[string]interface{}) ([]byte, error) { return nil, nil } -func (p *YAML) Unmarshal(b []byte) (map[string]interface{}, error) { - var out map[string]interface{} - if err := yaml.Unmarshal(b, &out); err != nil { +func (p *YAML) Marshal(Kv) ([]byte, error) { return nil, nil } +func (p *YAML) Unmarshal(b []byte) (Kv, error) { + var out Kv + klw := keysToLower(b) + if err := yaml.Unmarshal(klw, &out); err != nil { return nil, err } return out, nil } +// keysToLower iterates YAML bytes and tries to lower the keys. +// Used for merging with environment vars which are lowered as well. +func keysToLower(in []byte) []byte { + l, r, ignore := 0, 0, false + for i, b := range in { + switch b { + case '#': // skip comments + ignore = true + case ':': // lower left chunk before the next : symbol + if ignore { + continue + } + r = i + ignore = true + for j := l; j <= r; j++ { + c := in[j] + // we skip the line with the first explicit " string symbol + if c == '"' { + break + } + if 'A' <= c && c <= 'Z' { + in[j] += 'a' - 'A' + } + } + case '\n': + l = i + ignore = false + } + } + return in +} + type Env string func (e *Env) ReadBytes() ([]byte, error) { return nil, nil } -func (e *Env) Read() (map[string]interface{}, error) { +func (e *Env) Read() (Kv, error) { var keys []string for _, k := range os.Environ() { if strings.HasPrefix(k, string(*e)) { keys = append(keys, k) } } - mp := make(map[string]interface{}) + mp := make(Kv) for _, k := range keys { parts := strings.SplitN(k, "=", 2) n := strings.ToLower(strings.TrimPrefix(parts[0], string(*e))) @@ -65,10 +104,10 @@ var k = koanf.New("_") // LoadConfig loads a configuration file into the given struct. // The path param specifies a custom path to the configuration file. // Reads and puts environment variables with the prefix CLOUD_GAME_. -func LoadConfig(config any, path string) error { - dirs := []string{path} - if path == "" { - dirs = append(dirs, ".", "configs", "../../../configs") +func LoadConfig(config any, path string) (err error) { + dirs := []string{".", "configs", "../../../configs"} + if path != "" { + dirs = append([]string{path}, dirs...) } homeDir := "" diff --git a/pkg/config/loader_test.go b/pkg/config/loader_test.go index c0e7a116..b97fed5d 100644 --- a/pkg/config/loader_test.go +++ b/pkg/config/loader_test.go @@ -2,6 +2,7 @@ package config import ( "os" + "reflect" "testing" ) @@ -30,3 +31,28 @@ func TestConfigEnv(t *testing.T) { t.Errorf("%v is not x", v) } } + +func Test_keysToLower(t *testing.T) { + type args struct { + in []byte + } + tests := []struct { + name string + args args + want []byte + }{ + {name: "empty", args: args{in: []byte{}}, want: []byte{}}, + {name: "case", args: args{ + in: []byte("KEY:1\n#Comment with:\n KeY123_NamE: 1\n\n\n\nAAA:123\n \"KeyKey\":2\n"), + }, + want: []byte("key:1\n#Comment with:\n key123_name: 1\n\n\n\naaa:123\n \"KeyKey\":2\n"), + }, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + if got := keysToLower(tt.args.in); !reflect.DeepEqual(got, tt.want) { + t.Errorf("keysToLower() = %v, want %v", string(got), string(tt.want)) + } + }) + } +} From 9231120a551109fc0fca4d9a2c087956c4b0f738 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 24 Apr 2023 21:01:20 +0300 Subject: [PATCH 039/361] Add base path for games in workers --- configs/config.yaml | 3 +++ pkg/config/coordinator.go | 16 ---------------- pkg/config/emulator_test.go | 5 +---- pkg/config/shared.go | 16 ++++++++++++++++ pkg/config/worker.go | 1 + pkg/games/library.go | 7 ++++++- pkg/worker/room.go | 2 +- pkg/worker/room_test.go | 5 +++-- 8 files changed, 31 insertions(+), 24 deletions(-) diff --git a/configs/config.yaml b/configs/config.yaml index cd8c2f1a..c4f9b957 100644 --- a/configs/config.yaml +++ b/configs/config.yaml @@ -64,6 +64,9 @@ coordinator: worker: # show more logs debug: false + library: + # root folder for the library (where games are stored) + basePath: assets/games network: # a coordinator address to connect to coordinatorAddress: localhost:8000 diff --git a/pkg/config/coordinator.go b/pkg/config/coordinator.go index 78dba178..be7f71e1 100644 --- a/pkg/config/coordinator.go +++ b/pkg/config/coordinator.go @@ -23,22 +23,6 @@ type Coordinator struct { Server Server } -type Library struct { - // some directory which is going to be - // the root folder for the library - BasePath string - // a list of supported file extensions - Supported []string - // a list of ignored words in the files - Ignored []string - // print some additional info - Verbose bool - // enable directory changes watch - WatchMode bool -} - -func (l Library) GetSupportedExtensions() []string { return l.Supported } - // Analytics is optional Google Analytics type Analytics struct { Inject bool diff --git a/pkg/config/emulator_test.go b/pkg/config/emulator_test.go index d7f29803..a466783a 100644 --- a/pkg/config/emulator_test.go +++ b/pkg/config/emulator_test.go @@ -38,11 +38,8 @@ func TestGetEmulator(t *testing.T) { }, } - emu := Emulator{ - Libretro: LibretroConfig{}, - } - for _, test := range tests { + emu := Emulator{Libretro: LibretroConfig{}} emu.Libretro.Cores.List = test.config em := emu.GetEmulator(test.rom, test.path) if test.emulator != em { diff --git a/pkg/config/shared.go b/pkg/config/shared.go index d6898089..856479f4 100644 --- a/pkg/config/shared.go +++ b/pkg/config/shared.go @@ -4,6 +4,22 @@ import "flag" type Version int +type Library struct { + // some directory which is going to be + // the root folder for the library + BasePath string + // a list of supported file extensions + Supported []string + // a list of ignored words in the files + Ignored []string + // print some additional info + Verbose bool + // enable directory changes watch + WatchMode bool +} + +func (l Library) GetSupportedExtensions() []string { return l.Supported } + type Monitoring struct { Port int URLPrefix string diff --git a/pkg/config/worker.go b/pkg/config/worker.go index b7e580c2..e53201c1 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -28,6 +28,7 @@ type Storage struct { type Worker struct { Debug bool + Library Library Monitoring Monitoring Network struct { CoordinatorAddress string diff --git a/pkg/games/library.go b/pkg/games/library.go index 3b60041f..90f239d7 100644 --- a/pkg/games/library.go +++ b/pkg/games/library.go @@ -66,7 +66,12 @@ type GameMetadata struct { Path string } -func (g GameMetadata) FullPath() string { return filepath.Join(g.Base, g.Path) } +func (g GameMetadata) FullPath(base string) string { + if base == "" { + return filepath.Join(g.Base, g.Path) + } + return filepath.Join(base, g.Path) +} func NewLib(conf config.Library, log *logger.Logger) GameLibrary { return NewLibWhitelisted(conf, conf, log) diff --git a/pkg/worker/room.go b/pkg/worker/room.go index 16846951..ab63843d 100644 --- a/pkg/worker/room.go +++ b/pkg/worker/room.go @@ -56,7 +56,7 @@ func NewRoom(id string, game games.GameMetadata, onClose func(*Room), conf confi room.emulator = nano room.emulator.SetMainSaveName(id) room.emulator.LoadMetadata(conf.Emulator.GetEmulator(game.Type, game.Path)) - err = room.emulator.LoadGame(game.FullPath()) + err = room.emulator.LoadGame(game.FullPath(conf.Worker.Library.BasePath)) if err != nil { log.Fatal().Err(err).Msgf("couldn't load the game %v", game) } diff --git a/pkg/worker/room_test.go b/pkg/worker/room_test.go index 0dc73d4c..d0a3842c 100644 --- a/pkg/worker/room_test.go +++ b/pkg/worker/room_test.go @@ -203,12 +203,13 @@ func dumpCanvas(frame *image2.Frame, name string, caption string, path string) { // getRoomMock returns mocked Room struct. func getRoomMock(cfg roomMockConfig) roomMock { - cfg.game.Path = cfg.gamesPath + cfg.game.Path - var conf config.WorkerConfig if err := config.LoadConfig(&conf, whereIsConfigs); err != nil { panic(err) } + + conf.Worker.Library.BasePath = cfg.gamesPath + fixEmulators(&conf, cfg.autoGlContext) l := logger.NewConsole(conf.Worker.Debug, "w", false) if cfg.noLog { From b227260060c0af364524a21ffd2f2222ce3b612e Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 25 Apr 2023 20:53:06 +0300 Subject: [PATCH 040/361] Embed config.yaml into both apps --- .github/workflows/cd/deploy-app.sh | 1 - Dockerfile | 1 - cmd/coordinator/main.go | 4 +-- cmd/worker/main.go | 4 +-- {configs => pkg/config}/config.yaml | 0 pkg/config/coordinator.go | 4 +-- pkg/config/loader.go | 26 ++++++++++++++----- pkg/config/loader_test.go | 2 +- pkg/config/worker.go | 4 +-- pkg/worker/emulator/libretro/nanoarch_test.go | 3 +-- pkg/worker/room_test.go | 3 +-- 11 files changed, 31 insertions(+), 21 deletions(-) rename {configs => pkg/config}/config.yaml (100%) diff --git a/.github/workflows/cd/deploy-app.sh b/.github/workflows/cd/deploy-app.sh index 902f4837..cc7b3c85 100755 --- a/.github/workflows/cd/deploy-app.sh +++ b/.github/workflows/cd/deploy-app.sh @@ -72,7 +72,6 @@ WORKERS=${WORKERS:-4} USER=${USER:-root} compose_src=$(cat $LOCAL_WORK_DIR/docker-compose.yml) -config_src=$(cat $LOCAL_WORK_DIR/configs/config.yaml) function remote_run_commands() { ret="" diff --git a/Dockerfile b/Dockerfile index ce75b1b7..ea96d31d 100644 --- a/Dockerfile +++ b/Dockerfile @@ -59,7 +59,6 @@ RUN mkdir -p ./assets/cache && \ mkdir -p ./assets/games && \ mkdir -p ./libretro && \ mkdir -p /root/.cr -COPY configs ./configs COPY web ./web ARG VERSION COPY scripts/version.sh version.sh diff --git a/cmd/coordinator/main.go b/cmd/coordinator/main.go index a6e8fdbf..ce094f6a 100644 --- a/cmd/coordinator/main.go +++ b/cmd/coordinator/main.go @@ -10,12 +10,12 @@ import ( var Version = "?" func main() { - conf := config.NewCoordinatorConfig() + conf, paths := config.NewCoordinatorConfig() conf.ParseFlags() log := logger.NewConsole(conf.Coordinator.Debug, "c", false) log.Info().Msgf("version %s", Version) - log.Info().Msgf("conf: v%v", conf.Version) + log.Info().Msgf("conf: v%v, loaded: %v", conf.Version, paths) if log.GetLevel() < logger.InfoLevel { log.Debug().Msgf("conf: %+v", conf) } diff --git a/cmd/worker/main.go b/cmd/worker/main.go index a697b4f4..f6157d09 100644 --- a/cmd/worker/main.go +++ b/cmd/worker/main.go @@ -13,12 +13,12 @@ import ( var Version = "?" func run() { - conf := config.NewWorkerConfig() + conf, paths := config.NewWorkerConfig() conf.ParseFlags() log := logger.NewConsole(conf.Worker.Debug, "w", false) log.Info().Msgf("version %s", Version) - log.Info().Msgf("conf: v%v", conf.Version) + log.Info().Msgf("conf: v%v, loaded: %v", conf.Version, paths) if log.GetLevel() < logger.InfoLevel { log.Debug().Msgf("conf: %+v", conf) } diff --git a/configs/config.yaml b/pkg/config/config.yaml similarity index 100% rename from configs/config.yaml rename to pkg/config/config.yaml diff --git a/pkg/config/coordinator.go b/pkg/config/coordinator.go index be7f71e1..dd904880 100644 --- a/pkg/config/coordinator.go +++ b/pkg/config/coordinator.go @@ -34,8 +34,8 @@ const SelectByPing = "ping" // allows custom config path var coordinatorConfigPath string -func NewCoordinatorConfig() (conf CoordinatorConfig) { - err := LoadConfig(&conf, coordinatorConfigPath) +func NewCoordinatorConfig() (conf CoordinatorConfig, paths []string) { + paths, err := LoadConfig(&conf, coordinatorConfigPath) if err != nil { panic(err) } diff --git a/pkg/config/loader.go b/pkg/config/loader.go index 3ba6c3df..11a95583 100644 --- a/pkg/config/loader.go +++ b/pkg/config/loader.go @@ -5,6 +5,7 @@ import ( "path/filepath" "strings" + _ "embed" "github.com/knadh/koanf/maps" "github.com/knadh/koanf/v2" "gopkg.in/yaml.v3" @@ -12,6 +13,11 @@ import ( const EnvPrefix = "CLOUD_GAME_" +var ( + //go:embed config.yaml + conf Bytes +) + type Kv = map[string]any type Bytes []byte @@ -104,7 +110,7 @@ var k = koanf.New("_") // LoadConfig loads a configuration file into the given struct. // The path param specifies a custom path to the configuration file. // Reads and puts environment variables with the prefix CLOUD_GAME_. -func LoadConfig(config any, path string) (err error) { +func LoadConfig(config any, path string) (loaded []string, err error) { dirs := []string{".", "configs", "../../../configs"} if path != "" { dirs = append([]string{path}, dirs...) @@ -116,23 +122,31 @@ func LoadConfig(config any, path string) (err error) { dirs = append(dirs, homeDir) } + if err := k.Load(&conf, &YAML{}); err != nil { + return nil, err + } + conf = nil + loaded = append(loaded, "default") + for _, dir := range dirs { - f := File(filepath.Join(filepath.Clean(dir), "config.yaml")) + path := filepath.Join(filepath.Clean(dir), "config.yaml") + f := File(path) if _, err := os.Stat(string(f)); !os.IsNotExist(err) { if err := k.Load(&f, &YAML{}); err != nil { - return err + return loaded, err } + loaded = append(loaded, path) } } env := Env(EnvPrefix) if err := k.Load(&env, nil); err != nil { - return err + return loaded, err } if err := k.Unmarshal("", config); err != nil { - return err + return loaded, err } - return nil + return loaded, nil } diff --git a/pkg/config/loader_test.go b/pkg/config/loader_test.go index b97fed5d..355f19a4 100644 --- a/pkg/config/loader_test.go +++ b/pkg/config/loader_test.go @@ -17,7 +17,7 @@ func TestConfigEnv(t *testing.T) { _ = os.Unsetenv("CLOUD_GAME_EMULATOR_LIBRETRO_CORES_LIST_PCSX_OPTIONS__PCSX_REARMED_DRC") }() - err := LoadConfig(&out, "../../configs") + _, err := LoadConfig(&out, "") if err != nil { t.Fatal(err) } diff --git a/pkg/config/worker.go b/pkg/config/worker.go index e53201c1..6436feea 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -70,8 +70,8 @@ type Video struct { // allows custom config path var workerConfigPath string -func NewWorkerConfig() (conf WorkerConfig) { - err := LoadConfig(&conf, workerConfigPath) +func NewWorkerConfig() (conf WorkerConfig, paths []string) { + paths, err := LoadConfig(&conf, workerConfigPath) if err != nil { panic(err) } diff --git a/pkg/worker/emulator/libretro/nanoarch_test.go b/pkg/worker/emulator/libretro/nanoarch_test.go index 8de74be3..a94c8610 100644 --- a/pkg/worker/emulator/libretro/nanoarch_test.go +++ b/pkg/worker/emulator/libretro/nanoarch_test.go @@ -47,10 +47,9 @@ type EmulatorPaths struct { // Make sure you call shutdownEmulator(). func GetEmulatorMock(room string, system string) *EmulatorMock { rootPath := getRootPath() - configPath := rootPath + "configs/" var conf config.WorkerConfig - if err := config.LoadConfig(&conf, configPath); err != nil { + if _, err := config.LoadConfig(&conf, ""); err != nil { panic(err) } diff --git a/pkg/worker/room_test.go b/pkg/worker/room_test.go index d0a3842c..1b33aa81 100644 --- a/pkg/worker/room_test.go +++ b/pkg/worker/room_test.go @@ -60,7 +60,6 @@ type roomMockConfig struct { // Store absolute path to test games var whereIsGames = getRootPath() + "assets/games/" -var whereIsConfigs = getRootPath() + "configs/" var testTempDir = filepath.Join(os.TempDir(), "cloud-game-core-tests") // games @@ -204,7 +203,7 @@ func dumpCanvas(frame *image2.Frame, name string, caption string, path string) { // getRoomMock returns mocked Room struct. func getRoomMock(cfg roomMockConfig) roomMock { var conf config.WorkerConfig - if err := config.LoadConfig(&conf, whereIsConfigs); err != nil { + if _, err := config.LoadConfig(&conf, ""); err != nil { panic(err) } From 1dc0cabc2ba3c1826f623f0cdfbd454ecb754f01 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 24 Apr 2023 21:04:37 +0300 Subject: [PATCH 041/361] Add special Dockerfile for tiny coordinator (<10Mib) and worker (<150Mib) containers --- .dockerignore | 27 +++---- .github/workflows/build.yml | 2 +- Dockerfile | 139 ++++++++++++++++++++++-------------- Makefile | 8 ++- README.md | 17 ++--- docker-compose.yml | 28 +++++--- pkg/config/config.yaml | 5 +- scripts/install.sh | 28 -------- scripts/mkdirs.sh | 14 ++++ 9 files changed, 146 insertions(+), 122 deletions(-) delete mode 100755 scripts/install.sh create mode 100755 scripts/mkdirs.sh diff --git a/.dockerignore b/.dockerignore index d85038cf..9c6459c7 100644 --- a/.dockerignore +++ b/.dockerignore @@ -1,18 +1,9 @@ -.git/ -.github/ -.idea/ -.vscode/ -.gitignore - -.editorconfig -.env -docker-compose.yml -Dockerfile - -LICENSE -README.md -DESIGNv2.md -bin/ -release/ - -assets/games/ +/** +!cmd/ +!pkg/ +!scripts/ +!web/ +!go.mod +!go.sum +!LICENSE +!Makefile diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index f20391e1..17ce3d47 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -113,4 +113,4 @@ jobs: if: github.event_name == 'pull_request' steps: - uses: actions/checkout@v3 - - run: docker build --build-arg VERSION=$(./scripts/version.sh) . + - run: DOCKER_BUILDKIT=1 docker build --build-arg VERSION=$(./scripts/version.sh) . diff --git a/Dockerfile b/Dockerfile index ea96d31d..a5691748 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,68 +1,103 @@ -# The base cloud-game image -ARG BUILD_PATH=/go/src/github.com/giongto35/cloud-game +ARG BUILD_PATH=/tmp/cloud-game +ARG VERSION=master +ARG GO=1.20.4 -# build image -FROM ubuntu:lunar AS build +# base build stage +FROM ubuntu:lunar AS build0 +ARG GO + +RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ + ca-certificates \ + wget \ + make \ + upx + +ARG GO_DIST=go${GO}.linux-amd64.tar.gz +RUN wget -q https://golang.org/dl/$GO_DIST && \ + rm -rf /usr/local/go && \ + tar -C /usr/local -xzf $GO_DIST && \ + rm $GO_DIST +ENV PATH="${PATH}:/usr/local/go/bin" + +# next conditional build stage +FROM build0 AS build_coordinator ARG BUILD_PATH +ARG VERSION +ENV GIT_VERSION ${VERSION} + WORKDIR ${BUILD_PATH} -# system libs layer -RUN apt-get -qq update && apt-get -qq install --no-install-recommends -y \ +# install deps +RUN rm -rf /var/lib/apt/lists/* + +# by default we ignore all except some folders and files, see .dockerignore +COPY . ./ +RUN --mount=type=cache,target=/root/.cache/go-build make build.coordinator +RUN find ./bin/* | xargs upx --best --lzma + +WORKDIR /usr/local/share/cloud-game +RUN mv ${BUILD_PATH}/bin/* ./ && \ + mv ${BUILD_PATH}/web ./web && \ + mv ${BUILD_PATH}/LICENSE ./ +RUN ${BUILD_PATH}/scripts/version.sh ./web/index.html ${VERSION} && \ + ${BUILD_PATH}/scripts/mkdirs.sh + +# next worker build stage +FROM build0 AS build_worker +ARG BUILD_PATH +ARG VERSION +ENV GIT_VERSION ${VERSION} + +WORKDIR ${BUILD_PATH} + +# install deps +RUN apt-get -q install --no-install-recommends -y \ gcc \ - ca-certificates \ libopus-dev \ libsdl2-dev \ libvpx-dev \ libx264-dev \ - make \ pkg-config \ - wget \ - upx \ - && rm -rf /var/lib/apt/lists/* +&& rm -rf /var/lib/apt/lists/* -# go setup layer -ARG GO=go1.20.3.linux-amd64.tar.gz -RUN wget -q https://golang.org/dl/$GO \ - && rm -rf /usr/local/go \ - && tar -C /usr/local -xzf $GO \ - && rm $GO -ENV PATH="${PATH}:/usr/local/go/bin" +# by default we ignore all except some folders and files, see .dockerignore +COPY . ./ +RUN --mount=type=cache,target=/root/.cache/go-build make GO_TAGS=static,st build.worker +RUN find ./bin/* | xargs upx --best --lzma -# go deps layer -COPY go.mod go.sum ./ -RUN go mod download +WORKDIR /usr/local/share/cloud-game +RUN mv ${BUILD_PATH}/bin/* ./ && \ + mv ${BUILD_PATH}/LICENSE ./ +RUN ${BUILD_PATH}/scripts/mkdirs.sh worker -# app build layer -COPY pkg ./pkg -COPY cmd ./cmd -COPY Makefile . -COPY scripts/version.sh scripts/version.sh -ARG VERSION -RUN GIT_VERSION=${VERSION} make GO_TAGS=static,st build -# compress -RUN find ${BUILD_PATH}/bin/* | xargs strip --strip-unneeded -RUN find ${BUILD_PATH}/bin/* | xargs upx --best --lzma +RUN wget https://raw.githubusercontent.com/sergystepanov/mesa-llvmpipe/main/release/M23.1.0-LLVM16/libGL.so.1.5.0 + +FROM scratch AS coordinator + +COPY --from=build_coordinator /usr/local/share/cloud-game /cloud-game +# autocertbot (SSL) requires these on the first run +COPY --from=build_coordinator /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ + +FROM ubuntu:lunar AS worker + +RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ + libx11-6 \ + libxext6 \ + && apt-get autoremove \ + && rm -rf /var/lib/apt/lists/* /var/log/* /usr/share/bug /usr/share/doc /usr/share/doc-base \ + /usr/share/X11/locale/* + +COPY --from=build_worker /usr/local/share/cloud-game /cloud-game +COPY --from=build_worker /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ + +RUN mv /cloud-game/libGL.so.1.5.0 /usr/lib/x86_64-linux-gnu/ && \ + cd /usr/lib/x86_64-linux-gnu && \ + ln -s libGL.so.1.5.0 libGL.so.1 && \ + ln -s libGL.so.1 libGL.so + +FROM worker AS cloud-game -# base image -FROM ubuntu:lunar -ARG BUILD_PATH WORKDIR /usr/local/share/cloud-game -COPY scripts/install.sh install.sh -RUN bash install.sh x11-only && \ - rm -rf /var/lib/apt/lists/* install.sh - -COPY --from=build ${BUILD_PATH}/bin/ ./ -RUN cp -s $(pwd)/* /usr/local/bin -RUN mkdir -p ./assets/cache && \ - mkdir -p ./assets/cores && \ - mkdir -p ./assets/games && \ - mkdir -p ./libretro && \ - mkdir -p /root/.cr -COPY web ./web -ARG VERSION -COPY scripts/version.sh version.sh -RUN bash ./version.sh ./web/index.html ${VERSION} && \ - rm -rf version.sh - -EXPOSE 8000 9000 +COPY --from=coordinator /cloud-game ./ +COPY --from=worker /cloud-game ./ diff --git a/Makefile b/Makefile index 8341821d..585d2eac 100644 --- a/Makefile +++ b/Makefile @@ -18,14 +18,20 @@ clean: @rm -rf build @go clean ./cmd/* -build: + +build.coordinator: mkdir -p bin/ go build -ldflags "-w -s -X 'main.Version=$(GIT_VERSION)'" -o bin/ ./cmd/coordinator + +build.worker: + mkdir -p bin/ CGO_CFLAGS=${CGO_CFLAGS} CGO_LDFLAGS=${CGO_LDFLAGS} \ go build -buildmode=exe $(if $(GO_TAGS),-tags $(GO_TAGS),) \ -ldflags "-w -s -X 'main.Version=$(GIT_VERSION)'" $(EXT_WFLAGS) \ -o bin/ ./cmd/worker +build: build.coordinator build.worker + verify-cores: go test -run TestAllEmulatorRooms ./pkg/worker -v -renderFrames $(GL_CTX) -outputPath "../../_rendered" diff --git a/README.md b/README.md index c6963e80..66944fdc 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ # CloudRetro + [![Build](https://github.com/giongto35/cloud-game/workflows/build/badge.svg)](https://github.com/giongto35/cloud-game/actions?query=workflow:build) [![Latest release](https://img.shields.io/github/v/release/giongto35/cloud-game.svg)](https://github.com/giongto35/cloud-game/releases/latest) @@ -13,7 +14,9 @@ Discord: [Join Us](https://discord.gg/sXRQZa2zeP) ![screenshot](https://user-images.githubusercontent.com/846874/235532552-8c8253df-aa8d-48c9-a58e-3f54e284f86e.jpg) ## Try it at **[cloudretro.io](https://cloudretro.io)** -Direct play an existing game: **[Pokemon Emerald](https://cloudretro.io/?id=1bd37d4b5dfda87c___Pokemon%20-%20Emerald%20Version%20(U))** + +Direct play an existing game: * +*[Pokemon Emerald](https://cloudretro.io/?id=1bd37d4b5dfda87c___Pokemon%20-%20Emerald%20Version%20(U))** ## Introduction @@ -85,17 +88,16 @@ __See the `docker-compose.yml` file for Xvfb example config.__ ## Run with Docker -Use makefile script: `make dev.run-docker` or Docker Compose directly: `docker-compose up --build` -(`CLOUD_GAME_GAMES_PATH` is env variable for games on your host). It will spawn a docker environment and you can access -the service on `localhost:8000`. +Use makefile script: `make dev.run-docker` or Docker Compose directly: `docker compose up --build`. +It will spawn a docker environment and you can access the service on `localhost:8000`. ## Configuration The default configuration file is stored in the [`pkg/configs/config.yaml`](pkg/config/config.yaml) file. This configuration file will be embedded into the applications and loaded automatically during startup. -In order to override (change) the default parameters you can specify environment variables with the `CLOUD_GAME_` prefix -(except list params), or place a custom `config.yaml` file into one of these places: just near the application or in the `configs` folder, -`.cr` folder in user's home, or specify own directory with `-w-conf` application param (`worker -w-conf /usr/conf`). +In order to change the default parameters you can specify environment variables with the `CLOUD_GAME_` prefix, or place +a custom `config.yaml` file into one of these places: just near the application, `.cr` folder in user's home, or +specify own directory with `-w-conf` application param (`worker -w-conf /usr/conf`). ## Deployment @@ -152,7 +154,6 @@ Thanks: # Announcement - **[CloudMorph](https://github.com/giongto35/cloud-morph) is a sibling project that offers a more generic to run any offline games/application on browser in Cloud Gaming approach: [https://github.com/giongto35/cloud-morph](https://github.com/giongto35/cloud-morph))** diff --git a/docker-compose.yml b/docker-compose.yml index 5fb3725c..491c7783 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -7,20 +7,28 @@ services: container_name: cloud-game-local environment: - DISPLAY=:99 - - MESA_GL_VERSION_OVERRIDE=3.3 + - MESA_GL_VERSION_OVERRIDE=4.5 - CLOUD_GAME_WEBRTC_SINGLEPORT=8443 - - CLOUD_GAME_WEBRTC_ICEIPMAP=127.0.0.1 + # - CLOUD_GAME_WEBRTC_ICEIPMAP=127.0.0.1 + - CLOUD_GAME_COORDINATOR_DEBUG=true + - CLOUD_GAME_WORKER_DEBUG=true # - PION_LOG_TRACE=all ports: - - 8000:8000 - - 9000:9000 - - 8443:8443/udp + - "8000:8000" + - "9000:9000" + - "8443:8443/udp" command: > - bash -c "Xvfb :99 & coordinator & worker" + bash -c "./coordinator & ./worker" volumes: - # keep cores persistent in the cloud-game_cores volume - - cores:/usr/local/share/cloud-game/assets/cores - - ${CLOUD_GAME_GAMES_PATH:-./assets/games}:/usr/local/share/cloud-game/assets/games + - ./assets/cores:/usr/local/share/cloud-game/assets/cores + - ./assets/games:/usr/local/share/cloud-game/assets/games + - x11:/tmp/.X11-unix + + xvfb: + image: kcollins/xvfb:latest + volumes: + - x11:/tmp/.X11-unix + command: [ ":99", "-screen", "0", "320x240x16" ] volumes: - cores: + x11: diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index c4f9b957..de9e4bcb 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -1,7 +1,4 @@ -LOL123L: yolo -# -# Application configuration file -# +# The main config file # for the compatibility purposes version: 3 diff --git a/scripts/install.sh b/scripts/install.sh deleted file mode 100755 index 550fbc37..00000000 --- a/scripts/install.sh +++ /dev/null @@ -1,28 +0,0 @@ -#!/usr/bin/env bash - -deps="$1" - -echo This script should install application dependencies for Debian-based systems -if [ $(id -u) -ne 0 ] -then - echo "error: run with sudo or root" - exit 1 -fi - -apt-get -qq update -if [ "$deps" = "x11-only" ]; then - apt-get -qq install --no-install-recommends -y \ - ca-certificates \ - libgl1-mesa-dri \ - xvfb -else - apt-get -qq install --no-install-recommends -y \ - ca-certificates \ - libvpx7 \ - libx264-164 \ - libopus0 \ - libgl1-mesa-dri \ - xvfb -fi -apt-get clean -apt-get autoremove diff --git a/scripts/mkdirs.sh b/scripts/mkdirs.sh new file mode 100755 index 00000000..93e975b1 --- /dev/null +++ b/scripts/mkdirs.sh @@ -0,0 +1,14 @@ +#!/bin/sh + +app="$1" + +echo Making application runtime directories +mkdir -p ./assets/cache +mkdir -p ./assets/games +mkdir -p ./.cr +if [ "$app" = "worker" ]; then + mkdir -p ./assets/cores + mkdir -p ./libretro +fi + + From 39c63ec44aff0c8bebb6c6a9682eef1240a5deb4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 12 May 2023 16:49:15 +0300 Subject: [PATCH 042/361] Update cloudretro.io deployments --- .../workflows/cd/cloudretro.io/config.yaml | 12 +++++++++- .github/workflows/cd/docker-compose.yml | 24 +++++++++++++++---- 2 files changed, 31 insertions(+), 5 deletions(-) diff --git a/.github/workflows/cd/cloudretro.io/config.yaml b/.github/workflows/cd/cloudretro.io/config.yaml index 4479466d..535d1168 100644 --- a/.github/workflows/cd/cloudretro.io/config.yaml +++ b/.github/workflows/cd/cloudretro.io/config.yaml @@ -21,4 +21,14 @@ worker: https: true tls: address: :444 - domain: usw.cloudretro.io + domain: cloudretro.io + +emulator: + threads: 4 + libretro: + logLevel: 1 + cores: + list: + mame: + options: + fbneo-cpu-speed-adjust: 200% diff --git a/.github/workflows/cd/docker-compose.yml b/.github/workflows/cd/docker-compose.yml index bc4565f0..1517fce3 100644 --- a/.github/workflows/cd/docker-compose.yml +++ b/.github/workflows/cd/docker-compose.yml @@ -6,6 +6,8 @@ x-params: network_mode: "host" privileged: true restart: always + security_opt: + - seccomp:unconfined logging: driver: "journald" @@ -13,7 +15,9 @@ services: coordinator: <<: *default-params - command: coordinator + command: ./coordinator + environment: + - CLOUD_GAME_COORDINATOR_LIBRARY_BASEPATH=/usr/local/share/cloud-game/assets/games volumes: - ${APP_DIR:-/cloud-game}/cache:/usr/local/share/cloud-game/assets/cache - ${APP_DIR:-/cloud-game}/games:/usr/local/share/cloud-game/assets/games @@ -27,12 +31,24 @@ services: mode: replicated replicas: 4 environment: - - MESA_GL_VERSION_OVERRIDE=3.3 - #entrypoint: [ "/bin/sh", "-c", "xvfb-run -a $$@", "" ] - command: worker + - DISPLAY=:99 + - MESA_GL_VERSION_OVERRIDE=4.5 + - CLOUD_GAME_WORKER_LIBRARY_BASEPATH=/usr/local/share/cloud-game/assets/games + - CLOUD_GAME_EMULATOR_LIBRETRO_CORES_PATHS_LIBS=/usr/local/share/cloud-game/assets/cores + command: ./worker volumes: - ${APP_DIR:-/cloud-game}/cache:/usr/local/share/cloud-game/assets/cache - ${APP_DIR:-/cloud-game}/cores:/usr/local/share/cloud-game/assets/cores - ${APP_DIR:-/cloud-game}/games:/usr/local/share/cloud-game/assets/games - ${APP_DIR:-/cloud-game}/libretro:/usr/local/share/cloud-game/libretro - ${APP_DIR:-/cloud-game}/home:/root/.cr + - x11:/tmp/.X11-unix + + xvfb: + image: kcollins/xvfb:latest + volumes: + - x11:/tmp/.X11-unix + command: [":99", "-screen", "0", "320x240x16" ] + +volumes: + x11: From d985440930dc0f1e7bd574f7aaa23b2862978bfc Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 12 May 2023 21:20:08 +0300 Subject: [PATCH 043/361] Center menu item --- web/css/main.css | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/css/main.css b/web/css/main.css index 38eae42a..6fb53307 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -514,7 +514,7 @@ body { position: absolute; left: 15px; - top: 5px; + top: 7px; width: 226px; height: 25px; } From 70d9ff32b79b1822621f91ec0562b5e00793dfd8 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 12 May 2023 21:21:51 +0300 Subject: [PATCH 044/361] Update dependencies --- go.mod | 18 +++++++++--------- go.sum | 34 +++++++++++++++++++--------------- 2 files changed, 28 insertions(+), 24 deletions(-) diff --git a/go.mod b/go.mod index 9e1e8f01..e99eea29 100644 --- a/go.mod +++ b/go.mod @@ -11,13 +11,13 @@ require ( github.com/gorilla/websocket v1.5.0 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.0.1 - github.com/pion/interceptor v0.1.12 + github.com/pion/interceptor v0.1.16 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v3 v3.1.60 + github.com/pion/webrtc/v3 v3.2.1 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.29.1 - github.com/veandco/go-sdl2 v0.4.34 - golang.org/x/crypto v0.8.0 + github.com/veandco/go-sdl2 v0.4.35 + golang.org/x/crypto v0.9.0 golang.org/x/image v0.7.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -36,16 +36,16 @@ require ( github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.10 // indirect github.com/pion/rtp v1.7.13 // indirect - github.com/pion/sctp v1.8.6 // indirect + github.com/pion/sctp v1.8.7 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect - github.com/pion/srtp/v2 v2.0.12 // indirect - github.com/pion/stun v0.4.0 // indirect + github.com/pion/srtp/v2 v2.0.13 // indirect + github.com/pion/stun v0.5.2 // indirect github.com/pion/transport/v2 v2.2.0 // indirect github.com/pion/turn/v2 v2.1.0 // indirect github.com/pion/udp/v2 v2.0.1 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.9.0 // indirect - golang.org/x/sys v0.7.0 // indirect + golang.org/x/net v0.10.0 // indirect + golang.org/x/sys v0.8.0 // indirect golang.org/x/text v0.9.0 // indirect ) diff --git a/go.sum b/go.sum index e3de8899..0274ff4a 100644 --- a/go.sum +++ b/go.sum @@ -71,8 +71,8 @@ github.com/pion/dtls/v2 v2.2.6 h1:yXMxKr0Skd+Ub6A8UqXTRLSywskx93ooMRHsQUtd+Z4= github.com/pion/dtls/v2 v2.2.6/go.mod h1:t8fWJCIquY5rlQZwA2yWxUS1+OCrAdXrhVKXB5oD/wY= github.com/pion/ice/v2 v2.3.2 h1:vh+fi4RkZ8H5fB4brZ/jm3j4BqFgMmNs+aB3X52Hu7M= github.com/pion/ice/v2 v2.3.2/go.mod h1:AMIpuJqcpe+UwloocNebmTSWhCZM1TUCo9v7nW50jX0= -github.com/pion/interceptor v0.1.12 h1:CslaNriCFUItiXS5o+hh5lpL0t0ytQkFnUcbbCs2Zq8= -github.com/pion/interceptor v0.1.12/go.mod h1:bDtgAD9dRkBZpWHGKaoKb42FhDHTG2rX8Ii9LRALLVA= +github.com/pion/interceptor v0.1.16 h1:0GDZrfNO+BmVNWymS31fMlVtPO2IJVBzy2Qq5XCYMIg= +github.com/pion/interceptor v0.1.16/go.mod h1:SY8kpmfVBvrbUzvj2bsXz7OJt5JvmVNZ+4Kjq7FcwrI= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= github.com/pion/mdns v0.0.7 h1:P0UB4Sr6xDWEox0kTVxF0LmQihtCbSAdW0H2nEgkA3U= @@ -84,26 +84,29 @@ github.com/pion/rtcp v1.2.10/go.mod h1:ztfEwXZNLGyF1oQDttz/ZKIBaeeg/oWbRYqzBM9TL github.com/pion/rtp v1.7.13 h1:qcHwlmtiI50t1XivvoawdCGTP4Uiypzfrsap+bijcoA= github.com/pion/rtp v1.7.13/go.mod h1:bDb5n+BFZxXx0Ea7E5qe+klMuqiBrP+w8XSjiWtCUko= github.com/pion/sctp v1.8.5/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= -github.com/pion/sctp v1.8.6 h1:CUex11Vkt9YS++VhLf8b55O3VqKrWL6W3SDwX4jAqsI= -github.com/pion/sctp v1.8.6/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= +github.com/pion/sctp v1.8.7 h1:JnABvFakZueGAn4KU/4PSKg+GWbF6QWbKTWZOSGJjXw= +github.com/pion/sctp v1.8.7/go.mod h1:g1Ul+ARqZq5JEmoFy87Q/4CePtKnTJ1QCL9dBBdN6AU= github.com/pion/sdp/v3 v3.0.6 h1:WuDLhtuFUUVpTfus9ILC4HRyHsW6TdugjEX/QY9OiUw= github.com/pion/sdp/v3 v3.0.6/go.mod h1:iiFWFpQO8Fy3S5ldclBkpXqmWy02ns78NOKoLLL0YQw= -github.com/pion/srtp/v2 v2.0.12 h1:WrmiVCubGMOAObBU1vwWjG0H3VSyQHawKeer2PVA5rY= github.com/pion/srtp/v2 v2.0.12/go.mod h1:C3Ep44hlOo2qEYaq4ddsmK5dL63eLehXFbHaZ9F5V9Y= -github.com/pion/stun v0.4.0 h1:vgRrbBE2htWHy7l3Zsxckk7rkjnjOsSM7PHZnBwo8rk= +github.com/pion/srtp/v2 v2.0.13 h1:GJQNMCqbYrNIBt1f3maX+E+woREVh2ilhAafBh0vqmk= +github.com/pion/srtp/v2 v2.0.13/go.mod h1:FA7u5fWpVITMYNL70TA3csQuMQJA5/+6ZMajGxveHgM= github.com/pion/stun v0.4.0/go.mod h1:QPsh1/SbXASntw3zkkrIk3ZJVKz4saBY2G7S10P3wCw= +github.com/pion/stun v0.5.2 h1:J/8glQnDV91dfk2+ZnGN0o9bUJgABhTNljwfQWByoXE= +github.com/pion/stun v0.5.2/go.mod h1:TNo1HjyjaFVpMZsvowqPeV8TfwRytympQC0//neaksA= github.com/pion/transport v0.14.1 h1:XSM6olwW+o8J4SCmOBb/BpwZypkHeyM0PGFCxNQBr40= github.com/pion/transport v0.14.1/go.mod h1:4tGmbk00NeYA3rUa9+n+dzCCoKkcy3YlYb99Jn2fNnI= github.com/pion/transport/v2 v2.0.0/go.mod h1:HS2MEBJTwD+1ZI2eSXSvHJx/HnzQqRy2/LXxt6eVMHc= github.com/pion/transport/v2 v2.0.2/go.mod h1:vrz6bUbFr/cjdwbnxq8OdDDzHf7JJfGsIRkxfpZoTA0= +github.com/pion/transport/v2 v2.1.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= github.com/pion/transport/v2 v2.2.0 h1:u5lFqFHkXLMXMzai8tixZDfVjb8eOjH35yCunhPeb1c= github.com/pion/transport/v2 v2.2.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= github.com/pion/turn/v2 v2.1.0 h1:5wGHSgGhJhP/RpabkUb/T9PdsAjkGLS6toYz5HNzoSI= github.com/pion/turn/v2 v2.1.0/go.mod h1:yrT5XbXSGX1VFSF31A3c1kCNB5bBZgk/uu5LET162qs= github.com/pion/udp/v2 v2.0.1 h1:xP0z6WNux1zWEjhC7onRA3EwwSliXqu1ElUZAQhUP54= github.com/pion/udp/v2 v2.0.1/go.mod h1:B7uvTMP00lzWdyMr/1PVZXtV3wpPIxBRd4Wl6AksXn8= -github.com/pion/webrtc/v3 v3.1.60 h1:FLF6HT3x3CMHtPz5JbdAARfIUpMZu2YeOSzkVxaeF+k= -github.com/pion/webrtc/v3 v3.1.60/go.mod h1:65gfOgxrmszb6ec7kEiZp32QwnmDNIrJK8hgo/0niWY= +github.com/pion/webrtc/v3 v3.2.1 h1:eehbYzkM6xWoH3LXoIBnZTb4TOrjwmVzI78JO1+5kgQ= +github.com/pion/webrtc/v3 v3.2.1/go.mod h1:sQVqop5YhZezvKyyz6Nywvf15LhlXUWiXWdN5DV4zHs= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -126,8 +129,8 @@ github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= github.com/valyala/histogram v1.2.0/go.mod h1:Hb4kBwb4UxsaNbbbh+RRz8ZR6pdodR57tzWUS3BUzXY= -github.com/veandco/go-sdl2 v0.4.34 h1:dqbUhV/SSJ35grdYTLv3iVxtO1NzNmgzMV//hyCyypY= -github.com/veandco/go-sdl2 v0.4.34/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= +github.com/veandco/go-sdl2 v0.4.35 h1:NohzsfageDWGtCd9nf7Pc3sokMK/MOK+UA2QMJARWzQ= +github.com/veandco/go-sdl2 v0.4.35/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= @@ -136,8 +139,8 @@ golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPh golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= golang.org/x/crypto v0.5.0/go.mod h1:NK/OQwhpMQP3MwtdjgLlYHnH9ebylxKWv3e0fK+mkQU= golang.org/x/crypto v0.6.0/go.mod h1:OFC/31mSvZgRz0V1QTNCzfAI1aIRzbiufJtkMIlEp58= -golang.org/x/crypto v0.8.0 h1:pd9TJtTueMTVQXzk8E2XESSMQDj/U7OUu0PqJqPXQjQ= -golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= +golang.org/x/crypto v0.9.0 h1:LF6fAI+IutBocDJ2OT0Q1g8plpYljMZ4+lty+dsqw3g= +golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0= golang.org/x/image v0.7.0 h1:gzS29xtG1J5ybQlv0PuyfE3nmc6R4qB73m6LUUmvFuw= golang.org/x/image v0.7.0/go.mod h1:nd/q4ef1AKKYl/4kft7g+6UyGbdiqWqTP1ZAbRoV7Rg= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= @@ -156,8 +159,8 @@ golang.org/x/net v0.5.0/go.mod h1:DivGGAXEgPSlEBzxGzZI+ZLohi+xUj054jfeKui00ws= golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc= -golang.org/x/net v0.9.0 h1:aWJ/m6xSmxWBx+V0XRHTlrYrPG56jKsLdTFmsSsCzOM= -golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= +golang.org/x/net v0.10.0 h1:X2//UzNDwYmtCLn7To6G58Wr6f5ahEAQgKNzv9Y951M= +golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -186,8 +189,9 @@ golang.org/x/sys v0.2.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.4.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.7.0 h1:3jlCCIQZPdOYu1h8BkNvLz8Kgwtae2cagcG/VamtZRU= golang.org/x/sys v0.7.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.8.0 h1:EBmGv8NaZBZTWvrbjNoL6HVt+IVy3QDQpJs7VRIw3tU= +golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= From 0aeaa5580cb3b6a9d5e77b21e5d27633f10a475d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 14 May 2023 01:47:02 +0300 Subject: [PATCH 045/361] Don't scan the lib with errored dirs --- pkg/games/library.go | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/pkg/games/library.go b/pkg/games/library.go index 90f239d7..c8a84148 100644 --- a/pkg/games/library.go +++ b/pkg/games/library.go @@ -167,7 +167,8 @@ func (lib *library) Scan() { }) if err != nil { - lib.log.Error().Err(err).Str("dir", dir).Msgf("Lib scan error") + lib.log.Error().Err(err).Str("dir", dir).Msgf("Lib scan... failed") + return } if len(games) > 0 { From 75e41e4fd0cee6f09608c2e683dd570800517739 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 14 May 2023 01:47:37 +0300 Subject: [PATCH 046/361] Fix static x264 static link on Windows --- pkg/worker/encoder/h264/libx264.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/worker/encoder/h264/libx264.go b/pkg/worker/encoder/h264/libx264.go index 9b1d9ba2..cafac4fd 100644 --- a/pkg/worker/encoder/h264/libx264.go +++ b/pkg/worker/encoder/h264/libx264.go @@ -2,7 +2,7 @@ package h264 /* -#cgo pkg-config: x264 +#cgo !st pkg-config: x264 #cgo st LDFLAGS: -l:libx264.a #include "stdint.h" From 167071af6f0c5c92e197afef7b754be1b58d6211 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 16 May 2023 14:53:20 +0300 Subject: [PATCH 047/361] Update Dockerfile --- Dockerfile | 32 +++++++++++++------------------- 1 file changed, 13 insertions(+), 19 deletions(-) diff --git a/Dockerfile b/Dockerfile index a5691748..7fe08cd8 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,23 +1,21 @@ ARG BUILD_PATH=/tmp/cloud-game ARG VERSION=master -ARG GO=1.20.4 # base build stage FROM ubuntu:lunar AS build0 -ARG GO +ARG GO=1.20.4 +ARG GO_DIST=go${GO}.linux-amd64.tar.gz + +ADD https://go.dev/dl/$GO_DIST ./ +RUN tar -C /usr/local -xzf $GO_DIST && \ + rm $GO_DIST +ENV PATH="${PATH}:/usr/local/go/bin" RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ ca-certificates \ - wget \ make \ - upx - -ARG GO_DIST=go${GO}.linux-amd64.tar.gz -RUN wget -q https://golang.org/dl/$GO_DIST && \ - rm -rf /usr/local/go && \ - tar -C /usr/local -xzf $GO_DIST && \ - rm $GO_DIST -ENV PATH="${PATH}:/usr/local/go/bin" + upx \ +&& rm -rf /var/lib/apt/lists/* # next conditional build stage FROM build0 AS build_coordinator @@ -27,9 +25,6 @@ ENV GIT_VERSION ${VERSION} WORKDIR ${BUILD_PATH} -# install deps -RUN rm -rf /var/lib/apt/lists/* - # by default we ignore all except some folders and files, see .dockerignore COPY . ./ RUN --mount=type=cache,target=/root/.cache/go-build make build.coordinator @@ -51,7 +46,7 @@ ENV GIT_VERSION ${VERSION} WORKDIR ${BUILD_PATH} # install deps -RUN apt-get -q install --no-install-recommends -y \ +RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ gcc \ libopus-dev \ libsdl2-dev \ @@ -70,8 +65,6 @@ RUN mv ${BUILD_PATH}/bin/* ./ && \ mv ${BUILD_PATH}/LICENSE ./ RUN ${BUILD_PATH}/scripts/mkdirs.sh worker -RUN wget https://raw.githubusercontent.com/sergystepanov/mesa-llvmpipe/main/release/M23.1.0-LLVM16/libGL.so.1.5.0 - FROM scratch AS coordinator COPY --from=build_coordinator /usr/local/share/cloud-game /cloud-game @@ -90,8 +83,9 @@ RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ COPY --from=build_worker /usr/local/share/cloud-game /cloud-game COPY --from=build_worker /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ -RUN mv /cloud-game/libGL.so.1.5.0 /usr/lib/x86_64-linux-gnu/ && \ - cd /usr/lib/x86_64-linux-gnu && \ +ADD https://github.com/sergystepanov/mesa-llvmpipe/releases/download/v1.0.0/libGL.so.1.5.0 \ + /usr/lib/x86_64-linux-gnu/ +RUN cd /usr/lib/x86_64-linux-gnu && \ ln -s libGL.so.1.5.0 libGL.so.1 && \ ln -s libGL.so.1 libGL.so From 851d9a6fc17fe2dd0a5514f7f5287bceb8912657 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 17 May 2023 08:56:13 +0300 Subject: [PATCH 048/361] Use new Docker compose in Makefile --- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 585d2eac..4e2311bf 100644 --- a/Makefile +++ b/Makefile @@ -53,7 +53,7 @@ dev.run.debug: dev.run-docker: docker rm cloud-game-local -f || true - docker-compose up --build + docker compose up --build # RELEASE # Builds the app for new release. From 624eecd4e8ef3a26dabd3c51afc9793b01fba26c Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 17 May 2023 08:57:16 +0300 Subject: [PATCH 049/361] Show errors when ICE fails --- pkg/network/webrtc/webrtc.go | 8 ++++++-- web/js/network/webrtc.js | 4 +++- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/pkg/network/webrtc/webrtc.go b/pkg/network/webrtc/webrtc.go index e228eb28..afd13e34 100644 --- a/pkg/network/webrtc/webrtc.go +++ b/pkg/network/webrtc/webrtc.go @@ -141,8 +141,12 @@ func (p *Peer) handleICEState(onConnect func()) func(webrtc.ICEConnectionState) // nothing case webrtc.ICEConnectionStateConnected: onConnect() - case webrtc.ICEConnectionStateFailed, - webrtc.ICEConnectionStateClosed, + case webrtc.ICEConnectionStateFailed: + p.log.Error().Msgf("WebRTC connection fail! connection: %v, ice: %v, gathering: %v, signalling: %v", + p.conn.ConnectionState(), p.conn.ICEConnectionState(), p.conn.ICEGatheringState(), + p.conn.SignalingState()) + p.Disconnect() + case webrtc.ICEConnectionStateClosed, webrtc.ICEConnectionStateDisconnected: p.Disconnect() default: diff --git a/web/js/network/webrtc.js b/web/js/network/webrtc.js index 4a3d3605..99c5432a 100644 --- a/web/js/network/webrtc.js +++ b/web/js/network/webrtc.js @@ -105,7 +105,9 @@ const webrtc = (() => { break; } case 'disconnected': { - log.info('[rtc] disconnected...'); + log.info(`[rtc] disconnected... ` + + `connection: ${connection.connectionState}, ice: ${connection.iceConnectionState}, ` + + `gathering: ${connection.iceGatheringState}, signalling: ${connection.signalingState}`) connected = false; event.pub(WEBRTC_CONNECTION_CLOSED); break; From 5b4f74e2b7a07d77eaac484fb67f85f2e5793b50 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 21 May 2023 13:54:21 +0300 Subject: [PATCH 050/361] Notify users when there are no gaming slots --- pkg/api/api.go | 1 + pkg/coordinator/hub.go | 1 + web/js/api/api.js | 1 + web/js/controller.js | 7 ++++--- web/js/event/event.js | 1 + web/js/gui/message.js | 12 +++++------- 6 files changed, 13 insertions(+), 10 deletions(-) diff --git a/pkg/api/api.go b/pkg/api/api.go index cfdafe0a..6f53154d 100644 --- a/pkg/api/api.go +++ b/pkg/api/api.go @@ -79,6 +79,7 @@ const ( ToggleMultitap PT = 109 RecordGame PT = 110 GetWorkerList PT = 111 + ErrNoFreeSlots PT = 112 RegisterRoom PT = 201 CloseRoom PT = 202 IceCandidate = WebrtcIce diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index 6331aef4..bc815d9d 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -66,6 +66,7 @@ func (h *Hub) handleUserConnection() http.HandlerFunc { params := r.URL.Query() worker := h.findWorkerFor(user, params, h.log.Extend(h.log.With().Str("cid", user.Id().Short()))) if worker == nil { + user.Notify(api.ErrNoFreeSlots, "") h.log.Info().Msg("no free workers") return } diff --git a/web/js/api/api.js b/web/js/api/api.js index 7fafe225..bbb21318 100644 --- a/web/js/api/api.js +++ b/web/js/api/api.js @@ -20,6 +20,7 @@ const api = (() => { GAME_TOGGLE_MULTITAP: 109, GAME_RECORDING: 110, GET_WORKER_LIST: 111, + GAME_ERROR_NO_FREE_SLOTS: 112, }); const packet = (type, payload, id) => { diff --git a/web/js/controller.js b/web/js/controller.js index ab0ad129..eb7cd05a 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -214,6 +214,9 @@ case api.endpoint.GAME_RECORDING: event.pub(RECORDING_STATUS_CHANGED, payload); break; + case api.endpoint.GAME_ERROR_NO_FREE_SLOTS: + event.pub(GAME_ERROR_NO_FREE_SLOTS); + break; } } @@ -482,10 +485,8 @@ event.sub(GAME_PLAYER_IDX_SET, idx => { if (!isNaN(+idx)) message.show(+idx + 1); }); + event.sub(GAME_ERROR_NO_FREE_SLOTS, () => message.show("No free slots :(", 2500)); event.sub(WEBRTC_NEW_CONNECTION, (data) => { - // if (pingPong) { - // webrtc.setMessageHandler(onWebrtcMessage); - // } workerManager.whoami(data.wid); webrtc.start(data.ice); api.server.initWebrtc() diff --git a/web/js/event/event.js b/web/js/event/event.js index 922d468f..9ad45a4b 100644 --- a/web/js/event/event.js +++ b/web/js/event/event.js @@ -65,6 +65,7 @@ const GAME_SAVED = 'gameSaved'; const GAME_LOADED = 'gameLoaded'; const GAME_PLAYER_IDX = 'gamePlayerIndex'; const GAME_PLAYER_IDX_SET = 'gamePlayerIndexSet' +const GAME_ERROR_NO_FREE_SLOTS = 'gameNoFreeSlots' const WEBRTC_CONNECTION_CLOSED = 'webrtcConnectionClosed'; const WEBRTC_CONNECTION_READY = 'webrtcConnectionReady'; diff --git a/web/js/gui/message.js b/web/js/gui/message.js index d4bf668c..598d69e9 100644 --- a/web/js/gui/message.js +++ b/web/js/gui/message.js @@ -12,7 +12,7 @@ const message = (() => { let isScreenFree = true; - const _popup = () => { + const _popup = (time = 1000) => { // recursion edge case: // no messages in the queue or one on the screen if (!(queue.length > 0 && isScreenFree)) { @@ -21,7 +21,7 @@ const message = (() => { isScreenFree = false; popupBox.innerText = queue.shift(); - gui.anim.fadeInOut(popupBox, 1000, .05).finally(() => { + gui.anim.fadeInOut(popupBox, time, .05).finally(() => { isScreenFree = true; _popup(); }) @@ -33,14 +33,12 @@ const message = (() => { } } - const _proceed = (text) => { + const _proceed = (text, time) => { _storeMessage(text); - _popup(); + _popup(time); } - const show = (text) => { - _proceed(text) - } + const show = (text, time = 1000) => _proceed(text, time) return Object.freeze({ show: show From d237a5b6ead4b4fe54a1a5e7ee40550deb06234e Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 21 May 2023 13:59:33 +0300 Subject: [PATCH 051/361] Update dependencies --- go.mod | 17 ++++++++++------- go.sum | 20 ++++++++++++++++++++ 2 files changed, 30 insertions(+), 7 deletions(-) diff --git a/go.mod b/go.mod index e99eea29..aeff81a3 100644 --- a/go.mod +++ b/go.mod @@ -3,7 +3,7 @@ module github.com/giongto35/cloud-game/v3 go 1.20 require ( - github.com/VictoriaMetrics/metrics v1.23.1 + github.com/VictoriaMetrics/metrics v1.24.0 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.6.0 github.com/goccy/go-json v0.10.2 @@ -11,9 +11,9 @@ require ( github.com/gorilla/websocket v1.5.0 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.0.1 - github.com/pion/interceptor v0.1.16 + github.com/pion/interceptor v0.1.17 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v3 v3.2.1 + github.com/pion/webrtc/v3 v3.2.5 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.29.1 github.com/veandco/go-sdl2 v0.4.35 @@ -23,6 +23,7 @@ require ( ) require ( + github.com/davecgh/go-spew v1.1.1 // indirect github.com/google/uuid v1.3.0 // indirect github.com/mattn/go-colorable v0.1.13 // indirect github.com/mattn/go-isatty v0.0.18 // indirect @@ -30,19 +31,21 @@ require ( github.com/mitchellh/mapstructure v1.5.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect - github.com/pion/dtls/v2 v2.2.6 // indirect - github.com/pion/ice/v2 v2.3.2 // indirect + github.com/pion/dtls/v2 v2.2.7 // indirect + github.com/pion/ice/v2 v2.3.4 // indirect github.com/pion/mdns v0.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.10 // indirect github.com/pion/rtp v1.7.13 // indirect github.com/pion/sctp v1.8.7 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect - github.com/pion/srtp/v2 v2.0.13 // indirect + github.com/pion/srtp/v2 v2.0.15 // indirect github.com/pion/stun v0.5.2 // indirect - github.com/pion/transport/v2 v2.2.0 // indirect + github.com/pion/transport/v2 v2.2.1 // indirect github.com/pion/turn/v2 v2.1.0 // indirect github.com/pion/udp/v2 v2.0.1 // indirect + github.com/pmezard/go-difflib v1.0.0 // indirect + github.com/stretchr/testify v1.8.3 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect golang.org/x/net v0.10.0 // indirect diff --git a/go.sum b/go.sum index 0274ff4a..b3c7999e 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,7 @@ github.com/VictoriaMetrics/metrics v1.23.1 h1:/j8DzeJBxSpL2qSIdqnRFLvQQhbJyJbbEi22yMm7oL0= github.com/VictoriaMetrics/metrics v1.23.1/go.mod h1:rAr/llLpEnAdTehiNlUxKgnjcOuROSzpw0GvjpEbvFc= +github.com/VictoriaMetrics/metrics v1.24.0 h1:ILavebReOjYctAGY5QU2F9X0MYvkcrG3aEn2RKa1Zkw= +github.com/VictoriaMetrics/metrics v1.24.0/go.mod h1:eFT25kvsTidQFHb6U0oa0rTrDRdz4xTYjpL8+UPohys= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -69,10 +71,16 @@ github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= github.com/pion/dtls/v2 v2.2.6 h1:yXMxKr0Skd+Ub6A8UqXTRLSywskx93ooMRHsQUtd+Z4= github.com/pion/dtls/v2 v2.2.6/go.mod h1:t8fWJCIquY5rlQZwA2yWxUS1+OCrAdXrhVKXB5oD/wY= +github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= +github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= github.com/pion/ice/v2 v2.3.2 h1:vh+fi4RkZ8H5fB4brZ/jm3j4BqFgMmNs+aB3X52Hu7M= github.com/pion/ice/v2 v2.3.2/go.mod h1:AMIpuJqcpe+UwloocNebmTSWhCZM1TUCo9v7nW50jX0= +github.com/pion/ice/v2 v2.3.4 h1:tjYjTLpWyZzUjpDnzk6T1y3oQyhyY2DiM2t095iDhyQ= +github.com/pion/ice/v2 v2.3.4/go.mod h1:jVbxqPWQDK5+/V/YqpinUcP0YtDGYqd24n2lusVdX80= github.com/pion/interceptor v0.1.16 h1:0GDZrfNO+BmVNWymS31fMlVtPO2IJVBzy2Qq5XCYMIg= github.com/pion/interceptor v0.1.16/go.mod h1:SY8kpmfVBvrbUzvj2bsXz7OJt5JvmVNZ+4Kjq7FcwrI= +github.com/pion/interceptor v0.1.17 h1:prJtgwFh/gB8zMqGZoOgJPHivOwVAp61i2aG61Du/1w= +github.com/pion/interceptor v0.1.17/go.mod h1:SY8kpmfVBvrbUzvj2bsXz7OJt5JvmVNZ+4Kjq7FcwrI= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= github.com/pion/mdns v0.0.7 h1:P0UB4Sr6xDWEox0kTVxF0LmQihtCbSAdW0H2nEgkA3U= @@ -91,6 +99,8 @@ github.com/pion/sdp/v3 v3.0.6/go.mod h1:iiFWFpQO8Fy3S5ldclBkpXqmWy02ns78NOKoLLL0 github.com/pion/srtp/v2 v2.0.12/go.mod h1:C3Ep44hlOo2qEYaq4ddsmK5dL63eLehXFbHaZ9F5V9Y= github.com/pion/srtp/v2 v2.0.13 h1:GJQNMCqbYrNIBt1f3maX+E+woREVh2ilhAafBh0vqmk= github.com/pion/srtp/v2 v2.0.13/go.mod h1:FA7u5fWpVITMYNL70TA3csQuMQJA5/+6ZMajGxveHgM= +github.com/pion/srtp/v2 v2.0.15 h1:+tqRtXGsGwHC0G0IUIAzRmdkHvriF79IHVfZGfHrQoA= +github.com/pion/srtp/v2 v2.0.15/go.mod h1:b/pQOlDrbB0HEH5EUAQXzSYxikFbNcNuKmF8tM0hCtw= github.com/pion/stun v0.4.0/go.mod h1:QPsh1/SbXASntw3zkkrIk3ZJVKz4saBY2G7S10P3wCw= github.com/pion/stun v0.5.2 h1:J/8glQnDV91dfk2+ZnGN0o9bUJgABhTNljwfQWByoXE= github.com/pion/stun v0.5.2/go.mod h1:TNo1HjyjaFVpMZsvowqPeV8TfwRytympQC0//neaksA= @@ -101,12 +111,16 @@ github.com/pion/transport/v2 v2.0.2/go.mod h1:vrz6bUbFr/cjdwbnxq8OdDDzHf7JJfGsIR github.com/pion/transport/v2 v2.1.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= github.com/pion/transport/v2 v2.2.0 h1:u5lFqFHkXLMXMzai8tixZDfVjb8eOjH35yCunhPeb1c= github.com/pion/transport/v2 v2.2.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= +github.com/pion/transport/v2 v2.2.1 h1:7qYnCBlpgSJNYMbLCKuSY9KbQdBFoETvPNETv0y4N7c= +github.com/pion/transport/v2 v2.2.1/go.mod h1:cXXWavvCnFF6McHTft3DWS9iic2Mftcz1Aq29pGcU5g= github.com/pion/turn/v2 v2.1.0 h1:5wGHSgGhJhP/RpabkUb/T9PdsAjkGLS6toYz5HNzoSI= github.com/pion/turn/v2 v2.1.0/go.mod h1:yrT5XbXSGX1VFSF31A3c1kCNB5bBZgk/uu5LET162qs= github.com/pion/udp/v2 v2.0.1 h1:xP0z6WNux1zWEjhC7onRA3EwwSliXqu1ElUZAQhUP54= github.com/pion/udp/v2 v2.0.1/go.mod h1:B7uvTMP00lzWdyMr/1PVZXtV3wpPIxBRd4Wl6AksXn8= github.com/pion/webrtc/v3 v3.2.1 h1:eehbYzkM6xWoH3LXoIBnZTb4TOrjwmVzI78JO1+5kgQ= github.com/pion/webrtc/v3 v3.2.1/go.mod h1:sQVqop5YhZezvKyyz6Nywvf15LhlXUWiXWdN5DV4zHs= +github.com/pion/webrtc/v3 v3.2.5 h1:WA38+a1T3/EP55k5IYQFLH3ORaNpRTcElW6UL1CwNeA= +github.com/pion/webrtc/v3 v3.2.5/go.mod h1:8+GhDtUqfKmnZkj+aT2kjvV9B2/nhSTqINEXbVQEGSo= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -125,6 +139,8 @@ github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= github.com/stretchr/testify v1.8.2 h1:+h33VjcLVPDHtOdpUCuF+7gSuG3yGIftsP1YvFihtJ8= github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= +github.com/stretchr/testify v1.8.3 h1:RP3t2pwF7cMEbC1dqtB6poj3niw/9gnV4Cjg5oW5gtY= +github.com/stretchr/testify v1.8.3/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= @@ -139,6 +155,7 @@ golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPh golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= golang.org/x/crypto v0.5.0/go.mod h1:NK/OQwhpMQP3MwtdjgLlYHnH9ebylxKWv3e0fK+mkQU= golang.org/x/crypto v0.6.0/go.mod h1:OFC/31mSvZgRz0V1QTNCzfAI1aIRzbiufJtkMIlEp58= +golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= golang.org/x/crypto v0.9.0 h1:LF6fAI+IutBocDJ2OT0Q1g8plpYljMZ4+lty+dsqw3g= golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0= golang.org/x/image v0.7.0 h1:gzS29xtG1J5ybQlv0PuyfE3nmc6R4qB73m6LUUmvFuw= @@ -159,6 +176,7 @@ golang.org/x/net v0.5.0/go.mod h1:DivGGAXEgPSlEBzxGzZI+ZLohi+xUj054jfeKui00ws= golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc= +golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= golang.org/x/net v0.10.0 h1:X2//UzNDwYmtCLn7To6G58Wr6f5ahEAQgKNzv9Y951M= golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -198,6 +216,8 @@ golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.4.0/go.mod h1:9P2UbLfCdcvo3p/nzKvsmas4TnlujnuoV9hGgYzW1lQ= golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= golang.org/x/term v0.6.0/go.mod h1:m6U89DPEgQRMq3DNkDClhWw02AUbt2daBVO4cn4Hv9U= +golang.org/x/term v0.7.0/go.mod h1:P32HKFT3hSsZrRxla30E9HqToFYAQPCMs/zFMBUFqPY= +golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= From a4f47396e5d537955fa0672ae6adb260dee745b4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 21 May 2023 18:45:46 +0300 Subject: [PATCH 052/361] Remove unused 404 handler --- pkg/network/httpx/server.go | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/pkg/network/httpx/server.go b/pkg/network/httpx/server.go index b98f8e79..076f0683 100644 --- a/pkg/network/httpx/server.go +++ b/pkg/network/httpx/server.go @@ -53,9 +53,8 @@ func (m *Mux) HandleFunc(pattern string, handler func(ResponseWriter, *Request)) m.ServeMux.HandleFunc(m.prefix+pattern, handler) return m } -func (m *Mux) ServeHTTP(w ResponseWriter, r *Request) { m.ServeMux.ServeHTTP(w, r) } -func NotFound(w ResponseWriter) { http.Error(w, "404 page not found", http.StatusNotFound) } +func (m *Mux) ServeHTTP(w ResponseWriter, r *Request) { m.ServeMux.ServeHTTP(w, r) } func NewServer(address string, handler func(*Server) Handler, options ...Option) (*Server, error) { opts := &Options{ From 2ed6e8724f6a2b951769c0d73ac99bb25c599af3 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 22 May 2023 18:34:58 +0300 Subject: [PATCH 053/361] Add Alwa's Awakening (Demo) NES ROM --- assets/games/Alwa's Awakening (Demo).nes | Bin 0 -> 524304 bytes assets/games/Super Mario Bros.nes | Bin 40976 -> 0 bytes pkg/games/library_test.go | 2 +- pkg/worker/emulator/libretro/frontend_test.go | 2 +- pkg/worker/emulator/libretro/nanoarch_test.go | 2 +- pkg/worker/room_test.go | 8 ++++---- 6 files changed, 7 insertions(+), 7 deletions(-) create mode 100644 assets/games/Alwa's Awakening (Demo).nes delete mode 100644 assets/games/Super Mario Bros.nes diff --git a/assets/games/Alwa's Awakening (Demo).nes b/assets/games/Alwa's Awakening (Demo).nes new file mode 100644 index 0000000000000000000000000000000000000000..7c2f5155d8240f8063d3a384ec1dc5fdf4745ee8 GIT binary patch literal 524304 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

S5~mo+l8tcr7s4}c7}2vr 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 Date: Sat, 27 May 2023 17:34:35 +0300 Subject: [PATCH 054/361] Refactor media (#401) * Encapsulate media * Write audio by 4 bytes instead 2 * Update deps --- go.mod | 9 +- go.sum | 34 ++------ pkg/worker/coordinatorhandlers.go | 2 +- pkg/worker/media.go | 133 ++++++++++++++++-------------- pkg/worker/media_test.go | 70 +++++++++------- 5 files changed, 120 insertions(+), 128 deletions(-) diff --git a/go.mod b/go.mod index aeff81a3..611385d4 100644 --- a/go.mod +++ b/go.mod @@ -13,7 +13,7 @@ require ( github.com/knadh/koanf/v2 v2.0.1 github.com/pion/interceptor v0.1.17 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v3 v3.2.5 + github.com/pion/webrtc/v3 v3.2.8 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.29.1 github.com/veandco/go-sdl2 v0.4.35 @@ -26,13 +26,13 @@ require ( github.com/davecgh/go-spew v1.1.1 // indirect github.com/google/uuid v1.3.0 // indirect github.com/mattn/go-colorable v0.1.13 // indirect - github.com/mattn/go-isatty v0.0.18 // indirect + github.com/mattn/go-isatty v0.0.19 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/mapstructure v1.5.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect github.com/pion/dtls/v2 v2.2.7 // indirect - github.com/pion/ice/v2 v2.3.4 // indirect + github.com/pion/ice/v2 v2.3.6 // indirect github.com/pion/mdns v0.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.10 // indirect @@ -40,10 +40,9 @@ require ( github.com/pion/sctp v1.8.7 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect github.com/pion/srtp/v2 v2.0.15 // indirect - github.com/pion/stun v0.5.2 // indirect + github.com/pion/stun v0.6.0 // indirect github.com/pion/transport/v2 v2.2.1 // indirect github.com/pion/turn/v2 v2.1.0 // indirect - github.com/pion/udp/v2 v2.0.1 // indirect github.com/pmezard/go-difflib v1.0.0 // indirect github.com/stretchr/testify v1.8.3 // indirect github.com/valyala/fastrand v1.1.0 // indirect diff --git a/go.sum b/go.sum index b3c7999e..e6ba3a6a 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,3 @@ -github.com/VictoriaMetrics/metrics v1.23.1 h1:/j8DzeJBxSpL2qSIdqnRFLvQQhbJyJbbEi22yMm7oL0= -github.com/VictoriaMetrics/metrics v1.23.1/go.mod h1:rAr/llLpEnAdTehiNlUxKgnjcOuROSzpw0GvjpEbvFc= github.com/VictoriaMetrics/metrics v1.24.0 h1:ILavebReOjYctAGY5QU2F9X0MYvkcrG3aEn2RKa1Zkw= github.com/VictoriaMetrics/metrics v1.24.0/go.mod h1:eFT25kvsTidQFHb6U0oa0rTrDRdz4xTYjpL8+UPohys= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= @@ -50,8 +48,8 @@ github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxec github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg= github.com/mattn/go-isatty v0.0.14/go.mod h1:7GGIvUiUoEMVVmxf/4nioHXj79iQHKdU27kJ6hsGG94= github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM= -github.com/mattn/go-isatty v0.0.18 h1:DOKFKCQ7FNG2L1rbrmstDN4QVRdS89Nkh85u68Uwp98= -github.com/mattn/go-isatty v0.0.18/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/mattn/go-isatty v0.0.19 h1:JITubQf0MOLdlGRuRq+jtsDlekdYPia9ZFsB8h/APPA= +github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= @@ -69,16 +67,10 @@ github.com/onsi/gomega v1.10.1/go.mod h1:iN09h71vgCQne3DLsj+A5owkum+a2tYe+TOCB1y github.com/onsi/gomega v1.17.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAlGdZY= github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew8= github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= -github.com/pion/dtls/v2 v2.2.6 h1:yXMxKr0Skd+Ub6A8UqXTRLSywskx93ooMRHsQUtd+Z4= -github.com/pion/dtls/v2 v2.2.6/go.mod h1:t8fWJCIquY5rlQZwA2yWxUS1+OCrAdXrhVKXB5oD/wY= github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= -github.com/pion/ice/v2 v2.3.2 h1:vh+fi4RkZ8H5fB4brZ/jm3j4BqFgMmNs+aB3X52Hu7M= -github.com/pion/ice/v2 v2.3.2/go.mod h1:AMIpuJqcpe+UwloocNebmTSWhCZM1TUCo9v7nW50jX0= -github.com/pion/ice/v2 v2.3.4 h1:tjYjTLpWyZzUjpDnzk6T1y3oQyhyY2DiM2t095iDhyQ= -github.com/pion/ice/v2 v2.3.4/go.mod h1:jVbxqPWQDK5+/V/YqpinUcP0YtDGYqd24n2lusVdX80= -github.com/pion/interceptor v0.1.16 h1:0GDZrfNO+BmVNWymS31fMlVtPO2IJVBzy2Qq5XCYMIg= -github.com/pion/interceptor v0.1.16/go.mod h1:SY8kpmfVBvrbUzvj2bsXz7OJt5JvmVNZ+4Kjq7FcwrI= +github.com/pion/ice/v2 v2.3.6 h1:Jgqw36cAud47iD+N6rNX225uHvrgWtAlHfVyOQc3Heg= +github.com/pion/ice/v2 v2.3.6/go.mod h1:9/TzKDRwBVAPsC+YOrKH/e3xDrubeTRACU9/sHQarsU= github.com/pion/interceptor v0.1.17 h1:prJtgwFh/gB8zMqGZoOgJPHivOwVAp61i2aG61Du/1w= github.com/pion/interceptor v0.1.17/go.mod h1:SY8kpmfVBvrbUzvj2bsXz7OJt5JvmVNZ+4Kjq7FcwrI= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= @@ -96,31 +88,24 @@ github.com/pion/sctp v1.8.7 h1:JnABvFakZueGAn4KU/4PSKg+GWbF6QWbKTWZOSGJjXw= github.com/pion/sctp v1.8.7/go.mod h1:g1Ul+ARqZq5JEmoFy87Q/4CePtKnTJ1QCL9dBBdN6AU= github.com/pion/sdp/v3 v3.0.6 h1:WuDLhtuFUUVpTfus9ILC4HRyHsW6TdugjEX/QY9OiUw= github.com/pion/sdp/v3 v3.0.6/go.mod h1:iiFWFpQO8Fy3S5ldclBkpXqmWy02ns78NOKoLLL0YQw= -github.com/pion/srtp/v2 v2.0.12/go.mod h1:C3Ep44hlOo2qEYaq4ddsmK5dL63eLehXFbHaZ9F5V9Y= -github.com/pion/srtp/v2 v2.0.13 h1:GJQNMCqbYrNIBt1f3maX+E+woREVh2ilhAafBh0vqmk= -github.com/pion/srtp/v2 v2.0.13/go.mod h1:FA7u5fWpVITMYNL70TA3csQuMQJA5/+6ZMajGxveHgM= github.com/pion/srtp/v2 v2.0.15 h1:+tqRtXGsGwHC0G0IUIAzRmdkHvriF79IHVfZGfHrQoA= github.com/pion/srtp/v2 v2.0.15/go.mod h1:b/pQOlDrbB0HEH5EUAQXzSYxikFbNcNuKmF8tM0hCtw= github.com/pion/stun v0.4.0/go.mod h1:QPsh1/SbXASntw3zkkrIk3ZJVKz4saBY2G7S10P3wCw= -github.com/pion/stun v0.5.2 h1:J/8glQnDV91dfk2+ZnGN0o9bUJgABhTNljwfQWByoXE= -github.com/pion/stun v0.5.2/go.mod h1:TNo1HjyjaFVpMZsvowqPeV8TfwRytympQC0//neaksA= +github.com/pion/stun v0.6.0 h1:JHT/2iyGDPrFWE8NNC15wnddBN8KifsEDw8swQmrEmU= +github.com/pion/stun v0.6.0/go.mod h1:HPqcfoeqQn9cuaet7AOmB5e5xkObu9DwBdurwLKO9oA= github.com/pion/transport v0.14.1 h1:XSM6olwW+o8J4SCmOBb/BpwZypkHeyM0PGFCxNQBr40= github.com/pion/transport v0.14.1/go.mod h1:4tGmbk00NeYA3rUa9+n+dzCCoKkcy3YlYb99Jn2fNnI= github.com/pion/transport/v2 v2.0.0/go.mod h1:HS2MEBJTwD+1ZI2eSXSvHJx/HnzQqRy2/LXxt6eVMHc= github.com/pion/transport/v2 v2.0.2/go.mod h1:vrz6bUbFr/cjdwbnxq8OdDDzHf7JJfGsIRkxfpZoTA0= github.com/pion/transport/v2 v2.1.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= -github.com/pion/transport/v2 v2.2.0 h1:u5lFqFHkXLMXMzai8tixZDfVjb8eOjH35yCunhPeb1c= github.com/pion/transport/v2 v2.2.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= github.com/pion/transport/v2 v2.2.1 h1:7qYnCBlpgSJNYMbLCKuSY9KbQdBFoETvPNETv0y4N7c= github.com/pion/transport/v2 v2.2.1/go.mod h1:cXXWavvCnFF6McHTft3DWS9iic2Mftcz1Aq29pGcU5g= github.com/pion/turn/v2 v2.1.0 h1:5wGHSgGhJhP/RpabkUb/T9PdsAjkGLS6toYz5HNzoSI= github.com/pion/turn/v2 v2.1.0/go.mod h1:yrT5XbXSGX1VFSF31A3c1kCNB5bBZgk/uu5LET162qs= -github.com/pion/udp/v2 v2.0.1 h1:xP0z6WNux1zWEjhC7onRA3EwwSliXqu1ElUZAQhUP54= github.com/pion/udp/v2 v2.0.1/go.mod h1:B7uvTMP00lzWdyMr/1PVZXtV3wpPIxBRd4Wl6AksXn8= -github.com/pion/webrtc/v3 v3.2.1 h1:eehbYzkM6xWoH3LXoIBnZTb4TOrjwmVzI78JO1+5kgQ= -github.com/pion/webrtc/v3 v3.2.1/go.mod h1:sQVqop5YhZezvKyyz6Nywvf15LhlXUWiXWdN5DV4zHs= -github.com/pion/webrtc/v3 v3.2.5 h1:WA38+a1T3/EP55k5IYQFLH3ORaNpRTcElW6UL1CwNeA= -github.com/pion/webrtc/v3 v3.2.5/go.mod h1:8+GhDtUqfKmnZkj+aT2kjvV9B2/nhSTqINEXbVQEGSo= +github.com/pion/webrtc/v3 v3.2.8 h1:RmDEz7wjK3k0sAuCSMptfxp095pBYSkSSm5ySiJYIHI= +github.com/pion/webrtc/v3 v3.2.8/go.mod h1:6/7wF1P86AQAw4iTmKIgdzaevaQ8qh9SfrFyypqmN6w= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -137,7 +122,6 @@ github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= -github.com/stretchr/testify v1.8.2 h1:+h33VjcLVPDHtOdpUCuF+7gSuG3yGIftsP1YvFihtJ8= github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= github.com/stretchr/testify v1.8.3 h1:RP3t2pwF7cMEbC1dqtB6poj3niw/9gnV4Cjg5oW5gtY= github.com/stretchr/testify v1.8.3/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= @@ -153,8 +137,6 @@ golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACk golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= -golang.org/x/crypto v0.5.0/go.mod h1:NK/OQwhpMQP3MwtdjgLlYHnH9ebylxKWv3e0fK+mkQU= -golang.org/x/crypto v0.6.0/go.mod h1:OFC/31mSvZgRz0V1QTNCzfAI1aIRzbiufJtkMIlEp58= golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= golang.org/x/crypto v0.9.0 h1:LF6fAI+IutBocDJ2OT0Q1g8plpYljMZ4+lty+dsqw3g= golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0= diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 1f827faa..5dab2c9c 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -27,7 +27,7 @@ func buildConnQuery(id com.Uid, conf config.Worker, address string) (string, err func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest[com.Uid], w *Worker, connApi *webrtc.ApiFactory) api.Out { peer := webrtc.New(c.log, connApi) - localSDP, err := peer.NewCall(w.conf.Encoder.Video.Codec, audioCodec, func(data any) { + localSDP, err := peer.NewCall(w.conf.Encoder.Video.Codec, "opus", func(data any) { candidate, err := toBase64Json(data) if err != nil { c.log.Error().Err(err).Msgf("ICE candidate encode fail for [%v]", data) diff --git a/pkg/worker/media.go b/pkg/worker/media.go index 6754d66d..14191a7a 100644 --- a/pkg/worker/media.go +++ b/pkg/worker/media.go @@ -3,6 +3,7 @@ package worker import ( "sync" "time" + "unsafe" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" @@ -13,51 +14,55 @@ import ( webrtc "github.com/pion/webrtc/v3/pkg/media" ) +const ( + dstHz = 48000 + sampleBufLen = 1024 * 4 +) + +// buffer is a simple non-concurrent safe ring buffer for audio samples. +type ( + buffer struct { + s samples + wi int + dst int + stretch bool + } + samples []int16 +) + var ( encoderOnce = sync.Once{} opusCoder *opus.Encoder samplePool sync.Pool - audioPool = sync.Pool{New: func() any { b := make([]int16, 3000); return &b }} + audioPool = sync.Pool{New: func() any { b := make([]int16, sampleBufLen); return &b }} ) -const ( - audioChannels = 2 - audioCodec = "opus" - audioFrequency = 48000 -) +func newBuffer(srcLen int) buffer { return buffer{s: make(samples, srcLen)} } -// Buffer is a simple non-thread safe ring buffer for audio samples. -// It should be used for 16bit PCM (LE interleaved) data. -type ( - Buffer struct { - s Samples - wi int - } - OnFull func(s Samples) - Samples []int16 -) +// enableStretch adds a simple stretching of buffer to a desired size before +// the onFull callback call. +func (b *buffer) enableStretch(l int) { b.stretch = true; b.dst = l } -func NewBuffer(numSamples int) Buffer { return Buffer{s: make(Samples, numSamples)} } - -// Write fills the buffer with data calling a callback function when -// the internal buffer fills out. +// write fills the buffer until it's full and then passes the gathered data into a callback. // -// Consider two cases: -// -// 1. Underflow, when the length of written data is less than the buffer's available space. +// There are two cases to consider: +// 1. Underflow, when the length of the written data is less than the buffer's available space. // 2. Overflow, when the length exceeds the current available buffer space. -// In the both cases we overwrite any previous values in the buffer and move the internal -// write pointer on the length of written data. -// In the first case we won't call the callback, but it will be called every time +// +// We overwrite any previous values in the buffer and move the internal write pointer +// by the length of the written data. +// In the first case, we won't call the callback, but it will be called every time // when the internal buffer overflows until all samples are read. -func (b *Buffer) Write(s Samples, onFull OnFull) (r int) { +func (b *buffer) write(s samples, onFull func(samples)) (r int) { for r < len(s) { w := copy(b.s[b.wi:], s[r:]) r += w b.wi += w if b.wi == len(b.s) { b.wi = 0 - if onFull != nil { + if b.stretch { + onFull(b.s.stretch(b.dst)) + } else { onFull(b.s) } } @@ -65,18 +70,29 @@ func (b *Buffer) Write(s Samples, onFull OnFull) (r int) { return } -// GetFrameSizeFor calculates audio frame size, i.e. 48k*frame/1000*2 -func GetFrameSizeFor(hz int, frame int) int { return hz * frame / 1000 * audioChannels } +// frame calculates an audio stereo frame size, i.e. 48k*frame/1000*2 +func frame(hz int, frame int) int { return hz * frame / 1000 * 2 } -func (r *Room) initAudio(frequency int, conf config.Audio) { - buf := NewBuffer(GetFrameSizeFor(frequency, conf.Frame)) - resample, frameLen := frequency != audioFrequency, 0 - if resample { - frameLen = GetFrameSizeFor(audioFrequency, conf.Frame) +// stretch does a simple stretching of audio samples. +// something like: [1,2,3,4,5,6] -> [1,2,x,x,3,4,x,x,5,6,x,x] -> [1,2,1,2,3,4,3,4,5,6,5,6] +func (s samples) stretch(size int) []int16 { + out := (*audioPool.Get().(*[]int16))[:size] + n := len(s) + ratio := float32(size) / float32(n) + sPtr := unsafe.Pointer(&s[0]) + for i, l, r := 0, 0, 0; i < n; i += 2 { + l, r = r, int(float32((i+2)>>1)*ratio)<<1 // index in src * ratio -> approximated index in dst *2 due to int16 + for j := l; j < r; j += 2 { + *(*int32)(unsafe.Pointer(&out[j])) = *(*int32)(sPtr) // out[j] = s[i]; out[j+1] = s[i+1] + } + sPtr = unsafe.Add(sPtr, uintptr(4)) } + return out +} +func (r *Room) initAudio(srcHz int, conf config.Audio) { encoderOnce.Do(func() { - enc, err := opus.NewEncoder(audioFrequency) + enc, err := opus.NewEncoder(dstHz) if err != nil { r.log.Fatal().Err(err).Msg("couldn't create audio encoder") } @@ -87,23 +103,28 @@ func (r *Room) initAudio(frequency int, conf config.Audio) { } r.log.Debug().Msgf("Opus: %v", opusCoder.GetInfo()) - dur := time.Duration(conf.Frame) * time.Millisecond + buf := newBuffer(frame(srcHz, conf.Frame)) + if srcHz != dstHz { + buf.enableStretch(frame(dstHz, conf.Frame)) + r.log.Debug().Msgf("Resample %vHz -> %vHz", srcHz, dstHz) + } + frameDur := time.Duration(conf.Frame) * time.Millisecond - fn := func(s Samples) { - if resample { - s = ResampleStretchNew(s, frameLen) - } - f, err := opusCoder.Encode(s) - audioPool.Put((*[]int16)(&s)) - if err == nil { - r.handleSample(f, dur, func(u *Session, s *webrtc.Sample) { + r.emulator.SetAudio(func(raw *emulator.GameAudio) { + buf.write(*raw.Data, func(pcm samples) { + data, err := opusCoder.Encode(pcm) + audioPool.Put((*[]int16)(&pcm)) + if err != nil { + r.log.Error().Err(err).Msgf("opus encode fail") + return + } + r.handleSample(data, frameDur, func(u *Session, s *webrtc.Sample) { if err := u.SendAudio(s); err != nil { r.log.Error().Err(err).Send() } }) - } - } - r.emulator.SetAudio(func(samples *emulator.GameAudio) { buf.Write(*samples.Data, fn) }) + }) + }) } // initVideo processes videoFrames images with an encoder (codec) then pushes the result to WebRTC. @@ -160,19 +181,3 @@ func (r *Room) handleSample(b []byte, d time.Duration, fn func(*Session, *webrtc }) samplePool.Put(sample) } - -// ResampleStretchNew does a simple stretching of audio samples. -// something like: [1,2,3,4,5,6] -> [1,2,x,x,3,4,x,x,5,6,x,x] -> [1,2,1,2,3,4,3,4,5,6,5,6] -func ResampleStretchNew(pcm []int16, size int) []int16 { - out := (*audioPool.Get().(*[]int16))[:size] - n := len(pcm) - ratio := float32(size) / float32(n) - for i, l, r := 0, 0, 0; i < n; i += 2 { - l, r = r, int(float32((i+2)>>1)*ratio)<<1 - for j := l; j < r-1; j += 2 { - out[j] = pcm[i] - out[j+1] = pcm[i+1] - } - } - return out -} diff --git a/pkg/worker/media_test.go b/pkg/worker/media_test.go index 7086a51f..4e5a03f6 100644 --- a/pkg/worker/media_test.go +++ b/pkg/worker/media_test.go @@ -1,7 +1,6 @@ package worker import ( - "fmt" "image" "math/rand" "reflect" @@ -86,7 +85,7 @@ func genTestImage(w, h int, seed float32) *image.RGBA { func TestResampleStretch(t *testing.T) { type args struct { - pcm []int16 + pcm samples size int } tests := []struct { @@ -106,7 +105,7 @@ func TestResampleStretch(t *testing.T) { } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { - rez2 := ResampleStretchNew(tt.args.pcm, tt.args.size) + rez2 := tt.args.pcm.stretch(tt.args.size) if rez2[0] != tt.args.pcm[0] || rez2[1] != tt.args.pcm[1] || rez2[len(rez2)-1] != tt.args.pcm[len(tt.args.pcm)-1] || @@ -119,20 +118,10 @@ func TestResampleStretch(t *testing.T) { } func BenchmarkResampler(b *testing.B) { - tests := []struct { - name string - fn func(pcm []int16, size int) []int16 - }{ - {name: "new", fn: ResampleStretchNew}, - } - pcm := gen(1764) + pcm := samples(gen(1764)) size := 1920 - for _, bn := range tests { - b.Run(fmt.Sprintf("%v", bn.name), func(b *testing.B) { - for i := 0; i < b.N; i++ { - bn.fn(pcm, size) - } - }) + for i := 0; i < b.N; i++ { + pcm.stretch(size) } } @@ -141,10 +130,6 @@ func gen(l int) []int16 { for i := range nums { nums[i] = int16(rand.Intn(10)) } - //for i := len(nums) / 2; i < len(nums)/2+42; i++ { - // nums[i] = 0 - //} - return nums } @@ -157,7 +142,7 @@ func TestBufferWrite(t *testing.T) { tests := []struct { bufLen int writes []bufWrite - expect Samples + expect samples }{ { bufLen: 20, @@ -166,7 +151,7 @@ func TestBufferWrite(t *testing.T) { {sample: 2, len: 20}, {sample: 3, len: 30}, }, - expect: Samples{3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3}, + expect: samples{3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3}, }, { bufLen: 11, @@ -175,15 +160,15 @@ func TestBufferWrite(t *testing.T) { {sample: 2, len: 18}, {sample: 3, len: 2}, }, - expect: Samples{3, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3}, + expect: samples{3, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3}, }, } for _, test := range tests { - var lastResult Samples - buf := NewBuffer(test.bufLen) + var lastResult samples + buf := newBuffer(test.bufLen) for _, w := range test.writes { - buf.Write(samplesOf(w.sample, w.len), func(s Samples) { lastResult = s }) + buf.write(samplesOf(w.sample, w.len), func(s samples) { lastResult = s }) } if !reflect.DeepEqual(test.expect, lastResult) { t.Errorf("not expted buffer, %v != %v", lastResult, test.expect) @@ -192,21 +177,42 @@ func TestBufferWrite(t *testing.T) { } func BenchmarkBufferWrite(b *testing.B) { - fn := func(_ Samples) {} + fn := func(_ samples) {} l := 1920 - buf := NewBuffer(l) + buf := newBuffer(l) samples1 := samplesOf(1, l/2) samples2 := samplesOf(2, l*2) for i := 0; i < b.N; i++ { - buf.Write(samples1, fn) - buf.Write(samples2, fn) + buf.write(samples1, fn) + buf.write(samples2, fn) } } -func samplesOf(v int16, len int) (s Samples) { - s = make(Samples, len) +func samplesOf(v int16, len int) (s samples) { + s = make(samples, len) for i := range s { s[i] = v } return } + +func Test_frame(t *testing.T) { + type args struct { + hz int + frame int + } + tests := []struct { + name string + args args + want int + }{ + {name: "mGBA", args: args{hz: 32768, frame: 10}, want: 654}, + } + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + if got := frame(tt.args.hz, tt.args.frame); got != tt.want { + t.Errorf("frame() = %v, want %v", got, tt.want) + } + }) + } +} From a6bcf5cd9481d3f9335a8f2e3147e2e1ccc1a4fe Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 27 May 2023 17:36:57 +0300 Subject: [PATCH 055/361] Fix scale option (it is slow) --- pkg/worker/emulator/emulator.go | 2 +- pkg/worker/emulator/image/canvas.go | 5 ++++ pkg/worker/emulator/libretro/frontend.go | 4 +-- pkg/worker/emulator/libretro/nanoarch_test.go | 6 ++++- pkg/worker/media.go | 25 ++++++++----------- pkg/worker/room.go | 2 +- 6 files changed, 25 insertions(+), 19 deletions(-) diff --git a/pkg/worker/emulator/emulator.go b/pkg/worker/emulator/emulator.go index 32602549..08232202 100644 --- a/pkg/worker/emulator/emulator.go +++ b/pkg/worker/emulator/emulator.go @@ -22,7 +22,7 @@ type Emulator interface { // Start is called after LoadGame Start() // SetViewport sets viewport size - SetViewport(width int, height int) + SetViewport(width int, height int, scale int) // SetMainSaveName sets distinct name for saves naming SetMainSaveName(name string) // SaveGameState save game state diff --git a/pkg/worker/emulator/image/canvas.go b/pkg/worker/emulator/image/canvas.go index 84194ee1..3c1636c6 100644 --- a/pkg/worker/emulator/image/canvas.go +++ b/pkg/worker/emulator/image/canvas.go @@ -86,6 +86,11 @@ func (c *Canvas) Draw(encoding uint32, rot *Rotate, w, h, packedW, bpp int, data // rescale if dst.Rect.Dx() != c.w || dst.Rect.Dy() != c.h { + ww, hh := c.w, c.h + // w, h supposedly have been swapped before + if c.vertical { + ww, hh = hh, ww + } out := c.Get(c.w, c.h) Resize(ScaleNearestNeighbour, dst.RGBA, out.RGBA) c.Put(dst) diff --git a/pkg/worker/emulator/libretro/frontend.go b/pkg/worker/emulator/libretro/frontend.go index 92c15843..2b016b5f 100644 --- a/pkg/worker/emulator/libretro/frontend.go +++ b/pkg/worker/emulator/libretro/frontend.go @@ -189,10 +189,10 @@ func (f *Frontend) LoadGameState() error { return f.Load() } func (f *Frontend) HasVerticalFrame() bool { return nano.rot != nil && nano.rot.IsEven } func (f *Frontend) SaveGameState() error { return f.Save() } func (f *Frontend) SetMainSaveName(name string) { f.storage.SetMainSaveName(name) } -func (f *Frontend) SetViewport(width int, height int) { +func (f *Frontend) SetViewport(width int, height int, scale int) { f.mu.Lock() f.vw, f.vh = width, height - size := int(nano.sysAvInfo.geometry.max_width * nano.sysAvInfo.geometry.max_height) + size := int(nano.sysAvInfo.geometry.max_width) * scale * int(nano.sysAvInfo.geometry.max_height) * scale f.canvas = image.NewCanvas(width, height, size) f.mu.Unlock() } diff --git a/pkg/worker/emulator/libretro/nanoarch_test.go b/pkg/worker/emulator/libretro/nanoarch_test.go index 39267f4d..7b08f534 100644 --- a/pkg/worker/emulator/libretro/nanoarch_test.go +++ b/pkg/worker/emulator/libretro/nanoarch_test.go @@ -111,7 +111,11 @@ func (emu *EmulatorMock) loadRom(game string) { if err != nil { log.Fatal(err) } - emu.SetViewport(emu.GetFrameSize()) + w, h := emu.GetFrameSize() + if emu.conf.Scale == 0 { + emu.conf.Scale = 1 + } + emu.SetViewport(w, h, emu.conf.Scale) } // shutdownEmulator closes the emulator and cleans its resources. diff --git a/pkg/worker/media.go b/pkg/worker/media.go index 14191a7a..be5ac2ac 100644 --- a/pkg/worker/media.go +++ b/pkg/worker/media.go @@ -118,11 +118,7 @@ func (r *Room) initAudio(srcHz int, conf config.Audio) { r.log.Error().Err(err).Msgf("opus encode fail") return } - r.handleSample(data, frameDur, func(u *Session, s *webrtc.Sample) { - if err := u.SendAudio(s); err != nil { - r.log.Error().Err(err).Send() - } - }) + r.handleSample(data, frameDur, func(u *Session, s *webrtc.Sample) error { return u.SendAudio(s) }) }) }) } @@ -156,18 +152,17 @@ func (r *Room) initVideo(width, height int, conf config.Video) { r.vEncoder = encoder.NewVideoEncoder(enc, width, height, conf.Concurrency, r.log) - r.emulator.SetVideo(func(frame *emulator.GameFrame) { - if fr := r.vEncoder.Encode(frame.Data.RGBA); fr != nil { - r.handleSample(fr, frame.Duration, func(u *Session, s *webrtc.Sample) { - if err := u.SendVideo(s); err != nil { - r.log.Error().Err(err).Send() - } - }) + r.emulator.SetVideo(func(raw *emulator.GameFrame) { + data := r.vEncoder.Encode(raw.Data.RGBA) + if data == nil { + r.log.Warn().Msgf("no data after video encoding") + return } + r.handleSample(data, raw.Duration, func(u *Session, s *webrtc.Sample) error { return u.SendVideo(s) }) }) } -func (r *Room) handleSample(b []byte, d time.Duration, fn func(*Session, *webrtc.Sample)) { +func (r *Room) handleSample(b []byte, d time.Duration, fn func(*Session, *webrtc.Sample) error) { sample, _ := samplePool.Get().(*webrtc.Sample) if sample == nil { sample = new(webrtc.Sample) @@ -176,7 +171,9 @@ func (r *Room) handleSample(b []byte, d time.Duration, fn func(*Session, *webrtc sample.Duration = d r.users.ForEach(func(u *Session) { if u.IsConnected() { - fn(u, sample) + if err := fn(u, sample); err != nil { + r.log.Error().Err(err).Send() + } } }) samplePool.Put(sample) diff --git a/pkg/worker/room.go b/pkg/worker/room.go index ab63843d..596a4cd6 100644 --- a/pkg/worker/room.go +++ b/pkg/worker/room.go @@ -65,7 +65,7 @@ func NewRoom(id string, game games.GameMetadata, onClose func(*Room), conf confi if room.emulator.HasVerticalFrame() { w, h = h, w } - room.emulator.SetViewport(w, h) + room.emulator.SetViewport(w, h, conf.Emulator.Scale) room.initVideo(w, h, conf.Encoder.Video) room.initAudio(int(room.emulator.GetSampleRate()), conf.Encoder.Audio) From e5ac43a59e3702d01879b563a550e062bf34f142 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 1 Jun 2023 16:16:10 +0300 Subject: [PATCH 056/361] Use faster lib scan --- pkg/games/library.go | 44 +++++++++++++-------------------------- pkg/games/library_test.go | 20 +++++++++++++----- 2 files changed, 29 insertions(+), 35 deletions(-) diff --git a/pkg/games/library.go b/pkg/games/library.go index c8a84148..fec3cc47 100644 --- a/pkg/games/library.go +++ b/pkg/games/library.go @@ -1,10 +1,7 @@ package games import ( - "crypto/md5" - "fmt" - "io" - "os" + "io/fs" "path/filepath" "strings" "sync" @@ -18,8 +15,8 @@ import ( // libConf is an optimized internal library configuration type libConf struct { path string - supported map[string]bool - ignored map[string]bool + supported map[string]struct{} + ignored map[string]struct{} verbose bool watchMode bool } @@ -37,9 +34,8 @@ type library struct { games map[string]GameMetadata log *logger.Logger - // to restrict parallel execution - // or throttling - // !CAS would be better + // to restrict parallel execution or throttling + // for file watch mode mu sync.Mutex isScanning bool isScanningDelayed bool @@ -56,7 +52,6 @@ type FileExtensionWhitelist interface { } type GameMetadata struct { - uid string // the display name of the game Name string // the game file extension (e.g. nes, n64) @@ -150,16 +145,14 @@ func (lib *library) Scan() { start := time.Now() var games []GameMetadata dir := lib.config.path - err := filepath.Walk(dir, func(path string, info os.FileInfo, err error) error { + err := filepath.WalkDir(dir, func(path string, info fs.DirEntry, err error) error { if err != nil { return err } - if info != nil && !info.IsDir() && lib.isFileExtensionSupported(path) { + if info != nil && !info.IsDir() && lib.isExtAllowed(path) { meta := getMetadata(path, dir) - meta.uid = hash(path) - - if !lib.config.ignored[meta.Name] { + if _, ok := lib.config.ignored[meta.Name]; !ok { games = append(games, meta) } } @@ -239,12 +232,13 @@ func (lib *library) set(games []GameMetadata) { lib.games = res } -func (lib *library) isFileExtensionSupported(path string) bool { +func (lib *library) isExtAllowed(path string) bool { ext := filepath.Ext(path) if ext == "" { return false } - return lib.config.supported[ext[1:]] + _, ok := lib.config.supported[ext[1:]] + return ok } // getMetadata returns game info from a path @@ -278,20 +272,10 @@ func (lib *library) dumpLibrary() { gameList.String(), len(lib.games), lib.lastScanDuration) } -// hash makes an MD5 hash of the string -func hash(str string) string { - h := md5.New() - _, err := io.WriteString(h, str) - if err != nil { - return "" - } - return fmt.Sprintf("%x", h.Sum(nil)) -} - -func toMap(list []string) map[string]bool { - res := make(map[string]bool) +func toMap(list []string) map[string]struct{} { + res := make(map[string]struct{}, len(list)) for _, s := range list { - res[s] = true + res[s] = struct{}{} } return res } diff --git a/pkg/games/library_test.go b/pkg/games/library_test.go index 759389e8..f42890a8 100644 --- a/pkg/games/library_test.go +++ b/pkg/games/library_test.go @@ -25,16 +25,12 @@ func TestLibraryScan(t *testing.T) { library := NewLib(config.Library{ BasePath: test.directory, Supported: []string{"gba", "zip", "nes"}, - Ignored: []string{"neogeo", "pgm"}, }, l) library.Scan() games := library.GetAll() - list := _map(games, func(meta GameMetadata) string { - return meta.Name - }) + list := _map(games, func(g GameMetadata) string { return g.Name }) - // ^2 complexity (; all := true for _, expect := range test.expected { found := false @@ -52,6 +48,20 @@ func TestLibraryScan(t *testing.T) { } } +func Benchmark(b *testing.B) { + log := logger.Default() + logger.SetGlobalLevel(logger.Disabled) + library := NewLib(config.Library{ + BasePath: "../../assets/games", + Supported: []string{"gba", "zip", "nes"}, + }, log) + + for i := 0; i < b.N; i++ { + library.Scan() + _ = library.GetAll() + } +} + func _map(vs []GameMetadata, f func(info GameMetadata) string) []string { vsm := make([]string, len(vs)) for i, v := range vs { From 1f7b5139c6fe1ea99b01e8d3cda538c97f53f19f Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 2 Jun 2023 15:32:40 +0300 Subject: [PATCH 057/361] Remove session from lib --- pkg/games/launcher.go | 29 +++++++++++++++++++++++++---- pkg/games/session.go | 26 -------------------------- 2 files changed, 25 insertions(+), 30 deletions(-) delete mode 100644 pkg/games/session.go diff --git a/pkg/games/launcher.go b/pkg/games/launcher.go index 4ef5512e..b519b575 100644 --- a/pkg/games/launcher.go +++ b/pkg/games/launcher.go @@ -1,6 +1,11 @@ package games -import "fmt" +import ( + "fmt" + "math/rand" + "strconv" + "strings" +) type Launcher interface { FindAppByName(name string) (AppMeta, error) @@ -29,9 +34,7 @@ func (gl GameLauncher) FindAppByName(name string) (AppMeta, error) { return AppMeta{Name: game.Name, Base: game.Base, Type: game.Type, Path: game.Path}, nil } -func (gl GameLauncher) ExtractAppNameFromUrl(name string) string { - return GetGameNameFromRoomID(name) -} +func (gl GameLauncher) ExtractAppNameFromUrl(name string) string { return ExtractGame(name) } func (gl GameLauncher) GetAppNames() []string { var gameList []string @@ -40,3 +43,21 @@ func (gl GameLauncher) GetAppNames() []string { } return gameList } + +const separator = "___" + +// ExtractGame parses game room link returning the name of the game "encoded" there. +func ExtractGame(roomID string) string { + parts := strings.Split(roomID, separator) + if len(parts) > 1 { + return parts[1] + } + return "" +} + +// GenerateRoomID generate a unique room ID containing 16 digits. +// RoomID contains random number + gameName +// Next time when we only get roomID, we can launch game based on gameName +func GenerateRoomID(title string) string { + return strconv.FormatInt(rand.Int63(), 16) + separator + title +} diff --git a/pkg/games/session.go b/pkg/games/session.go deleted file mode 100644 index 79ea326d..00000000 --- a/pkg/games/session.go +++ /dev/null @@ -1,26 +0,0 @@ -package games - -import ( - "math/rand" - "strconv" - "strings" -) - -const separator = "___" - -// GetGameNameFromRoomID parse roomID to get roomID and gameName. -func GetGameNameFromRoomID(roomID string) string { - parts := strings.Split(roomID, separator) - if len(parts) > 1 { - return parts[1] - } - return "" -} - -// GenerateRoomID generate a unique room ID containing 16 digits. -func GenerateRoomID(gameName string) string { - // RoomID contains random number + gameName - // Next time when we only get roomID, we can launch game based on gameName - roomID := strconv.FormatInt(rand.Int63(), 16) + separator + gameName - return roomID -} From 860c8b9d45ec461fdd886466deb3b23ffb42c92e Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 2 Jun 2023 17:14:08 +0300 Subject: [PATCH 058/361] Add system param into the library --- pkg/api/worker.go | 9 +++---- pkg/coordinator/coordinator.go | 2 +- pkg/coordinator/workerapi.go | 2 +- pkg/games/launcher.go | 11 +++++---- pkg/games/library.go | 23 +++++++++++------- pkg/games/library_test.go | 40 +++++++++++++++++-------------- pkg/worker/coordinatorhandlers.go | 4 +++- pkg/worker/room.go | 2 +- pkg/worker/room_test.go | 8 +++---- 9 files changed, 57 insertions(+), 44 deletions(-) diff --git a/pkg/api/worker.go b/pkg/api/worker.go index c1b4f14d..b82d1914 100644 --- a/pkg/api/worker.go +++ b/pkg/api/worker.go @@ -25,10 +25,11 @@ type ( PlayerIndex int `json:"player_index"` } GameInfo struct { - Name string `json:"name"` - Base string `json:"base"` - Path string `json:"path"` - Type string `json:"type"` + Name string `json:"name"` + Base string `json:"base"` + Path string `json:"path"` + System string `json:"system"` + Type string `json:"type"` } StartGameResponse struct { Room diff --git a/pkg/coordinator/coordinator.go b/pkg/coordinator/coordinator.go index 7a8fb200..c3601666 100644 --- a/pkg/coordinator/coordinator.go +++ b/pkg/coordinator/coordinator.go @@ -14,7 +14,7 @@ import ( ) func New(conf config.CoordinatorConfig, log *logger.Logger) (services service.Group) { - lib := games.NewLibWhitelisted(conf.Coordinator.Library, conf.Emulator, log) + lib := games.NewLib(conf.Coordinator.Library, conf.Emulator, log) lib.Scan() hub := NewHub(conf, lib, log) h, err := NewHTTPServer(conf, log, func(mux *httpx.Mux) *httpx.Mux { diff --git a/pkg/coordinator/workerapi.go b/pkg/coordinator/workerapi.go index 0943d666..65b57589 100644 --- a/pkg/coordinator/workerapi.go +++ b/pkg/coordinator/workerapi.go @@ -23,7 +23,7 @@ func (w *Worker) StartGame(id com.Uid, app games.AppMeta, req api.GameStartUserR return api.UnwrapChecked[api.StartGameResponse]( w.Send(api.StartGame, api.StartGameRequest[com.Uid]{ StatefulRoom: StateRoom(id, req.RoomId), - Game: api.GameInfo{Name: app.Name, Base: app.Base, Path: app.Path, Type: app.Type}, + Game: api.GameInfo{Name: app.Name, Base: app.Base, Path: app.Path, System: app.System, Type: app.Type}, PlayerIndex: req.PlayerIndex, Record: req.Record, RecordUser: req.RecordUser, diff --git a/pkg/games/launcher.go b/pkg/games/launcher.go index b519b575..b9146594 100644 --- a/pkg/games/launcher.go +++ b/pkg/games/launcher.go @@ -14,10 +14,11 @@ type Launcher interface { } type AppMeta struct { - Name string - Type string - Base string - Path string + Name string + Type string + Base string + Path string + System string } type GameLauncher struct { @@ -31,7 +32,7 @@ func (gl GameLauncher) FindAppByName(name string) (AppMeta, error) { if game.Path == "" { return AppMeta{}, fmt.Errorf("couldn't find game info for the game %v", name) } - return AppMeta{Name: game.Name, Base: game.Base, Type: game.Type, Path: game.Path}, nil + return AppMeta{Name: game.Name, Base: game.Base, Type: game.Type, Path: game.Path, System: game.System}, nil } func (gl GameLauncher) ExtractAppNameFromUrl(name string) string { return ExtractGame(name) } diff --git a/pkg/games/library.go b/pkg/games/library.go index fec3cc47..d46b8093 100644 --- a/pkg/games/library.go +++ b/pkg/games/library.go @@ -1,6 +1,7 @@ package games import ( + "fmt" "io/fs" "path/filepath" "strings" @@ -34,6 +35,8 @@ type library struct { games map[string]GameMetadata log *logger.Logger + emuConf WithEmulatorInfo + // to restrict parallel execution or throttling // for file watch mode mu sync.Mutex @@ -47,8 +50,9 @@ type GameLibrary interface { Scan() } -type FileExtensionWhitelist interface { +type WithEmulatorInfo interface { GetSupportedExtensions() []string + GetEmulator(rom string, path string) string } type GameMetadata struct { @@ -58,7 +62,8 @@ type GameMetadata struct { Type string Base string // the game path relative to the library base path - Path string + Path string + System string } func (g GameMetadata) FullPath(base string) string { @@ -68,11 +73,7 @@ func (g GameMetadata) FullPath(base string) string { return filepath.Join(base, g.Path) } -func NewLib(conf config.Library, log *logger.Logger) GameLibrary { - return NewLibWhitelisted(conf, conf, log) -} - -func NewLibWhitelisted(conf config.Library, filter FileExtensionWhitelist, log *logger.Logger) GameLibrary { +func NewLib(conf config.Library, emu WithEmulatorInfo, log *logger.Logger) GameLibrary { hasSource := true dir, err := filepath.Abs(conf.BasePath) if err != nil { @@ -81,7 +82,7 @@ func NewLibWhitelisted(conf config.Library, filter FileExtensionWhitelist, log * } if len(conf.Supported) == 0 { - conf.Supported = filter.GetSupportedExtensions() + conf.Supported = emu.GetSupportedExtensions() } library := &library{ @@ -96,6 +97,7 @@ func NewLibWhitelisted(conf config.Library, filter FileExtensionWhitelist, log * games: map[string]GameMetadata{}, hasSource: hasSource, log: log, + emuConf: emu, } if conf.WatchMode && hasSource { @@ -152,6 +154,9 @@ func (lib *library) Scan() { if info != nil && !info.IsDir() && lib.isExtAllowed(path) { meta := getMetadata(path, dir) + + meta.System = lib.emuConf.GetEmulator(meta.Type, meta.Path) + if _, ok := lib.config.ignored[meta.Name]; !ok { games = append(games, meta) } @@ -258,7 +263,7 @@ func getMetadata(path string, basePath string) GameMetadata { func (lib *library) dumpLibrary() { var gameList strings.Builder for _, game := range lib.games { - gameList.WriteString(" " + game.Name + " (" + game.Path + ")" + "\n") + gameList.WriteString(fmt.Sprintf(" %5s %s (%s)\n", game.System, game.Name, game.Path)) } lib.log.Debug().Msgf("Lib dump\n"+ diff --git a/pkg/games/library_test.go b/pkg/games/library_test.go index f42890a8..74dedb27 100644 --- a/pkg/games/library_test.go +++ b/pkg/games/library_test.go @@ -10,32 +10,44 @@ import ( func TestLibraryScan(t *testing.T) { tests := []struct { directory string - expected []string + expected []struct { + name string + system string + } }{ { directory: "../../assets/games", - expected: []string{ - "Alwa's Awakening (Demo)", "Sushi The Cat", "anguna", + expected: []struct { + name string + system string + }{ + {name: "Alwa's Awakening (Demo)", system: "nes"}, + {name: "Sushi The Cat", system: "gba"}, + {name: "anguna", system: "gba"}, }, }, } + emuConf := config.Emulator{Libretro: config.LibretroConfig{}} + emuConf.Libretro.Cores.List = map[string]config.LibretroCoreConfig{ + "nes": {Roms: []string{"nes"}}, + "gba": {Roms: []string{"gba"}}, + } + l := logger.NewConsole(false, "w", false) for _, test := range tests { library := NewLib(config.Library{ BasePath: test.directory, Supported: []string{"gba", "zip", "nes"}, - }, l) + }, emuConf, l) library.Scan() games := library.GetAll() - list := _map(games, func(g GameMetadata) string { return g.Name }) - all := true for _, expect := range test.expected { found := false - for _, game := range list { - if game == expect { + for _, game := range games { + if game.Name == expect.name && (expect.system != "" && expect.system == game.System) { found = true break } @@ -43,7 +55,7 @@ func TestLibraryScan(t *testing.T) { all = all && found } if !all { - t.Errorf("Test fail for dir %v with %v != %v", test.directory, list, test.expected) + t.Errorf("Test fail for dir %v with %v != %v", test.directory, games, test.expected) } } } @@ -54,18 +66,10 @@ func Benchmark(b *testing.B) { library := NewLib(config.Library{ BasePath: "../../assets/games", Supported: []string{"gba", "zip", "nes"}, - }, log) + }, config.Emulator{}, log) for i := 0; i < b.N; i++ { library.Scan() _ = library.GetAll() } } - -func _map(vs []GameMetadata, f func(info GameMetadata) string) []string { - vsm := make([]string, len(vs)) - for i, v := range vs { - vsm[i] = f(v) - } - return vsm -} diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 5dab2c9c..420aaaef 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -81,7 +81,9 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke if room == nil { room = NewRoom( rq.Room.Rid, - games.GameMetadata{Name: rq.Game.Name, Base: rq.Game.Base, Type: rq.Game.Type, Path: rq.Game.Path}, + games.GameMetadata{ + Name: rq.Game.Name, Base: rq.Game.Base, Type: rq.Game.Type, Path: rq.Game.Path, System: rq.Game.System, + }, func(room *Room) { w.router.SetRoom(nil) c.CloseRoom(room.id) diff --git a/pkg/worker/room.go b/pkg/worker/room.go index 596a4cd6..2fff1cf3 100644 --- a/pkg/worker/room.go +++ b/pkg/worker/room.go @@ -55,7 +55,7 @@ func NewRoom(id string, game games.GameMetadata, onClose func(*Room), conf confi } room.emulator = nano room.emulator.SetMainSaveName(id) - room.emulator.LoadMetadata(conf.Emulator.GetEmulator(game.Type, game.Path)) + room.emulator.LoadMetadata(game.System) err = room.emulator.LoadGame(game.FullPath(conf.Worker.Library.BasePath)) if err != nil { log.Fatal().Err(err).Msgf("couldn't load the game %v", game) diff --git a/pkg/worker/room_test.go b/pkg/worker/room_test.go index 46ab2031..3d3543bf 100644 --- a/pkg/worker/room_test.go +++ b/pkg/worker/room_test.go @@ -43,7 +43,7 @@ type roomMock struct { func (rm roomMock) Close() { rm.Room.Close() // hack: wait room destruction - time.Sleep(3 * time.Second) + time.Sleep(2 * time.Second) } func (rm roomMock) CloseNowait() { rm.Room.Close() } @@ -64,9 +64,9 @@ var testTempDir = filepath.Join(os.TempDir(), "cloud-game-core-tests") // games var ( - alwas = games.GameMetadata{Name: "Alwa's Awakening (Demo)", Type: "nes", Path: "Alwa's Awakening (Demo).nes"} - sushi = games.GameMetadata{Name: "Sushi The Cat", Type: "gba", Path: "Sushi The Cat.gba"} - fd = games.GameMetadata{Name: "Florian Demo", Type: "n64", Path: "Sample Demo by Florian (PD).z64"} + alwas = games.GameMetadata{Name: "Alwa's Awakening (Demo)", Type: "nes", Path: "Alwa's Awakening (Demo).nes", System: "nes"} + sushi = games.GameMetadata{Name: "Sushi The Cat", Type: "gba", Path: "Sushi The Cat.gba", System: "gba"} + fd = games.GameMetadata{Name: "Florian Demo", Type: "n64", Path: "Sample Demo by Florian (PD).z64", System: "n64"} ) func init() { From 2e1c837643a1f91fca1658f13bd1574b0c7c6f4c Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 2 Jun 2023 20:49:50 +0300 Subject: [PATCH 059/361] Show systems in the interface --- pkg/api/user.go | 6 +++++- pkg/coordinator/hub.go | 7 ++++++- pkg/coordinator/userapi.go | 5 ++--- pkg/games/launcher.go | 9 ++++----- web/css/main.css | 10 +++++++++- web/js/gameList.js | 30 +++++++++++++++++++++--------- 6 files changed, 47 insertions(+), 20 deletions(-) diff --git a/pkg/api/user.go b/pkg/api/user.go index df7f9e22..84d8ee62 100644 --- a/pkg/api/user.go +++ b/pkg/api/user.go @@ -18,9 +18,13 @@ type ( } InitSessionUserResponse struct { Ice []IceServer `json:"ice"` - Games []string `json:"games"` + Games []AppMeta `json:"games"` Wid string `json:"wid"` } + AppMeta struct { + Title string `json:"title"` + System string `json:"system"` + } WebrtcAnswerUserRequest string WebrtcUserIceCandidate string ) diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index bc815d9d..87794ade 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -72,7 +72,12 @@ func (h *Hub) handleUserConnection() http.HandlerFunc { } user.Bind(worker) h.users.Add(user) - user.InitSession(worker.Id().String(), h.conf.Webrtc.IceServers, h.launcher.GetAppNames()) + apps := h.launcher.GetAppNames() + list := make([]api.AppMeta, len(apps)) + for i := range apps { + list[i] = api.AppMeta{Title: apps[i].Name, System: apps[i].System} + } + user.InitSession(worker.Id().String(), h.conf.Webrtc.IceServers, list) log.Info().Str(logger.DirectionField, logger.MarkPlus).Msgf("user %s", user.Id()) <-done } diff --git a/pkg/coordinator/userapi.go b/pkg/coordinator/userapi.go index 77590062..4f922d9a 100644 --- a/pkg/coordinator/userapi.go +++ b/pkg/coordinator/userapi.go @@ -22,10 +22,9 @@ func (u *User) CheckLatency(req api.CheckLatencyUserResponse) (api.CheckLatencyU } // InitSession signals the user that the app is ready to go. -func (u *User) InitSession(wid string, ice []config.IceServer, games []string) { +func (u *User) InitSession(wid string, ice []config.IceServer, games []api.AppMeta) { u.Notify(api.InitSession, api.InitSessionUserResponse{ - // don't do this at home - Ice: *(*[]api.IceServer)(unsafe.Pointer(&ice)), + Ice: *(*[]api.IceServer)(unsafe.Pointer(&ice)), // don't do this at home Games: games, Wid: wid, }) diff --git a/pkg/games/launcher.go b/pkg/games/launcher.go index b9146594..c0b1e478 100644 --- a/pkg/games/launcher.go +++ b/pkg/games/launcher.go @@ -10,7 +10,7 @@ import ( type Launcher interface { FindAppByName(name string) (AppMeta, error) ExtractAppNameFromUrl(name string) string - GetAppNames() []string + GetAppNames() []AppMeta } type AppMeta struct { @@ -37,12 +37,11 @@ func (gl GameLauncher) FindAppByName(name string) (AppMeta, error) { func (gl GameLauncher) ExtractAppNameFromUrl(name string) string { return ExtractGame(name) } -func (gl GameLauncher) GetAppNames() []string { - var gameList []string +func (gl GameLauncher) GetAppNames() (apps []AppMeta) { for _, game := range gl.lib.GetAll() { - gameList = append(gameList, game.Name) + apps = append(apps, AppMeta{Name: game.Name, System: game.System}) } - return gameList + return } const separator = "___" diff --git a/web/css/main.css b/web/css/main.css index 6fb53307..61f13505 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -508,7 +508,7 @@ body { font-size: 19px; } -.menu-item div { +.menu-item div:first-child { overflow: hidden; display: block; position: absolute; @@ -534,6 +534,14 @@ body { overflow: unset; } +.menu-item__info { + display: none; + color: white; + font-size: 50%; + position: absolute; + right: 15px; +} + .text-move { animation: horizontally 4s linear infinite alternate; } diff --git a/web/js/gameList.js b/web/js/gameList.js index cd68c3f5..db0425bb 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -23,19 +23,22 @@ const gameList = (() => { let gamesElList; const setGames = (gameList) => { - games = gameList !== null ? gameList.sort((a, b) => a > b ? 1 : -1) : []; + games = gameList !== null ? gameList.sort((a, b) => a.title > b.title ? 1 : -1) : []; }; const render = () => { log.debug('[games] load game menu'); listBox.innerHTML = games - .map(game => `

`) + .map(game => `
${game.title}
${game.system}
`) .join(''); }; + const getTitleEl = (parent) => parent.firstChild.firstChild + const getDescEl = (parent) => parent.children[1] + const show = () => { render(); - gamesElList = listBox.querySelectorAll(`.menu-item span`); + gamesElList = listBox.querySelectorAll(`.menu-item`); menuItemChoice.style.display = "block"; pickGame(); }; @@ -44,7 +47,8 @@ const gameList = (() => { const clearPrev = () => { let prev = gamesElList[gameIndex] if (prev) { - prev.classList.remove('pick', 'text-move'); + getTitleEl(prev).classList.remove('pick', 'text-move'); + getDescEl(prev).style.display = 'none' } } @@ -54,8 +58,12 @@ const gameList = (() => { const i = gamesElList[gameIndex]; if (i) { - setTimeout(() => i.classList.add('pick'), 50) - !menuInSelection && i.classList.add('text-move') + const title = getTitleEl(i) + setTimeout(() => { + title.classList.add('pick') + !menuInSelection && (getDescEl(i).style.display = 'block') + }, 50) + !menuInSelection && title.classList.add('text-move') } // transition menu box @@ -78,7 +86,11 @@ const gameList = (() => { const stopGamePickerTimer = () => { menuInSelection = false - gamesElList[gameIndex] && gamesElList[gameIndex].classList.add('text-move') + const item = gamesElList[gameIndex] + if (item) { + getTitleEl(item).classList.add('text-move') + getDescEl(item).style.display = 'block' + } if (gamePickTimer === null) return; clearInterval(gamePickTimer); @@ -86,7 +98,7 @@ const gameList = (() => { }; const onMenuPressed = (newPosition) => { - clearPrev() + clearPrev(true) listBox.style.transition = ''; listBox.style.top = `${menuTop - newPosition}px`; }; @@ -106,6 +118,6 @@ const gameList = (() => { pickGame: pickGame, show: show, set: setGames, - getCurrentGame: () => games[gameIndex] + getCurrentGame: () => games[gameIndex].title } })(document, event, log); From 6106eee97e5ebd056c0760d33df269bb7355ccb9 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 12 Jun 2023 16:56:05 +0300 Subject: [PATCH 060/361] Update game list module --- web/css/main.css | 1 - web/index.html | 5 +- web/js/controller.js | 38 +----- web/js/gameList.js | 309 +++++++++++++++++++++++++++++-------------- 4 files changed, 214 insertions(+), 139 deletions(-) diff --git a/web/css/main.css b/web/css/main.css index 61f13505..aefa7d8e 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -535,7 +535,6 @@ body { } .menu-item__info { - display: none; color: white; font-size: 50%; position: absolute; diff --git a/web/index.html b/web/index.html index 1a895c16..4f44140f 100644 --- a/web/index.html +++ b/web/index.html @@ -40,9 +40,8 @@ diff --git a/web/js/controller.js b/web/js/controller.js index eb7cd05a..489590ca 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -12,16 +12,6 @@ // ping-pong // let pingPong = 0; - - const DIR = (() => { - return { - IDLE: 'idle', - UP: 'up', - DOWN: 'down', - } - })(); - let prevDir = DIR.IDLE; - const menuScreen = document.getElementById('menu-screen'); const helpOverlay = document.getElementById('help-overlay'); const playerIndex = document.getElementById('playeridx'); @@ -161,7 +151,7 @@ // so there's no point in doing this and this' really confusing api.game.start( - gameList.getCurrentGame(), + gameList.selected, room.getId(), recording.isActive(), recording.getUser(), @@ -340,32 +330,12 @@ menu: { ..._default, name: 'menu', - axisChanged: (id, value) => { - if (id === 1) { // Left Stick, Y Axis - let dir = DIR.IDLE; - if (value < -0.5) dir = DIR.UP; - if (value > 0.5) dir = DIR.DOWN; - if (dir !== prevDir) { - prevDir = dir; - switch (dir) { - case DIR.IDLE: - gameList.stopGamePickerTimer(); - break; - case DIR.UP: - gameList.startGamePickerTimer(true); - break; - case DIR.DOWN: - gameList.startGamePickerTimer(false); - break; - } - } - } - }, + axisChanged: (id, val) => id === 1 && gameList.scroll(val < -.5 ? -1 : val > .5 ? 1 : 0), keyPress: (key) => { switch (key) { case KEY.UP: case KEY.DOWN: - gameList.startGamePickerTimer(key === KEY.UP); + gameList.scroll(key === KEY.UP ? -1 : 1) break; } }, @@ -373,7 +343,7 @@ switch (key) { case KEY.UP: case KEY.DOWN: - gameList.stopGamePickerTimer(); + gameList.scroll(0); break; case KEY.JOIN: case KEY.A: diff --git a/web/js/gameList.js b/web/js/gameList.js index db0425bb..86623bf6 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -3,121 +3,228 @@ * @version 1 */ const gameList = (() => { - // state - let games = []; - let gameIndex = 1; - let gamePickTimer = null; + const TOP_POSITION = 102 + const SELECT_THRESHOLD_MS = 160 - // UI - const listBox = document.getElementById('menu-container'); - const menuItemChoice = document.getElementById('menu-item-choice'); + const games = (() => { + let list = [], index = 0 + return { + get index() { + return index + }, + get list() { + return list + }, + get selected() { + return list[index].title // selected by the game title, oof + }, + set index(i) { + //-2 | + //-1 | | + // 0 < | < + // 1 | | + // 2 < < | + //+1 | | + //+2 | + index = i < -1 ? i = 0 : + i > list.length ? i = list.length - 1 : + (i % list.length + list.length) % list.length + }, + set: (data = []) => list = data.sort((a, b) => a.title > b.title ? 1 : -1), + empty: () => list.length === 0 + } + })() - const MENU_TOP_POSITION = 102; - const MENU_SELECT_THRESHOLD_MS = 180; - let menuTop = MENU_TOP_POSITION; - let menuInSelection = false; - const MENU_TRANSITION_DEFAULT = `top ${MENU_SELECT_THRESHOLD_MS}ms`; + const scroll = ((DEFAULT_INTERVAL) => { + const state = { + IDLE: 0, UP: -1, DOWN: 1, DRAG: 3 + } + let last = state.IDLE + let _si + let onShift, onStop - listBox.style.transition = MENU_TRANSITION_DEFAULT; + const shift = (delta) => { + if (scroll.scrolling) return + onShift(delta) + // velocity? + // keep rolling the game list if the button is pressed + _si = setInterval(() => onShift(delta), DEFAULT_INTERVAL) + } - let gamesElList; + const stop = () => { + onStop() + _si && (clearInterval(_si) && (_si = null)) + } - const setGames = (gameList) => { - games = gameList !== null ? gameList.sort((a, b) => a.title > b.title ? 1 : -1) : []; - }; + const handle = {[state.IDLE]: stop, [state.UP]: shift, [state.DOWN]: shift, [state.DRAG]: null} - const render = () => { - log.debug('[games] load game menu'); - listBox.innerHTML = games - .map(game => `
${game.title}
${game.system}
`) - .join(''); - }; + return { + scroll: (move = state.IDLE) => { + handle[move] && handle[move](move) + last = move + }, + get scrolling() { + return last !== state.IDLE + }, + set onShift(fn) { + onShift = fn + }, + set onStop(fn) { + onStop = fn + }, + state, + last: () => last + } + })(SELECT_THRESHOLD_MS) - const getTitleEl = (parent) => parent.firstChild.firstChild - const getDescEl = (parent) => parent.children[1] + const ui = (() => { + const rootEl = document.getElementById('menu-container') + const choiceMarkerEl = document.getElementById('menu-item-choice') + + const TRANSITION_DEFAULT = `top ${SELECT_THRESHOLD_MS}ms` + let listTopPos = TOP_POSITION + + rootEl.style.transition = TRANSITION_DEFAULT + + let onTransitionEnd = () => ({}) + + rootEl.addEventListener('transitionend', () => onTransitionEnd()) + + let items = [] + + const item = (parent) => { + const title = parent.firstChild.firstChild + const desc = parent.children[1] + + const _desc = { + hide: () => gui.hide(desc), + show: async () => { + gui.show(desc) + await gui.anim.fadeIn(desc, .054321) + }, + } + + const _title = { + animate: () => title.classList.add('text-move'), + pick: () => title.classList.add('pick'), + reset: () => title.classList.remove('pick', 'text-move'), + } + + const clear = () => { + _title.reset() + _desc.hide() + } + + return { + get description() { + return _desc + }, + get title() { + return _title + }, + clear, + } + } + + const render = () => { + rootEl.innerHTML = games.list.map(game => + `
` + + `
${game.title}
` + + `` + + `
`) + .join('') + items = [...rootEl.querySelectorAll('.menu-item')].map(x => item(x)) + } + + return { + get selected() { + return items[games.index] + }, + get roundIndex() { + const closest = Math.round((listTopPos - TOP_POSITION) / -36) + return closest < 0 ? 0 : + closest > games.list.length - 1 ? games.list.length - 1 : + closest // don't wrap the list on drag + }, + set onTransitionEnd(x) { + onTransitionEnd = x + }, + set pos(idx) { + listTopPos = TOP_POSITION - idx * 36 + rootEl.style.top = `${listTopPos}px` + }, + drag: { + startPos: (pos) => { + rootEl.style.top = `${listTopPos - pos}px` + rootEl.style.transition = '' + }, + stopPos: (pos) => { + listTopPos -= pos + rootEl.style.transition = TRANSITION_DEFAULT + }, + }, + render, + marker: { + show: () => gui.show(choiceMarkerEl) + } + } + })(TOP_POSITION, SELECT_THRESHOLD_MS, games) const show = () => { - render(); - gamesElList = listBox.querySelectorAll(`.menu-item`); - menuItemChoice.style.display = "block"; - pickGame(); - }; + ui.render() + ui.marker.show() // we show square pseudo-selection marker only after rendering + scroll.scroll(scroll.state.DOWN) // interactively moves games select down + scroll.scroll(scroll.state.IDLE) + } - const bounds = (i = gameIndex) => (i % games.length + games.length) % games.length - const clearPrev = () => { - let prev = gamesElList[gameIndex] - if (prev) { - getTitleEl(prev).classList.remove('pick', 'text-move'); - getDescEl(prev).style.display = 'none' + const select = (index) => { + ui.selected && ui.selected.clear() + games.index = index + ui.pos = games.index + } + + scroll.onShift = (delta) => select(games.index + delta) + + let hasTransition = true // needed for cases when MENU_RELEASE called instead MENU_PRESSED + + scroll.onStop = () => { + const item = ui.selected + if (item) { + item.title.pick() + item.title.animate() + hasTransition ? (ui.onTransitionEnd = item.description.show) : item.description.show() } } - const pickGame = (index) => { - clearPrev() - gameIndex = bounds(index) + event.sub(MENU_PRESSED, (position) => { + if (games.empty()) return + hasTransition = false + scroll.scroll(scroll.state.DRAG) + ui.selected && ui.selected.clear() + ui.drag.startPos(position) + }) - const i = gamesElList[gameIndex]; - if (i) { - const title = getTitleEl(i) - setTimeout(() => { - title.classList.add('pick') - !menuInSelection && (getDescEl(i).style.display = 'block') - }, 50) - !menuInSelection && title.classList.add('text-move') - } - - // transition menu box - menuTop = MENU_TOP_POSITION - gameIndex * 36; - listBox.style.top = `${menuTop}px`; - }; - - const startGamePickerTimer = (upDirection) => { - menuInSelection = true - if (gamePickTimer !== null) return; - const shift = upDirection ? -1 : 1; - pickGame(gameIndex + shift); - - // velocity? - // keep rolling the game list if the button is pressed - gamePickTimer = setInterval(() => { - pickGame(gameIndex + shift, true); - }, MENU_SELECT_THRESHOLD_MS); - }; - - const stopGamePickerTimer = () => { - menuInSelection = false - const item = gamesElList[gameIndex] - if (item) { - getTitleEl(item).classList.add('text-move') - getDescEl(item).style.display = 'block' - } - - if (gamePickTimer === null) return; - clearInterval(gamePickTimer); - gamePickTimer = null; - }; - - const onMenuPressed = (newPosition) => { - clearPrev(true) - listBox.style.transition = ''; - listBox.style.top = `${menuTop - newPosition}px`; - }; - - const onMenuReleased = (position) => { - listBox.style.transition = MENU_TRANSITION_DEFAULT - menuTop -= position; - pickGame(Math.round((menuTop - MENU_TOP_POSITION) / -36)); - }; - - event.sub(MENU_PRESSED, onMenuPressed); - event.sub(MENU_RELEASED, onMenuReleased); + event.sub(MENU_RELEASED, (position) => { + if (games.empty()) return + ui.drag.stopPos(position) + select(ui.roundIndex) + hasTransition = !hasTransition + scroll.scroll(scroll.state.IDLE) + hasTransition = true + }) return { - startGamePickerTimer: startGamePickerTimer, - stopGamePickerTimer: stopGamePickerTimer, - pickGame: pickGame, - show: show, - set: setGames, - getCurrentGame: () => games[gameIndex].title + scroll: (x) => { + if (games.empty()) return + scroll.scroll(x) + }, + get selected() { + return games.selected + }, + set: games.set, + show: () => { + if (games.empty()) return + show() + }, } -})(document, event, log); +})(document, event, gui) From 42b82a368ce6366f682345c9df02c7aa82cb4c51 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 16 Jun 2023 13:21:25 +0300 Subject: [PATCH 061/361] Update deps --- go.mod | 16 ++++++++-------- go.sum | 31 +++++++++++++++++-------------- 2 files changed, 25 insertions(+), 22 deletions(-) diff --git a/go.mod b/go.mod index 611385d4..ae3fbf61 100644 --- a/go.mod +++ b/go.mod @@ -13,12 +13,12 @@ require ( github.com/knadh/koanf/v2 v2.0.1 github.com/pion/interceptor v0.1.17 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v3 v3.2.8 + github.com/pion/webrtc/v3 v3.2.10 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.29.1 github.com/veandco/go-sdl2 v0.4.35 - golang.org/x/crypto v0.9.0 - golang.org/x/image v0.7.0 + golang.org/x/crypto v0.10.0 + golang.org/x/image v0.8.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -32,7 +32,7 @@ require ( github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect github.com/pion/dtls/v2 v2.2.7 // indirect - github.com/pion/ice/v2 v2.3.6 // indirect + github.com/pion/ice/v2 v2.3.8 // indirect github.com/pion/mdns v0.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.10 // indirect @@ -44,10 +44,10 @@ require ( github.com/pion/transport/v2 v2.2.1 // indirect github.com/pion/turn/v2 v2.1.0 // indirect github.com/pmezard/go-difflib v1.0.0 // indirect - github.com/stretchr/testify v1.8.3 // indirect + github.com/stretchr/testify v1.8.4 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.10.0 // indirect - golang.org/x/sys v0.8.0 // indirect - golang.org/x/text v0.9.0 // indirect + golang.org/x/net v0.11.0 // indirect + golang.org/x/sys v0.9.0 // indirect + golang.org/x/text v0.10.0 // indirect ) diff --git a/go.sum b/go.sum index e6ba3a6a..4036a3b4 100644 --- a/go.sum +++ b/go.sum @@ -69,8 +69,9 @@ github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= -github.com/pion/ice/v2 v2.3.6 h1:Jgqw36cAud47iD+N6rNX225uHvrgWtAlHfVyOQc3Heg= -github.com/pion/ice/v2 v2.3.6/go.mod h1:9/TzKDRwBVAPsC+YOrKH/e3xDrubeTRACU9/sHQarsU= +github.com/pion/ice/v2 v2.3.7/go.mod h1:DoMA9FvsfNTBVnjyRf2t4EhUkSp9tNrH77fMtPFYygQ= +github.com/pion/ice/v2 v2.3.8 h1:/4vM7uFPJez3PhNhlqUcJhboYaDNWo+R8oAuMj2cKsA= +github.com/pion/ice/v2 v2.3.8/go.mod h1:DoMA9FvsfNTBVnjyRf2t4EhUkSp9tNrH77fMtPFYygQ= github.com/pion/interceptor v0.1.17 h1:prJtgwFh/gB8zMqGZoOgJPHivOwVAp61i2aG61Du/1w= github.com/pion/interceptor v0.1.17/go.mod h1:SY8kpmfVBvrbUzvj2bsXz7OJt5JvmVNZ+4Kjq7FcwrI= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= @@ -96,16 +97,14 @@ github.com/pion/stun v0.6.0/go.mod h1:HPqcfoeqQn9cuaet7AOmB5e5xkObu9DwBdurwLKO9o github.com/pion/transport v0.14.1 h1:XSM6olwW+o8J4SCmOBb/BpwZypkHeyM0PGFCxNQBr40= github.com/pion/transport v0.14.1/go.mod h1:4tGmbk00NeYA3rUa9+n+dzCCoKkcy3YlYb99Jn2fNnI= github.com/pion/transport/v2 v2.0.0/go.mod h1:HS2MEBJTwD+1ZI2eSXSvHJx/HnzQqRy2/LXxt6eVMHc= -github.com/pion/transport/v2 v2.0.2/go.mod h1:vrz6bUbFr/cjdwbnxq8OdDDzHf7JJfGsIRkxfpZoTA0= github.com/pion/transport/v2 v2.1.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= github.com/pion/transport/v2 v2.2.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= github.com/pion/transport/v2 v2.2.1 h1:7qYnCBlpgSJNYMbLCKuSY9KbQdBFoETvPNETv0y4N7c= github.com/pion/transport/v2 v2.2.1/go.mod h1:cXXWavvCnFF6McHTft3DWS9iic2Mftcz1Aq29pGcU5g= github.com/pion/turn/v2 v2.1.0 h1:5wGHSgGhJhP/RpabkUb/T9PdsAjkGLS6toYz5HNzoSI= github.com/pion/turn/v2 v2.1.0/go.mod h1:yrT5XbXSGX1VFSF31A3c1kCNB5bBZgk/uu5LET162qs= -github.com/pion/udp/v2 v2.0.1/go.mod h1:B7uvTMP00lzWdyMr/1PVZXtV3wpPIxBRd4Wl6AksXn8= -github.com/pion/webrtc/v3 v3.2.8 h1:RmDEz7wjK3k0sAuCSMptfxp095pBYSkSSm5ySiJYIHI= -github.com/pion/webrtc/v3 v3.2.8/go.mod h1:6/7wF1P86AQAw4iTmKIgdzaevaQ8qh9SfrFyypqmN6w= +github.com/pion/webrtc/v3 v3.2.10 h1:CPsuYs14f1aBhywmES0idje5t5XhftXeKMHwfzrxcIc= +github.com/pion/webrtc/v3 v3.2.10/go.mod h1:mr/kJrVSGAOs1ZDAQDFpny4xogAuYKemWujj88XzeQE= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -123,8 +122,9 @@ github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/ github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= -github.com/stretchr/testify v1.8.3 h1:RP3t2pwF7cMEbC1dqtB6poj3niw/9gnV4Cjg5oW5gtY= github.com/stretchr/testify v1.8.3/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk= +github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= @@ -138,10 +138,11 @@ golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8U golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= -golang.org/x/crypto v0.9.0 h1:LF6fAI+IutBocDJ2OT0Q1g8plpYljMZ4+lty+dsqw3g= golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0= -golang.org/x/image v0.7.0 h1:gzS29xtG1J5ybQlv0PuyfE3nmc6R4qB73m6LUUmvFuw= -golang.org/x/image v0.7.0/go.mod h1:nd/q4ef1AKKYl/4kft7g+6UyGbdiqWqTP1ZAbRoV7Rg= +golang.org/x/crypto v0.10.0 h1:LKqV2xt9+kDzSTfOhx4FrkEBcMrAgHSYgzywV9zcGmM= +golang.org/x/crypto v0.10.0/go.mod h1:o4eNf7Ede1fv+hwOwZsTHl9EsPFO6q6ZvYR8vYfY45I= +golang.org/x/image v0.8.0 h1:agUcRXV/+w6L9ryntYYsF2x9fQTMd4T8fiiYXAVW6Jg= +golang.org/x/image v0.8.0/go.mod h1:PwLxp3opCYg4WR2WO9P0L6ESnsD6bLTWcw8zanLMVFM= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= @@ -156,11 +157,11 @@ golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug golang.org/x/net v0.1.0/go.mod h1:Cx3nUiGt4eDBEyega/BKRp+/AlGL8hYe7U9odMt2Cco= golang.org/x/net v0.5.0/go.mod h1:DivGGAXEgPSlEBzxGzZI+ZLohi+xUj054jfeKui00ws= golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= -golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc= golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= -golang.org/x/net v0.10.0 h1:X2//UzNDwYmtCLn7To6G58Wr6f5ahEAQgKNzv9Y951M= golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= +golang.org/x/net v0.11.0 h1:Gi2tvZIJyBtO9SDr1q9h5hEQCp/4L2RQ+ar0qjx2oNU= +golang.org/x/net v0.11.0/go.mod h1:2L/ixqYpgIVXmeoSA/4Lu7BzTG4KIyPIryS4IsOd1oQ= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -190,8 +191,9 @@ golang.org/x/sys v0.4.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.7.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.8.0 h1:EBmGv8NaZBZTWvrbjNoL6HVt+IVy3QDQpJs7VRIw3tU= golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.9.0 h1:KS/R3tvhPqvJvwcKfnBHJwwthS11LRhmM5D59eEXa0s= +golang.org/x/sys v0.9.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= @@ -208,8 +210,9 @@ golang.org/x/text v0.4.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.6.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.8.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= -golang.org/x/text v0.9.0 h1:2sjJmO8cDvYveuX97RDLsxlyUxLl+GHoLxBiRdHllBE= golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= +golang.org/x/text v0.10.0 h1:UpjohKhiEgNc0CSauXmwYftY1+LlaC75SJwh0SgCX58= +golang.org/x/text v0.10.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20201224043029-2b0845dc783e/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= From c063dd92c6ebb8c33f1cf906815b1343f70f6042 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 16 Jun 2023 14:05:37 +0300 Subject: [PATCH 062/361] Remove unused CSS rules --- web/css/main.css | 34 ---------------------------------- 1 file changed, 34 deletions(-) diff --git a/web/css/main.css b/web/css/main.css index aefa7d8e..7daa3640 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -261,9 +261,6 @@ body { background-image: url('/img/ui/bt REC.png'); } -.record { -} - .record-user { position: absolute; padding-left: 6px; @@ -294,7 +291,6 @@ body { top: 7px; } - .record.blink:before { animation: blinker 1s linear infinite; } @@ -384,36 +380,6 @@ body { left: 460px; } -@-webkit-keyframes blink { - 0% { - background: #7a7e7d; - } - - 100% { - background: yellow; - } -} - -@-moz-keyframes blink { - 0% { - background: #7a7e7d; - } - - 100% { - background: yellow; - } -} - -@keyframes blink { - 0% { - background: #7a7e7d; - } - - 100% { - background: yellow; - } -} - #room-txt { position: absolute; width: 59px; From d5bb2714692ef9f0bac8c3ed9d9f254f1ad8ab19 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 23 Jun 2023 18:39:36 +0300 Subject: [PATCH 063/361] Add core hacks options --- pkg/config/config.yaml | 4 ++++ pkg/config/emulator.go | 1 + pkg/worker/emulator/emulator.go | 10 ++++++++++ pkg/worker/emulator/libretro/frontend.go | 1 + pkg/worker/emulator/libretro/nanoarch.go | 10 +++++++++- 5 files changed, 25 insertions(+), 1 deletion(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index de9e4bcb..bce3726d 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -182,6 +182,10 @@ emulator: # noticeable video stutter (with the current frame rendering time calculations). # - options ([]string) a list of Libretro core options for tweaking. # All keys of the options should be in the double quotes in order to preserve upper-case symbols. + # - hacks ([]string) a list of hacks. + # Available: + # - skip_hw_context_destroy -- don't destroy OpenGL context during Libretro core deinit. + # May help with crashes, for example, with PPSSPP. list: gba: lib: mgba_libretro diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index 3880b12b..c53fdd45 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -61,6 +61,7 @@ type LibretroCoreConfig struct { AltRepo bool AutoGlContext bool // hack: keep it here to pass it down the emulator Folder string + Hacks []string HasMultitap bool Height int IsGlAllowed bool diff --git a/pkg/worker/emulator/emulator.go b/pkg/worker/emulator/emulator.go index 08232202..aaa6fa64 100644 --- a/pkg/worker/emulator/emulator.go +++ b/pkg/worker/emulator/emulator.go @@ -52,6 +52,16 @@ type Metadata struct { HasMultitap bool HasVFR bool Options map[string]string + Hacks []string +} + +func (m Metadata) HasHack(h string) bool { + for _, n := range m.Hacks { + if h == n { + return true + } + } + return false } type ( diff --git a/pkg/worker/emulator/libretro/frontend.go b/pkg/worker/emulator/libretro/frontend.go index 2b016b5f..3de96b2f 100644 --- a/pkg/worker/emulator/libretro/frontend.go +++ b/pkg/worker/emulator/libretro/frontend.go @@ -108,6 +108,7 @@ func (f *Frontend) LoadMetadata(emu string) { conf := f.conf.GetLibretroCoreConfig(emu) meta := emulator.Metadata{ AutoGlContext: conf.AutoGlContext, + Hacks: conf.Hacks, HasMultitap: conf.HasMultitap, HasVFR: conf.VFR, IsGlAllowed: conf.IsGlAllowed, diff --git a/pkg/worker/emulator/libretro/nanoarch.go b/pkg/worker/emulator/libretro/nanoarch.go index 80d1433b..0f8fac7f 100644 --- a/pkg/worker/emulator/libretro/nanoarch.go +++ b/pkg/worker/emulator/libretro/nanoarch.go @@ -78,6 +78,8 @@ var ( cSystemDirectory *C.char cUserName *C.char + hackSkipHwContextDestroy bool + initOnce sync.Once ) @@ -420,12 +422,15 @@ func initVideo() { //export deinitVideo func deinitVideo() { - C.bridge_context_reset(nano.v.hw.context_destroy) + if !hackSkipHwContextDestroy { + C.bridge_context_reset(nano.v.hw.context_destroy) + } if err := sdlCtx.Deinit(); err != nil { libretroLogger.Error().Err(err).Msg("deinit fail") } nano.v.isGl = false nano.v.autoGlContext = false + hackSkipHwContextDestroy = false } var ( @@ -461,6 +466,9 @@ func coreLoad(meta emulator.Metadata) { nano.v.autoGlContext = meta.AutoGlContext hasVFR = meta.HasVFR + // hacks + hackSkipHwContextDestroy = meta.HasHack("skip_hw_context_destroy") + nano.options = &meta.Options nano.multitap.supported = meta.HasMultitap From 65b6e3208fccb26e24a561c321f0c180e30d869e Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 27 Jun 2023 23:45:57 +0300 Subject: [PATCH 064/361] Fix lint warnings --- pkg/com/map_test.go | 2 +- pkg/config/emulator_test.go | 4 +-- pkg/games/launcher.go | 2 +- pkg/worker/emulator/image/canvas.go | 7 +++--- pkg/worker/encoder/vpx/libvpx.go | 6 ++--- pkg/worker/encoder/yuv/yuv_test.go | 10 ++------ pkg/worker/recorder/draw.go | 39 ----------------------------- pkg/worker/recorder/pngstream.go | 2 -- pkg/worker/recorder/wavstream.go | 21 ++++++++++------ 9 files changed, 27 insertions(+), 66 deletions(-) delete mode 100644 pkg/worker/recorder/draw.go diff --git a/pkg/com/map_test.go b/pkg/com/map_test.go index 3a4d89bf..fb2b19f7 100644 --- a/pkg/com/map_test.go +++ b/pkg/com/map_test.go @@ -21,7 +21,7 @@ func TestMap_Base(t *testing.T) { if v != 0 && !ok { t.Errorf("should have the key %v and ok, %v %v", k, ok, m.m) } - v, ok = m.Find(k + 1) + _, ok = m.Find(k + 1) if ok { t.Errorf("should not find anything, %v %v", ok, m.m) } diff --git a/pkg/config/emulator_test.go b/pkg/config/emulator_test.go index a466783a..09afd2d4 100644 --- a/pkg/config/emulator_test.go +++ b/pkg/config/emulator_test.go @@ -29,9 +29,9 @@ func TestGetEmulator(t *testing.T) { }, { rom: "nes", - path: "test/game.nes", + path: "test2/game.nes", config: map[string]LibretroCoreConfig{ - "snes": {Roms: []string{"nes"}}, + "snes": {Roms: []string{"snes"}}, "nes": {Roms: []string{"nes"}}, }, emulator: "nes", diff --git a/pkg/games/launcher.go b/pkg/games/launcher.go index c0b1e478..af5be8df 100644 --- a/pkg/games/launcher.go +++ b/pkg/games/launcher.go @@ -32,7 +32,7 @@ func (gl GameLauncher) FindAppByName(name string) (AppMeta, error) { if game.Path == "" { return AppMeta{}, fmt.Errorf("couldn't find game info for the game %v", name) } - return AppMeta{Name: game.Name, Base: game.Base, Type: game.Type, Path: game.Path, System: game.System}, nil + return AppMeta(game), nil } func (gl GameLauncher) ExtractAppNameFromUrl(name string) string { return ExtractGame(name) } diff --git a/pkg/worker/emulator/image/canvas.go b/pkg/worker/emulator/image/canvas.go index 3c1636c6..6e8eda17 100644 --- a/pkg/worker/emulator/image/canvas.go +++ b/pkg/worker/emulator/image/canvas.go @@ -86,12 +86,13 @@ func (c *Canvas) Draw(encoding uint32, rot *Rotate, w, h, packedW, bpp int, data // rescale if dst.Rect.Dx() != c.w || dst.Rect.Dy() != c.h { - ww, hh := c.w, c.h + ww := c.w + hh := c.h // w, h supposedly have been swapped before if c.vertical { - ww, hh = hh, ww + ww, hh = c.h, c.w } - out := c.Get(c.w, c.h) + out := c.Get(ww, hh) Resize(ScaleNearestNeighbour, dst.RGBA, out.RGBA) c.Put(dst) return out diff --git a/pkg/worker/encoder/vpx/libvpx.go b/pkg/worker/encoder/vpx/libvpx.go index 23ca371a..e0370926 100644 --- a/pkg/worker/encoder/vpx/libvpx.go +++ b/pkg/worker/encoder/vpx/libvpx.go @@ -162,9 +162,9 @@ func (vpx *Vpx) IntraRefresh() { } func (vpx *Vpx) Shutdown() error { - if &vpx.image != nil { - C.vpx_img_free(&vpx.image) - } + //if &vpx.image != nil { + C.vpx_img_free(&vpx.image) + //} C.vpx_codec_destroy(&vpx.codecCtx) return nil } diff --git a/pkg/worker/encoder/yuv/yuv_test.go b/pkg/worker/encoder/yuv/yuv_test.go index 1bbe47b7..fbf53efe 100644 --- a/pkg/worker/encoder/yuv/yuv_test.go +++ b/pkg/worker/encoder/yuv/yuv_test.go @@ -246,18 +246,12 @@ func TestGen24bitFull(t *testing.T) { } } - f, err := os.Create("outimage.png") - if err != nil { - // Handle error - } + f, _ := os.Create("out_image.png") defer func() { _ = f.Close() }() // Encode to `PNG` with `DefaultCompression` level // then save to file - err = png.Encode(f, img) - if err != nil { - // Handle error - } + _ = png.Encode(f, img) } func linear(a, b, x float64) float64 { return (x - a) / (b - a) } diff --git a/pkg/worker/recorder/draw.go b/pkg/worker/recorder/draw.go deleted file mode 100644 index e3f6d4f8..00000000 --- a/pkg/worker/recorder/draw.go +++ /dev/null @@ -1,39 +0,0 @@ -package recorder - -import ( - "fmt" - "image" - "image/color" - "image/draw" - "time" - - "golang.org/x/image/font" - "golang.org/x/image/font/basicfont" - "golang.org/x/image/math/fixed" -) - -func AddLabel(img *image.RGBA, x, y int, label string) { - draw.Draw(img, image.Rect(x, y, x+len(label)*7+3, y+12), &image.Uniform{C: color.RGBA{}}, image.Point{}, draw.Src) - (&font.Drawer{ - Dst: img, - Src: image.NewUniform(color.RGBA{R: 255, G: 255, B: 255, A: 255}), - Face: basicfont.Face7x13, - Dot: fixed.Point26_6{X: fixed.Int26_6((x + 2) * 64), Y: fixed.Int26_6((y + 10) * 64)}, - }).DrawString(label) -} - -func clone(src image.Image) *image.RGBA { - b := src.Bounds() - dst := image.NewRGBA(b) - draw.Draw(dst, b, src, b.Min, draw.Src) - return dst -} - -func TimeFormat(d time.Duration) string { - mms := int(d.Milliseconds()) - ms := mms % 1000 - s := (mms / 1000) % 60 - m := (mms / (1000 * 60)) % 60 - h := (mms / (1000 * 60 * 60)) % 24 - return fmt.Sprintf("%02d:%02d:%02d.%03d", h, m, s, ms) -} diff --git a/pkg/worker/recorder/pngstream.go b/pkg/worker/recorder/pngstream.go index 39fee7bb..1cb0cf88 100644 --- a/pkg/worker/recorder/pngstream.go +++ b/pkg/worker/recorder/pngstream.go @@ -13,8 +13,6 @@ import ( ) type pngStream struct { - videoStream - dir string e *png.Encoder id uint32 diff --git a/pkg/worker/recorder/wavstream.go b/pkg/worker/recorder/wavstream.go index c445a6d5..f63ea70e 100644 --- a/pkg/worker/recorder/wavstream.go +++ b/pkg/worker/recorder/wavstream.go @@ -1,10 +1,11 @@ package recorder -import "encoding/binary" +import ( + "encoding/binary" + "errors" +) type wavStream struct { - audioStream - frequency int wav *file } @@ -33,14 +34,20 @@ func (w *wavStream) Close() (err error) { err = w.wav.Flush() size, er := w.wav.Size() if er != nil { - err = er + err = errors.Join(err, er) } if size > 0 { // write an actual RIFF header - err = w.wav.WriteAtStart(rIFFWavHeader(uint32(size), w.frequency)) - err = w.wav.Flush() + if er = w.wav.WriteAtStart(rIFFWavHeader(uint32(size), w.frequency)); er != nil { + err = errors.Join(err, er) + } + if er = w.wav.Flush(); er != nil { + err = errors.Join(err, er) + } + } + if er = w.wav.Close(); er != nil { + err = errors.Join(err, er) } - err = w.wav.Close() return } From cc414881eadbc95483b3ec67f2eb573d9e18143d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 6 Jul 2023 00:01:27 +0300 Subject: [PATCH 065/361] Update dependencies --- go.mod | 16 ++++++++-------- go.sum | 31 ++++++++++++++++--------------- 2 files changed, 24 insertions(+), 23 deletions(-) diff --git a/go.mod b/go.mod index ae3fbf61..d7fbb0a0 100644 --- a/go.mod +++ b/go.mod @@ -13,12 +13,12 @@ require ( github.com/knadh/koanf/v2 v2.0.1 github.com/pion/interceptor v0.1.17 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v3 v3.2.10 + github.com/pion/webrtc/v3 v3.2.11 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.29.1 github.com/veandco/go-sdl2 v0.4.35 - golang.org/x/crypto v0.10.0 - golang.org/x/image v0.8.0 + golang.org/x/crypto v0.11.0 + golang.org/x/image v0.9.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -40,14 +40,14 @@ require ( github.com/pion/sctp v1.8.7 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect github.com/pion/srtp/v2 v2.0.15 // indirect - github.com/pion/stun v0.6.0 // indirect + github.com/pion/stun v0.6.1 // indirect github.com/pion/transport/v2 v2.2.1 // indirect - github.com/pion/turn/v2 v2.1.0 // indirect + github.com/pion/turn/v2 v2.1.2 // indirect github.com/pmezard/go-difflib v1.0.0 // indirect github.com/stretchr/testify v1.8.4 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.11.0 // indirect - golang.org/x/sys v0.9.0 // indirect - golang.org/x/text v0.10.0 // indirect + golang.org/x/net v0.12.0 // indirect + golang.org/x/sys v0.10.0 // indirect + golang.org/x/text v0.11.0 // indirect ) diff --git a/go.sum b/go.sum index 4036a3b4..450737d6 100644 --- a/go.sum +++ b/go.sum @@ -69,7 +69,6 @@ github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= -github.com/pion/ice/v2 v2.3.7/go.mod h1:DoMA9FvsfNTBVnjyRf2t4EhUkSp9tNrH77fMtPFYygQ= github.com/pion/ice/v2 v2.3.8 h1:/4vM7uFPJez3PhNhlqUcJhboYaDNWo+R8oAuMj2cKsA= github.com/pion/ice/v2 v2.3.8/go.mod h1:DoMA9FvsfNTBVnjyRf2t4EhUkSp9tNrH77fMtPFYygQ= github.com/pion/interceptor v0.1.17 h1:prJtgwFh/gB8zMqGZoOgJPHivOwVAp61i2aG61Du/1w= @@ -92,8 +91,9 @@ github.com/pion/sdp/v3 v3.0.6/go.mod h1:iiFWFpQO8Fy3S5ldclBkpXqmWy02ns78NOKoLLL0 github.com/pion/srtp/v2 v2.0.15 h1:+tqRtXGsGwHC0G0IUIAzRmdkHvriF79IHVfZGfHrQoA= github.com/pion/srtp/v2 v2.0.15/go.mod h1:b/pQOlDrbB0HEH5EUAQXzSYxikFbNcNuKmF8tM0hCtw= github.com/pion/stun v0.4.0/go.mod h1:QPsh1/SbXASntw3zkkrIk3ZJVKz4saBY2G7S10P3wCw= -github.com/pion/stun v0.6.0 h1:JHT/2iyGDPrFWE8NNC15wnddBN8KifsEDw8swQmrEmU= github.com/pion/stun v0.6.0/go.mod h1:HPqcfoeqQn9cuaet7AOmB5e5xkObu9DwBdurwLKO9oA= +github.com/pion/stun v0.6.1 h1:8lp6YejULeHBF8NmV8e2787BogQhduZugh5PdhDyyN4= +github.com/pion/stun v0.6.1/go.mod h1:/hO7APkX4hZKu/D0f2lHzNyvdkTGtIy3NDmLR7kSz/8= github.com/pion/transport v0.14.1 h1:XSM6olwW+o8J4SCmOBb/BpwZypkHeyM0PGFCxNQBr40= github.com/pion/transport v0.14.1/go.mod h1:4tGmbk00NeYA3rUa9+n+dzCCoKkcy3YlYb99Jn2fNnI= github.com/pion/transport/v2 v2.0.0/go.mod h1:HS2MEBJTwD+1ZI2eSXSvHJx/HnzQqRy2/LXxt6eVMHc= @@ -101,10 +101,11 @@ github.com/pion/transport/v2 v2.1.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlD github.com/pion/transport/v2 v2.2.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= github.com/pion/transport/v2 v2.2.1 h1:7qYnCBlpgSJNYMbLCKuSY9KbQdBFoETvPNETv0y4N7c= github.com/pion/transport/v2 v2.2.1/go.mod h1:cXXWavvCnFF6McHTft3DWS9iic2Mftcz1Aq29pGcU5g= -github.com/pion/turn/v2 v2.1.0 h1:5wGHSgGhJhP/RpabkUb/T9PdsAjkGLS6toYz5HNzoSI= github.com/pion/turn/v2 v2.1.0/go.mod h1:yrT5XbXSGX1VFSF31A3c1kCNB5bBZgk/uu5LET162qs= -github.com/pion/webrtc/v3 v3.2.10 h1:CPsuYs14f1aBhywmES0idje5t5XhftXeKMHwfzrxcIc= -github.com/pion/webrtc/v3 v3.2.10/go.mod h1:mr/kJrVSGAOs1ZDAQDFpny4xogAuYKemWujj88XzeQE= +github.com/pion/turn/v2 v2.1.2 h1:wj0cAoGKltaZ790XEGW9HwoUewqjliwmhtxCuB2ApyM= +github.com/pion/turn/v2 v2.1.2/go.mod h1:1kjnPkBcex3dhCU2Am+AAmxDcGhLX3WnMfmkNpvSTQU= +github.com/pion/webrtc/v3 v3.2.11 h1:lfGKYZcG7ghCTQWn+zsD+icIIWL3qIfclEjBGk537+s= +github.com/pion/webrtc/v3 v3.2.11/go.mod h1:fejQio1v8tKG4ntq4u8H4uDHsCNX6eX7bT093t4H+0E= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -139,10 +140,10 @@ golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPh golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0= -golang.org/x/crypto v0.10.0 h1:LKqV2xt9+kDzSTfOhx4FrkEBcMrAgHSYgzywV9zcGmM= -golang.org/x/crypto v0.10.0/go.mod h1:o4eNf7Ede1fv+hwOwZsTHl9EsPFO6q6ZvYR8vYfY45I= -golang.org/x/image v0.8.0 h1:agUcRXV/+w6L9ryntYYsF2x9fQTMd4T8fiiYXAVW6Jg= -golang.org/x/image v0.8.0/go.mod h1:PwLxp3opCYg4WR2WO9P0L6ESnsD6bLTWcw8zanLMVFM= +golang.org/x/crypto v0.11.0 h1:6Ewdq3tDic1mg5xRO4milcWCfMVQhI4NkqWWvqejpuA= +golang.org/x/crypto v0.11.0/go.mod h1:xgJhtzW8F9jGdVFWZESrid1U1bjeNy4zgy5cRr/CIio= +golang.org/x/image v0.9.0 h1:QrzfX26snvCM20hIhBwuHI/ThTg18b/+kcKdXHvnR+g= +golang.org/x/image v0.9.0/go.mod h1:jtrku+n79PfroUbvDdeUWMAI+heR786BofxrbiSF+J0= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= @@ -160,8 +161,8 @@ golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc= golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= -golang.org/x/net v0.11.0 h1:Gi2tvZIJyBtO9SDr1q9h5hEQCp/4L2RQ+ar0qjx2oNU= -golang.org/x/net v0.11.0/go.mod h1:2L/ixqYpgIVXmeoSA/4Lu7BzTG4KIyPIryS4IsOd1oQ= +golang.org/x/net v0.12.0 h1:cfawfvKITfUsFCeJIHJrbSxpeu/E81khclypR0GVT50= +golang.org/x/net v0.12.0/go.mod h1:zEVYFnQC7m/vmpQFELhcD1EWkZlX69l4oqgmer6hfKA= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -192,8 +193,8 @@ golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.7.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.9.0 h1:KS/R3tvhPqvJvwcKfnBHJwwthS11LRhmM5D59eEXa0s= -golang.org/x/sys v0.9.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.10.0 h1:SqMFp9UcQJZa+pmYuAKjd9xq1f0j5rLcDIk0mj4qAsA= +golang.org/x/sys v0.10.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= @@ -211,8 +212,8 @@ golang.org/x/text v0.6.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.8.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= -golang.org/x/text v0.10.0 h1:UpjohKhiEgNc0CSauXmwYftY1+LlaC75SJwh0SgCX58= -golang.org/x/text v0.10.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= +golang.org/x/text v0.11.0 h1:LAntKIrcmeSKERyiOh0XMV39LXS8IE9UL2yP7+f5ij4= +golang.org/x/text v0.11.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20201224043029-2b0845dc783e/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= From 8fef57aa8dee1853a92e4182aa25c1fc8535398a Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 6 Jul 2023 00:04:05 +0300 Subject: [PATCH 066/361] Use TLS with the monitoring / profiling routes --- pkg/coordinator/coordinator.go | 2 +- pkg/monitoring/monitoring.go | 3 ++- pkg/worker/worker.go | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/pkg/coordinator/coordinator.go b/pkg/coordinator/coordinator.go index c3601666..66c37e8e 100644 --- a/pkg/coordinator/coordinator.go +++ b/pkg/coordinator/coordinator.go @@ -28,7 +28,7 @@ func New(conf config.CoordinatorConfig, log *logger.Logger) (services service.Gr } services.Add(hub, h) if conf.Coordinator.Monitoring.IsEnabled() { - services.Add(monitoring.New(conf.Coordinator.Monitoring, h.GetHost(), log)) + services.Add(monitoring.New(conf.Coordinator.Monitoring, conf.Coordinator.Server, h.GetHost(), log)) } return } diff --git a/pkg/monitoring/monitoring.go b/pkg/monitoring/monitoring.go index a071672b..a040ea20 100644 --- a/pkg/monitoring/monitoring.go +++ b/pkg/monitoring/monitoring.go @@ -23,7 +23,7 @@ type Monitoring struct { // New creates new monitoring service. // The tag param specifies owner label for logs. -func New(conf config.Monitoring, baseAddr string, log *logger.Logger) *Monitoring { +func New(conf config.Monitoring, servConf config.Server, baseAddr string, log *logger.Logger) *Monitoring { serv, err := httpx.NewServer( net.JoinHostPort(baseAddr, strconv.Itoa(conf.Port)), func(s *httpx.Server) httpx.Handler { @@ -52,6 +52,7 @@ func New(conf config.Monitoring, baseAddr string, log *logger.Logger) *Monitorin return h }, httpx.WithPortRoll(true), + httpx.WithServerConfig(servConf), httpx.WithLogger(log), ) if err != nil { diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 0af214cb..20e6dab1 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -48,7 +48,7 @@ func New(conf config.WorkerConfig, log *logger.Logger, done chan struct{}) (serv } services.Add(h) if conf.Worker.Monitoring.IsEnabled() { - services.Add(monitoring.New(conf.Worker.Monitoring, h.GetHost(), log)) + services.Add(monitoring.New(conf.Worker.Monitoring, conf.Worker.Server, h.GetHost(), log)) } st, err := GetCloudStorage(conf.Storage.Provider, conf.Storage.Key) if err != nil { From be83b1c287e6fb77031e6f6f5055e61a6262b350 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 6 Jul 2023 15:31:55 +0300 Subject: [PATCH 067/361] Skip HTTPS redirect for monitoring --- pkg/monitoring/monitoring.go | 1 + 1 file changed, 1 insertion(+) diff --git a/pkg/monitoring/monitoring.go b/pkg/monitoring/monitoring.go index a040ea20..f70a50bb 100644 --- a/pkg/monitoring/monitoring.go +++ b/pkg/monitoring/monitoring.go @@ -53,6 +53,7 @@ func New(conf config.Monitoring, servConf config.Server, baseAddr string, log *l }, httpx.WithPortRoll(true), httpx.WithServerConfig(servConf), + httpx.HttpsRedirect(false), httpx.WithLogger(log), ) if err != nil { From d7e8ca5ace02dffc66f9b9662ab2ae6a028a72a3 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 7 Jul 2023 15:28:50 +0300 Subject: [PATCH 068/361] Remove SSL from the monitoring routes --- pkg/coordinator/coordinator.go | 2 +- pkg/coordinator/hub.go | 2 +- pkg/monitoring/monitoring.go | 3 +-- pkg/network/httpx/server.go | 8 ++++---- pkg/worker/worker.go | 2 +- 5 files changed, 8 insertions(+), 9 deletions(-) diff --git a/pkg/coordinator/coordinator.go b/pkg/coordinator/coordinator.go index 66c37e8e..c3601666 100644 --- a/pkg/coordinator/coordinator.go +++ b/pkg/coordinator/coordinator.go @@ -28,7 +28,7 @@ func New(conf config.CoordinatorConfig, log *logger.Logger) (services service.Gr } services.Add(hub, h) if conf.Coordinator.Monitoring.IsEnabled() { - services.Add(monitoring.New(conf.Coordinator.Monitoring, conf.Coordinator.Server, h.GetHost(), log)) + services.Add(monitoring.New(conf.Coordinator.Monitoring, h.GetHost(), log)) } return } diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index 87794ade..6b418143 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -89,7 +89,7 @@ func RequestToHandshake(data string) (*api.ConnectionRequest[com.Uid], error) { } handshake, err := api.UnwrapChecked[api.ConnectionRequest[com.Uid]](base64.URLEncoding.DecodeString(data)) if err != nil || handshake == nil { - return nil, fmt.Errorf("%v (%v)", err, handshake) + return nil, fmt.Errorf("%w (%v)", err, handshake) } return handshake, nil } diff --git a/pkg/monitoring/monitoring.go b/pkg/monitoring/monitoring.go index f70a50bb..6ed7d3da 100644 --- a/pkg/monitoring/monitoring.go +++ b/pkg/monitoring/monitoring.go @@ -23,7 +23,7 @@ type Monitoring struct { // New creates new monitoring service. // The tag param specifies owner label for logs. -func New(conf config.Monitoring, servConf config.Server, baseAddr string, log *logger.Logger) *Monitoring { +func New(conf config.Monitoring, baseAddr string, log *logger.Logger) *Monitoring { serv, err := httpx.NewServer( net.JoinHostPort(baseAddr, strconv.Itoa(conf.Port)), func(s *httpx.Server) httpx.Handler { @@ -52,7 +52,6 @@ func New(conf config.Monitoring, servConf config.Server, baseAddr string, log *l return h }, httpx.WithPortRoll(true), - httpx.WithServerConfig(servConf), httpx.HttpsRedirect(false), httpx.WithLogger(log), ) diff --git a/pkg/network/httpx/server.go b/pkg/network/httpx/server.go index 076f0683..eb6e8c1e 100644 --- a/pkg/network/httpx/server.go +++ b/pkg/network/httpx/server.go @@ -1,6 +1,7 @@ package httpx import ( + "errors" "fmt" "net/http" "net/url" @@ -133,13 +134,12 @@ func (s *Server) run() { } else { err = s.Serve(*s.listener) } - switch err { - case http.ErrServerClosed: + + if errors.Is(err, http.ErrServerClosed) { s.log.Debug().Msgf("%s server was closed", protocol) return - default: - s.log.Error().Err(err) } + s.log.Error().Err(err) } func (s *Server) Stop() error { diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 20e6dab1..0af214cb 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -48,7 +48,7 @@ func New(conf config.WorkerConfig, log *logger.Logger, done chan struct{}) (serv } services.Add(h) if conf.Worker.Monitoring.IsEnabled() { - services.Add(monitoring.New(conf.Worker.Monitoring, conf.Worker.Server, h.GetHost(), log)) + services.Add(monitoring.New(conf.Worker.Monitoring, h.GetHost(), log)) } st, err := GetCloudStorage(conf.Storage.Provider, conf.Storage.Key) if err != nil { From a0e549a6b972e7726ecc948d06e3412058a6c134 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 7 Jul 2023 16:19:30 +0300 Subject: [PATCH 069/361] Add worker PGO 070723 --- cmd/worker/default.pgo | Bin 0 -> 49125 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 cmd/worker/default.pgo diff --git a/cmd/worker/default.pgo b/cmd/worker/default.pgo new file mode 100644 index 0000000000000000000000000000000000000000..35a67035847acc971e1a31dbe34b4c0848e08869 GIT binary patch literal 49125 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 Date: Fri, 7 Jul 2023 21:27:33 +0300 Subject: [PATCH 070/361] Enable PGO --- Makefile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Makefile b/Makefile index 4e2311bf..79a34d18 100644 --- a/Makefile +++ b/Makefile @@ -26,7 +26,7 @@ build.coordinator: build.worker: mkdir -p bin/ CGO_CFLAGS=${CGO_CFLAGS} CGO_LDFLAGS=${CGO_LDFLAGS} \ - go build -buildmode=exe $(if $(GO_TAGS),-tags $(GO_TAGS),) \ + go build -pgo=auto -buildmode=exe $(if $(GO_TAGS),-tags $(GO_TAGS),) \ -ldflags "-w -s -X 'main.Version=$(GIT_VERSION)'" $(EXT_WFLAGS) \ -o bin/ ./cmd/worker @@ -40,7 +40,7 @@ dev.build: compile build dev.build-local: mkdir -p bin/ go build -o bin/ ./cmd/coordinator - CGO_CFLAGS=${CGO_CFLAGS} CGO_LDFLAGS=${CGO_LDFLAGS} go build -o bin/ ./cmd/worker + CGO_CFLAGS=${CGO_CFLAGS} CGO_LDFLAGS=${CGO_LDFLAGS} go build -pgo=auto -o bin/ ./cmd/worker dev.run: dev.build-local ./bin/coordinator & ./bin/worker From 4a627a30f2c47b805da865c7b12c34c6cefa6def Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 8 Jul 2023 23:07:38 +0300 Subject: [PATCH 071/361] Use alt pcsx-rearmed build for prod --- .github/workflows/cd/cloudretro.io/config.yaml | 2 ++ pkg/config/config.yaml | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/.github/workflows/cd/cloudretro.io/config.yaml b/.github/workflows/cd/cloudretro.io/config.yaml index 535d1168..5ca390ad 100644 --- a/.github/workflows/cd/cloudretro.io/config.yaml +++ b/.github/workflows/cd/cloudretro.io/config.yaml @@ -32,3 +32,5 @@ emulator: mame: options: fbneo-cpu-speed-adjust: 200% + pcsx: + altRepo: true diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index bce3726d..481269ad 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -150,7 +150,7 @@ emulator: # a secondary repo to use i.e. for not found in the main cores secondary: type: github - url: https://github.com/sergystepanov/libretro-spiegel/blob/main + url: https://github.com/sergystepanov/libretro-spiegel/raw/main compression: zip # Libretro core configuration # From d278ab6e3d6c847539aadf085ec37cbc3088276f Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 25 Jul 2023 23:44:08 +0300 Subject: [PATCH 072/361] Remove cache when loading YAML configs for mem --- pkg/config/loader.go | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/pkg/config/loader.go b/pkg/config/loader.go index 11a95583..37c1449f 100644 --- a/pkg/config/loader.go +++ b/pkg/config/loader.go @@ -1,6 +1,7 @@ package config import ( + "bytes" "os" "path/filepath" "strings" @@ -35,7 +36,8 @@ func (p *YAML) Marshal(Kv) ([]byte, error) { return nil, nil } func (p *YAML) Unmarshal(b []byte) (Kv, error) { var out Kv klw := keysToLower(b) - if err := yaml.Unmarshal(klw, &out); err != nil { + decoder := yaml.NewDecoder(bytes.NewReader(klw)) + if err := decoder.Decode(&out); err != nil { return nil, err } return out, nil @@ -105,8 +107,6 @@ func (e *Env) Read() (Kv, error) { return maps.Unflatten(mp, "."), nil } -var k = koanf.New("_") - // LoadConfig loads a configuration file into the given struct. // The path param specifies a custom path to the configuration file. // Reads and puts environment variables with the prefix CLOUD_GAME_. @@ -122,6 +122,8 @@ func LoadConfig(config any, path string) (loaded []string, err error) { dirs = append(dirs, homeDir) } + k := koanf.New("_") // move to global scope if configs become dynamic + defer k.Delete("") if err := k.Load(&conf, &YAML{}); err != nil { return nil, err } From f9a5ce0e6803b811078080d1dfa4ba06998ab875 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 26 Jul 2023 19:38:03 +0300 Subject: [PATCH 073/361] Make embedded conf reentrant --- pkg/config/loader.go | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/pkg/config/loader.go b/pkg/config/loader.go index 37c1449f..99ae6e7c 100644 --- a/pkg/config/loader.go +++ b/pkg/config/loader.go @@ -2,11 +2,11 @@ package config import ( "bytes" + "embed" "os" "path/filepath" "strings" - _ "embed" "github.com/knadh/koanf/maps" "github.com/knadh/koanf/v2" "gopkg.in/yaml.v3" @@ -16,7 +16,7 @@ const EnvPrefix = "CLOUD_GAME_" var ( //go:embed config.yaml - conf Bytes + conf embed.FS ) type Kv = map[string]any @@ -124,10 +124,14 @@ func LoadConfig(config any, path string) (loaded []string, err error) { k := koanf.New("_") // move to global scope if configs become dynamic defer k.Delete("") + data, err := conf.ReadFile("config.yaml") + if err != nil { + return nil, err + } + conf := Bytes(data) if err := k.Load(&conf, &YAML{}); err != nil { return nil, err } - conf = nil loaded = append(loaded, "default") for _, dir := range dirs { From b7fb079243054aea054fd90900cf93db48f09076 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 1 Aug 2023 22:08:28 +0300 Subject: [PATCH 074/361] Derace the frontend when parallel testing --- pkg/worker/emulator/libretro/frontend.go | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/pkg/worker/emulator/libretro/frontend.go b/pkg/worker/emulator/libretro/frontend.go index 3de96b2f..7a89c057 100644 --- a/pkg/worker/emulator/libretro/frontend.go +++ b/pkg/worker/emulator/libretro/frontend.go @@ -90,6 +90,10 @@ func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { store = &ZipStorage{Storage: store} } + last := frontend + if last != nil { + last.mu.Lock() + } // set global link to the Libretro frontend = &Frontend{ conf: conf, @@ -101,6 +105,9 @@ func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { onAudio: noAudio, onVideo: noVideo, } + if last != nil { + last.mu.Unlock() + } return frontend, nil } From 7c0a2051d409de8b5c7f8090c8035453844a5779 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 1 Aug 2023 22:20:30 +0300 Subject: [PATCH 075/361] Disable mDNS for ICE --- pkg/network/webrtc/factory.go | 3 +++ 1 file changed, 3 insertions(+) diff --git a/pkg/network/webrtc/factory.go b/pkg/network/webrtc/factory.go index 82088166..fdcc9631 100644 --- a/pkg/network/webrtc/factory.go +++ b/pkg/network/webrtc/factory.go @@ -2,6 +2,7 @@ package webrtc import ( "fmt" + "github.com/pion/ice/v2" "net" "github.com/giongto35/cloud-game/v3/pkg/config" @@ -72,6 +73,8 @@ func NewApiFactory(conf config.Webrtc, log *logger.Logger, mod ModApiFun) (api * log.Info().Msgf("The NAT mapping is active for %v", conf.IceIpMap) } + s.SetICEMulticastDNSMode(ice.MulticastDNSModeDisabled) + if mod != nil { mod(m, i, &s) } From 7fe3a893f655269d00453ef588bfc0b9fbe40455 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 10 Jul 2023 11:56:33 +0300 Subject: [PATCH 076/361] Remove service package --- cmd/coordinator/main.go | 8 +++- cmd/worker/main.go | 18 +++++---- pkg/coordinator/coordinator.go | 50 ++++++++++++++++++++----- pkg/service/service.go | 46 ----------------------- pkg/worker/worker.go | 68 ++++++++++++++++++++++------------ 5 files changed, 101 insertions(+), 89 deletions(-) delete mode 100644 pkg/service/service.go diff --git a/cmd/coordinator/main.go b/cmd/coordinator/main.go index ce094f6a..95609982 100644 --- a/cmd/coordinator/main.go +++ b/cmd/coordinator/main.go @@ -19,10 +19,14 @@ func main() { if log.GetLevel() < logger.InfoLevel { log.Debug().Msgf("conf: %+v", conf) } - c := coordinator.New(conf, log) + c, err := coordinator.New(conf, log) + if err != nil { + log.Error().Err(err).Msgf("init fail") + return + } c.Start() <-os.ExpectTermination() if err := c.Stop(); err != nil { - log.Error().Err(err).Msg("service shutdown errors") + log.Error().Err(err).Msg("shutdown fail") } } diff --git a/cmd/worker/main.go b/cmd/worker/main.go index f6157d09..a20cd819 100644 --- a/cmd/worker/main.go +++ b/cmd/worker/main.go @@ -24,15 +24,17 @@ func run() { } done := os.ExpectTermination() - wrk := worker.New(conf, log, done) - wrk.Start() + w, err := worker.New(conf, log) + if err != nil { + log.Error().Err(err).Msgf("init fail") + return + } + w.Start(done) <-done - time.Sleep(100 * time.Millisecond) - if err := wrk.Stop(); err != nil { - log.Error().Err(err).Msg("service shutdown errors") + time.Sleep(100 * time.Millisecond) // hack + if err := w.Stop(); err != nil { + log.Error().Err(err).Msg("shutdown fail") } } -func main() { - thread.Wrap(run) -} +func main() { thread.Wrap(run) } diff --git a/pkg/coordinator/coordinator.go b/pkg/coordinator/coordinator.go index c3601666..b2614ac4 100644 --- a/pkg/coordinator/coordinator.go +++ b/pkg/coordinator/coordinator.go @@ -1,6 +1,8 @@ package coordinator import ( + "errors" + "fmt" "html/template" "net/http" "strings" @@ -10,27 +12,55 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/monitoring" "github.com/giongto35/cloud-game/v3/pkg/network/httpx" - "github.com/giongto35/cloud-game/v3/pkg/service" ) -func New(conf config.CoordinatorConfig, log *logger.Logger) (services service.Group) { +type Coordinator struct { + hub *Hub + services [2]runnable +} + +type runnable interface { + Run() + Stop() error +} + +func New(conf config.CoordinatorConfig, log *logger.Logger) (*Coordinator, error) { + coordinator := &Coordinator{} lib := games.NewLib(conf.Coordinator.Library, conf.Emulator, log) lib.Scan() - hub := NewHub(conf, lib, log) + coordinator.hub = NewHub(conf, lib, log) h, err := NewHTTPServer(conf, log, func(mux *httpx.Mux) *httpx.Mux { - mux.HandleFunc("/ws", hub.handleUserConnection()) - mux.HandleFunc("/wso", hub.handleWorkerConnection()) + mux.HandleFunc("/ws", coordinator.hub.handleUserConnection()) + mux.HandleFunc("/wso", coordinator.hub.handleWorkerConnection()) return mux }) if err != nil { - log.Error().Err(err).Msg("http server init fail") - return + return nil, fmt.Errorf("http init fail: %w", err) } - services.Add(hub, h) + coordinator.services[0] = h if conf.Coordinator.Monitoring.IsEnabled() { - services.Add(monitoring.New(conf.Coordinator.Monitoring, h.GetHost(), log)) + coordinator.services[1] = monitoring.New(conf.Coordinator.Monitoring, h.GetHost(), log) } - return + return coordinator, nil +} + +func (c *Coordinator) Start() { + for _, s := range c.services { + if s != nil { + s.Run() + } + } +} + +func (c *Coordinator) Stop() error { + var err error + for _, s := range c.services { + if s != nil { + err0 := s.Stop() + err = errors.Join(err, err0) + } + } + return err } func NewHTTPServer(conf config.CoordinatorConfig, log *logger.Logger, fnMux func(*httpx.Mux) *httpx.Mux) (*httpx.Server, error) { diff --git a/pkg/service/service.go b/pkg/service/service.go deleted file mode 100644 index 48c3f063..00000000 --- a/pkg/service/service.go +++ /dev/null @@ -1,46 +0,0 @@ -package service - -import "fmt" - -// Service defines a generic service. -type Service any - -// RunnableService defines a service that can be run. -type RunnableService interface { - Service - - Run() - Stop() error -} - -// Group is a container for managing a bunch of services. -type Group struct { - list []Service -} - -func (g *Group) Add(services ...Service) { g.list = append(g.list, services...) } - -// Start starts each service in the group. -func (g *Group) Start() { - for _, s := range g.list { - if v, ok := s.(RunnableService); ok { - v.Run() - } - } -} - -// Stop terminates a group of services. -func (g *Group) Stop() (err error) { - var errs []error - for _, s := range g.list { - if v, ok := s.(RunnableService); ok { - if err := v.Stop(); err != nil { - errs = append(errs, fmt.Errorf("error: failed to stop [%s] because of %v", s, err)) - } - } - } - if len(errs) > 0 { - err = fmt.Errorf("%s", errs) - } - return -} diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 0af214cb..99dea997 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -1,32 +1,41 @@ package worker import ( + "errors" + "fmt" "time" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/monitoring" "github.com/giongto35/cloud-game/v3/pkg/network/httpx" - "github.com/giongto35/cloud-game/v3/pkg/service" "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/manager/remotehttp" ) type Worker struct { - address string - conf config.WorkerConfig - cord *coordinator - log *logger.Logger - router Router - storage CloudStorage - done chan struct{} + address string + conf config.WorkerConfig + cord *coordinator + log *logger.Logger + router Router + services [2]runnable + storage CloudStorage +} + +type runnable interface { + Run() + Stop() error } const retry = 10 * time.Second -func New(conf config.WorkerConfig, log *logger.Logger, done chan struct{}) (services service.Group) { +func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { if err := remotehttp.CheckCores(conf.Emulator, log); err != nil { - log.Error().Err(err).Msg("cores sync error") + log.Warn().Err(err).Msgf("a Libretro cores sync fail") } + + worker := &Worker{conf: conf, log: log, router: NewRouter()} + h, err := httpx.NewServer( conf.Worker.GetAddr(), func(s *httpx.Server) httpx.Handler { @@ -36,30 +45,34 @@ func New(conf config.WorkerConfig, log *logger.Logger, done chan struct{}) (serv }) }, httpx.WithServerConfig(conf.Worker.Server), - // no need just for one route httpx.HttpsRedirect(false), httpx.WithPortRoll(true), httpx.WithZone(conf.Worker.Network.Zone), httpx.WithLogger(log), ) if err != nil { - log.Error().Err(err).Msg("http init fail") - return + return nil, fmt.Errorf("http init fail: %w", err) } - services.Add(h) + worker.address = h.Addr + worker.services[0] = h if conf.Worker.Monitoring.IsEnabled() { - services.Add(monitoring.New(conf.Worker.Monitoring, h.GetHost(), log)) + worker.services[1] = monitoring.New(conf.Worker.Monitoring, h.GetHost(), log) } st, err := GetCloudStorage(conf.Storage.Provider, conf.Storage.Key) if err != nil { - log.Error().Err(err).Msgf("cloud storage fail, using dummy cloud storage instead") + log.Warn().Err(err).Msgf("cloud storage fail, using dummy cloud storage instead") } - services.Add(&Worker{address: h.Addr, conf: conf, done: done, log: log, storage: st, router: NewRouter()}) + worker.storage = st - return + return worker, nil } -func (w *Worker) Run() { +func (w *Worker) Start(done chan struct{}) { + for _, s := range w.services { + if s != nil { + s.Run() + } + } go func() { remoteAddr := w.conf.Worker.Network.CoordinatorAddress defer func() { @@ -67,17 +80,16 @@ func (w *Worker) Run() { w.cord.Disconnect() } w.router.Close() - w.log.Debug().Msgf("Service loop end") }() for { select { - case <-w.done: + case <-done: return default: cord, err := newCoordinatorConnection(remoteAddr, w.conf.Worker, w.address, w.log) if err != nil { - w.log.Error().Err(err).Msgf("no connection: %v. Retrying in %v", remoteAddr, retry) + w.log.Warn().Err(err).Msgf("no connection: %v. Retrying in %v", remoteAddr, retry) time.Sleep(retry) continue } @@ -89,4 +101,14 @@ func (w *Worker) Run() { } }() } -func (w *Worker) Stop() error { return nil } + +func (w *Worker) Stop() error { + var err error + for _, s := range w.services { + if s != nil { + err0 := s.Stop() + err = errors.Join(err, err0) + } + } + return err +} From 49cb752b5ca4b762e6ea9ed2d16529bdbf0866d6 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 10 Jul 2023 13:27:25 +0300 Subject: [PATCH 077/361] Use implicit cast of app/game structs That will make the code a bit tidier. --- pkg/api/worker.go | 2 +- pkg/coordinator/workerapi.go | 2 +- pkg/games/launcher.go | 4 ++-- pkg/games/library.go | 11 ++++------- pkg/worker/coordinatorhandlers.go | 4 +--- 5 files changed, 9 insertions(+), 14 deletions(-) diff --git a/pkg/api/worker.go b/pkg/api/worker.go index b82d1914..b206c5c1 100644 --- a/pkg/api/worker.go +++ b/pkg/api/worker.go @@ -25,8 +25,8 @@ type ( PlayerIndex int `json:"player_index"` } GameInfo struct { - Name string `json:"name"` Base string `json:"base"` + Name string `json:"name"` Path string `json:"path"` System string `json:"system"` Type string `json:"type"` diff --git a/pkg/coordinator/workerapi.go b/pkg/coordinator/workerapi.go index 65b57589..cc21bec3 100644 --- a/pkg/coordinator/workerapi.go +++ b/pkg/coordinator/workerapi.go @@ -23,7 +23,7 @@ func (w *Worker) StartGame(id com.Uid, app games.AppMeta, req api.GameStartUserR return api.UnwrapChecked[api.StartGameResponse]( w.Send(api.StartGame, api.StartGameRequest[com.Uid]{ StatefulRoom: StateRoom(id, req.RoomId), - Game: api.GameInfo{Name: app.Name, Base: app.Base, Path: app.Path, System: app.System, Type: app.Type}, + Game: api.GameInfo(app), PlayerIndex: req.PlayerIndex, Record: req.Record, RecordUser: req.RecordUser, diff --git a/pkg/games/launcher.go b/pkg/games/launcher.go index af5be8df..78bcdae3 100644 --- a/pkg/games/launcher.go +++ b/pkg/games/launcher.go @@ -14,11 +14,11 @@ type Launcher interface { } type AppMeta struct { - Name string - Type string Base string + Name string Path string System string + Type string } type GameLauncher struct { diff --git a/pkg/games/library.go b/pkg/games/library.go index d46b8093..0fde5023 100644 --- a/pkg/games/library.go +++ b/pkg/games/library.go @@ -56,14 +56,11 @@ type WithEmulatorInfo interface { } type GameMetadata struct { - // the display name of the game - Name string - // the game file extension (e.g. nes, n64) - Type string - Base string - // the game path relative to the library base path - Path string + Base string + Name string // the display name of the game + Path string // the game path relative to the library base path System string + Type string // the game file extension (e.g. nes, n64) } func (g GameMetadata) FullPath(base string) string { diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 420aaaef..c530c61a 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -81,9 +81,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke if room == nil { room = NewRoom( rq.Room.Rid, - games.GameMetadata{ - Name: rq.Game.Name, Base: rq.Game.Base, Type: rq.Game.Type, Path: rq.Game.Path, System: rq.Game.System, - }, + games.GameMetadata(rq.Game), func(room *Room) { w.router.SetRoom(nil) c.CloseRoom(room.id) From ddc841e8c6b085336ad66e2668aef22027e9eaa9 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 22 Jul 2023 16:03:51 +0300 Subject: [PATCH 078/361] Fold vpx/h264 struct options --- pkg/config/worker.go | 2 +- pkg/worker/encoder/h264/x264.go | 14 ++++++-------- pkg/worker/encoder/vpx/libvpx.go | 8 ++++---- pkg/worker/media.go | 19 ++++++------------- 4 files changed, 17 insertions(+), 26 deletions(-) diff --git a/pkg/config/worker.go b/pkg/config/worker.go index 6436feea..ed0145d4 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -56,10 +56,10 @@ type Video struct { Concurrency int H264 struct { Crf uint8 + LogLevel int32 Preset string Profile string Tune string - LogLevel int } Vpx struct { Bitrate uint diff --git a/pkg/worker/encoder/h264/x264.go b/pkg/worker/encoder/h264/x264.go index a33948bd..2c87e9f2 100644 --- a/pkg/worker/encoder/h264/x264.go +++ b/pkg/worker/encoder/h264/x264.go @@ -1,8 +1,6 @@ package h264 -/* -#include -*/ +// #include import "C" import ( "fmt" @@ -28,14 +26,14 @@ type Options struct { // This method allows the encoder to attempt to achieve a certain output quality for the whole file // when output file size is of less importance. // The range of the CRF scale is 0–51, where 0 is lossless, 23 is the default, and 51 is the worst quality possible. - Crf uint8 - // film, animation, grain, stillimage, psnr, ssim, fastdecode, zerolatency. - Tune string + Crf uint8 + LogLevel int32 // ultrafast, superfast, veryfast, faster, fast, medium, slow, slower, veryslow, placebo. Preset string // baseline, main, high, high10, high422, high444. - Profile string - LogLevel int32 + Profile string + // film, animation, grain, stillimage, psnr, ssim, fastdecode, zerolatency. + Tune string } func NewEncoder(w, h int, opts *Options) (encoder *H264, err error) { diff --git a/pkg/worker/encoder/vpx/libvpx.go b/pkg/worker/encoder/vpx/libvpx.go index e0370926..c9047e18 100644 --- a/pkg/worker/encoder/vpx/libvpx.go +++ b/pkg/worker/encoder/vpx/libvpx.go @@ -90,7 +90,7 @@ type Options struct { // Target bandwidth to use for this stream, in kilobits per second. Bitrate uint // Force keyframe interval. - KeyframeInt uint + KeyframeInterval uint } func NewEncoder(w, h int, opts *Options) (*Vpx, error) { @@ -101,14 +101,14 @@ func NewEncoder(w, h int, opts *Options) (*Vpx, error) { if opts == nil { opts = &Options{ - Bitrate: 1200, - KeyframeInt: 5, + Bitrate: 1200, + KeyframeInterval: 5, } } vpx := Vpx{ frameCount: C.int(0), - kfi: C.int(opts.KeyframeInt), + kfi: C.int(opts.KeyframeInterval), } if C.vpx_img_alloc(&vpx.image, C.VPX_IMG_FMT_I420, C.uint(w), C.uint(h), 1) == nil { diff --git a/pkg/worker/media.go b/pkg/worker/media.go index be5ac2ac..9a13ab58 100644 --- a/pkg/worker/media.go +++ b/pkg/worker/media.go @@ -124,25 +124,18 @@ func (r *Room) initAudio(srcHz int, conf config.Audio) { } // initVideo processes videoFrames images with an encoder (codec) then pushes the result to WebRTC. -func (r *Room) initVideo(width, height int, conf config.Video) { +func (r *Room) initVideo(w, h int, conf config.Video) { var enc encoder.Encoder var err error r.log.Info().Msgf("Video codec: %v", conf.Codec) if conf.Codec == string(encoder.H264) { r.log.Debug().Msgf("x264: build v%v", h264.LibVersion()) - enc, err = h264.NewEncoder(width, height, &h264.Options{ - Crf: conf.H264.Crf, - Tune: conf.H264.Tune, - Preset: conf.H264.Preset, - Profile: conf.H264.Profile, - LogLevel: int32(conf.H264.LogLevel), - }) + opts := h264.Options(conf.H264) + enc, err = h264.NewEncoder(w, h, &opts) } else { - enc, err = vpx.NewEncoder(width, height, &vpx.Options{ - Bitrate: conf.Vpx.Bitrate, - KeyframeInt: conf.Vpx.KeyframeInterval, - }) + opts := vpx.Options(conf.Vpx) + enc, err = vpx.NewEncoder(w, h, &opts) } if err != nil { @@ -150,7 +143,7 @@ func (r *Room) initVideo(width, height int, conf config.Video) { return } - r.vEncoder = encoder.NewVideoEncoder(enc, width, height, conf.Concurrency, r.log) + r.vEncoder = encoder.NewVideoEncoder(enc, w, h, conf.Concurrency, r.log) r.emulator.SetVideo(func(raw *emulator.GameFrame) { data := r.vEncoder.Encode(raw.Data.RGBA) From b2e4848ed3a6448538773af8b360fc07643fd8b2 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 15 Jul 2023 22:32:31 +0300 Subject: [PATCH 079/361] Update to Go 1.21.0 --- .github/workflows/build.yml | 2 +- Dockerfile | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 17ce3d47..4097cc8f 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -27,7 +27,7 @@ jobs: - uses: actions/setup-go@v4 with: - go-version: ^1.20 + go-version: ^1.21 - name: Get Linux dev libraries and tools if: matrix.os == 'ubuntu-latest' diff --git a/Dockerfile b/Dockerfile index 7fe08cd8..78e13f7e 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:lunar AS build0 -ARG GO=1.20.4 +ARG GO=1.21.0 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ From 8e92f6822e484503e428bb0cadcba077ed6fb706 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 9 Aug 2023 19:19:10 +0300 Subject: [PATCH 080/361] Revert Go version to 1.20 due to MacOS crash --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 4097cc8f..17ce3d47 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -27,7 +27,7 @@ jobs: - uses: actions/setup-go@v4 with: - go-version: ^1.21 + go-version: ^1.20 - name: Get Linux dev libraries and tools if: matrix.os == 'ubuntu-latest' From 240a1f92ce0a40709db3b9fccb0d3e80bc1f555b Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 9 Aug 2023 19:55:44 +0300 Subject: [PATCH 081/361] Use Go 1.20.7 with Docker builds --- Dockerfile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Dockerfile b/Dockerfile index 78e13f7e..98a8a807 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:lunar AS build0 -ARG GO=1.21.0 +ARG GO=1.20.7 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ From c27c88c0fa4695aebc554039f56087c2a6d6666d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 24 Aug 2023 00:14:25 +0300 Subject: [PATCH 082/361] Disable canvas pool with recording enabled for now --- pkg/worker/emulator/image/canvas.go | 7 +++++-- pkg/worker/emulator/libretro/frontend.go | 10 +++++++--- pkg/worker/emulator/libretro/nanoarch.go | 4 ++-- pkg/worker/room.go | 3 +++ 4 files changed, 17 insertions(+), 7 deletions(-) diff --git a/pkg/worker/emulator/image/canvas.go b/pkg/worker/emulator/image/canvas.go index 6e8eda17..bb420a1c 100644 --- a/pkg/worker/emulator/image/canvas.go +++ b/pkg/worker/emulator/image/canvas.go @@ -9,6 +9,7 @@ import ( // Canvas is a stateful drawing surface, i.e. image.RGBA type Canvas struct { + enabled bool w, h int vertical bool pool sync.Pool @@ -36,6 +37,7 @@ const ( func NewCanvas(w, h, size int) *Canvas { return &Canvas{ + enabled: true, w: w, h: h, vertical: h > w, // input is inverted @@ -61,11 +63,12 @@ func (c *Canvas) Get(w, h int) *Frame { } func (c *Canvas) Put(i *Frame) { - if i != nil { + if c.enabled && i != nil { c.pool.Put(i) } } -func (c *Canvas) Clear() { c.wg = sync.WaitGroup{} } +func (c *Canvas) Clear() { c.wg = sync.WaitGroup{} } +func (c *Canvas) SetEnabled(enabled bool) { c.enabled = enabled } func (c *Canvas) Draw(encoding uint32, rot *Rotate, w, h, packedW, bpp int, data []byte, th int) *Frame { dst := c.Get(w, h) diff --git a/pkg/worker/emulator/libretro/frontend.go b/pkg/worker/emulator/libretro/frontend.go index 7a89c057..86697777 100644 --- a/pkg/worker/emulator/libretro/frontend.go +++ b/pkg/worker/emulator/libretro/frontend.go @@ -31,7 +31,8 @@ type Frontend struct { stopped atomic.Bool - canvas *image.Canvas + Canvas *image.Canvas + DisableCanvasPool bool done chan struct{} log *logger.Logger @@ -139,7 +140,7 @@ func (f *Frontend) Start() { ticker.Stop() f.mu.Lock() nanoarchShutdown() - frontend.canvas.Clear() + frontend.Canvas.Clear() f.SetAudio(noAudio) f.SetVideo(noVideo) f.mu.Unlock() @@ -201,7 +202,10 @@ func (f *Frontend) SetViewport(width int, height int, scale int) { f.mu.Lock() f.vw, f.vh = width, height size := int(nano.sysAvInfo.geometry.max_width) * scale * int(nano.sysAvInfo.geometry.max_height) * scale - f.canvas = image.NewCanvas(width, height, size) + f.Canvas = image.NewCanvas(width, height, size) + if f.DisableCanvasPool { + f.Canvas.SetEnabled(false) + } f.mu.Unlock() } func (f *Frontend) ToggleMultitap() { toggleMultitap() } diff --git a/pkg/worker/emulator/libretro/nanoarch.go b/pkg/worker/emulator/libretro/nanoarch.go index 0f8fac7f..bd49255b 100644 --- a/pkg/worker/emulator/libretro/nanoarch.go +++ b/pkg/worker/emulator/libretro/nanoarch.go @@ -164,11 +164,11 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { } // !to fix possible nil pointer dereference // when the internal pool can be nil during first Get??? - fr.Data = frontend.canvas. + fr.Data = frontend.Canvas. Draw(nano.v.pixFmt, nano.rot, int(width), int(height), int(packed), int(nano.v.bpp), data_, frontend.th) fr.Duration = time.Duration(dt) frontend.onVideo(fr) - frontend.canvas.Put(fr.Data) + frontend.Canvas.Put(fr.Data) videoPool.Put(fr) } diff --git a/pkg/worker/room.go b/pkg/worker/room.go index 2fff1cf3..d7e4f51a 100644 --- a/pkg/worker/room.go +++ b/pkg/worker/room.go @@ -53,6 +53,9 @@ func NewRoom(id string, game games.GameMetadata, onClose func(*Room), conf confi if err != nil { log.Fatal().Err(err).Send() } + if conf.Recording.Enabled { + nano.DisableCanvasPool = true + } room.emulator = nano room.emulator.SetMainSaveName(id) room.emulator.LoadMetadata(game.System) From 882aae9daf6519bcf7edea870a2440aebbe8d6e4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 24 Aug 2023 00:37:56 +0300 Subject: [PATCH 083/361] Use Go 1.20.7 for builds --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 17ce3d47..8a156e0f 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -27,7 +27,7 @@ jobs: - uses: actions/setup-go@v4 with: - go-version: ^1.20 + go-version: 1.20.7 - name: Get Linux dev libraries and tools if: matrix.os == 'ubuntu-latest' From ae3f91dfc69ecc816b2bc8efa3cdb2219a554538 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 24 Aug 2023 10:16:58 +0300 Subject: [PATCH 084/361] Add diagnostic input to FBNeo on crio --- .github/workflows/cd/cloudretro.io/config.yaml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/workflows/cd/cloudretro.io/config.yaml b/.github/workflows/cd/cloudretro.io/config.yaml index 5ca390ad..9cfb0e7b 100644 --- a/.github/workflows/cd/cloudretro.io/config.yaml +++ b/.github/workflows/cd/cloudretro.io/config.yaml @@ -31,6 +31,7 @@ emulator: list: mame: options: - fbneo-cpu-speed-adjust: 200% + "fbneo-cpu-speed-adjust": "200%" + "fbneo-diagnostic-input": "Hold Start" pcsx: altRepo: true From f2d21c67dc2249b8cd8050e50c0fd4b677e591bf Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 1 Sep 2023 22:54:14 +0300 Subject: [PATCH 085/361] Partial fix for convoluted game list ext info bug --- web/js/gameList.js | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/web/js/gameList.js b/web/js/gameList.js index 86623bf6..f77a7ef6 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -166,7 +166,8 @@ const gameList = (() => { render, marker: { show: () => gui.show(choiceMarkerEl) - } + }, + NO_TRANSITION: onTransitionEnd(), } })(TOP_POSITION, SELECT_THRESHOLD_MS, games) @@ -198,6 +199,7 @@ const gameList = (() => { event.sub(MENU_PRESSED, (position) => { if (games.empty()) return + ui.onTransitionEnd = ui.NO_TRANSITION hasTransition = false scroll.scroll(scroll.state.DRAG) ui.selected && ui.selected.clear() From 3b06905e15de9fa8b9212494173f77e070b7eb10 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 1 Aug 2023 22:13:27 +0300 Subject: [PATCH 086/361] Skip peer connection state error due to DTLS spam --- pkg/network/webrtc/webrtc.go | 27 ++++++++++++++++----------- 1 file changed, 16 insertions(+), 11 deletions(-) diff --git a/pkg/network/webrtc/webrtc.go b/pkg/network/webrtc/webrtc.go index afd13e34..ab685771 100644 --- a/pkg/network/webrtc/webrtc.go +++ b/pkg/network/webrtc/webrtc.go @@ -3,6 +3,7 @@ package webrtc import ( "fmt" "strings" + "time" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/pion/webrtc/v3" @@ -20,6 +21,15 @@ type Peer struct { dTrack *webrtc.DataChannel } +// A Sample contains encoded media and timing information +type Sample struct { + Data []byte + Timestamp time.Time + Duration time.Duration + PacketTimestamp uint32 + PrevDroppedPackets uint16 +} + type Decoder func(data string, obj any) error func New(log *logger.Logger, api *ApiFactory) *Peer { return &Peer{api: api, log: log} } @@ -92,9 +102,8 @@ func (p *Peer) SetRemoteSDP(sdp string, decoder Decoder) error { return nil } -func (p *Peer) WriteVideo(sample *media.Sample) error { return p.vTrack.WriteSample(*sample) } - -func (p *Peer) WriteAudio(sample *media.Sample) error { return p.aTrack.WriteSample(*sample) } +func (p *Peer) WriteVideo(s Sample) error { return p.vTrack.WriteSample(media.Sample(s)) } +func (p *Peer) WriteAudio(s Sample) error { return p.aTrack.WriteSample(media.Sample(s)) } func newTrack(id string, label string, codec string) (*webrtc.TrackLocalStaticSample, error) { codec = strings.ToLower(codec) @@ -172,6 +181,7 @@ func (p *Peer) Disconnect() { return } if p.conn.ConnectionState() < webrtc.PeerConnectionStateDisconnected { + // ignore this due to DTLS fatal: conn is closed _ = p.conn.Close() } p.conn = nil @@ -195,17 +205,12 @@ func (p *Peer) addInputChannel(label string) error { p.log.Debug().Str("label", ch.Label()).Uint16("id", *ch.ID()).Msg("Data channel [input] opened") }) ch.OnError(p.logx) - ch.OnMessage(func(mess webrtc.DataChannelMessage) { - if len(mess.Data) == 0 { - return - } - // echo string messages (e.g. ping/pong) - if mess.IsString { - p.logx(ch.Send(mess.Data)) + ch.OnMessage(func(m webrtc.DataChannelMessage) { + if len(m.Data) == 0 { return } if p.OnMessage != nil { - p.OnMessage(mess.Data) + p.OnMessage(m.Data) } }) p.dTrack = ch From 594b02d37e44991f902866481af7ae5ce31c444a Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 25 Aug 2023 22:43:26 +0300 Subject: [PATCH 087/361] Avoid exe/non-exe conflicts with WSL2 when dev.run is called --- Makefile | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Makefile b/Makefile index 79a34d18..93908989 100644 --- a/Makefile +++ b/Makefile @@ -43,7 +43,11 @@ dev.build-local: CGO_CFLAGS=${CGO_CFLAGS} CGO_LDFLAGS=${CGO_LDFLAGS} go build -pgo=auto -o bin/ ./cmd/worker dev.run: dev.build-local +ifeq ($(OS),Windows_NT) + ./bin/coordinator.exe & ./bin/worker.exe +else ./bin/coordinator & ./bin/worker +endif dev.run.debug: go build -race -o bin/ ./cmd/coordinator From d7e7112e25b86154a03e4b2657e92e61d5d9d4ab Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 21 Jul 2023 21:10:02 +0300 Subject: [PATCH 088/361] Update dependencies --- go.mod | 35 +++++++------ go.sum | 97 +++++++++++++++++------------------ pkg/network/webrtc/factory.go | 4 +- pkg/network/webrtc/webrtc.go | 5 +- 4 files changed, 71 insertions(+), 70 deletions(-) diff --git a/go.mod b/go.mod index d7fbb0a0..86da4b88 100644 --- a/go.mod +++ b/go.mod @@ -11,20 +11,21 @@ require ( github.com/gorilla/websocket v1.5.0 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.0.1 - github.com/pion/interceptor v0.1.17 + github.com/pion/ice/v3 v3.0.1 + github.com/pion/interceptor v0.1.19 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v3 v3.2.11 + github.com/pion/webrtc/v4 v4.0.0-beta.3 github.com/rs/xid v1.5.0 - github.com/rs/zerolog v1.29.1 + github.com/rs/zerolog v1.30.0 github.com/veandco/go-sdl2 v0.4.35 - golang.org/x/crypto v0.11.0 - golang.org/x/image v0.9.0 + golang.org/x/crypto v0.13.0 + golang.org/x/image v0.12.0 gopkg.in/yaml.v3 v3.0.1 ) require ( github.com/davecgh/go-spew v1.1.1 // indirect - github.com/google/uuid v1.3.0 // indirect + github.com/google/uuid v1.3.1 // indirect github.com/mattn/go-colorable v0.1.13 // indirect github.com/mattn/go-isatty v0.0.19 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect @@ -32,22 +33,22 @@ require ( github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect github.com/pion/dtls/v2 v2.2.7 // indirect - github.com/pion/ice/v2 v2.3.8 // indirect - github.com/pion/mdns v0.0.7 // indirect + github.com/pion/mdns v0.0.9 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.10 // indirect - github.com/pion/rtp v1.7.13 // indirect - github.com/pion/sctp v1.8.7 // indirect + github.com/pion/rtp v1.8.1 // indirect + github.com/pion/sctp v1.8.9 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect - github.com/pion/srtp/v2 v2.0.15 // indirect - github.com/pion/stun v0.6.1 // indirect - github.com/pion/transport/v2 v2.2.1 // indirect - github.com/pion/turn/v2 v2.1.2 // indirect + github.com/pion/srtp/v3 v3.0.0 // indirect + github.com/pion/stun/v2 v2.0.0 // indirect + github.com/pion/transport/v2 v2.2.4 // indirect + github.com/pion/transport/v3 v3.0.1 // indirect + github.com/pion/turn/v3 v3.0.1 // indirect github.com/pmezard/go-difflib v1.0.0 // indirect github.com/stretchr/testify v1.8.4 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.12.0 // indirect - golang.org/x/sys v0.10.0 // indirect - golang.org/x/text v0.11.0 // indirect + golang.org/x/net v0.15.0 // indirect + golang.org/x/sys v0.12.0 // indirect + golang.org/x/text v0.13.0 // indirect ) diff --git a/go.sum b/go.sum index 450737d6..04e3441d 100644 --- a/go.sum +++ b/go.sum @@ -29,8 +29,8 @@ github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMyw github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= -github.com/google/uuid v1.3.0 h1:t6JiXgmwXMjEs8VusXIJk2BXHsn+wx8BZdTaoZ5fu7I= -github.com/google/uuid v1.3.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/google/uuid v1.3.1 h1:KjJaJ9iWZ3jOFZIf1Lqf4laDRCasjl0BCmnEGxkdLb4= +github.com/google/uuid v1.3.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.0 h1:PPwGk2jz7EePpoHN/+ClbZu8SPxiqlu12wZP/3sWmnc= github.com/gorilla/websocket v1.5.0/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= @@ -69,51 +69,48 @@ github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= -github.com/pion/ice/v2 v2.3.8 h1:/4vM7uFPJez3PhNhlqUcJhboYaDNWo+R8oAuMj2cKsA= -github.com/pion/ice/v2 v2.3.8/go.mod h1:DoMA9FvsfNTBVnjyRf2t4EhUkSp9tNrH77fMtPFYygQ= -github.com/pion/interceptor v0.1.17 h1:prJtgwFh/gB8zMqGZoOgJPHivOwVAp61i2aG61Du/1w= -github.com/pion/interceptor v0.1.17/go.mod h1:SY8kpmfVBvrbUzvj2bsXz7OJt5JvmVNZ+4Kjq7FcwrI= +github.com/pion/ice/v3 v3.0.1 h1:dwWGgIFDlYrKrCW13LihifuFabGw375hoU0347S9wNw= +github.com/pion/ice/v3 v3.0.1/go.mod h1:j4tfTlj4aSEQN9gP3IdliSHcUTWTu9tlOZL0c59MFXo= +github.com/pion/interceptor v0.1.19 h1:tq0TGBzuZQqipyBhaC1mVUCfCh8XjDKUuibq9rIl5t4= +github.com/pion/interceptor v0.1.19/go.mod h1:VANhFxdJezB8mwToMMmrmyHyP9gym6xLqIUch31xryg= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= -github.com/pion/mdns v0.0.7 h1:P0UB4Sr6xDWEox0kTVxF0LmQihtCbSAdW0H2nEgkA3U= -github.com/pion/mdns v0.0.7/go.mod h1:4iP2UbeFhLI/vWju/bw6ZfwjJzk0z8DNValjGxR/dD8= +github.com/pion/mdns v0.0.8/go.mod h1:hYE72WX8WDveIhg7fmXgMKivD3Puklk0Ymzog0lSyaI= +github.com/pion/mdns v0.0.9 h1:7Ue5KZsqq8EuqStnpPWV33vYYEH0+skdDN5L7EiEsI4= +github.com/pion/mdns v0.0.9/go.mod h1:2JA5exfxwzXiCihmxpTKgFUpiQws2MnipoPK09vecIc= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.10 h1:nkr3uj+8Sp97zyItdN60tE/S6vk4al5CPRR6Gejsdjc= github.com/pion/rtcp v1.2.10/go.mod h1:ztfEwXZNLGyF1oQDttz/ZKIBaeeg/oWbRYqzBM9TL1I= -github.com/pion/rtp v1.7.13 h1:qcHwlmtiI50t1XivvoawdCGTP4Uiypzfrsap+bijcoA= -github.com/pion/rtp v1.7.13/go.mod h1:bDb5n+BFZxXx0Ea7E5qe+klMuqiBrP+w8XSjiWtCUko= +github.com/pion/rtp v1.8.1 h1:26OxTc6lKg/qLSGir5agLyj0QKaOv8OP5wps2SFnVNQ= +github.com/pion/rtp v1.8.1/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/sctp v1.8.5/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= -github.com/pion/sctp v1.8.7 h1:JnABvFakZueGAn4KU/4PSKg+GWbF6QWbKTWZOSGJjXw= -github.com/pion/sctp v1.8.7/go.mod h1:g1Ul+ARqZq5JEmoFy87Q/4CePtKnTJ1QCL9dBBdN6AU= +github.com/pion/sctp v1.8.9 h1:TP5ZVxV5J7rz7uZmbyvnUvsn7EJ2x/5q9uhsTtXbI3g= +github.com/pion/sctp v1.8.9/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= github.com/pion/sdp/v3 v3.0.6 h1:WuDLhtuFUUVpTfus9ILC4HRyHsW6TdugjEX/QY9OiUw= github.com/pion/sdp/v3 v3.0.6/go.mod h1:iiFWFpQO8Fy3S5ldclBkpXqmWy02ns78NOKoLLL0YQw= -github.com/pion/srtp/v2 v2.0.15 h1:+tqRtXGsGwHC0G0IUIAzRmdkHvriF79IHVfZGfHrQoA= -github.com/pion/srtp/v2 v2.0.15/go.mod h1:b/pQOlDrbB0HEH5EUAQXzSYxikFbNcNuKmF8tM0hCtw= -github.com/pion/stun v0.4.0/go.mod h1:QPsh1/SbXASntw3zkkrIk3ZJVKz4saBY2G7S10P3wCw= -github.com/pion/stun v0.6.0/go.mod h1:HPqcfoeqQn9cuaet7AOmB5e5xkObu9DwBdurwLKO9oA= -github.com/pion/stun v0.6.1 h1:8lp6YejULeHBF8NmV8e2787BogQhduZugh5PdhDyyN4= -github.com/pion/stun v0.6.1/go.mod h1:/hO7APkX4hZKu/D0f2lHzNyvdkTGtIy3NDmLR7kSz/8= +github.com/pion/srtp/v3 v3.0.0 h1:dH5nZUTxN+JDu4otle8Dfh5E/MHR6m8/aib7eD22QDc= +github.com/pion/srtp/v3 v3.0.0/go.mod h1:WxJGk0scShe0UdUidDgR0kDHywX7JN83JOYPkYiLdpM= +github.com/pion/stun/v2 v2.0.0 h1:A5+wXKLAypxQri59+tmQKVs7+l6mMM+3d+eER9ifRU0= +github.com/pion/stun/v2 v2.0.0/go.mod h1:22qRSh08fSEttYUmJZGlriq9+03jtVmXNODgLccj8GQ= github.com/pion/transport v0.14.1 h1:XSM6olwW+o8J4SCmOBb/BpwZypkHeyM0PGFCxNQBr40= github.com/pion/transport v0.14.1/go.mod h1:4tGmbk00NeYA3rUa9+n+dzCCoKkcy3YlYb99Jn2fNnI= -github.com/pion/transport/v2 v2.0.0/go.mod h1:HS2MEBJTwD+1ZI2eSXSvHJx/HnzQqRy2/LXxt6eVMHc= -github.com/pion/transport/v2 v2.1.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= -github.com/pion/transport/v2 v2.2.0/go.mod h1:AdSw4YBZVDkZm8fpoz+fclXyQwANWmZAlDuQdctTThQ= -github.com/pion/transport/v2 v2.2.1 h1:7qYnCBlpgSJNYMbLCKuSY9KbQdBFoETvPNETv0y4N7c= github.com/pion/transport/v2 v2.2.1/go.mod h1:cXXWavvCnFF6McHTft3DWS9iic2Mftcz1Aq29pGcU5g= -github.com/pion/turn/v2 v2.1.0/go.mod h1:yrT5XbXSGX1VFSF31A3c1kCNB5bBZgk/uu5LET162qs= -github.com/pion/turn/v2 v2.1.2 h1:wj0cAoGKltaZ790XEGW9HwoUewqjliwmhtxCuB2ApyM= -github.com/pion/turn/v2 v2.1.2/go.mod h1:1kjnPkBcex3dhCU2Am+AAmxDcGhLX3WnMfmkNpvSTQU= -github.com/pion/webrtc/v3 v3.2.11 h1:lfGKYZcG7ghCTQWn+zsD+icIIWL3qIfclEjBGk537+s= -github.com/pion/webrtc/v3 v3.2.11/go.mod h1:fejQio1v8tKG4ntq4u8H4uDHsCNX6eX7bT093t4H+0E= +github.com/pion/transport/v2 v2.2.4 h1:41JJK6DZQYSeVLxILA2+F4ZkKb4Xd/tFJZRFZQ9QAlo= +github.com/pion/transport/v2 v2.2.4/go.mod h1:q2U/tf9FEfnSBGSW6w5Qp5PFWRLRj3NjLhCCgpRK4p0= +github.com/pion/transport/v3 v3.0.1 h1:gDTlPJwROfSfz6QfSi0ZmeCSkFcnWWiiR9ES0ouANiM= +github.com/pion/transport/v3 v3.0.1/go.mod h1:UY7kiITrlMv7/IKgd5eTUcaahZx5oUN3l9SzK5f5xE0= +github.com/pion/turn/v3 v3.0.1 h1:wLi7BTQr6/Q20R0vt/lHbjv6y4GChFtC33nkYbasoT8= +github.com/pion/turn/v3 v3.0.1/go.mod h1:MrJDKgqryDyWy1/4NT9TWfXWGMC7UHT6pJIv1+gMeNE= +github.com/pion/webrtc/v4 v4.0.0-beta.3 h1:QWnz0PtSrXLmzW5sO/iF4+ORNyfaxZ4RrG1rm65pR1U= +github.com/pion/webrtc/v4 v4.0.0-beta.3/go.mod h1:du0swJWWJPiVe+Dybe2wMaLPgPPk6pifZwd3EI/Ly3U= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= -github.com/rs/xid v1.4.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg= github.com/rs/xid v1.5.0 h1:mKX4bl4iPYJtEIxp6CYiUuLQ/8DYMoz0PUdtGgMFRVc= github.com/rs/xid v1.5.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg= -github.com/rs/zerolog v1.29.1 h1:cO+d60CHkknCbvzEWxP0S9K6KqyTjrCNUy1LdQLCGPc= -github.com/rs/zerolog v1.29.1/go.mod h1:Le6ESbR7hc+DP6Lt1THiV8CQSdkkNrd3R0XbEgp3ZBU= +github.com/rs/zerolog v1.30.0 h1:SymVODrcRsaRaSInD9yQtKbtWqwsfoPcRff/oRXLj4c= +github.com/rs/zerolog v1.30.0/go.mod h1:/tk+P47gFdPXq4QYjvCmT5/Gsug2nagsFWBWhAiSi1w= github.com/sclevine/agouti v3.0.0+incompatible/go.mod h1:b4WX9W9L1sfQKXeJf1mUTLZKJ48R1S7H23Ji7oFO5Bw= github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= @@ -122,7 +119,6 @@ github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= -github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= github.com/stretchr/testify v1.8.3/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk= github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= @@ -139,11 +135,12 @@ golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8U golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= -golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0= -golang.org/x/crypto v0.11.0 h1:6Ewdq3tDic1mg5xRO4milcWCfMVQhI4NkqWWvqejpuA= -golang.org/x/crypto v0.11.0/go.mod h1:xgJhtzW8F9jGdVFWZESrid1U1bjeNy4zgy5cRr/CIio= -golang.org/x/image v0.9.0 h1:QrzfX26snvCM20hIhBwuHI/ThTg18b/+kcKdXHvnR+g= -golang.org/x/image v0.9.0/go.mod h1:jtrku+n79PfroUbvDdeUWMAI+heR786BofxrbiSF+J0= +golang.org/x/crypto v0.10.0/go.mod h1:o4eNf7Ede1fv+hwOwZsTHl9EsPFO6q6ZvYR8vYfY45I= +golang.org/x/crypto v0.12.0/go.mod h1:NF0Gs7EO5K4qLn+Ylc+fih8BSTeIjAP05siRnAh98yw= +golang.org/x/crypto v0.13.0 h1:mvySKfSWJ+UKUii46M40LOvyWfN0s2U+46/jDd0e6Ck= +golang.org/x/crypto v0.13.0/go.mod h1:y6Z2r+Rw4iayiXXAIxJIDAJ1zMW4yaTpebo8fPOliYc= +golang.org/x/image v0.12.0 h1:w13vZbU4o5rKOFFR8y7M+c4A5jXDC0uXTdHYRP8X2DQ= +golang.org/x/image v0.12.0/go.mod h1:Lu90jvHG7GfemOIcldsh9A2hS01ocl6oNO7ype5mEnk= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= @@ -156,13 +153,13 @@ golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v golang.org/x/net v0.0.0-20210428140749-89ef3d95e781/go.mod h1:OJAsFXCWl8Ukc7SiCT/9KSuxbyM7479/AVlXFRxuMCk= golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c= golang.org/x/net v0.1.0/go.mod h1:Cx3nUiGt4eDBEyega/BKRp+/AlGL8hYe7U9odMt2Cco= -golang.org/x/net v0.5.0/go.mod h1:DivGGAXEgPSlEBzxGzZI+ZLohi+xUj054jfeKui00ws= golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= -golang.org/x/net v0.8.0/go.mod h1:QVkue5JL9kW//ek3r6jTKnTFis1tRmNAW2P1shuFdJc= golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= -golang.org/x/net v0.12.0 h1:cfawfvKITfUsFCeJIHJrbSxpeu/E81khclypR0GVT50= -golang.org/x/net v0.12.0/go.mod h1:zEVYFnQC7m/vmpQFELhcD1EWkZlX69l4oqgmer6hfKA= +golang.org/x/net v0.11.0/go.mod h1:2L/ixqYpgIVXmeoSA/4Lu7BzTG4KIyPIryS4IsOd1oQ= +golang.org/x/net v0.14.0/go.mod h1:PpSgVXXLK0OxS0F31C1/tv6XNguvCrnXIDrFMspZIUI= +golang.org/x/net v0.15.0 h1:ugBLEUaxABaB5AJqW9enI0ACdci2RUd4eP51NTBvuJ8= +golang.org/x/net v0.15.0/go.mod h1:idbUs1IY1+zTqbi8yxTbhexhEEk5ur9LInksu6HrEpk= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -188,32 +185,34 @@ golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBc golang.org/x/sys v0.0.0-20220908164124-27713097b956/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.2.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.4.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.7.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.10.0 h1:SqMFp9UcQJZa+pmYuAKjd9xq1f0j5rLcDIk0mj4qAsA= -golang.org/x/sys v0.10.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.9.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.12.0 h1:CM0HF96J0hcLAwsHPJZjfdNzs0gftsLfgKt57wWHJ0o= +golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= -golang.org/x/term v0.4.0/go.mod h1:9P2UbLfCdcvo3p/nzKvsmas4TnlujnuoV9hGgYzW1lQ= golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= -golang.org/x/term v0.6.0/go.mod h1:m6U89DPEgQRMq3DNkDClhWw02AUbt2daBVO4cn4Hv9U= golang.org/x/term v0.7.0/go.mod h1:P32HKFT3hSsZrRxla30E9HqToFYAQPCMs/zFMBUFqPY= golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= +golang.org/x/term v0.9.0/go.mod h1:M6DEAAIenWoTxdKrOltXcmDY3rSplQUkrvaDU5FcQyo= +golang.org/x/term v0.11.0/go.mod h1:zC9APTIj3jG3FdV/Ons+XE1riIZXG4aZ4GTHiPZJPIU= +golang.org/x/term v0.12.0/go.mod h1:owVbMEjm3cBLCHdkQu9b1opXd4ETQWc3BhuQGKgXgvU= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ= golang.org/x/text v0.4.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= -golang.org/x/text v0.6.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= -golang.org/x/text v0.8.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= -golang.org/x/text v0.11.0 h1:LAntKIrcmeSKERyiOh0XMV39LXS8IE9UL2yP7+f5ij4= -golang.org/x/text v0.11.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= +golang.org/x/text v0.10.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= +golang.org/x/text v0.12.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= +golang.org/x/text v0.13.0 h1:ablQoSUd0tRdKxZewP80B+BaqeKJuVhuRxj/dkrun3k= +golang.org/x/text v0.13.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20201224043029-2b0845dc783e/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= diff --git a/pkg/network/webrtc/factory.go b/pkg/network/webrtc/factory.go index fdcc9631..0eaa9dd7 100644 --- a/pkg/network/webrtc/factory.go +++ b/pkg/network/webrtc/factory.go @@ -2,15 +2,15 @@ package webrtc import ( "fmt" - "github.com/pion/ice/v2" "net" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/network/socket" + "github.com/pion/ice/v3" "github.com/pion/interceptor" "github.com/pion/interceptor/pkg/report" - "github.com/pion/webrtc/v3" + "github.com/pion/webrtc/v4" ) type ApiFactory struct { diff --git a/pkg/network/webrtc/webrtc.go b/pkg/network/webrtc/webrtc.go index ab685771..751ddf83 100644 --- a/pkg/network/webrtc/webrtc.go +++ b/pkg/network/webrtc/webrtc.go @@ -6,8 +6,8 @@ import ( "time" "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/pion/webrtc/v3" - "github.com/pion/webrtc/v3/pkg/media" + "github.com/pion/webrtc/v4" + "github.com/pion/webrtc/v4/pkg/media" ) type Peer struct { @@ -28,6 +28,7 @@ type Sample struct { Duration time.Duration PacketTimestamp uint32 PrevDroppedPackets uint16 + Metadata interface{} } type Decoder func(data string, obj any) error From 992b6e06da71198eb7b6eb9f95f7f315fed715c1 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 12 Sep 2023 01:55:35 +0300 Subject: [PATCH 089/361] Hide sys info in the frontend --- web/css/main.css | 4 ++-- web/js/gameList.js | 11 +++++++---- 2 files changed, 9 insertions(+), 6 deletions(-) diff --git a/web/css/main.css b/web/css/main.css index 7daa3640..d106b1be 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -502,9 +502,9 @@ body { .menu-item__info { color: white; - font-size: 50%; + font-size: 30%; position: absolute; - right: 15px; + left: 15px; } .text-move { diff --git a/web/js/gameList.js b/web/js/gameList.js index f77a7ef6..406b27e0 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -112,7 +112,7 @@ const gameList = (() => { const clear = () => { _title.reset() - _desc.hide() + // _desc.hide() } return { @@ -130,13 +130,16 @@ const gameList = (() => { rootEl.innerHTML = games.list.map(game => `
` + `
${game.title}
` + - `` + + //`
${game.system}
` + `
`) .join('') items = [...rootEl.querySelectorAll('.menu-item')].map(x => item(x)) } return { + get items() { + return items + }, get selected() { return items[games.index] }, @@ -179,7 +182,7 @@ const gameList = (() => { } const select = (index) => { - ui.selected && ui.selected.clear() + ui.items.forEach(i => i.clear()) // !to rewrite games.index = index ui.pos = games.index } @@ -193,7 +196,7 @@ const gameList = (() => { if (item) { item.title.pick() item.title.animate() - hasTransition ? (ui.onTransitionEnd = item.description.show) : item.description.show() + // hasTransition ? (ui.onTransitionEnd = item.description.show) : item.description.show() } } From cccb3dce844ac48f377c5ec6e13f15ea78befa8a Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 29 Aug 2023 14:46:45 +0300 Subject: [PATCH 090/361] Fix some test on Arch --- pkg/com/net_test.go | 11 ++++++----- pkg/network/httpx/listener_test.go | 11 +++++------ pkg/worker/room_test.go | 16 ---------------- 3 files changed, 11 insertions(+), 27 deletions(-) diff --git a/pkg/com/net_test.go b/pkg/com/net_test.go index 44c21805..fa7d3130 100644 --- a/pkg/com/net_test.go +++ b/pkg/com/net_test.go @@ -49,8 +49,9 @@ func TestWebsocket(t *testing.T) { } func testWebsocket(t *testing.T) { - server := newServer(t) - client := newClient(t, url.URL{Scheme: "ws", Host: "localhost:8080", Path: "/ws"}) + addr := ":8989" + server := newServer(addr, t) + client := newClient(t, url.URL{Scheme: "ws", Host: "localhost" + addr, Path: "/ws"}) clDone := client.ProcessPackets(func(in TestIn) error { return nil }) if server.conn == nil { @@ -190,15 +191,15 @@ func (s *serverHandler) serve(t *testing.T) func(w http.ResponseWriter, r *http. } } -func newServer(t *testing.T) *serverHandler { +func newServer(addr string, t *testing.T) *serverHandler { var wg sync.WaitGroup handler := serverHandler{} http.HandleFunc("/ws", handler.serve(t)) wg.Add(1) go func() { wg.Done() - if err := http.ListenAndServe(":8080", nil); err != nil { - t.Errorf("no server") + if err := http.ListenAndServe(addr, nil); err != nil { + t.Errorf("no server, %v", err) return } }() diff --git a/pkg/network/httpx/listener_test.go b/pkg/network/httpx/listener_test.go index 49be5aac..c8d06eb4 100644 --- a/pkg/network/httpx/listener_test.go +++ b/pkg/network/httpx/listener_test.go @@ -13,7 +13,6 @@ func TestListenerCreation(t *testing.T) { random bool error bool }{ - {addr: ":80", port: "80"}, {addr: ":", random: true}, {addr: ":0", random: true}, {addr: "", random: true}, @@ -38,14 +37,14 @@ func TestListenerCreation(t *testing.T) { continue } - defer func() { _ = ls.Close() }() - addr := ls.Addr().(*net.TCPAddr) port := ls.GetPort() hasPort := port > 0 isPortSame := strings.HasSuffix(addr.String(), ":"+test.port) + _ = ls.Close() + if test.random { if !hasPort { t.Errorf("expected a random port, got %v", port) @@ -64,7 +63,7 @@ func TestFailOnPortInUse(t *testing.T) { if err != nil { t.Errorf("expected no error, got %v", err) } - defer a.Close() + defer func() { _ = a.Close() }() _, err = NewListener(":3333", false) if err == nil { t.Errorf("expected busy port error, but got none") @@ -76,10 +75,10 @@ func TestListenerPortRoll(t *testing.T) { if err != nil { t.Errorf("expected no error, got %v", err) } - defer a.Close() + defer func() { _ = a.Close() }() b, err := NewListener("127.0.0.1:3333", true) if err != nil { t.Errorf("expected no port error, but got %v", err) } - b.Close() + _ = b.Close() } diff --git a/pkg/worker/room_test.go b/pkg/worker/room_test.go index 3d3543bf..91c09b20 100644 --- a/pkg/worker/room_test.go +++ b/pkg/worker/room_test.go @@ -227,22 +227,6 @@ func getRoomMock(cfg roomMockConfig) roomMock { room.StartEmulator() } - // loop-wait the room initialization - var init sync.WaitGroup - init.Add(1) - wasted := 0 - go func() { - sleepDeltaMs := 10 - for room.emulator == nil { - time.Sleep(time.Duration(sleepDeltaMs) * time.Millisecond) - wasted++ - if wasted > 1000 { - break - } - } - init.Done() - }() - init.Wait() return roomMock{Room: room, startEmulator: !cfg.dontStartEmulator} } From 878d7fe2988c1e534727e911bd5428d215d32839 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 11 Sep 2023 00:17:55 +0300 Subject: [PATCH 091/361] API cleanup --- pkg/api/api.go | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/pkg/api/api.go b/pkg/api/api.go index 6f53154d..6a8e96f6 100644 --- a/pkg/api/api.go +++ b/pkg/api/api.go @@ -72,10 +72,10 @@ const ( WebrtcAnswer PT = 102 WebrtcIce PT = 103 StartGame PT = 104 - ChangePlayer PT = 108 QuitGame PT = 105 SaveGame PT = 106 LoadGame PT = 107 + ChangePlayer PT = 108 ToggleMultitap PT = 109 RecordGame PT = 110 GetWorkerList PT = 111 @@ -116,6 +116,8 @@ func (p PT) String() string { return "RecordGame" case GetWorkerList: return "GetWorkerList" + case ErrNoFreeSlots: + return "NoFreeSlots" case RegisterRoom: return "RegisterRoom" case CloseRoom: From 196930281b5589b1ff17dabf79edf398d57c84af Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 10 Jul 2023 14:14:12 +0300 Subject: [PATCH 092/361] Add the initial caged apps abstraction In the current version of the application, we have strictly hardcoded the captured runtime application (FFI Libretro frontend) as well as the streaming transport (WebRTC). This commit makes it possible to choose these components at runtime. In this commit, we no longer manage initially connected users separately from the rooms, and instead, we treat all users as abstract app sessions, rather than hardcoded WebRTC connections. These sessions may contain all the transport specifics, such as WebRTC and so on. Rooms, instead of having the hardcoded emulator app and WebRTC media encoders, now have these components decoupled. In theory, it is possible to add new transports (e.g., WebTransport) and streaming apps (e.g., wrapped into an ffmpeg desktop app). --- Makefile | 2 +- pkg/com/com.go | 17 +- pkg/com/map.go | 10 +- pkg/com/net.go | 1 + pkg/config/emulator.go | 24 +- pkg/coordinator/coordinator.go | 10 +- pkg/coordinator/hub.go | 8 +- pkg/coordinator/user.go | 2 +- pkg/coordinator/worker.go | 2 +- pkg/network/webrtc/webrtc.go | 63 +- pkg/worker/caged/app/app.go | 25 + pkg/worker/caged/caged.go | 61 + pkg/worker/caged/libretro/caged.go | 84 ++ pkg/worker/caged/libretro/cloud.go | 50 + pkg/worker/caged/libretro/frontend.go | 410 +++++++ pkg/worker/caged/libretro/frontend_test.go | 439 +++++++ .../libretro}/graphics/gl/KHR/khrplatform.h | 0 .../libretro}/graphics/gl/gl.go | 0 .../libretro}/graphics/opengl.go | 18 +- .../libretro}/graphics/sdl.go | 0 .../libretro}/image/canvas.go | 20 +- .../libretro}/image/canvas_test.go | 0 .../libretro}/image/rotation.go | 0 .../libretro}/image/rotation_test.go | 0 .../libretro}/image/scale.go | 0 .../libretro/manager}/downloader.go | 2 +- .../libretro/manager}/grab.go | 2 +- .../libretro/manager/http.go} | 19 +- .../libretro/manager/http_test.go} | 2 +- .../libretro/manager/manager.go | 17 +- .../libretro/nanoarch}/libretro.h | 0 .../libretro/nanoarch}/loader.go | 2 +- .../libretro/nanoarch}/nanoarch.c | 0 .../libretro/nanoarch}/nanoarch.go | 1033 +++++++++-------- .../libretro/nanoarch}/nanoarch.h | 0 pkg/worker/caged/libretro/recording.go | 78 ++ .../libretro/repo/arch/arch.go} | 12 +- .../libretro/repo/buildbot/repository.go | 6 +- .../libretro/repo/buildbot/repository_test.go | 18 +- .../libretro/repo/github/repository.go | 6 +- .../libretro/repo/github/repository_test.go | 18 +- .../caged/libretro/repo/raw/repository.go | 14 + .../libretro/repo/repository.go | 10 +- .../{emulator => caged}/libretro/storage.go | 0 .../libretro/storage_test.go | 0 .../{storage.go => cloud/cloudstore.go} | 10 +- .../cloudstore_test.go} | 2 +- pkg/worker/cloudsave.go | 56 - pkg/worker/coordinator.go | 7 +- pkg/worker/coordinatorhandlers.go | 152 +-- pkg/worker/emulator/emulator.go | 79 -- pkg/worker/emulator/graphics/context.go | 18 - pkg/worker/emulator/libretro/frontend.go | 285 ----- pkg/worker/emulator/libretro/frontend_test.go | 263 ----- pkg/worker/emulator/libretro/nanoarch_test.go | 228 ---- .../emulator/libretro/repo/raw/repository.go | 20 - pkg/worker/{ => media}/media.go | 156 +-- pkg/worker/{ => media}/media_test.go | 12 +- pkg/worker/recorder/recorder.go | 8 +- pkg/worker/recorder/recorder_test.go | 6 +- pkg/worker/recorder/wavstream.go | 2 +- pkg/worker/recording.go | 69 -- pkg/worker/room.go | 190 --- pkg/worker/room/cast.go | 22 + pkg/worker/room/cast_test.go | 36 + pkg/worker/room/room.go | 139 +++ pkg/worker/room/room_test.go | 301 +++++ pkg/worker/room_test.go | 323 ------ pkg/worker/router.go | 55 - pkg/worker/worker.go | 35 +- 70 files changed, 2542 insertions(+), 2417 deletions(-) create mode 100644 pkg/worker/caged/app/app.go create mode 100644 pkg/worker/caged/caged.go create mode 100644 pkg/worker/caged/libretro/caged.go create mode 100644 pkg/worker/caged/libretro/cloud.go create mode 100644 pkg/worker/caged/libretro/frontend.go create mode 100644 pkg/worker/caged/libretro/frontend_test.go rename pkg/worker/{emulator => caged/libretro}/graphics/gl/KHR/khrplatform.h (100%) rename pkg/worker/{emulator => caged/libretro}/graphics/gl/gl.go (100%) rename pkg/worker/{emulator => caged/libretro}/graphics/opengl.go (92%) rename pkg/worker/{emulator => caged/libretro}/graphics/sdl.go (100%) rename pkg/worker/{emulator => caged/libretro}/image/canvas.go (92%) rename pkg/worker/{emulator => caged/libretro}/image/canvas_test.go (100%) rename pkg/worker/{emulator => caged/libretro}/image/rotation.go (100%) rename pkg/worker/{emulator => caged/libretro}/image/rotation_test.go (100%) rename pkg/worker/{emulator => caged/libretro}/image/scale.go (100%) rename pkg/worker/{emulator/libretro/manager/remotehttp => caged/libretro/manager}/downloader.go (98%) rename pkg/worker/{emulator/libretro/manager/remotehttp => caged/libretro/manager}/grab.go (98%) rename pkg/worker/{emulator/libretro/manager/remotehttp/manager.go => caged/libretro/manager/http.go} (89%) rename pkg/worker/{emulator/libretro/manager/remotehttp/manager_test.go => caged/libretro/manager/http_test.go} (98%) rename pkg/worker/{emulator => caged}/libretro/manager/manager.go (56%) rename pkg/worker/{emulator/libretro => caged/libretro/nanoarch}/libretro.h (100%) rename pkg/worker/{emulator/libretro => caged/libretro/nanoarch}/loader.go (98%) rename pkg/worker/{emulator/libretro => caged/libretro/nanoarch}/nanoarch.c (100%) rename pkg/worker/{emulator/libretro => caged/libretro/nanoarch}/nanoarch.go (57%) rename pkg/worker/{emulator/libretro => caged/libretro/nanoarch}/nanoarch.h (100%) create mode 100644 pkg/worker/caged/libretro/recording.go rename pkg/worker/{emulator/libretro/core.go => caged/libretro/repo/arch/arch.go} (78%) rename pkg/worker/{emulator => caged}/libretro/repo/buildbot/repository.go (71%) rename pkg/worker/{emulator => caged}/libretro/repo/buildbot/repository_test.go (72%) rename pkg/worker/{emulator => caged}/libretro/repo/github/repository.go (56%) rename pkg/worker/{emulator => caged}/libretro/repo/github/repository_test.go (73%) create mode 100644 pkg/worker/caged/libretro/repo/raw/repository.go rename pkg/worker/{emulator => caged}/libretro/repo/repository.go (60%) rename pkg/worker/{emulator => caged}/libretro/storage.go (100%) rename pkg/worker/{emulator => caged}/libretro/storage_test.go (100%) rename pkg/worker/{storage.go => cloud/cloudstore.go} (94%) rename pkg/worker/{storage_test.go => cloud/cloudstore_test.go} (98%) delete mode 100644 pkg/worker/cloudsave.go delete mode 100644 pkg/worker/emulator/emulator.go delete mode 100644 pkg/worker/emulator/graphics/context.go delete mode 100644 pkg/worker/emulator/libretro/frontend.go delete mode 100644 pkg/worker/emulator/libretro/frontend_test.go delete mode 100644 pkg/worker/emulator/libretro/nanoarch_test.go delete mode 100644 pkg/worker/emulator/libretro/repo/raw/repository.go rename pkg/worker/{ => media}/media.go (53%) rename pkg/worker/{ => media}/media_test.go (97%) delete mode 100644 pkg/worker/recording.go delete mode 100644 pkg/worker/room.go create mode 100644 pkg/worker/room/cast.go create mode 100644 pkg/worker/room/cast_test.go create mode 100644 pkg/worker/room/room.go create mode 100644 pkg/worker/room/room_test.go delete mode 100644 pkg/worker/room_test.go delete mode 100644 pkg/worker/router.go diff --git a/Makefile b/Makefile index 93908989..f8097ac0 100644 --- a/Makefile +++ b/Makefile @@ -33,7 +33,7 @@ build.worker: build: build.coordinator build.worker verify-cores: - go test -run TestAllEmulatorRooms ./pkg/worker -v -renderFrames $(GL_CTX) -outputPath "../../_rendered" + go test -run TestAll ./pkg/worker/room -v -renderFrames $(GL_CTX) -outputPath "../../../_rendered" dev.build: compile build diff --git a/pkg/com/com.go b/pkg/com/com.go index 87247046..d6cc5ca7 100644 --- a/pkg/com/com.go +++ b/pkg/com/com.go @@ -2,18 +2,21 @@ package com import "github.com/giongto35/cloud-game/v3/pkg/logger" -type NetClient interface { +type NetClient[K comparable] interface { Disconnect() - Id() Uid + Id() K } -type NetMap[T NetClient] struct{ Map[Uid, T] } +type NetMap[K comparable, T NetClient[K]] struct{ Map[K, T] } -func NewNetMap[T NetClient]() NetMap[T] { return NetMap[T]{Map: Map[Uid, T]{m: make(map[Uid]T, 10)}} } +func NewNetMap[K comparable, T NetClient[K]]() NetMap[K, T] { + return NetMap[K, T]{Map: Map[K, T]{m: make(map[K]T, 10)}} +} -func (m *NetMap[T]) Add(client T) { m.Put(client.Id(), client) } -func (m *NetMap[T]) Remove(client T) { m.Map.Remove(client.Id()) } -func (m *NetMap[T]) RemoveDisconnect(client T) { client.Disconnect(); m.Remove(client) } +func (m *NetMap[K, T]) Add(client T) bool { return m.Put(client.Id(), client) } +func (m *NetMap[K, T]) Remove(client T) { m.Map.Remove(client.Id()) } +func (m *NetMap[K, T]) Reset() { m.Map = Map[K, T]{m: make(map[K]T, 10)} } +func (m *NetMap[K, T]) RemoveDisconnect(client T) { client.Disconnect(); m.Remove(client) } type SocketClient[T ~uint8, P Packet[T], X any, P2 Packet2[X]] struct { id Uid diff --git a/pkg/com/map.go b/pkg/com/map.go index e7e4cf83..a144c0e3 100644 --- a/pkg/com/map.go +++ b/pkg/com/map.go @@ -18,8 +18,14 @@ func (m *Map[K, V]) Pop(key K) V { m.mu.Unlock() return v } -func (m *Map[K, V]) Put(key K, v V) { m.mu.Lock(); m.m[key] = v; m.mu.Unlock() } -func (m *Map[K, _]) Remove(key K) { m.mu.Lock(); delete(m.m, key); m.mu.Unlock() } +func (m *Map[K, V]) Put(key K, v V) bool { + m.mu.Lock() + _, ok := m.m[key] + m.m[key] = v + m.mu.Unlock() + return ok +} +func (m *Map[K, _]) Remove(key K) { m.mu.Lock(); delete(m.m, key); m.mu.Unlock() } // Find returns the first value found and a boolean flag if its found or not. func (m *Map[K, V]) Find(key K) (v V, ok bool) { diff --git a/pkg/com/net.go b/pkg/com/net.go index 348511c4..f670266a 100644 --- a/pkg/com/net.go +++ b/pkg/com/net.go @@ -29,6 +29,7 @@ func UidFromString(id string) (Uid, error) { } func (u Uid) Short() string { return u.String()[:3] + "." + u.String()[len(u.String())-3:] } +func (u Uid) Id() string { return u.String() } type HasCallId interface { SetGetId(fmt.Stringer) diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index c53fdd45..3b902518 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -1,7 +1,6 @@ package config import ( - "math" "path" "path/filepath" "strings" @@ -10,30 +9,17 @@ import ( type Emulator struct { Scale int Threads int - AspectRatio AspectRatio + AspectRatio struct { + Keep bool + Width int + Height int + } Storage string LocalPath string Libretro LibretroConfig AutosaveSec int } -type AspectRatio struct { - Keep bool - Width int - Height int -} - -func (a AspectRatio) ResizeToAspect(ratio float64, sw int, sh int) (dw int, dh int) { - // ratio is always > 0 - dw = int(math.Round(float64(sh)*ratio/2) * 2) - dh = sh - if dw > sw { - dw = sw - dh = int(math.Round(float64(sw)/ratio/2) * 2) - } - return -} - type LibretroConfig struct { Cores struct { Paths struct { diff --git a/pkg/coordinator/coordinator.go b/pkg/coordinator/coordinator.go index b2614ac4..bdb21067 100644 --- a/pkg/coordinator/coordinator.go +++ b/pkg/coordinator/coordinator.go @@ -16,12 +16,10 @@ import ( type Coordinator struct { hub *Hub - services [2]runnable -} - -type runnable interface { - Run() - Stop() error + services [2]interface { + Run() + Stop() error + } } func New(conf config.CoordinatorConfig, log *logger.Logger) (*Coordinator, error) { diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index 6b418143..8d19fb4f 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -27,15 +27,15 @@ type Hub struct { conf config.CoordinatorConfig launcher games.Launcher log *logger.Logger - users com.NetMap[*User] - workers com.NetMap[*Worker] + users com.NetMap[com.Uid, *User] + workers com.NetMap[com.Uid, *Worker] } func NewHub(conf config.CoordinatorConfig, lib games.GameLibrary, log *logger.Logger) *Hub { return &Hub{ conf: conf, - users: com.NewNetMap[*User](), - workers: com.NewNetMap[*Worker](), + users: com.NewNetMap[com.Uid, *User](), + workers: com.NewNetMap[com.Uid, *Worker](), launcher: games.NewGameLauncher(lib), log: log, } diff --git a/pkg/coordinator/user.go b/pkg/coordinator/user.go index 711c6bac..e2a3d60b 100644 --- a/pkg/coordinator/user.go +++ b/pkg/coordinator/user.go @@ -19,7 +19,7 @@ type HasServerInfo interface { } func NewUser(sock *com.Connection, log *logger.Logger) *User { - conn := com.NewConnection[api.PT, api.In[com.Uid], api.Out](sock, com.NewUid(), log) + conn := com.NewConnection[api.PT, api.In[com.Uid], api.Out, *api.Out](sock, com.NewUid(), log) return &User{ Connection: conn, log: log.Extend(log.With(). diff --git a/pkg/coordinator/worker.go b/pkg/coordinator/worker.go index 7fcc93bc..dd0221fb 100644 --- a/pkg/coordinator/worker.go +++ b/pkg/coordinator/worker.go @@ -33,7 +33,7 @@ type HasUserRegistry interface { } func NewWorker(sock *com.Connection, handshake api.ConnectionRequest[com.Uid], log *logger.Logger) *Worker { - conn := com.NewConnection[api.PT, api.In[com.Uid], api.Out](sock, handshake.Id, log) + conn := com.NewConnection[api.PT, api.In[com.Uid], api.Out, *api.Out](sock, handshake.Id, log) return &Worker{ Connection: conn, Addr: handshake.Addr, diff --git a/pkg/network/webrtc/webrtc.go b/pkg/network/webrtc/webrtc.go index 751ddf83..d05b07c3 100644 --- a/pkg/network/webrtc/webrtc.go +++ b/pkg/network/webrtc/webrtc.go @@ -3,6 +3,7 @@ package webrtc import ( "fmt" "strings" + "sync" "time" "github.com/giongto35/cloud-game/v3/pkg/logger" @@ -16,27 +17,19 @@ type Peer struct { log *logger.Logger OnMessage func(data []byte) - aTrack *webrtc.TrackLocalStaticSample - vTrack *webrtc.TrackLocalStaticSample - dTrack *webrtc.DataChannel + a *webrtc.TrackLocalStaticSample + v *webrtc.TrackLocalStaticSample + d *webrtc.DataChannel } -// A Sample contains encoded media and timing information -type Sample struct { - Data []byte - Timestamp time.Time - Duration time.Duration - PacketTimestamp uint32 - PrevDroppedPackets uint16 - Metadata interface{} -} +var samplePool sync.Pool type Decoder func(data string, obj any) error func New(log *logger.Logger, api *ApiFactory) *Peer { return &Peer{api: api, log: log} } func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp any, err error) { - if p.IsConnected() { + if p.conn != nil && p.conn.ConnectionState() == webrtc.PeerConnectionStateConnected { return } p.log.Info().Msg("WebRTC start") @@ -52,7 +45,7 @@ func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp if _, err = p.conn.AddTrack(video); err != nil { return "", err } - p.vTrack = video + p.v = video p.log.Debug().Msgf("Added [%s] track", video.Codec().MimeType) // plug in the [audio] track (out) @@ -64,7 +57,7 @@ func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp return "", err } p.log.Debug().Msgf("Added [%s] track", audio.Codec().MimeType) - p.aTrack = audio + p.a = audio // plug in the [input] data channel (in) if err = p.addInputChannel("game-input"); err != nil { @@ -90,6 +83,35 @@ func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp return offer, nil } +func (p *Peer) SendAudio(dat []byte, dur int32) { + if err := p.send(dat, int64(dur), p.a.WriteSample); err != nil { + p.log.Error().Err(err).Send() + } +} + +func (p *Peer) SendVideo(data []byte, dur int32) { + if err := p.send(data, int64(dur), p.v.WriteSample); err != nil { + p.log.Error().Err(err).Send() + } +} + +func (p *Peer) SendData(data []byte) { _ = p.d.Send(data) } + +func (p *Peer) send(data []byte, duration int64, fn func(media.Sample) error) error { + sample, _ := samplePool.Get().(*media.Sample) + if sample == nil { + sample = new(media.Sample) + } + sample.Data = data + sample.Duration = time.Duration(duration) + err := fn(*sample) + if err != nil { + return err + } + samplePool.Put(sample) + return nil +} + func (p *Peer) SetRemoteSDP(sdp string, decoder Decoder) error { var answer webrtc.SessionDescription if err := decoder(sdp, &answer); err != nil { @@ -103,9 +125,6 @@ func (p *Peer) SetRemoteSDP(sdp string, decoder Decoder) error { return nil } -func (p *Peer) WriteVideo(s Sample) error { return p.vTrack.WriteSample(media.Sample(s)) } -func (p *Peer) WriteAudio(s Sample) error { return p.aTrack.WriteSample(media.Sample(s)) } - func newTrack(id string, label string, codec string) (*webrtc.TrackLocalStaticSample, error) { codec = strings.ToLower(codec) var mime string @@ -189,12 +208,6 @@ func (p *Peer) Disconnect() { p.log.Debug().Msg("WebRTC stop") } -func (p *Peer) IsConnected() bool { - return p.conn != nil && p.conn.ConnectionState() == webrtc.PeerConnectionStateConnected -} - -func (p *Peer) SendMessage(data []byte) { _ = p.dTrack.Send(data) } - // addInputChannel creates a new WebRTC data channel for user input. // Default params -- ordered: true, negotiated: false. func (p *Peer) addInputChannel(label string) error { @@ -214,7 +227,7 @@ func (p *Peer) addInputChannel(label string) error { p.OnMessage(m.Data) } }) - p.dTrack = ch + p.d = ch ch.OnClose(func() { p.log.Debug().Msg("Data channel [input] has been closed") }) return nil } diff --git a/pkg/worker/caged/app/app.go b/pkg/worker/caged/app/app.go new file mode 100644 index 00000000..82fff885 --- /dev/null +++ b/pkg/worker/caged/app/app.go @@ -0,0 +1,25 @@ +package app + +import "image" + +type App interface { + AudioSampleRate() int + Init() error + ViewportSize() (int, int) + Start() + Close() + + SetAudioCb(func(Audio)) + SetVideoCb(func(Video)) + SendControl(port int, data []byte) +} + +type Audio struct { + Data []int16 + Duration int32 // up to 6y nanosecond-wise +} + +type Video struct { + Frame image.RGBA + Duration int32 +} diff --git a/pkg/worker/caged/caged.go b/pkg/worker/caged/caged.go new file mode 100644 index 00000000..2328d96f --- /dev/null +++ b/pkg/worker/caged/caged.go @@ -0,0 +1,61 @@ +package caged + +import ( + "errors" + "reflect" + + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro" +) + +type Manager struct { + list map[ModName]app.App + log *logger.Logger +} + +type ModName string + +const Libretro ModName = "libretro" + +func NewManager(log *logger.Logger) *Manager { + return &Manager{log: log, list: make(map[ModName]app.App)} +} + +func (m *Manager) Get(name ModName) app.App { return m.list[name] } + +func (m *Manager) Load(name ModName, conf any) error { + if name == Libretro { + caged, err := m.loadLibretro(conf) + if err != nil { + return err + } + m.list[name] = caged + } + return nil +} + +func (m *Manager) loadLibretro(conf any) (*libretro.Caged, error) { + s := reflect.ValueOf(conf) + + e := s.FieldByName("Emulator") + if !e.IsValid() { + return nil, errors.New("no emulator conf") + } + r := s.FieldByName("Recording") + if !r.IsValid() { + return nil, errors.New("no recording conf") + } + + c := libretro.CagedConf{ + Emulator: e.Interface().(config.Emulator), + Recording: r.Interface().(config.Recording), + } + + caged := libretro.Cage(c, m.log) + if err := caged.Init(); err != nil { + return nil, err + } + return &caged, nil +} diff --git a/pkg/worker/caged/libretro/caged.go b/pkg/worker/caged/libretro/caged.go new file mode 100644 index 00000000..57ea82d8 --- /dev/null +++ b/pkg/worker/caged/libretro/caged.go @@ -0,0 +1,84 @@ +package libretro + +import ( + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/games" + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/manager" + "github.com/giongto35/cloud-game/v3/pkg/worker/cloud" +) + +type Caged struct { + Emulator + + base *Frontend // maintains the root for mad embedding + conf CagedConf + log *logger.Logger + w, h int +} + +type CagedConf struct { + Emulator config.Emulator + Recording config.Recording +} + +func (c *Caged) Name() string { return "libretro" } + +func Cage(conf CagedConf, log *logger.Logger) Caged { + return Caged{conf: conf, log: log} +} + +func (c *Caged) Init() error { + if err := manager.CheckCores(c.conf.Emulator, c.log); err != nil { + c.log.Warn().Err(err).Msgf("a Libretro cores sync fail") + } + return nil +} + +func (c *Caged) ReloadFrontend() { + frontend, err := NewFrontend(c.conf.Emulator, c.log) + if err != nil { + c.log.Fatal().Err(err).Send() + } + c.Emulator = frontend + c.base = frontend +} + +func (c *Caged) Load(game games.GameMetadata, path string) error { + c.Emulator.LoadCore(game.System) + if err := c.Emulator.LoadGame(game.FullPath(path)); err != nil { + return err + } + w, h := c.ViewportCalc() + c.SetViewport(w, h, c.conf.Emulator.Scale) + + return nil +} + +func (c *Caged) EnableRecording(nowait bool, user string, game string) { + if c.conf.Recording.Enabled { + // !to fix races with canvas pool when recording + c.base.DisableCanvasPool = true + c.Emulator = WithRecording(c.Emulator, nowait, user, game, c.conf.Recording, c.log) + } +} + +func (c *Caged) EnableCloudStorage(uid string, storage cloud.Storage) { + if storage != nil { + wc, err := WithCloud(c.Emulator, uid, storage) + if err != nil { + c.log.Error().Err(err).Msgf("couldn't init %v", wc.HashPath()) + } else { + c.log.Info().Msgf("cloud state %v has been initialized", wc.HashPath()) + c.Emulator = wc + } + } +} + +func (c *Caged) AudioSampleRate() int { return c.Emulator.AudioSampleRate() } +func (c *Caged) ViewportSize() (int, int) { return c.Emulator.ViewportSize() } +func (c *Caged) SendControl(port int, data []byte) { c.base.Input(port, data) } +func (c *Caged) Start() { go c.Emulator.Start() } +func (c *Caged) SetSaveOnClose(v bool) { c.base.SaveOnClose = v } +func (c *Caged) SetSessionId(name string) { c.base.SetSessionId(name) } +func (c *Caged) Close() { c.Emulator.Close() } diff --git a/pkg/worker/caged/libretro/cloud.go b/pkg/worker/caged/libretro/cloud.go new file mode 100644 index 00000000..caaa0335 --- /dev/null +++ b/pkg/worker/caged/libretro/cloud.go @@ -0,0 +1,50 @@ +package libretro + +import ( + "github.com/giongto35/cloud-game/v3/pkg/os" + "github.com/giongto35/cloud-game/v3/pkg/worker/cloud" +) + +type CloudFrontend struct { + Emulator + stateName string + stateLocalPath string + storage cloud.Storage // a cloud storage to store room state online +} + +func WithCloud(fe Emulator, stateName string, storage cloud.Storage) (*CloudFrontend, error) { + r := &CloudFrontend{Emulator: fe, stateLocalPath: fe.HashPath(), stateName: stateName, storage: storage} + + // saveOnlineRoomToLocal save online room to local. + // !Supports only one file of main save state. + data, err := r.storage.Load(stateName) + if err != nil { + return nil, err + } + // save the data fetched from the cloud to a local directory + if data != nil { + if err := os.WriteFile(r.stateLocalPath, data, 0644); err != nil { + return nil, err + } + } + + return r, nil +} + +func (c *CloudFrontend) HasSave() bool { + _, err := c.storage.Load(c.stateName) + if err == nil { + return true + } + return c.Emulator.HasSave() +} + +func (c *CloudFrontend) SaveGameState() error { + if err := c.Emulator.SaveGameState(); err != nil { + return err + } + if err := c.storage.Save(c.stateName, c.stateLocalPath); err != nil { + return err + } + return nil +} diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go new file mode 100644 index 00000000..a9c50fcd --- /dev/null +++ b/pkg/worker/caged/libretro/frontend.go @@ -0,0 +1,410 @@ +package libretro + +import ( + "errors" + "fmt" + "math" + "path/filepath" + "sync" + "sync/atomic" + "time" + "unsafe" + + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/os" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/image" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/nanoarch" +) + +type Emulator interface { + SetAudioCb(func(app.Audio)) + SetVideoCb(func(app.Video)) + LoadCore(name string) + LoadGame(path string) error + FPS() int + AudioSampleRate() int + IsPortrait() bool + // Start is called after LoadGame + Start() + // SetViewport sets viewport size + SetViewport(width int, height int, scale int) + // ViewportCalc calculates the viewport size with the aspect ratio and scale + ViewportCalc() (nw int, nh int) + ViewportSize() (w, h int) + RestoreGameState() error + // SetSessionId sets distinct name for the game session (in order to save/load it later) + SetSessionId(name string) + SaveGameState() error + // HashPath returns the path emulator will save state to + HashPath() string + // HasSave returns true if the current ROM was saved before + HasSave() bool + // Close will be called when the game is done + Close() + // ToggleMultitap toggles multitap controller. + ToggleMultitap() + // Input passes input to the emulator + Input(player int, data []byte) +} + +type Frontend struct { + canvas *image.Canvas + conf config.Emulator + done chan struct{} + input InputState + log *logger.Logger + nano *nanoarch.Nanoarch + onAudio func(app.Audio) + onVideo func(app.Video) + storage Storage + th int // draw threads + vw, vh int // out frame size + + mu sync.Mutex + + DisableCanvasPool bool + SaveOnClose bool +} + +// InputState stores full controller state. +// It consists of: +// - uint16 button values +// - int16 analog stick values +type ( + InputState [maxPort]State + State struct { + keys uint32 + axes [dpadAxes]int32 + } +) + +const ( + maxPort = 4 + dpadAxes = 4 +) + +var ( + audioPool sync.Pool + noAudio = func(app.Audio) {} + noVideo = func(app.Video) {} + videoPool sync.Pool +) + +// NewFrontend implements Emulator interface for a Libretro frontend. +func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { + path, err := filepath.Abs(conf.LocalPath) + if err != nil { + return nil, fmt.Errorf("failed to use emulator path: %v, %w", conf.LocalPath, err) + } + if err := os.CheckCreateDir(path); err != nil { + return nil, fmt.Errorf("failed to create local path: %v, %w", conf.LocalPath, err) + } + log.Info().Msgf("Emulator save path is %v", path) + + // we use the global Nanoarch instance from nanoarch + nano := nanoarch.NewNano(path) + + log = log.Extend(log.With().Str("m", "Libretro")) + ll := log.Extend(log.Level(logger.Level(conf.Libretro.LogLevel)).With()) + nano.SetLogger(ll) + + // Check if room is on local storage, if not, pull from GCS to local storage + log.Info().Msgf("Local storage path: %v", conf.Storage) + if err := os.CheckCreateDir(conf.Storage); err != nil { + return nil, fmt.Errorf("failed to create local storage path: %v, %w", conf.Storage, err) + } + + var store Storage = &StateStorage{Path: conf.Storage} + if conf.Libretro.SaveCompression { + store = &ZipStorage{Storage: store} + } + + // set global link to the Libretro + f := &Frontend{ + conf: conf, + done: make(chan struct{}), + input: NewGameSessionInput(), + log: log, + onAudio: noAudio, + onVideo: noVideo, + storage: store, + th: conf.Threads, + } + f.linkNano(nano) + + return f, nil +} + +func (f *Frontend) LoadCore(emu string) { + conf := f.conf.GetLibretroCoreConfig(emu) + meta := nanoarch.Metadata{ + AutoGlContext: conf.AutoGlContext, + Hacks: conf.Hacks, + HasMultitap: conf.HasMultitap, + HasVFR: conf.VFR, + IsGlAllowed: conf.IsGlAllowed, + LibPath: conf.Lib, + Options: conf.Options, + UsesLibCo: conf.UsesLibCo, + } + f.mu.Lock() + f.nano.CoreLoad(meta) + f.mu.Unlock() +} + +func (f *Frontend) handleAudio(audio unsafe.Pointer, samples int) { + fr, _ := audioPool.Get().(*app.Audio) + if fr == nil { + fr = new(app.Audio) + } + // !to look if we need a copy + fr.Data = unsafe.Slice((*int16)(audio), samples) + // due to audio buffering for opus fixed frames and const duration up in the hierarchy, + // we skip Duration here + f.onAudio(*fr) + audioPool.Put(fr) +} + +func (f *Frontend) handleVideo(data []byte, delta int32, fi nanoarch.FrameInfo) { + pixFmt := f.nano.Video.PixFmt + bpp := int(f.nano.Video.BPP) + drawn := f.canvas.Draw(pixFmt, f.nano.Rot, int(fi.W), int(fi.H), int(fi.Packed), bpp, data, f.th) + + fr, _ := videoPool.Get().(*app.Video) + if fr == nil { + fr = new(app.Video) + } + fr.Frame = drawn.Unwrap() + fr.Duration = delta + f.onVideo(*fr) + f.canvas.Put(drawn) + videoPool.Put(fr) +} + +func (f *Frontend) Shutdown() { + f.log.Debug().Msgf("run loop cleanup") + f.mu.Lock() + f.nano.Shutdown() + f.canvas.Clear() + f.SetAudioCb(noAudio) + f.SetVideoCb(noVideo) + f.mu.Unlock() + f.log.Debug().Msgf("run loop finished") +} + +func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { + f.nano = nano + f.nano.WaitReady() // start only when nano is available + + f.nano.OnKeyPress = f.input.isKeyPressed + f.nano.OnDpad = f.input.isDpadTouched + f.nano.OnVideo = f.handleVideo + f.nano.OnAudio = f.handleAudio +} + +func (f *Frontend) Start() { + f.log.Debug().Msgf("Frontend start") + + f.done = make(chan struct{}) + f.nano.LastFrameTime = time.Now().UnixNano() + defer f.Shutdown() + + if f.HasSave() { + // advance 1 frame for Mupen save state + if f.nano.LibCo { + f.Tick() + } + if err := f.RestoreGameState(); err != nil { + f.log.Error().Err(err).Msg("couldn't load a save file") + } + } + + ticker := time.NewTicker(time.Second / time.Duration(f.nano.VideoFramerate())) + defer ticker.Stop() + + if f.conf.AutosaveSec > 0 { + // !to sync both for loops, can crash if the emulator starts later + go f.autosave(f.conf.AutosaveSec) + } + + for { + select { + case <-ticker.C: + f.Tick() + case <-f.done: + return + } + } +} + +func (f *Frontend) FrameSize() (int, int) { return f.nano.GeometryBase() } +func (f *Frontend) FPS() int { return f.nano.VideoFramerate() } +func (f *Frontend) HashPath() string { return f.storage.GetSavePath() } +func (f *Frontend) HasSave() bool { return os.Exists(f.HashPath()) } +func (f *Frontend) SRAMPath() string { return f.storage.GetSRAMPath() } +func (f *Frontend) AudioSampleRate() int { return f.nano.AudioSampleRate() } +func (f *Frontend) Input(player int, data []byte) { f.input.setInput(player, data) } +func (f *Frontend) LoadGame(path string) error { return f.nano.LoadGame(path) } +func (f *Frontend) RestoreGameState() error { return f.Load() } +func (f *Frontend) IsPortrait() bool { return f.nano.IsPortrait() } +func (f *Frontend) SaveGameState() error { return f.Save() } +func (f *Frontend) Scale(factor int) { w, h := f.ViewportSize(); f.SetViewport(w, h, factor) } +func (f *Frontend) SetAudioCb(cb func(app.Audio)) { f.onAudio = cb } +func (f *Frontend) SetSessionId(name string) { f.storage.SetMainSaveName(name) } +func (f *Frontend) SetVideoCb(ff func(app.Video)) { f.onVideo = ff } +func (f *Frontend) SetViewport(width int, height int, scale int) { + f.mu.Lock() + f.vw, f.vh = width, height + mw, mh := f.nano.GeometryMax() + size := mw * scale * mh * scale + f.canvas = image.NewCanvas(width, height, size) + if f.DisableCanvasPool { + f.canvas.SetEnabled(false) + } + f.mu.Unlock() +} + +// Tick runs one emulation frame. +func (f *Frontend) Tick() { f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } +func (f *Frontend) ToggleMultitap() { f.nano.ToggleMultitap() } +func (f *Frontend) ViewportSize() (int, int) { return f.vw, f.vh } + +func (f *Frontend) ViewportCalc() (nw int, nh int) { + w, h := f.FrameSize() + f.log.Debug().Msgf("Viewport source size: %dx%d", w, h) + + aspect, aw, ah := f.conf.AspectRatio.Keep, f.conf.AspectRatio.Width, f.conf.AspectRatio.Height + // calc the aspect ratio + if aspect && aw > 0 && ah > 0 { + ratio := float64(w) / float64(ah) + nw = int(math.Round(float64(ah)*ratio/2) * 2) + nh = ah + if nw > aw { + nw = aw + nh = int(math.Round(float64(aw)/ratio/2) * 2) + } + f.log.Debug().Msgf("Viewport aspect change: %dx%d (%f) -> %dx%d", aw, ah, ratio, nw, nh) + } else { + nw, nh = w, h + } + + if f.conf.Scale > 1 { + nw, nh = nw*f.conf.Scale, nh*f.conf.Scale + f.log.Debug().Msgf("Viewport size scaled: %dx%d", nw, nh) + } + + if f.IsPortrait() { + nw, nh = nh, nw + f.log.Debug().Msgf("Viewport was flipped") + } + + f.log.Info().Msgf("Viewport final size: %dx%d", nw, nh) + + return +} + +func (f *Frontend) Close() { + f.log.Debug().Msgf("frontend close called") + + // Save game on quit if it was saved before (shared or click-saved). + if f.SaveOnClose && f.HasSave() { + f.log.Debug().Msg("Save on quit") + if err := f.Save(); err != nil { + f.log.Error().Err(err).Msg("save on quit failed") + } + } + + close(f.done) + f.nano.Close() +} + +// Save writes the current state to the filesystem. +func (f *Frontend) Save() error { + f.mu.Lock() + defer f.mu.Unlock() + + ss, err := nanoarch.SaveState() + if err != nil { + return err + } + if err := f.storage.Save(f.HashPath(), ss); err != nil { + return err + } + ss = nil + + if sram := nanoarch.SaveRAM(); sram != nil { + if err := f.storage.Save(f.SRAMPath(), sram); err != nil { + return err + } + sram = nil + } + return nil +} + +// Load restores the state from the filesystem. +func (f *Frontend) Load() error { + f.mu.Lock() + defer f.mu.Unlock() + + ss, err := f.storage.Load(f.HashPath()) + if err != nil && !errors.Is(err, os.ErrNotExist) { + return err + } + if err := nanoarch.RestoreSaveState(ss); err != nil { + return err + } + + sram, err := f.storage.Load(f.SRAMPath()) + if err != nil && !errors.Is(err, os.ErrNotExist) { + return err + } + if sram != nil { + nanoarch.RestoreSaveRAM(sram) + } + return nil +} + +func (f *Frontend) autosave(periodSec int) { + f.log.Info().Msgf("Autosave every [%vs]", periodSec) + ticker := time.NewTicker(time.Duration(periodSec) * time.Second) + defer ticker.Stop() + + for { + select { + case <-ticker.C: + if f.nano.IsStopped() { + return + } + if err := f.Save(); err != nil { + f.log.Error().Msgf("Autosave failed: %v", err) + } else { + f.log.Debug().Msgf("Autosave done") + } + case <-f.done: + return + } + } +} + +func NewGameSessionInput() InputState { return [maxPort]State{} } + +// setInput sets input state for some player in a game session. +func (s *InputState) setInput(player int, data []byte) { + atomic.StoreUint32(&s[player].keys, uint32(uint16(data[1])<<8+uint16(data[0]))) + for i, axes := 0, len(data); i < dpadAxes && i<<1+3 < axes; i++ { + axis := i<<1 + 2 + atomic.StoreInt32(&s[player].axes[i], int32(data[axis+1])<<8+int32(data[axis])) + } +} + +// isKeyPressed checks if some button is pressed by any player. +func (s *InputState) isKeyPressed(port uint, key int) int { + return int((atomic.LoadUint32(&s[port].keys) >> uint(key)) & 1) +} + +// isDpadTouched checks if D-pad is used by any player. +func (s *InputState) isDpadTouched(port uint, axis uint) (shift int16) { + return int16(atomic.LoadInt32(&s[port].axes[axis])) +} diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go new file mode 100644 index 00000000..afedbd53 --- /dev/null +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -0,0 +1,439 @@ +package libretro + +import ( + "crypto/md5" + "fmt" + "io" + "log" + "math/rand" + "os" + "path" + "path/filepath" + "sync" + "testing" + "unsafe" + + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/nanoarch" +) + +type testRun struct { + room string + system string + rom string + emulationTicks int +} + +// EmulatorMock contains Frontend mocking data. +type EmulatorMock struct { + *Frontend + + // Libretro compiled lib core name + core string + // shared core paths (can't be changed) + paths EmulatorPaths +} + +// EmulatorPaths defines various emulator file paths. +type EmulatorPaths struct { + assets string + cores string + games string + save string +} + +// GetEmulatorMock returns a properly stubbed emulator instance. +// Due to extensive use of globals -- one mock instance is allowed per a test run. +// Don't forget to init one image channel consumer, it will lock-out otherwise. +// Make sure you call Shutdown(). +func GetEmulatorMock(room string, system string) *EmulatorMock { + rootPath := getRootPath() + + var conf config.WorkerConfig + if _, err := config.LoadConfig(&conf, ""); err != nil { + panic(err) + } + + meta := conf.Emulator.GetLibretroCoreConfig(system) + + nano := nanoarch.NewNano(cleanPath(conf.Emulator.LocalPath)) + + l := logger.Default() + l2 := l.Extend(l.Level(logger.ErrorLevel).With()) + nano.SetLogger(l2) + + // an emu + emu := &EmulatorMock{ + Frontend: &Frontend{ + conf: conf.Emulator, + storage: &StateStorage{ + Path: os.TempDir(), + MainSave: room, + }, + input: NewGameSessionInput(), + done: make(chan struct{}), + th: conf.Emulator.Threads, + log: l2, + SaveOnClose: false, + }, + + core: path.Base(meta.Lib), + + paths: EmulatorPaths{ + assets: cleanPath(rootPath), + cores: cleanPath(rootPath + "assets/cores/"), + games: cleanPath(rootPath + "assets/games/"), + }, + } + emu.linkNano(nano) + + emu.paths.save = cleanPath(emu.HashPath()) + + return emu +} + +// GetDefaultFrontend returns initialized emulator mock with default params. +// Spawns audio/image channels consumers. +// Don't forget to close emulator mock with Shutdown(). +func GetDefaultFrontend(room string, system string, rom string) *EmulatorMock { + mock := GetEmulatorMock(room, system) + mock.loadRom(rom) + mock.SetVideoCb(func(app.Video) {}) + mock.SetAudioCb(func(app.Audio) {}) + return mock +} + +// loadRom loads a ROM into the emulator. +// The rom will be loaded from emulators' games path. +func (emu *EmulatorMock) loadRom(game string) { + fmt.Printf("%v %v\n", emu.paths.cores, emu.core) + emu.nano.CoreLoad(nanoarch.Metadata{LibPath: emu.paths.cores + emu.core}) + err := emu.nano.LoadGame(emu.paths.games + game) + if err != nil { + log.Fatal(err) + } + w, h := emu.FrameSize() + if emu.conf.Scale == 0 { + emu.conf.Scale = 1 + } + emu.SetViewport(w, h, emu.conf.Scale) +} + +// Shutdown closes the emulator and cleans its resources. +func (emu *EmulatorMock) Shutdown() { + _ = os.Remove(emu.HashPath()) + _ = os.Remove(emu.SRAMPath()) + + emu.Frontend.Close() + emu.Frontend.Shutdown() +} + +// dumpState returns the current emulator state and +// the latest saved state for its session. +// Locks the emulator. +func (emu *EmulatorMock) dumpState() (string, string) { + emu.mu.Lock() + bytes, _ := os.ReadFile(emu.paths.save) + persistedStateHash := getHash(bytes) + emu.mu.Unlock() + + stateHash := emu.getStateHash() + fmt.Printf("mem: %v, dat: %v\n", stateHash, persistedStateHash) + return stateHash, persistedStateHash +} + +// getStateHash returns the current emulator state hash. +// Locks the emulator. +func (emu *EmulatorMock) getStateHash() string { + emu.mu.Lock() + state, _ := nanoarch.SaveState() + emu.mu.Unlock() + + return getHash(state) +} + +// getRootPath returns absolute path to the root directory. +func getRootPath() string { + p, _ := filepath.Abs("../../../../") + return p + string(filepath.Separator) +} + +// getHash returns MD5 hash. +func getHash(bytes []byte) string { return fmt.Sprintf("%x", md5.Sum(bytes)) } + +// cleanPath returns a proper file path for current OS. +func cleanPath(path string) string { return filepath.FromSlash(path) } + +// benchmarkEmulator is a generic function for +// measuring emulator performance for one emulation frame. +func benchmarkEmulator(system string, rom string, b *testing.B) { + b.StopTimer() + log.SetOutput(io.Discard) + os.Stdout, _ = os.Open(os.DevNull) + + s := GetDefaultFrontend("bench_"+system+"_performance", system, rom) + + b.StartTimer() + for i := 0; i < b.N; i++ { + s.nano.Run() + } + s.Shutdown() +} + +func BenchmarkEmulatorGba(b *testing.B) { + benchmarkEmulator("gba", "Sushi The Cat.gba", b) +} + +func BenchmarkEmulatorNes(b *testing.B) { + benchmarkEmulator("nes", "Alwa's Awakening (Demo).nes", b) +} + +func TestSwap(t *testing.T) { + data := []byte{1, 254, 255, 32} + pixel := *(*uint32)(unsafe.Pointer(&data[0])) + // 0 1 2 3 + // 2 1 0 3 + ll := ((pixel >> 16) & 0xff) | (pixel & 0xff00) | ((pixel << 16) & 0xff0000) | 0xff000000 + + rez := []byte{0, 0, 0, 0} + *(*uint32)(unsafe.Pointer(&rez[0])) = ll + + log.Printf("%v\n%v", data, rez) +} + +// Tests a successful emulator state save. +func TestSave(t *testing.T) { + tests := []testRun{ + { + room: "test_save_ok_00", + system: "gba", + rom: "Sushi The Cat.gba", + emulationTicks: 100, + }, + { + room: "test_save_ok_01", + system: "gba", + rom: "anguna.gba", + emulationTicks: 10, + }, + } + + for _, test := range tests { + t.Logf("Testing [%v] save with [%v]\n", test.system, test.rom) + + front := GetDefaultFrontend(test.room, test.system, test.rom) + + for test.emulationTicks > 0 { + front.Tick() + test.emulationTicks-- + } + + fmt.Printf("[%-14v] ", "before save") + _, _ = front.dumpState() + if err := front.Save(); err != nil { + t.Errorf("Save fail %v", err) + } + fmt.Printf("[%-14v] ", "after save") + snapshot1, snapshot2 := front.dumpState() + + if snapshot1 != snapshot2 { + t.Errorf("It seems rom state save has failed: %v != %v", snapshot1, snapshot2) + } + + front.Shutdown() + } +} + +// Tests save and restore function: +// +// Emulate n ticks. +// Call save (a). +// Emulate n ticks again. +// Call load from the save (b). +// Compare states (a) and (b), should be =. +func TestLoad(t *testing.T) { + tests := []testRun{ + { + room: "test_load_00", + system: "nes", + rom: "Alwa's Awakening (Demo).nes", + emulationTicks: 100, + }, + { + room: "test_load_01", + system: "gba", + rom: "Sushi The Cat.gba", + emulationTicks: 1000, + }, + { + room: "test_load_02", + system: "gba", + rom: "anguna.gba", + emulationTicks: 100, + }, + } + + for _, test := range tests { + t.Logf("Testing [%v] load with [%v]\n", test.system, test.rom) + + mock := GetDefaultFrontend(test.room, test.system, test.rom) + + fmt.Printf("[%-14v] ", "initial") + mock.dumpState() + + for ticks := test.emulationTicks; ticks > 0; ticks-- { + mock.Tick() + } + fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.emulationTicks)) + mock.dumpState() + + if err := mock.Save(); err != nil { + t.Errorf("Save fail %v", err) + } + fmt.Printf("[%-14v] ", "saved") + snapshot1, _ := mock.dumpState() + + for ticks := test.emulationTicks; ticks > 0; ticks-- { + mock.Tick() + } + fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.emulationTicks)) + mock.dumpState() + + if err := mock.Load(); err != nil { + t.Errorf("Load fail %v", err) + } + fmt.Printf("[%-14v] ", "restored") + snapshot2, _ := mock.dumpState() + + if snapshot1 != snapshot2 { + t.Errorf("It seems rom state restore has failed: %v != %v", snapshot1, snapshot2) + } + + mock.Shutdown() + } +} + +func TestStateConcurrency(t *testing.T) { + tests := []struct { + run testRun + // determine random + seed int + }{ + { + run: testRun{ + room: "test_concurrency_00", + system: "gba", + rom: "Sushi The Cat.gba", + emulationTicks: 120, + }, + seed: 42, + }, + { + run: testRun{ + room: "test_concurrency_01", + system: "gba", + rom: "anguna.gba", + emulationTicks: 300, + }, + seed: 42 + 42, + }, + } + + for _, test := range tests { + t.Logf("Testing [%v] concurrency with [%v]\n", test.run.system, test.run.rom) + + mock := GetEmulatorMock(test.run.room, test.run.system) + + ops := &sync.WaitGroup{} + // quantum lock + qLock := &sync.Mutex{} + + mock.loadRom(test.run.rom) + mock.SetVideoCb(func(v app.Video) { + if len(v.Frame.Pix) == 0 { + t.Errorf("It seems that rom video frame was empty, which is strange!") + } + }) + mock.SetAudioCb(func(app.Audio) {}) + + t.Logf("Random seed is [%v]\n", test.seed) + t.Logf("Save path is [%v]\n", mock.paths.save) + + _ = mock.Save() + + for i := 0; i < test.run.emulationTicks; i++ { + qLock.Lock() + mock.Tick() + qLock.Unlock() + + i := i + if lucky() && !lucky() { + ops.Add(1) + go func() { + qLock.Lock() + defer qLock.Unlock() + + mock.dumpState() + // remove save to reproduce the bug + _ = mock.Save() + _, snapshot1 := mock.dumpState() + _ = mock.Load() + snapshot2, _ := mock.dumpState() + + // Bug or feature? + // When you load a state from the file + // without immediate preceding save, + // it won't be in the loaded state + // even without calling retro_run. + // But if you pause the threads with a debugger + // and run the code step by step, then it will work as expected. + // Possible background emulation? + + if snapshot1 != snapshot2 { + t.Errorf("States are inconsistent %v != %v on tick %v\n", snapshot1, snapshot2, i+1) + } + ops.Done() + }() + } + } + + ops.Wait() + mock.Shutdown() + } +} + +// lucky returns random boolean. +func lucky() bool { return rand.Intn(2) == 1 } + +func TestConcurrentInput(t *testing.T) { + players := NewGameSessionInput() + + events := 1000 + var wg sync.WaitGroup + + wg.Add(events * 2) + + go func() { + for i := 0; i < events; i++ { + player := rand.Intn(maxPort) + go func() { + players.setInput(player, []byte{0, 1}) + wg.Done() + }() + } + }() + + go func() { + for i := 0; i < events; i++ { + player := rand.Intn(maxPort) + go func() { + players.isKeyPressed(uint(player), 100) + wg.Done() + }() + } + }() + + wg.Wait() +} diff --git a/pkg/worker/emulator/graphics/gl/KHR/khrplatform.h b/pkg/worker/caged/libretro/graphics/gl/KHR/khrplatform.h similarity index 100% rename from pkg/worker/emulator/graphics/gl/KHR/khrplatform.h rename to pkg/worker/caged/libretro/graphics/gl/KHR/khrplatform.h diff --git a/pkg/worker/emulator/graphics/gl/gl.go b/pkg/worker/caged/libretro/graphics/gl/gl.go similarity index 100% rename from pkg/worker/emulator/graphics/gl/gl.go rename to pkg/worker/caged/libretro/graphics/gl/gl.go diff --git a/pkg/worker/emulator/graphics/opengl.go b/pkg/worker/caged/libretro/graphics/opengl.go similarity index 92% rename from pkg/worker/emulator/graphics/opengl.go rename to pkg/worker/caged/libretro/graphics/opengl.go index fc9e3ebe..ea8b8c09 100644 --- a/pkg/worker/emulator/graphics/opengl.go +++ b/pkg/worker/caged/libretro/graphics/opengl.go @@ -3,9 +3,10 @@ package graphics import ( "errors" "fmt" + "math" "unsafe" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/graphics/gl" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/graphics/gl" ) type ( @@ -26,6 +27,21 @@ type ( PixelFormat int ) +type Context int + +const ( + CtxNone Context = iota + CtxOpenGl + CtxOpenGlEs2 + CtxOpenGlCore + CtxOpenGlEs3 + CtxOpenGlEsVersion + CtxVulkan + + CtxUnknown = math.MaxInt32 - 1 + CtxDummy = math.MaxInt32 +) + const ( UnsignedShort5551 PixelFormat = iota UnsignedShort565 diff --git a/pkg/worker/emulator/graphics/sdl.go b/pkg/worker/caged/libretro/graphics/sdl.go similarity index 100% rename from pkg/worker/emulator/graphics/sdl.go rename to pkg/worker/caged/libretro/graphics/sdl.go diff --git a/pkg/worker/emulator/image/canvas.go b/pkg/worker/caged/libretro/image/canvas.go similarity index 92% rename from pkg/worker/emulator/image/canvas.go rename to pkg/worker/caged/libretro/image/canvas.go index bb420a1c..c5f321ca 100644 --- a/pkg/worker/emulator/image/canvas.go +++ b/pkg/worker/caged/libretro/image/canvas.go @@ -16,17 +16,12 @@ type Canvas struct { wg sync.WaitGroup } -type Frame struct { - *image.RGBA -} +type Frame struct{ image.RGBA } -func (f *Frame) Opaque() bool { return true } +func (f *Frame) Unwrap() image.RGBA { return f.RGBA } +func (f *Frame) Opaque() bool { return true } func (f *Frame) Copy() Frame { - return Frame{&image.RGBA{ - Pix: append([]uint8{}, f.Pix...), - Stride: f.Stride, - Rect: f.Rect, - }} + return Frame{image.RGBA{Pix: append([]uint8{}, f.Pix...), Stride: f.Stride, Rect: f.Rect}} } const ( @@ -42,10 +37,11 @@ func NewCanvas(w, h, size int) *Canvas { h: h, vertical: h > w, // input is inverted pool: sync.Pool{New: func() any { - return &Frame{&image.RGBA{ + i := Frame{image.RGBA{ Pix: make([]uint8, size<<2), Rect: image.Rectangle{Max: image.Point{X: w, Y: h}}, }} + return &i }}, } } @@ -63,7 +59,7 @@ func (c *Canvas) Get(w, h int) *Frame { } func (c *Canvas) Put(i *Frame) { - if c.enabled && i != nil { + if c.enabled { c.pool.Put(i) } } @@ -96,7 +92,7 @@ func (c *Canvas) Draw(encoding uint32, rot *Rotate, w, h, packedW, bpp int, data ww, hh = c.h, c.w } out := c.Get(ww, hh) - Resize(ScaleNearestNeighbour, dst.RGBA, out.RGBA) + Resize(ScaleNearestNeighbour, &dst.RGBA, &out.RGBA) c.Put(dst) return out } diff --git a/pkg/worker/emulator/image/canvas_test.go b/pkg/worker/caged/libretro/image/canvas_test.go similarity index 100% rename from pkg/worker/emulator/image/canvas_test.go rename to pkg/worker/caged/libretro/image/canvas_test.go diff --git a/pkg/worker/emulator/image/rotation.go b/pkg/worker/caged/libretro/image/rotation.go similarity index 100% rename from pkg/worker/emulator/image/rotation.go rename to pkg/worker/caged/libretro/image/rotation.go diff --git a/pkg/worker/emulator/image/rotation_test.go b/pkg/worker/caged/libretro/image/rotation_test.go similarity index 100% rename from pkg/worker/emulator/image/rotation_test.go rename to pkg/worker/caged/libretro/image/rotation_test.go diff --git a/pkg/worker/emulator/image/scale.go b/pkg/worker/caged/libretro/image/scale.go similarity index 100% rename from pkg/worker/emulator/image/scale.go rename to pkg/worker/caged/libretro/image/scale.go diff --git a/pkg/worker/emulator/libretro/manager/remotehttp/downloader.go b/pkg/worker/caged/libretro/manager/downloader.go similarity index 98% rename from pkg/worker/emulator/libretro/manager/remotehttp/downloader.go rename to pkg/worker/caged/libretro/manager/downloader.go index 914108f6..d3e97409 100644 --- a/pkg/worker/emulator/libretro/manager/remotehttp/downloader.go +++ b/pkg/worker/caged/libretro/manager/downloader.go @@ -1,4 +1,4 @@ -package remotehttp +package manager import ( "os" diff --git a/pkg/worker/emulator/libretro/manager/remotehttp/grab.go b/pkg/worker/caged/libretro/manager/grab.go similarity index 98% rename from pkg/worker/emulator/libretro/manager/remotehttp/grab.go rename to pkg/worker/caged/libretro/manager/grab.go index 5ef161ea..a2ece967 100644 --- a/pkg/worker/emulator/libretro/manager/remotehttp/grab.go +++ b/pkg/worker/caged/libretro/manager/grab.go @@ -1,4 +1,4 @@ -package remotehttp +package manager import ( "crypto/tls" diff --git a/pkg/worker/emulator/libretro/manager/remotehttp/manager.go b/pkg/worker/caged/libretro/manager/http.go similarity index 89% rename from pkg/worker/emulator/libretro/manager/remotehttp/manager.go rename to pkg/worker/caged/libretro/manager/http.go index aba54880..8609314e 100644 --- a/pkg/worker/emulator/libretro/manager/remotehttp/manager.go +++ b/pkg/worker/caged/libretro/manager/http.go @@ -1,20 +1,19 @@ -package remotehttp +package manager import ( "os" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/manager" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/repo" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" "github.com/gofrs/flock" ) type Manager struct { - manager.BasicManager + BasicManager - arch libretro.ArchInfo + arch arch.Info repo repo.Repository altRepo repo.Repository client Downloader @@ -32,14 +31,14 @@ func NewRemoteHttpManager(conf config.LibretroConfig, log *logger.Logger) Manage } log.Debug().Msgf("Using .lock file: %v", fileLock) - arch, err := libretro.GetCoreExt() + ar, err := arch.Guess() if err != nil { log.Error().Err(err).Msg("couldn't get Libretro core file extension") } m := Manager{ - BasicManager: manager.BasicManager{Conf: conf}, - arch: arch, + BasicManager: BasicManager{Conf: conf}, + arch: ar, client: NewDefaultDownloader(log), fmu: flock.New(fileLock), log: log, @@ -77,7 +76,7 @@ func (m *Manager) Sync() error { m.fmu.Lock() defer m.fmu.Unlock() - installed, err := m.GetInstalled() + installed, err := m.GetInstalled(m.arch.LibExt) if err != nil { return err } diff --git a/pkg/worker/emulator/libretro/manager/remotehttp/manager_test.go b/pkg/worker/caged/libretro/manager/http_test.go similarity index 98% rename from pkg/worker/emulator/libretro/manager/remotehttp/manager_test.go rename to pkg/worker/caged/libretro/manager/http_test.go index 02b955fa..5d447d9c 100644 --- a/pkg/worker/emulator/libretro/manager/remotehttp/manager_test.go +++ b/pkg/worker/caged/libretro/manager/http_test.go @@ -1,4 +1,4 @@ -package remotehttp +package manager import ( "reflect" diff --git a/pkg/worker/emulator/libretro/manager/manager.go b/pkg/worker/caged/libretro/manager/manager.go similarity index 56% rename from pkg/worker/emulator/libretro/manager/manager.go rename to pkg/worker/caged/libretro/manager/manager.go index 7b01d551..9ccfa022 100644 --- a/pkg/worker/emulator/libretro/manager/manager.go +++ b/pkg/worker/caged/libretro/manager/manager.go @@ -6,24 +6,17 @@ import ( "strings" "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" ) -type Manager interface { - Sync() error -} - type BasicManager struct { Conf config.LibretroConfig } -func (m BasicManager) GetInstalled() (installed []config.CoreInfo, err error) { - dir := m.Conf.GetCoresStorePath() - arch, err := libretro.GetCoreExt() - if err != nil { +func (m BasicManager) GetInstalled(libExt string) (installed []config.CoreInfo, err error) { + if libExt == "" { return } - + dir := m.Conf.GetCoresStorePath() files, err := os.ReadDir(dir) if err != nil { return @@ -31,8 +24,8 @@ func (m BasicManager) GetInstalled() (installed []config.CoreInfo, err error) { for _, file := range files { name := file.Name() - if filepath.Ext(name) == arch.LibExt { - installed = append(installed, config.CoreInfo{Name: strings.TrimSuffix(name, arch.LibExt)}) + if filepath.Ext(name) == libExt { + installed = append(installed, config.CoreInfo{Name: strings.TrimSuffix(name, libExt)}) } } return diff --git a/pkg/worker/emulator/libretro/libretro.h b/pkg/worker/caged/libretro/nanoarch/libretro.h similarity index 100% rename from pkg/worker/emulator/libretro/libretro.h rename to pkg/worker/caged/libretro/nanoarch/libretro.h diff --git a/pkg/worker/emulator/libretro/loader.go b/pkg/worker/caged/libretro/nanoarch/loader.go similarity index 98% rename from pkg/worker/emulator/libretro/loader.go rename to pkg/worker/caged/libretro/nanoarch/loader.go index f715bce1..274a1a8d 100644 --- a/pkg/worker/emulator/libretro/loader.go +++ b/pkg/worker/caged/libretro/nanoarch/loader.go @@ -1,4 +1,4 @@ -package libretro +package nanoarch import ( "errors" diff --git a/pkg/worker/emulator/libretro/nanoarch.c b/pkg/worker/caged/libretro/nanoarch/nanoarch.c similarity index 100% rename from pkg/worker/emulator/libretro/nanoarch.c rename to pkg/worker/caged/libretro/nanoarch/nanoarch.c diff --git a/pkg/worker/emulator/libretro/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go similarity index 57% rename from pkg/worker/emulator/libretro/nanoarch.go rename to pkg/worker/caged/libretro/nanoarch/nanoarch.go index bd49255b..d75f2c96 100644 --- a/pkg/worker/emulator/libretro/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -1,20 +1,19 @@ -package libretro +package nanoarch import ( "errors" "fmt" "os" - "os/user" "runtime" "strings" - "sync" + "sync/atomic" "time" "unsafe" "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/graphics" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/image" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/graphics" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/image" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" "github.com/giongto35/cloud-game/v3/pkg/worker/thread" ) @@ -29,466 +28,143 @@ import "C" const lastKey = int(C.RETRO_DEVICE_ID_JOYPAD_R3) -type ( - nanoarch struct { - options *map[string]string - v video - multitap multitap - rot *image.Rotate - sysInfo C.struct_retro_system_info - sysAvInfo C.struct_retro_system_av_info - reserved chan struct{} // limits concurrent use - serializeSize C.size_t - } - video struct { - pixFmt uint32 - bpp uint - hw *C.struct_retro_hw_render_callback - isGl bool - autoGlContext bool - } - multitap struct { +const KeyPressed = 1 +const KeyReleased = 0 + +const MaxPort int = 4 + +type Nanoarch struct { + Handlers + LastFrameTime int64 + LibCo bool + multitap struct { supported bool enabled bool value C.unsigned } - // defines any memory state of the emulator - state []byte - mem struct { - ptr unsafe.Pointer - size uint - } -) - -// Global link for C callbacks to Go -var nano = nanoarch{ - // this thing forbids concurrent use of the emulator - reserved: make(chan struct{}, 1), -} - -var ( - frontend *Frontend - lastFrameTime int64 - libretroLogger = logger.Default() - sdlCtx *graphics.SDL - usesLibCo bool - hasVFR bool + options *map[string]string + reserved chan struct{} // limits concurrent use + Rot *image.Rotate + serializeSize C.size_t + stopped atomic.Bool + sysAvInfo C.struct_retro_system_av_info + sysInfo C.struct_retro_system_info tickTime int64 cSaveDirectory *C.char cSystemDirectory *C.char cUserName *C.char - + Video struct { + gl struct { + enabled bool + autoCtx bool + } + BPP uint + hw *C.struct_retro_hw_render_callback + PixFmt uint32 + } + vfr bool + sdlCtx *graphics.SDL hackSkipHwContextDestroy bool - - initOnce sync.Once -) - -const rawAudioBuffer = 4096 // 4K -var ( - audioCopyPool sync.Pool - audioPool sync.Pool - videoPool sync.Pool -) - -const ( - CallSerialize = 1 - CallUnserialize = 2 -) - -func init() { - nano.reserved <- struct{}{} - usr, err := user.Current() - if err == nil { - cUserName = C.CString(usr.Name) - } else { - cUserName = C.CString("retro") - } + log *logger.Logger } -func Init(localPath string) { - initOnce.Do(func() { - cSaveDirectory = C.CString(localPath + string(os.PathSeparator) + "legacy_save") - cSystemDirectory = C.CString(localPath + string(os.PathSeparator) + "system") - }) +type Handlers struct { + OnDpad func(port uint, axis uint) (shift int16) + OnKeyPress func(port uint, key int) int + OnAudio func(ptr unsafe.Pointer, frames int) + OnVideo func(data []byte, delta int32, fi FrameInfo) } -//export coreVideoRefresh -func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { - if frontend.stopped.Load() { - libretroLogger.Warn().Msgf(">>> skip video") - return - } - - // some frames can be rendered slower or faster than internal 1/fps core tick - // so track actual frame render time for proper RTP packet timestamps - // (and proper frame display time, for example: 1->1/60=16.6ms, 2->10ms, 3->23ms, 4->16.6ms) - // this is useful only for cores with variable framerate, for the fixed framerate cores this adds stutter - // !to find docs on Libretro refresh sync and frame times - t := time.Now().UnixNano() - dt := tickTime - // override frame rendering with dynamic frame times - if hasVFR { - dt = t - lastFrameTime - } - lastFrameTime = t - - // some cores can return nothing - // !to add duplicate if can dup - if data == nil { - return - } - - // calculate real frame width in pixels from packed data (realWidth >= width) - // some cores or games output zero pitch, i.e. N64 Mupen - if packed == 0 { - packed = width * nano.v.bpp - } - // calculate space for the video frame - bytes := packed * height - - var data_ []byte - if data != C.RETRO_HW_FRAME_BUFFER_VALID { - data_ = unsafe.Slice((*byte)(data), bytes) - } else { - // if Libretro renders frame with OpenGL context - data_ = graphics.ReadFramebuffer(bytes, width, height) - } - - // some cores or games have a variable output frame size, i.e. PSX Rearmed - // also we have an option of xN output frame magnification - // so, it may be rescaled - - fr, _ := videoPool.Get().(*emulator.GameFrame) - if fr == nil { - fr = &emulator.GameFrame{} - } - // !to fix possible nil pointer dereference - // when the internal pool can be nil during first Get??? - fr.Data = frontend.Canvas. - Draw(nano.v.pixFmt, nano.rot, int(width), int(height), int(packed), int(nano.v.bpp), data_, frontend.th) - fr.Duration = time.Duration(dt) - frontend.onVideo(fr) - frontend.Canvas.Put(fr.Data) - videoPool.Put(fr) +type FrameInfo struct { + W uint + H uint + Packed uint } -//export coreInputPoll -func coreInputPoll() {} - -//export coreInputState -func coreInputState(port C.unsigned, device C.unsigned, index C.unsigned, id C.unsigned) C.int16_t { - if port >= maxPort { - return KeyReleased - } - - if device == C.RETRO_DEVICE_ANALOG { - if index > C.RETRO_DEVICE_INDEX_ANALOG_RIGHT || id > C.RETRO_DEVICE_ID_ANALOG_Y { - return 0 - } - axis := index*2 + id - value := frontend.input.isDpadTouched(uint(port), uint(axis)) - if value != 0 { - return (C.int16_t)(value) - } - } - - key := int(id) - if key > lastKey || index > 0 || device != C.RETRO_DEVICE_JOYPAD { - return KeyReleased - } - if frontend.input.isKeyPressed(uint(port), key) == KeyPressed { - return KeyPressed - } - return KeyReleased +type Metadata struct { + LibPath string // the full path to some emulator lib + AudioSampleRate int + Fps float64 + BaseWidth int + BaseHeight int + Rotation image.Rotate + IsGlAllowed bool + UsesLibCo bool + AutoGlContext bool + HasMultitap bool + HasVFR bool + Options map[string]string + Hacks []string } -func audioWrite(buf unsafe.Pointer, frames C.size_t) C.size_t { - if frontend.stopped.Load() { - libretroLogger.Warn().Msgf(">>> skip %v audio frames", frames) - return frames - } - - samples := int(frames) << 1 - src := unsafe.Slice((*int16)(buf), samples) - dst, _ := audioCopyPool.Get().(*[]int16) - if dst == nil { - x := make([]int16, rawAudioBuffer) - dst = &x - } - xx := (*dst)[:samples] - copy(xx, src) - - // 1600 = x / 1000 * 48000 * 2 - estimate := float64(samples) / float64(int(nano.sysAvInfo.timing.sample_rate)<<1) * 1000000000 - - fr, _ := audioPool.Get().(*emulator.GameAudio) - if fr == nil { - fr = &emulator.GameAudio{} - } - fr.Data = &xx - fr.Duration = time.Duration(estimate) // used in recordings - frontend.onAudio(fr) - audioPool.Put(fr) - audioCopyPool.Put(dst) - - return frames +// Nan0 is a global link for C callbacks to Go +var Nan0 = Nanoarch{ + reserved: make(chan struct{}, 1), // this thing forbids concurrent use of the emulator + stopped: atomic.Bool{}, + Handlers: Handlers{ + OnDpad: func(uint, uint) int16 { return 0 }, + OnKeyPress: func(uint, int) int { return 0 }, + OnAudio: func(unsafe.Pointer, int) {}, + OnVideo: func([]byte, int32, FrameInfo) {}, + }, } -//export coreAudioSample -func coreAudioSample(left C.int16_t, right C.int16_t) { - buf := []C.int16_t{left, right} - audioWrite(unsafe.Pointer(&buf), 1) +// init provides a global single instance lock +// !to remove when isolated properly +func init() { Nan0.reserved <- struct{}{} } + +func NewNano(localPath string) *Nanoarch { + nano := &Nan0 + nano.cSaveDirectory = C.CString(localPath + string(os.PathSeparator) + "legacy_save") + nano.cSystemDirectory = C.CString(localPath + string(os.PathSeparator) + "system") + nano.cUserName = C.CString("retro") + + return nano } -//export coreAudioSampleBatch -func coreAudioSampleBatch(data unsafe.Pointer, frames C.size_t) C.size_t { - return audioWrite(data, frames) +func (n *Nanoarch) AudioSampleRate() int { return int(n.sysAvInfo.timing.sample_rate) } +func (n *Nanoarch) VideoFramerate() int { return int(n.sysAvInfo.timing.fps) } +func (n *Nanoarch) IsPortrait() bool { return n.Rot != nil && n.Rot.IsEven } +func (n *Nanoarch) GeometryBase() (int, int) { + return int(n.sysAvInfo.geometry.base_width), int(n.sysAvInfo.geometry.base_height) } - -func m(m *C.char) string { return strings.TrimRight(C.GoString(m), "\n") } - -//export coreLog -func coreLog(level C.enum_retro_log_level, msg *C.char) { - switch level { - // with debug level cores have too much logs - case C.RETRO_LOG_DEBUG: - libretroLogger.Debug().MsgFunc(func() string { return m(msg) }) - case C.RETRO_LOG_INFO: - libretroLogger.Info().MsgFunc(func() string { return m(msg) }) - case C.RETRO_LOG_WARN: - libretroLogger.Warn().MsgFunc(func() string { return m(msg) }) - case C.RETRO_LOG_ERROR: - libretroLogger.Error().MsgFunc(func() string { return m(msg) }) - default: - libretroLogger.Log().MsgFunc(func() string { return m(msg) }) - // RETRO_LOG_DUMMY = INT_MAX - } +func (n *Nanoarch) GeometryMax() (int, int) { + return int(n.sysAvInfo.geometry.max_width), int(n.sysAvInfo.geometry.max_height) } +func (n *Nanoarch) WaitReady() { <-n.reserved } +func (n *Nanoarch) Close() { n.stopped.Store(true); n.reserved <- struct{}{} } +func (n *Nanoarch) SetLogger(log *logger.Logger) { n.log = log } -//export coreGetCurrentFramebuffer -func coreGetCurrentFramebuffer() C.uintptr_t { return (C.uintptr_t)(graphics.GetGlFbo()) } - -//export coreGetProcAddress -func coreGetProcAddress(sym *C.char) C.retro_proc_address_t { - return (C.retro_proc_address_t)(graphics.GetGlProcAddress(C.GoString(sym))) -} - -//export coreEnvironment -func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { - // spammy - switch cmd { - case C.RETRO_ENVIRONMENT_GET_VARIABLE_UPDATE: - return false - case C.RETRO_ENVIRONMENT_GET_AUDIO_VIDEO_ENABLE: - return false - } - - switch cmd { - case C.RETRO_ENVIRONMENT_SET_ROTATION: - setRotation(*(*uint)(data) % 4) - return true - case C.RETRO_ENVIRONMENT_GET_CAN_DUPE: - *(*C.bool)(data) = C.bool(true) - return true - case C.RETRO_ENVIRONMENT_GET_USERNAME: - *(**C.char)(data) = cUserName - return true - case C.RETRO_ENVIRONMENT_GET_LOG_INTERFACE: - cb := (*C.struct_retro_log_callback)(data) - cb.log = (C.retro_log_printf_t)(C.core_log_cgo) - return true - case C.RETRO_ENVIRONMENT_SET_PIXEL_FORMAT: - res, err := videoSetPixelFormat(*(*C.enum_retro_pixel_format)(data)) - if err != nil { - libretroLogger.Fatal().Err(err).Msg("pix format failed") - } - return res - case C.RETRO_ENVIRONMENT_GET_SYSTEM_DIRECTORY: - *(**C.char)(data) = cSystemDirectory - return true - case C.RETRO_ENVIRONMENT_GET_SAVE_DIRECTORY: - *(**C.char)(data) = cSaveDirectory - return true - case C.RETRO_ENVIRONMENT_SET_MESSAGE: - // only with the Libretro debug mode - if libretroLogger.GetLevel() < logger.InfoLevel { - message := (*C.struct_retro_message)(data) - msg := C.GoString(message.msg) - libretroLogger.Debug().Msgf("message: %v", msg) - return true - } - return false - case C.RETRO_ENVIRONMENT_SHUTDOWN: - //window.SetShouldClose(true) - return false - case C.RETRO_ENVIRONMENT_GET_VARIABLE: - if (*nano.options) == nil { - return false - } - rv := (*C.struct_retro_variable)(data) - key := C.GoString(rv.key) - if v, ok := (*nano.options)[key]; ok { - // make Go strings null-terminated copies ;_; - (*nano.options)[key] = v + "\x00" - // cast to C string and set the value - // we hope the string won't be collected while C needs it - rv.value = (*C.char)(unsafe.Pointer(unsafe.StringData((*nano.options)[key]))) - libretroLogger.Debug().Msgf("Set %s=%v", key, v) - return true - } - return false - case C.RETRO_ENVIRONMENT_SET_HW_RENDER: - if nano.v.isGl { - nano.v.hw = (*C.struct_retro_hw_render_callback)(data) - nano.v.hw.get_current_framebuffer = (C.retro_hw_get_current_framebuffer_t)(C.core_get_current_framebuffer_cgo) - nano.v.hw.get_proc_address = (C.retro_hw_get_proc_address_t)(C.core_get_proc_address_cgo) - return true - } - return false - case C.RETRO_ENVIRONMENT_SET_CONTROLLER_INFO: - // !to rewrite - if !nano.multitap.supported { - return false - } - info := (*[100]C.struct_retro_controller_info)(data) - var i C.unsigned - for i = 0; unsafe.Pointer(info[i].types) != nil; i++ { - var j C.unsigned - types := (*[100]C.struct_retro_controller_description)(unsafe.Pointer(info[i].types)) - for j = 0; j < info[i].num_types; j++ { - if C.GoString(types[j].desc) == "Multitap" { - nano.multitap.value = types[j].id - return true - } - } - } - return false - case C.RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB: - C.bridge_clear_all_thread_waits_cb(data) - return true - case C.RETRO_ENVIRONMENT_GET_SAVESTATE_CONTEXT: - if ctx := (*C.int)(data); ctx != nil { - *ctx = C.RETRO_SAVESTATE_CONTEXT_NORMAL - } - return true - } - return false -} - -//export initVideo -func initVideo() { - var context graphics.Context - switch nano.v.hw.context_type { - case C.RETRO_HW_CONTEXT_NONE: - context = graphics.CtxNone - case C.RETRO_HW_CONTEXT_OPENGL: - context = graphics.CtxOpenGl - case C.RETRO_HW_CONTEXT_OPENGLES2: - context = graphics.CtxOpenGlEs2 - case C.RETRO_HW_CONTEXT_OPENGL_CORE: - context = graphics.CtxOpenGlCore - case C.RETRO_HW_CONTEXT_OPENGLES3: - context = graphics.CtxOpenGlEs3 - case C.RETRO_HW_CONTEXT_OPENGLES_VERSION: - context = graphics.CtxOpenGlEsVersion - case C.RETRO_HW_CONTEXT_VULKAN: - context = graphics.CtxVulkan - case C.RETRO_HW_CONTEXT_DUMMY: - context = graphics.CtxDummy - default: - context = graphics.CtxUnknown - } - - sdl, err := graphics.NewSDLContext(graphics.Config{ - Ctx: context, - W: int(nano.sysAvInfo.geometry.max_width), - H: int(nano.sysAvInfo.geometry.max_height), - GLAutoContext: nano.v.autoGlContext, - GLVersionMajor: uint(nano.v.hw.version_major), - GLVersionMinor: uint(nano.v.hw.version_minor), - GLHasDepth: bool(nano.v.hw.depth), - GLHasStencil: bool(nano.v.hw.stencil), - }, libretroLogger) - if err != nil { - panic(err) - } - sdlCtx = sdl - - C.bridge_context_reset(nano.v.hw.context_reset) - if libretroLogger.GetLevel() < logger.InfoLevel { - printOpenGLDriverInfo() - } -} - -//export deinitVideo -func deinitVideo() { - if !hackSkipHwContextDestroy { - C.bridge_context_reset(nano.v.hw.context_destroy) - } - if err := sdlCtx.Deinit(); err != nil { - libretroLogger.Error().Err(err).Msg("deinit fail") - } - nano.v.isGl = false - nano.v.autoGlContext = false - hackSkipHwContextDestroy = false -} - -var ( - //retroAPIVersion unsafe.Pointer - retroDeinit unsafe.Pointer - retroGetSystemAVInfo unsafe.Pointer - retroGetSystemInfo unsafe.Pointer - coreLib unsafe.Pointer - retroInit unsafe.Pointer - retroLoadGame unsafe.Pointer - retroRun unsafe.Pointer - retroSetAudioSample unsafe.Pointer - retroSetAudioSampleBatch unsafe.Pointer - retroSetControllerPortDevice unsafe.Pointer - retroSetEnvironment unsafe.Pointer - retroSetInputPoll unsafe.Pointer - retroSetInputState unsafe.Pointer - retroSetVideoRefresh unsafe.Pointer - retroUnloadGame unsafe.Pointer - retroGetMemoryData unsafe.Pointer - retroGetMemorySize unsafe.Pointer - retroSerialize unsafe.Pointer - retroSerializeSize unsafe.Pointer - retroUnserialize unsafe.Pointer -) - -func SetLibretroLogger(log *logger.Logger) { libretroLogger = log } - -func coreLoad(meta emulator.Metadata) { +func (n *Nanoarch) CoreLoad(meta Metadata) { var err error - nano.v.isGl = meta.IsGlAllowed - usesLibCo = meta.UsesLibCo - nano.v.autoGlContext = meta.AutoGlContext - hasVFR = meta.HasVFR + n.LibCo = meta.UsesLibCo + n.vfr = meta.HasVFR + n.Video.gl.autoCtx = meta.AutoGlContext + n.Video.gl.enabled = meta.IsGlAllowed // hacks - hackSkipHwContextDestroy = meta.HasHack("skip_hw_context_destroy") + Nan0.hackSkipHwContextDestroy = meta.HasHack("skip_hw_context_destroy") - nano.options = &meta.Options + n.options = &meta.Options - nano.multitap.supported = meta.HasMultitap - nano.multitap.enabled = false - nano.multitap.value = 0 + n.multitap.supported = meta.HasMultitap + n.multitap.enabled = false + n.multitap.value = 0 filePath := meta.LibPath - if arch, err := GetCoreExt(); err == nil { - filePath = filePath + arch.LibExt + if ar, err := arch.Guess(); err == nil { + filePath = filePath + ar.LibExt } else { - libretroLogger.Warn().Err(err).Msg("system arch guesser failed") + n.log.Warn().Err(err).Msg("system arch guesser failed") } coreLib, err = loadLib(filePath) // fallback to sequential lib loader (first successfully loaded) if err != nil { - libretroLogger.Error().Err(err).Msgf("load fail: %v", filePath) + n.log.Error().Err(err).Msgf("load fail: %v", filePath) coreLib, err = loadLibRollingRollingRolling(filePath) if err != nil { - libretroLogger.Fatal().Err(err).Msgf("core load: %s", filePath) + n.log.Fatal().Err(err).Msgf("core load: %s", filePath) } } @@ -520,31 +196,32 @@ func coreLoad(meta emulator.Metadata) { C.bridge_retro_set_audio_sample(retroSetAudioSample, C.core_audio_sample_cgo) C.bridge_retro_set_audio_sample_batch(retroSetAudioSampleBatch, C.core_audio_sample_batch_cgo) - if usesLibCo { + if n.LibCo { C.same_thread(retroInit) } else { C.bridge_retro_init(retroInit) } - C.bridge_retro_get_system_info(retroGetSystemInfo, &nano.sysInfo) - libretroLogger.Debug().Msgf("System >>> %s (%s) [%s] nfp: %v", - C.GoString(nano.sysInfo.library_name), C.GoString(nano.sysInfo.library_version), - C.GoString(nano.sysInfo.valid_extensions), bool(nano.sysInfo.need_fullpath)) + C.bridge_retro_get_system_info(retroGetSystemInfo, &n.sysInfo) + n.log.Debug().Msgf("System >>> %s (%s) [%s] nfp: %v", + C.GoString(n.sysInfo.library_name), C.GoString(n.sysInfo.library_version), + C.GoString(n.sysInfo.valid_extensions), bool(n.sysInfo.need_fullpath)) } -func LoadGame(path string) error { +func (n *Nanoarch) LoadGame(path string) error { fi, err := os.Stat(path) if err != nil { return err } fileSize := fi.Size() - libretroLogger.Debug().Msgf("ROM size: %v", byteCountBinary(fileSize)) + + n.log.Debug().Msgf("ROM size: %v", byteCountBinary(fileSize)) fPath := C.CString(path) defer C.free(unsafe.Pointer(fPath)) gi := C.struct_retro_game_info{path: fPath, size: C.size_t(fileSize)} - if !bool(nano.sysInfo.need_fullpath) { + if !bool(n.sysInfo.need_fullpath) { bytes, err := os.ReadFile(path) if err != nil { return err @@ -558,28 +235,30 @@ func LoadGame(path string) error { return fmt.Errorf("core failed to load ROM: %v", path) } - C.bridge_retro_get_system_av_info(retroGetSystemAVInfo, &nano.sysAvInfo) - libretroLogger.Info().Msgf("System A/V >>> %vx%v (%vx%v), [%vfps], AR [%v], audio [%vHz]", - nano.sysAvInfo.geometry.base_width, nano.sysAvInfo.geometry.base_height, - nano.sysAvInfo.geometry.max_width, nano.sysAvInfo.geometry.max_height, - nano.sysAvInfo.timing.fps, nano.sysAvInfo.geometry.aspect_ratio, nano.sysAvInfo.timing.sample_rate, + C.bridge_retro_get_system_av_info(retroGetSystemAVInfo, &n.sysAvInfo) + n.log.Info().Msgf("System A/V >>> %vx%v (%vx%v), [%vfps], AR [%v], audio [%vHz]", + n.sysAvInfo.geometry.base_width, n.sysAvInfo.geometry.base_height, + n.sysAvInfo.geometry.max_width, n.sysAvInfo.geometry.max_height, + n.sysAvInfo.timing.fps, n.sysAvInfo.geometry.aspect_ratio, n.sysAvInfo.timing.sample_rate, ) - nano.serializeSize = C.bridge_retro_serialize_size(retroSerializeSize) - libretroLogger.Info().Msgf("Save file size: %v", byteCountBinary(int64(nano.serializeSize))) + n.serializeSize = C.bridge_retro_serialize_size(retroSerializeSize) + n.log.Info().Msgf("Save file size: %v", byteCountBinary(int64(n.serializeSize))) - tickTime = int64(time.Second / time.Duration(nano.sysAvInfo.timing.fps)) - if hasVFR { - libretroLogger.Info().Msgf("variable framerate (VFR) is enabled") + Nan0.tickTime = int64(time.Second / time.Duration(n.sysAvInfo.timing.fps)) + if n.vfr { + n.log.Info().Msgf("variable framerate (VFR) is enabled") } - if nano.v.isGl { + n.stopped.Store(false) + + if n.Video.gl.enabled { // flip Y coordinates of OpenGL setRotation(uint(image.Flip180)) - bufS := uint(nano.sysAvInfo.geometry.max_width*nano.sysAvInfo.geometry.max_height) * nano.v.bpp + bufS := uint(n.sysAvInfo.geometry.max_width*n.sysAvInfo.geometry.max_height) * n.Video.BPP graphics.SetBuffer(int(bufS)) - libretroLogger.Info().Msgf("Set buffer: %v", byteCountBinary(int64(bufS))) - if usesLibCo { + n.log.Info().Msgf("Set buffer: %v", byteCountBinary(int64(bufS))) + if n.LibCo { C.same_thread(C.init_video_cgo) } else { runtime.LockOSThread() @@ -589,53 +268,57 @@ func LoadGame(path string) error { } // set default controller types on all ports - for i := 0; i < maxPort; i++ { + for i := 0; i < MaxPort; i++ { C.bridge_retro_set_controller_port_device(retroSetControllerPortDevice, C.uint(i), C.RETRO_DEVICE_JOYPAD) } - lastFrameTime = 0 + n.LastFrameTime = time.Now().UnixNano() return nil } -func toggleMultitap() { - if nano.multitap.supported && nano.multitap.value != 0 { - // Official SNES games only support a single multitap device - // Most require it to be plugged in player 2 port - // And Snes9X requires it to be "plugged" after the game is loaded - // Control this from the browser since player 2 will stop working in some games if multitap is "plugged" in - if nano.multitap.enabled { - C.bridge_retro_set_controller_port_device(retroSetControllerPortDevice, 1, C.RETRO_DEVICE_JOYPAD) - } else { - C.bridge_retro_set_controller_port_device(retroSetControllerPortDevice, 1, nano.multitap.value) - } - nano.multitap.enabled = !nano.multitap.enabled +// ToggleMultitap toggles multitap controller for cores. +// +// Official SNES games only support a single multitap device +// Most require it to be plugged in player 2 port and Snes9X requires it +// to be "plugged" after the game is loaded. +// Control this from the browser since player 2 will stop working in some games +// if multitap is "plugged" in. +func (n *Nanoarch) ToggleMultitap() { + if !n.multitap.supported || n.multitap.value == 0 { + return } + mt := n.multitap.value + if n.multitap.enabled { + mt = C.RETRO_DEVICE_JOYPAD + } + C.bridge_retro_set_controller_port_device(retroSetControllerPortDevice, 1, mt) + n.multitap.enabled = !n.multitap.enabled } -func nanoarchShutdown() { - if usesLibCo { +func (n *Nanoarch) Shutdown() { + if n.LibCo { thread.Main(func() { C.same_thread(retroUnloadGame) C.same_thread(retroDeinit) - if nano.v.isGl { + if n.Video.gl.enabled { C.same_thread(C.deinit_video_cgo) } C.same_thread(C.same_thread_stop) }) } else { - if nano.v.isGl { + if n.Video.gl.enabled { thread.Main(func() { // running inside a go routine, lock the thread to make sure the OpenGL context stays current runtime.LockOSThread() - if err := sdlCtx.BindContext(); err != nil { - libretroLogger.Error().Err(err).Msg("ctx switch fail") + if err := n.sdlCtx.BindContext(); err != nil { + n.log.Error().Err(err).Msg("ctx switch fail") } }) } C.bridge_retro_unload_game(retroUnloadGame) C.bridge_retro_deinit(retroDeinit) - if nano.v.isGl { + if n.Video.gl.enabled { thread.Main(func() { deinitVideo() runtime.UnlockOSThread() @@ -645,51 +328,56 @@ func nanoarchShutdown() { setRotation(0) if err := closeLib(coreLib); err != nil { - libretroLogger.Error().Err(err).Msg("lib close failed") + n.log.Error().Err(err).Msg("lib close failed") } - nano.options = nil + n.options = nil + C.free(unsafe.Pointer(n.cUserName)) + C.free(unsafe.Pointer(n.cSaveDirectory)) + C.free(unsafe.Pointer(n.cSystemDirectory)) } -func run() { - if usesLibCo { +func (n *Nanoarch) Run() { + if n.LibCo { C.same_thread(retroRun) } else { - if nano.v.isGl { + if n.Video.gl.enabled { // running inside a go routine, lock the thread to make sure the OpenGL context stays current runtime.LockOSThread() - if err := sdlCtx.BindContext(); err != nil { - libretroLogger.Error().Err(err).Msg("ctx bind fail") + if err := n.sdlCtx.BindContext(); err != nil { + n.log.Error().Err(err).Msg("ctx bind fail") } } C.bridge_retro_run(retroRun) - if nano.v.isGl { + if n.Video.gl.enabled { runtime.UnlockOSThread() } } } +func (n *Nanoarch) IsStopped() bool { return n.stopped.Load() } + func videoSetPixelFormat(format uint32) (C.bool, error) { switch format { case C.RETRO_PIXEL_FORMAT_0RGB1555: - nano.v.pixFmt = image.BitFormatShort5551 + Nan0.Video.PixFmt = image.BitFormatShort5551 if err := graphics.SetPixelFormat(graphics.UnsignedShort5551); err != nil { - return false, fmt.Errorf("unknown pixel format %v", nano.v.pixFmt) + return false, fmt.Errorf("unknown pixel format %v", Nan0.Video.PixFmt) } - nano.v.bpp = 2 + Nan0.Video.BPP = 2 // format is not implemented return false, fmt.Errorf("unsupported pixel type %v converter", format) case C.RETRO_PIXEL_FORMAT_XRGB8888: - nano.v.pixFmt = image.BitFormatInt8888Rev + Nan0.Video.PixFmt = image.BitFormatInt8888Rev if err := graphics.SetPixelFormat(graphics.UnsignedInt8888Rev); err != nil { - return false, fmt.Errorf("unknown pixel format %v", nano.v.pixFmt) + return false, fmt.Errorf("unknown pixel format %v", Nan0.Video.PixFmt) } - nano.v.bpp = 4 + Nan0.Video.BPP = 4 case C.RETRO_PIXEL_FORMAT_RGB565: - nano.v.pixFmt = image.BitFormatShort565 + Nan0.Video.PixFmt = image.BitFormatShort565 if err := graphics.SetPixelFormat(graphics.UnsignedShort565); err != nil { - return false, fmt.Errorf("unknown pixel format %v", nano.v.pixFmt) + return false, fmt.Errorf("unknown pixel format %v", Nan0.Video.PixFmt) } - nano.v.bpp = 2 + Nan0.Video.BPP = 2 default: return false, fmt.Errorf("unknown pixel type %v", format) } @@ -697,16 +385,16 @@ func videoSetPixelFormat(format uint32) (C.bool, error) { } func setRotation(rotation uint) { - if nano.rot != nil && rotation == uint(nano.rot.Angle) { + if Nan0.Rot != nil && rotation == uint(Nan0.Rot.Angle) { return } if rotation > 0 { r := image.GetRotation(image.Angle(rotation)) - nano.rot = &r + Nan0.Rot = &r } else { - nano.rot = nil + Nan0.Rot = nil } - libretroLogger.Debug().Msgf("Image rotated %v°", map[uint]uint{0: 0, 1: 90, 2: 180, 3: 270}[rotation]) + Nan0.log.Debug().Msgf("Image rotated %v°", map[uint]uint{0: 0, 1: 90, 2: 180, 3: 270}[rotation]) } func printOpenGLDriverInfo() { @@ -719,17 +407,30 @@ func printOpenGLDriverInfo() { // It might even say "Direct3D" if the Windows Direct3D wrapper is being used. openGLInfo.WriteString(fmt.Sprintf("[OpenGL] Renderer: %v\n", graphics.GetGLRendererInfo())) openGLInfo.WriteString(fmt.Sprintf("[OpenGL] GLSL Version: %v", graphics.GetGLSLInfo())) - libretroLogger.Debug().Msg(openGLInfo.String()) + Nan0.log.Debug().Msg(openGLInfo.String()) } -// getSaveState returns emulator internal state. -func getSaveState() (state, error) { - data := make([]byte, uint(nano.serializeSize)) +// State defines any memory state of the emulator +type State []byte + +type mem struct { + ptr unsafe.Pointer + size uint +} + +const ( + CallSerialize = 1 + CallUnserialize = 2 +) + +// SaveState returns emulator internal state. +func SaveState() (State, error) { + data := make([]byte, uint(Nan0.serializeSize)) rez := false - if usesLibCo { - rez = *(*bool)(C.same_thread_with_args2(retroSerialize, C.int(CallSerialize), unsafe.Pointer(&data[0]), unsafe.Pointer(&nano.serializeSize))) + if Nan0.LibCo { + rez = *(*bool)(C.same_thread_with_args2(retroSerialize, C.int(CallSerialize), unsafe.Pointer(&data[0]), unsafe.Pointer(&Nan0.serializeSize))) } else { - rez = bool(C.bridge_retro_serialize(retroSerialize, unsafe.Pointer(&data[0]), nano.serializeSize)) + rez = bool(C.bridge_retro_serialize(retroSerialize, unsafe.Pointer(&data[0]), Nan0.serializeSize)) } if !rez { return nil, errors.New("retro_serialize failed") @@ -737,14 +438,14 @@ func getSaveState() (state, error) { return data, nil } -// restoreSaveState restores emulator internal state. -func restoreSaveState(st state) error { +// RestoreSaveState restores emulator internal state. +func RestoreSaveState(st State) error { if len(st) > 0 { rez := false - if usesLibCo { - rez = *(*bool)(C.same_thread_with_args2(retroUnserialize, C.int(CallUnserialize), unsafe.Pointer(&st[0]), unsafe.Pointer(&nano.serializeSize))) + if Nan0.LibCo { + rez = *(*bool)(C.same_thread_with_args2(retroUnserialize, C.int(CallUnserialize), unsafe.Pointer(&st[0]), unsafe.Pointer(&Nan0.serializeSize))) } else { - rez = bool(C.bridge_retro_unserialize(retroUnserialize, unsafe.Pointer(&st[0]), nano.serializeSize)) + rez = bool(C.bridge_retro_unserialize(retroUnserialize, unsafe.Pointer(&st[0]), Nan0.serializeSize)) } if !rez { return errors.New("retro_unserialize failed") @@ -753,8 +454,8 @@ func restoreSaveState(st state) error { return nil } -// getSaveRAM returns the game save RAM (cartridge) data or a nil slice. -func getSaveRAM() state { +// SaveRAM returns the game save RAM (cartridge) data or a nil slice. +func SaveRAM() State { memory := ptSaveRAM() if memory == nil { return nil @@ -762,8 +463,8 @@ func getSaveRAM() state { return C.GoBytes(memory.ptr, C.int(memory.size)) } -// restoreSaveRAM restores game save RAM. -func restoreSaveRAM(st state) { +// RestoreSaveRAM restores game save RAM. +func RestoreSaveRAM(st State) { if len(st) > 0 { if memory := ptSaveRAM(); memory != nil { copy(unsafe.Slice((*byte)(memory.ptr), memory.size), st) @@ -802,3 +503,321 @@ func byteCountBinary(b int64) string { } return fmt.Sprintf("%.1f %ciB", float64(b)/float64(div), "KMGTPE"[exp]) } + +func (m Metadata) HasHack(h string) bool { + for _, n := range m.Hacks { + if h == n { + return true + } + } + return false +} + +var ( + //retroAPIVersion unsafe.Pointer + retroDeinit unsafe.Pointer + retroGetSystemAVInfo unsafe.Pointer + retroGetSystemInfo unsafe.Pointer + coreLib unsafe.Pointer + retroInit unsafe.Pointer + retroLoadGame unsafe.Pointer + retroRun unsafe.Pointer + retroSetAudioSample unsafe.Pointer + retroSetAudioSampleBatch unsafe.Pointer + retroSetControllerPortDevice unsafe.Pointer + retroSetEnvironment unsafe.Pointer + retroSetInputPoll unsafe.Pointer + retroSetInputState unsafe.Pointer + retroSetVideoRefresh unsafe.Pointer + retroUnloadGame unsafe.Pointer + retroGetMemoryData unsafe.Pointer + retroGetMemorySize unsafe.Pointer + retroSerialize unsafe.Pointer + retroSerializeSize unsafe.Pointer + retroUnserialize unsafe.Pointer +) + +//export coreVideoRefresh +func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { + if Nan0.stopped.Load() { + Nan0.log.Warn().Msgf(">>> skip video") + return + } + + // some frames can be rendered slower or faster than internal 1/fps core tick + // so track actual frame render time for proper RTP packet timestamps + // (and proper frame display time, for example: 1->1/60=16.6ms, 2->10ms, 3->23ms, 4->16.6ms) + // this is useful only for cores with variable framerate, for the fixed framerate cores this adds stutter + // !to find docs on Libretro refresh sync and frame times + t := time.Now().UnixNano() + dt := Nan0.tickTime + // override frame rendering with dynamic frame times + if Nan0.vfr { + dt = t - Nan0.LastFrameTime + } + Nan0.LastFrameTime = t + + // some cores can return nothing + // !to add duplicate if can dup + if data == nil { + return + } + + // calculate real frame width in pixels from packed data (realWidth >= width) + // some cores or games output zero pitch, i.e. N64 Mupen + if packed == 0 { + packed = width * Nan0.Video.BPP + } + // calculate space for the video frame + bytes := packed * height + + var data_ []byte + if data != C.RETRO_HW_FRAME_BUFFER_VALID { + data_ = unsafe.Slice((*byte)(data), bytes) + } else { + // if Libretro renders frame with OpenGL context + data_ = graphics.ReadFramebuffer(bytes, width, height) + } + + // some cores or games have a variable output frame size, i.e. PSX Rearmed + // also we have an option of xN output frame magnification + // so, it may be rescaled + + Nan0.Handlers.OnVideo(data_, int32(dt), FrameInfo{W: width, H: height, Packed: packed}) +} + +//export coreInputPoll +func coreInputPoll() {} + +//export coreInputState +func coreInputState(port C.unsigned, device C.unsigned, index C.unsigned, id C.unsigned) C.int16_t { + if uint(port) >= uint(MaxPort) { + return KeyReleased + } + + if device == C.RETRO_DEVICE_ANALOG { + if index > C.RETRO_DEVICE_INDEX_ANALOG_RIGHT || id > C.RETRO_DEVICE_ID_ANALOG_Y { + return 0 + } + axis := index*2 + id + value := Nan0.Handlers.OnDpad(uint(port), uint(axis)) + if value != 0 { + return (C.int16_t)(value) + } + } + + key := int(id) + if key > lastKey || index > 0 || device != C.RETRO_DEVICE_JOYPAD { + return KeyReleased + } + if Nan0.Handlers.OnKeyPress(uint(port), key) == KeyPressed { + return KeyPressed + } + return KeyReleased +} + +//export coreAudioSample +func coreAudioSample(l, r C.int16_t) { + frame := []C.int16_t{l, r} + coreAudioSampleBatch(unsafe.Pointer(&frame), 1) +} + +//export coreAudioSampleBatch +func coreAudioSampleBatch(data unsafe.Pointer, frames C.size_t) C.size_t { + if Nan0.stopped.Load() { + if Nan0.log.GetLevel() < logger.InfoLevel { + Nan0.log.Warn().Msgf(">>> skip %v audio frames", frames) + } + return frames + } + Nan0.Handlers.OnAudio(data, int(frames)<<1) + return frames +} + +func m(m *C.char) string { return strings.TrimRight(C.GoString(m), "\n") } + +//export coreLog +func coreLog(level C.enum_retro_log_level, msg *C.char) { + switch level { + // with debug level cores have too much logs + case C.RETRO_LOG_DEBUG: + Nan0.log.Debug().MsgFunc(func() string { return m(msg) }) + case C.RETRO_LOG_INFO: + Nan0.log.Info().MsgFunc(func() string { return m(msg) }) + case C.RETRO_LOG_WARN: + Nan0.log.Warn().MsgFunc(func() string { return m(msg) }) + case C.RETRO_LOG_ERROR: + Nan0.log.Error().MsgFunc(func() string { return m(msg) }) + default: + Nan0.log.Log().MsgFunc(func() string { return m(msg) }) + // RETRO_LOG_DUMMY = INT_MAX + } +} + +//export coreGetCurrentFramebuffer +func coreGetCurrentFramebuffer() C.uintptr_t { return (C.uintptr_t)(graphics.GetGlFbo()) } + +//export coreGetProcAddress +func coreGetProcAddress(sym *C.char) C.retro_proc_address_t { + return (C.retro_proc_address_t)(graphics.GetGlProcAddress(C.GoString(sym))) +} + +//export coreEnvironment +func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { + // spammy + switch cmd { + case C.RETRO_ENVIRONMENT_GET_VARIABLE_UPDATE: + return false + case C.RETRO_ENVIRONMENT_GET_AUDIO_VIDEO_ENABLE: + return false + } + + switch cmd { + case C.RETRO_ENVIRONMENT_SET_ROTATION: + setRotation(*(*uint)(data) % 4) + return true + case C.RETRO_ENVIRONMENT_GET_CAN_DUPE: + *(*C.bool)(data) = C.bool(true) + return true + case C.RETRO_ENVIRONMENT_GET_USERNAME: + *(**C.char)(data) = Nan0.cUserName + return true + case C.RETRO_ENVIRONMENT_GET_LOG_INTERFACE: + cb := (*C.struct_retro_log_callback)(data) + cb.log = (C.retro_log_printf_t)(C.core_log_cgo) + return true + case C.RETRO_ENVIRONMENT_SET_PIXEL_FORMAT: + res, err := videoSetPixelFormat(*(*C.enum_retro_pixel_format)(data)) + if err != nil { + Nan0.log.Fatal().Err(err).Msg("pix format failed") + } + return res + case C.RETRO_ENVIRONMENT_GET_SYSTEM_DIRECTORY: + *(**C.char)(data) = Nan0.cSystemDirectory + return true + case C.RETRO_ENVIRONMENT_GET_SAVE_DIRECTORY: + *(**C.char)(data) = Nan0.cSaveDirectory + return true + case C.RETRO_ENVIRONMENT_SET_MESSAGE: + // only with the Libretro debug mode + if Nan0.log.GetLevel() < logger.InfoLevel { + message := (*C.struct_retro_message)(data) + msg := C.GoString(message.msg) + Nan0.log.Debug().Msgf("message: %v", msg) + return true + } + return false + case C.RETRO_ENVIRONMENT_SHUTDOWN: + //window.SetShouldClose(true) + return false + case C.RETRO_ENVIRONMENT_GET_VARIABLE: + if (*Nan0.options) == nil { + return false + } + rv := (*C.struct_retro_variable)(data) + key := C.GoString(rv.key) + if v, ok := (*Nan0.options)[key]; ok { + // make Go strings null-terminated copies ;_; + (*Nan0.options)[key] = v + "\x00" + // cast to C string and set the value + // we hope the string won't be collected while C needs it + rv.value = (*C.char)(unsafe.Pointer(unsafe.StringData((*Nan0.options)[key]))) + Nan0.log.Debug().Msgf("Set %s=%v", key, v) + return true + } + return false + case C.RETRO_ENVIRONMENT_SET_HW_RENDER: + if Nan0.Video.gl.enabled { + Nan0.Video.hw = (*C.struct_retro_hw_render_callback)(data) + Nan0.Video.hw.get_current_framebuffer = (C.retro_hw_get_current_framebuffer_t)(C.core_get_current_framebuffer_cgo) + Nan0.Video.hw.get_proc_address = (C.retro_hw_get_proc_address_t)(C.core_get_proc_address_cgo) + return true + } + return false + case C.RETRO_ENVIRONMENT_SET_CONTROLLER_INFO: + // !to rewrite + if !Nan0.multitap.supported { + return false + } + info := (*[100]C.struct_retro_controller_info)(data) + var i C.unsigned + for i = 0; unsafe.Pointer(info[i].types) != nil; i++ { + var j C.unsigned + types := (*[100]C.struct_retro_controller_description)(unsafe.Pointer(info[i].types)) + for j = 0; j < info[i].num_types; j++ { + if C.GoString(types[j].desc) == "Multitap" { + Nan0.multitap.value = types[j].id + return true + } + } + } + return false + case C.RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB: + C.bridge_clear_all_thread_waits_cb(data) + return true + case C.RETRO_ENVIRONMENT_GET_SAVESTATE_CONTEXT: + if ctx := (*C.int)(data); ctx != nil { + *ctx = C.RETRO_SAVESTATE_CONTEXT_NORMAL + } + return true + } + return false +} + +//export initVideo +func initVideo() { + var context graphics.Context + switch Nan0.Video.hw.context_type { + case C.RETRO_HW_CONTEXT_NONE: + context = graphics.CtxNone + case C.RETRO_HW_CONTEXT_OPENGL: + context = graphics.CtxOpenGl + case C.RETRO_HW_CONTEXT_OPENGLES2: + context = graphics.CtxOpenGlEs2 + case C.RETRO_HW_CONTEXT_OPENGL_CORE: + context = graphics.CtxOpenGlCore + case C.RETRO_HW_CONTEXT_OPENGLES3: + context = graphics.CtxOpenGlEs3 + case C.RETRO_HW_CONTEXT_OPENGLES_VERSION: + context = graphics.CtxOpenGlEsVersion + case C.RETRO_HW_CONTEXT_VULKAN: + context = graphics.CtxVulkan + case C.RETRO_HW_CONTEXT_DUMMY: + context = graphics.CtxDummy + default: + context = graphics.CtxUnknown + } + + sdl, err := graphics.NewSDLContext(graphics.Config{ + Ctx: context, + W: int(Nan0.sysAvInfo.geometry.max_width), + H: int(Nan0.sysAvInfo.geometry.max_height), + GLAutoContext: Nan0.Video.gl.autoCtx, + GLVersionMajor: uint(Nan0.Video.hw.version_major), + GLVersionMinor: uint(Nan0.Video.hw.version_minor), + GLHasDepth: bool(Nan0.Video.hw.depth), + GLHasStencil: bool(Nan0.Video.hw.stencil), + }, Nan0.log) + if err != nil { + panic(err) + } + Nan0.sdlCtx = sdl + + C.bridge_context_reset(Nan0.Video.hw.context_reset) + if Nan0.log.GetLevel() < logger.InfoLevel { + printOpenGLDriverInfo() + } +} + +//export deinitVideo +func deinitVideo() { + if !Nan0.hackSkipHwContextDestroy { + C.bridge_context_reset(Nan0.Video.hw.context_destroy) + } + if err := Nan0.sdlCtx.Deinit(); err != nil { + Nan0.log.Error().Err(err).Msg("deinit fail") + } + Nan0.Video.gl.enabled = false + Nan0.Video.gl.autoCtx = false + Nan0.hackSkipHwContextDestroy = false +} diff --git a/pkg/worker/emulator/libretro/nanoarch.h b/pkg/worker/caged/libretro/nanoarch/nanoarch.h similarity index 100% rename from pkg/worker/emulator/libretro/nanoarch.h rename to pkg/worker/caged/libretro/nanoarch/nanoarch.h diff --git a/pkg/worker/caged/libretro/recording.go b/pkg/worker/caged/libretro/recording.go new file mode 100644 index 00000000..7c128aea --- /dev/null +++ b/pkg/worker/caged/libretro/recording.go @@ -0,0 +1,78 @@ +package libretro + +import ( + "image" + "time" + + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + "github.com/giongto35/cloud-game/v3/pkg/worker/recorder" +) + +type RecordingFrontend struct { + Emulator + rec *recorder.Recording +} + +// !to fix opaque image save + +type opaque struct{ image.RGBA } + +func (o *opaque) Opaque() bool { return true } + +func WithRecording(fe Emulator, rec bool, user string, game string, conf config.Recording, log *logger.Logger) *RecordingFrontend { + rr := &RecordingFrontend{Emulator: fe, rec: recorder.NewRecording( + recorder.Meta{UserName: user}, + log, + recorder.Options{ + Dir: conf.Folder, + Game: game, + ImageCompressionLevel: conf.CompressLevel, + Name: conf.Name, + Zip: conf.Zip, + Vsync: true, + })} + rr.ToggleRecording(rec, user) + return rr +} + +func (r *RecordingFrontend) SetAudioCb(fn func(app.Audio)) { + r.Emulator.SetAudioCb(func(audio app.Audio) { + if r.IsRecording() { + pcm := audio.Data + // example: 1600 = x / 1000 * 48000 * 2 + l := time.Duration(float64(len(pcm)) / float64(r.AudioSampleRate()<<1) * 1000000000) + r.rec.WriteAudio(recorder.Audio{Samples: pcm, Duration: l}) + } + fn(audio) + }) +} + +func (r *RecordingFrontend) SetVideoCb(fn func(app.Video)) { + r.Emulator.SetVideoCb(func(v app.Video) { + if r.IsRecording() { + r.rec.WriteVideo(recorder.Video{Image: &opaque{v.Frame}, Duration: time.Duration(v.Duration)}) + } + fn(v) + }) +} + +func (r *RecordingFrontend) LoadGame(path string) error { + err := r.Emulator.LoadGame(path) + if err != nil { + return err + } + r.rec.SetFramerate(float64(r.Emulator.FPS())) + r.rec.SetAudioFrequency(r.Emulator.AudioSampleRate()) + return nil +} + +func (r *RecordingFrontend) ToggleRecording(active bool, user string) { + if r.rec != nil { + r.rec.Set(active, user) + } +} + +func (r *RecordingFrontend) IsRecording() bool { return r.rec != nil && r.rec.Enabled() } +func (r *RecordingFrontend) Close() { r.Emulator.Close(); r.ToggleRecording(false, "") } diff --git a/pkg/worker/emulator/libretro/core.go b/pkg/worker/caged/libretro/repo/arch/arch.go similarity index 78% rename from pkg/worker/emulator/libretro/core.go rename to pkg/worker/caged/libretro/repo/arch/arch.go index 72393ee6..16e5a88d 100644 --- a/pkg/worker/emulator/libretro/core.go +++ b/pkg/worker/caged/libretro/repo/arch/arch.go @@ -1,4 +1,4 @@ -package libretro +package arch import ( "errors" @@ -6,7 +6,7 @@ import ( ) // See: https://gist.github.com/asukakenji/f15ba7e588ac42795f421b48b8aede63. -var libretroOsArchMap = map[string]ArchInfo{ +var libretroOsArchMap = map[string]Info{ "linux:amd64": {Os: "linux", Arch: "x86_64", LibExt: ".so"}, "linux:arm": {Os: "linux", Arch: "armv7-neon-hf", LibExt: ".so"}, "windows:amd64": {Os: "windows", Arch: "x86_64", LibExt: ".dll"}, @@ -14,10 +14,10 @@ var libretroOsArchMap = map[string]ArchInfo{ "darwin:arm64": {Os: "osx", Arch: "arm64", Vendor: "apple", LibExt: ".dylib"}, } -// ArchInfo contains Libretro core lib platform info. +// Info contains Libretro core lib platform info. // And cores are just C-compiled libraries. // See: https://buildbot.libretro.com/nightly. -type ArchInfo struct { +type Info struct { // bottom: x86_64, x86, ... Arch string // middle: windows, ios, ... @@ -29,11 +29,11 @@ type ArchInfo struct { LibExt string } -func GetCoreExt() (ArchInfo, error) { +func Guess() (Info, error) { key := runtime.GOOS + ":" + runtime.GOARCH if arch, ok := libretroOsArchMap[key]; ok { return arch, nil } else { - return ArchInfo{}, errors.New("core mapping not found for " + key) + return Info{}, errors.New("core mapping not found for " + key) } } diff --git a/pkg/worker/emulator/libretro/repo/buildbot/repository.go b/pkg/worker/caged/libretro/repo/buildbot/repository.go similarity index 71% rename from pkg/worker/emulator/libretro/repo/buildbot/repository.go rename to pkg/worker/caged/libretro/repo/buildbot/repository.go index 0e6be336..44bdcd1b 100644 --- a/pkg/worker/emulator/libretro/repo/buildbot/repository.go +++ b/pkg/worker/caged/libretro/repo/buildbot/repository.go @@ -1,10 +1,10 @@ package buildbot import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" "strings" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/repo/raw" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/raw" ) type RepoBuildbot struct { @@ -20,7 +20,7 @@ func NewBuildbotRepo(address string, compression string) RepoBuildbot { } } -func (r RepoBuildbot) GetCoreUrl(file string, info libretro.ArchInfo) string { +func (r RepoBuildbot) GetCoreUrl(file string, info arch.Info) string { var sb strings.Builder sb.WriteString(r.Address + "/") if info.Vendor != "" { diff --git a/pkg/worker/emulator/libretro/repo/buildbot/repository_test.go b/pkg/worker/caged/libretro/repo/buildbot/repository_test.go similarity index 72% rename from pkg/worker/emulator/libretro/repo/buildbot/repository_test.go rename to pkg/worker/caged/libretro/repo/buildbot/repository_test.go index e45ae766..5aa007b9 100644 --- a/pkg/worker/emulator/libretro/repo/buildbot/repository_test.go +++ b/pkg/worker/caged/libretro/repo/buildbot/repository_test.go @@ -1,8 +1,9 @@ package buildbot import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" "testing" + + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" ) func TestBuildbotRepo(t *testing.T) { @@ -10,12 +11,12 @@ func TestBuildbotRepo(t *testing.T) { tests := []struct { file string compression string - arch libretro.ArchInfo + arch arch.Info resultUrl string }{ { file: "uber_core", - arch: libretro.ArchInfo{ + arch: arch.Info{ Os: "linux", Arch: "x86_64", LibExt: ".so", @@ -25,7 +26,7 @@ func TestBuildbotRepo(t *testing.T) { { file: "uber_core", compression: "zip", - arch: libretro.ArchInfo{ + arch: arch.Info{ Os: "linux", Arch: "x86_64", LibExt: ".so", @@ -34,7 +35,7 @@ func TestBuildbotRepo(t *testing.T) { }, { file: "uber_core", - arch: libretro.ArchInfo{ + arch: arch.Info{ Os: "osx", Arch: "x86_64", Vendor: "apple", @@ -45,11 +46,10 @@ func TestBuildbotRepo(t *testing.T) { } for _, test := range tests { - repo := NewBuildbotRepo(testAddress, test.compression) - url := repo.GetCoreUrl(test.file, test.arch) + rep := NewBuildbotRepo(testAddress, test.compression) + url := rep.GetCoreUrl(test.file, test.arch) if url != test.resultUrl { - t.Errorf("seems that expected link address is incorrect (%v) for file %s %+v", - url, test.file, test.arch) + t.Errorf("seems that expected link address is incorrect (%v) for file %s %+v", url, test.file, test.arch) } } } diff --git a/pkg/worker/emulator/libretro/repo/github/repository.go b/pkg/worker/caged/libretro/repo/github/repository.go similarity index 56% rename from pkg/worker/emulator/libretro/repo/github/repository.go rename to pkg/worker/caged/libretro/repo/github/repository.go index c3ab698c..532c02f0 100644 --- a/pkg/worker/emulator/libretro/repo/github/repository.go +++ b/pkg/worker/caged/libretro/repo/github/repository.go @@ -1,8 +1,8 @@ package github import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/repo/buildbot" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/buildbot" ) type RepoGithub struct { @@ -13,6 +13,6 @@ func NewGithubRepo(address string, compression string) RepoGithub { return RepoGithub{RepoBuildbot: buildbot.NewBuildbotRepo(address, compression)} } -func (r RepoGithub) GetCoreUrl(file string, info libretro.ArchInfo) string { +func (r RepoGithub) GetCoreUrl(file string, info arch.Info) string { return r.RepoBuildbot.GetCoreUrl(file, info) + "?raw=true" } diff --git a/pkg/worker/emulator/libretro/repo/github/repository_test.go b/pkg/worker/caged/libretro/repo/github/repository_test.go similarity index 73% rename from pkg/worker/emulator/libretro/repo/github/repository_test.go rename to pkg/worker/caged/libretro/repo/github/repository_test.go index fe8c2a4c..cf3a4380 100644 --- a/pkg/worker/emulator/libretro/repo/github/repository_test.go +++ b/pkg/worker/caged/libretro/repo/github/repository_test.go @@ -1,8 +1,9 @@ package github import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" "testing" + + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" ) func TestBuildbotRepo(t *testing.T) { @@ -10,12 +11,12 @@ func TestBuildbotRepo(t *testing.T) { tests := []struct { file string compression string - arch libretro.ArchInfo + arch arch.Info resultUrl string }{ { file: "uber_core", - arch: libretro.ArchInfo{ + arch: arch.Info{ Os: "linux", Arch: "x86_64", LibExt: ".so", @@ -25,7 +26,7 @@ func TestBuildbotRepo(t *testing.T) { { file: "uber_core", compression: "zip", - arch: libretro.ArchInfo{ + arch: arch.Info{ Os: "linux", Arch: "x86_64", LibExt: ".so", @@ -34,7 +35,7 @@ func TestBuildbotRepo(t *testing.T) { }, { file: "uber_core", - arch: libretro.ArchInfo{ + arch: arch.Info{ Os: "osx", Arch: "x86_64", Vendor: "apple", @@ -45,11 +46,10 @@ func TestBuildbotRepo(t *testing.T) { } for _, test := range tests { - repo := NewGithubRepo(testAddress, test.compression) - url := repo.GetCoreUrl(test.file, test.arch) + rep := NewGithubRepo(testAddress, test.compression) + url := rep.GetCoreUrl(test.file, test.arch) if url != test.resultUrl { - t.Errorf("seems that expected link address is incorrect (%v) for file %s %+v", - url, test.file, test.arch) + t.Errorf("seems that expected link address is incorrect (%v) for file %s %+v", url, test.file, test.arch) } } } diff --git a/pkg/worker/caged/libretro/repo/raw/repository.go b/pkg/worker/caged/libretro/repo/raw/repository.go new file mode 100644 index 00000000..33c9056a --- /dev/null +++ b/pkg/worker/caged/libretro/repo/raw/repository.go @@ -0,0 +1,14 @@ +package raw + +import "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" + +type Repo struct { + Address string + Compression string +} + +// NewRawRepo defines a simple zip file containing +// all the cores that will be extracted as is. +func NewRawRepo(address string) Repo { return Repo{Address: address, Compression: "zip"} } + +func (r Repo) GetCoreUrl(_ string, _ arch.Info) string { return r.Address } diff --git a/pkg/worker/emulator/libretro/repo/repository.go b/pkg/worker/caged/libretro/repo/repository.go similarity index 60% rename from pkg/worker/emulator/libretro/repo/repository.go rename to pkg/worker/caged/libretro/repo/repository.go index 3f826891..e2a99c1e 100644 --- a/pkg/worker/emulator/libretro/repo/repository.go +++ b/pkg/worker/caged/libretro/repo/repository.go @@ -1,10 +1,10 @@ package repo import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/repo/buildbot" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/repo/github" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/repo/raw" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/buildbot" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/github" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/raw" ) type ( @@ -14,7 +14,7 @@ type ( } Repository interface { - GetCoreUrl(file string, info libretro.ArchInfo) (url string) + GetCoreUrl(file string, info arch.Info) (url string) } ) diff --git a/pkg/worker/emulator/libretro/storage.go b/pkg/worker/caged/libretro/storage.go similarity index 100% rename from pkg/worker/emulator/libretro/storage.go rename to pkg/worker/caged/libretro/storage.go diff --git a/pkg/worker/emulator/libretro/storage_test.go b/pkg/worker/caged/libretro/storage_test.go similarity index 100% rename from pkg/worker/emulator/libretro/storage_test.go rename to pkg/worker/caged/libretro/storage_test.go diff --git a/pkg/worker/storage.go b/pkg/worker/cloud/cloudstore.go similarity index 94% rename from pkg/worker/storage.go rename to pkg/worker/cloud/cloudstore.go index 183f1441..76d0f616 100644 --- a/pkg/worker/storage.go +++ b/pkg/worker/cloud/cloudstore.go @@ -1,4 +1,4 @@ -package worker +package cloud import ( "bytes" @@ -12,7 +12,9 @@ import ( "time" ) -type CloudStorage interface { +// !to replace all with unified s3 api + +type Storage interface { Save(name string, localPath string) (err error) Load(name string) (data []byte, err error) } @@ -22,8 +24,8 @@ type OracleDataStorageClient struct { client *http.Client } -func GetCloudStorage(provider, key string) (CloudStorage, error) { - var st CloudStorage +func Store(provider, key string) (Storage, error) { + var st Storage var err error switch provider { case "oracle": diff --git a/pkg/worker/storage_test.go b/pkg/worker/cloud/cloudstore_test.go similarity index 98% rename from pkg/worker/storage_test.go rename to pkg/worker/cloud/cloudstore_test.go index cb80830a..228d4d29 100644 --- a/pkg/worker/storage_test.go +++ b/pkg/worker/cloud/cloudstore_test.go @@ -1,4 +1,4 @@ -package worker +package cloud import ( "io" diff --git a/pkg/worker/cloudsave.go b/pkg/worker/cloudsave.go deleted file mode 100644 index 24083dc5..00000000 --- a/pkg/worker/cloudsave.go +++ /dev/null @@ -1,56 +0,0 @@ -package worker - -import "os" - -type CloudSaveRoom struct { - GamingRoom - storage CloudStorage // a cloud storage to store room state online -} - -func WithCloudStorage(room GamingRoom, storage CloudStorage) *CloudSaveRoom { - cr := CloudSaveRoom{ - GamingRoom: room, - storage: storage, - } - if err := cr.Download(); err != nil { - room.GetLog().Warn().Err(err).Msg("The room is not in the cloud") - } - return &cr -} - -func (c *CloudSaveRoom) Download() error { - // saveOnlineRoomToLocal save online room to local. - // !Supports only one file of main save state. - - data, err := c.storage.Load(c.GetId()) - if err != nil { - return err - } - // Save the data fetched from a cloud provider to the local server - if data != nil { - if err := os.WriteFile(c.GetEmulator().GetHashPath(), data, 0644); err != nil { - return err - } - c.GetLog().Debug().Msg("Successfully downloaded cloud save") - } - return nil -} - -func (c *CloudSaveRoom) HasSave() bool { - _, err := c.storage.Load(c.GetId()) - if err == nil { - return true - } - return c.GamingRoom.HasSave() -} - -func (c *CloudSaveRoom) SaveGame() error { - if err := c.GamingRoom.SaveGame(); err != nil { - return err - } - if err := c.storage.Save(c.GetId(), c.GetEmulator().GetHashPath()); err != nil { - return err - } - c.GetLog().Debug().Msg("Cloud save is successful") - return nil -} diff --git a/pkg/worker/coordinator.go b/pkg/worker/coordinator.go index 23d19675..86ce6226 100644 --- a/pkg/worker/coordinator.go +++ b/pkg/worker/coordinator.go @@ -52,10 +52,9 @@ func newCoordinatorConnection(host string, conf config.Worker, addr string, log return nil, err } - client := com.NewConnection[api.PT, api.In[com.Uid], api.Out]( - conn, id, - log.Extend(log.With().Str(logger.ClientField, "c")), - ) + clog := log.Extend(log.With().Str(logger.ClientField, "c")) + client := com.NewConnection[api.PT, api.In[com.Uid], api.Out, *api.Out](conn, id, clog) + return &coordinator{ Connection: client, log: log.Extend(log.With().Str("cid", client.Id().Short())), diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index c530c61a..b04fa412 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -8,6 +8,9 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/network/webrtc" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged" + "github.com/giongto35/cloud-game/v3/pkg/worker/media" + "github.com/giongto35/cloud-game/v3/pkg/worker/room" "github.com/goccy/go-json" ) @@ -25,8 +28,8 @@ func buildConnQuery(id com.Uid, conf config.Worker, address string) (string, err }) } -func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest[com.Uid], w *Worker, connApi *webrtc.ApiFactory) api.Out { - peer := webrtc.New(c.log, connApi) +func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest[com.Uid], w *Worker, factory *webrtc.ApiFactory) api.Out { + peer := webrtc.New(c.log, factory) localSDP, err := peer.NewCall(w.conf.Encoder.Video.Codec, "opus", func(data any) { candidate, err := toBase64Json(data) if err != nil { @@ -45,113 +48,114 @@ func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest[com.Uid], w *Wor return api.EmptyPacket } - // use user uid from the coordinator - user := NewSession(peer, rq.Id) + user := room.NewGameSession(rq.Id, peer) // use user uid from the coordinator w.router.AddUser(user) - c.log.Info().Str("id", rq.Id.String()).Msgf("Peer connection (uid:%s)", user.Id()) + c.log.Info().Msgf("Peer connection: %s", user.Id()) return api.Out{Payload: sdp} } func (c *coordinator) HandleWebrtcAnswer(rq api.WebrtcAnswerRequest[com.Uid], w *Worker) { - if user := w.router.GetUser(rq.Id); user != nil { - if err := user.GetPeerConn().SetRemoteSDP(rq.Sdp, fromBase64Json); err != nil { + if user := w.router.FindUser(rq.Id); user != nil { + if err := room.WithWebRTC(user.Session).SetRemoteSDP(rq.Sdp, fromBase64Json); err != nil { c.log.Error().Err(err).Msgf("cannot set remote SDP of client [%v]", rq.Id) } } } func (c *coordinator) HandleWebrtcIceCandidate(rs api.WebrtcIceCandidateRequest[com.Uid], w *Worker) { - if user := w.router.GetUser(rs.Id); user != nil { - if err := user.GetPeerConn().AddCandidate(rs.Candidate, fromBase64Json); err != nil { + if user := w.router.FindUser(rs.Id); user != nil { + if err := room.WithWebRTC(user.Session).AddCandidate(rs.Candidate, fromBase64Json); err != nil { c.log.Error().Err(err).Msgf("cannot add ICE candidate of the client [%v]", rs.Id) } } } func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worker) api.Out { - user := w.router.GetUser(rq.Id) + user := w.router.FindUser(rq.Id) if user == nil { c.log.Error().Msgf("no user [%v]", rq.Id) return api.EmptyPacket } - w.log.Info().Msgf("Starting game: %v", rq.Game.Name) + user.Index = rq.PlayerIndex - room := w.router.GetRoom(rq.Rid) - if room == nil { - room = NewRoom( - rq.Room.Rid, - games.GameMetadata(rq.Game), - func(room *Room) { - w.router.SetRoom(nil) - c.CloseRoom(room.id) - w.log.Debug().Msgf("Room close has been called %v", room.id) - }, - w.conf, - w.log, - ) - user.SetPlayerIndex(rq.PlayerIndex) + r := w.router.FindRoom(rq.Rid) - if w.storage != nil { - room = WithCloudStorage(room, w.storage) + if r == nil { + uid := rq.Room.Rid + if uid == "" { + uid = games.GenerateRoomID(rq.Game.Name) } - if w.conf.Recording.Enabled { - room = WithRecording(room.(*Room), rq.Record, rq.RecordUser, rq.Game.Name, w.conf) - } - w.router.SetRoom(room) - room.StartEmulator() + // start the emulator + app := room.WithEmulator(w.mana.Get(caged.Libretro)) + app.ReloadFrontend() + app.SetSessionId(uid) + app.SetSaveOnClose(true) + app.EnableCloudStorage(uid, w.storage) + app.EnableRecording(rq.Record, rq.RecordUser, rq.Game.Name) - if w.conf.Emulator.AutosaveSec > 0 { - // !to can crash if emulator starts earlier - go room.EnableAutosave(w.conf.Emulator.AutosaveSec) + w.log.Info().Msgf("Starting game: %v", rq.Game.Name) + game := games.GameMetadata(rq.Game) + if err := app.Load(game, w.conf.Worker.Library.BasePath); err != nil { + c.log.Error().Err(err).Msgf("couldn't load the game %v", game) + app.Close() + return api.EmptyPacket } + + m := media.NewWebRtcMediaPipe(w.conf.Encoder.Audio, w.conf.Encoder.Video, w.log) + m.AudioSrcHz = app.AudioSampleRate() + m.AudioFrame = w.conf.Encoder.Audio.Frame + m.VideoW, m.VideoH = app.ViewportSize() + if err := m.Init(); err != nil { + c.log.Error().Err(err).Msgf("couldn't init the media") + app.Close() + return api.EmptyPacket + } + + // make the room + r = room.NewRoom[*room.GameSession](uid, app, w.router.Users(), m) + r.HandleClose = func() { + w.router.Close() + c.CloseRoom(uid) + w.log.Debug().Msgf("Closed room %v", uid) + } + + w.router.SetRoom(r) + c.log.Info().Str("room", r.Id()).Str("game", game.Name).Msg("New room") + + r.StartApp() } - if room == nil { - c.log.Error().Msgf("couldn't create a room [%v]", rq.Id) - return api.EmptyPacket - } + c.log.Debug().Msg("Start session input poll") + room.WithWebRTC(user.Session).OnMessage = func(data []byte) { r.App().SendControl(user.Index, data) } - if !room.HasUser(user) { - room.AddUser(user) - room.PollUserInput(user) - } - user.SetRoom(room) + c.RegisterRoom(r.Id()) - c.RegisterRoom(room.GetId()) - - return api.Out{Payload: api.StartGameResponse{Room: api.Room{Rid: room.GetId()}, Record: w.conf.Recording.Enabled}} + return api.Out{Payload: api.StartGameResponse{Room: api.Room{Rid: r.Id()}, Record: w.conf.Recording.Enabled}} } // HandleTerminateSession handles cases when a user has been disconnected from the websocket of coordinator. func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com.Uid], w *Worker) { - if session := w.router.GetUser(rq.Id); session != nil { - w.router.RemoveDisconnect(session) - if room := session.GetSetRoom(nil); room != nil { - room.CleanupUser(session) - } + if user := w.router.FindUser(rq.Id); user != nil { + w.router.Remove(user) + user.Disconnect() } } // HandleQuitGame handles cases when a user manually exits the game. func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) { - if user := w.router.GetUser(rq.Id); user != nil { - // we don't strictly need a room id form the request, - // since users hold their room reference - // !to remove rid, maybe - if room := w.router.GetRoom(rq.Rid); room != nil { - room.CleanupUser(user) - } + if user := w.router.FindUser(rq.Id); user != nil { + w.router.Remove(user) } } func (c *coordinator) HandleSaveGame(rq api.SaveGameRequest[com.Uid], w *Worker) api.Out { - room := w.router.GetRoom(rq.Rid) - if room == nil { + r := w.router.FindRoom(rq.Rid) + if r == nil { return api.ErrPacket } - if err := room.SaveGame(); err != nil { + if err := room.WithEmulator(r.App()).SaveGameState(); err != nil { c.log.Error().Err(err).Msg("cannot save game state") return api.ErrPacket } @@ -159,11 +163,11 @@ func (c *coordinator) HandleSaveGame(rq api.SaveGameRequest[com.Uid], w *Worker) } func (c *coordinator) HandleLoadGame(rq api.LoadGameRequest[com.Uid], w *Worker) api.Out { - room := w.router.GetRoom(rq.Rid) - if room == nil { + r := w.router.FindRoom(rq.Rid) + if r == nil { return api.ErrPacket } - if err := room.LoadGame(); err != nil { + if err := room.WithEmulator(r.App()).RestoreGameState(); err != nil { c.log.Error().Err(err).Msg("cannot load game state") return api.ErrPacket } @@ -171,21 +175,21 @@ func (c *coordinator) HandleLoadGame(rq api.LoadGameRequest[com.Uid], w *Worker) } func (c *coordinator) HandleChangePlayer(rq api.ChangePlayerRequest[com.Uid], w *Worker) api.Out { - user := w.router.GetUser(rq.Id) - if user == nil || w.router.GetRoom(rq.Rid) == nil { + user := w.router.FindUser(rq.Id) + if user == nil || w.router.FindRoom(rq.Rid) == nil { return api.Out{Payload: -1} // semi-predicates } - user.SetPlayerIndex(rq.Index) + user.Index = rq.Index w.log.Info().Msgf("Updated player index to: %d", rq.Index) return api.Out{Payload: rq.Index} } func (c *coordinator) HandleToggleMultitap(rq api.ToggleMultitapRequest[com.Uid], w *Worker) api.Out { - room := w.router.GetRoom(rq.Rid) - if room == nil { + r := w.router.FindRoom(rq.Rid) + if r == nil { return api.ErrPacket } - room.ToggleMultitap() + room.WithEmulator(r.App()).ToggleMultitap() return api.OkPacket } @@ -193,11 +197,11 @@ func (c *coordinator) HandleRecordGame(rq api.RecordGameRequest[com.Uid], w *Wor if !w.conf.Recording.Enabled { return api.ErrPacket } - room := w.router.GetRoom(rq.Rid) - if room == nil { + r := w.router.FindRoom(rq.Rid) + if r == nil { return api.ErrPacket } - room.(*RecordingRoom).ToggleRecording(rq.Active, rq.User) + room.WithRecorder(r.App()).ToggleRecording(rq.Active, rq.User) return api.OkPacket } diff --git a/pkg/worker/emulator/emulator.go b/pkg/worker/emulator/emulator.go deleted file mode 100644 index aaa6fa64..00000000 --- a/pkg/worker/emulator/emulator.go +++ /dev/null @@ -1,79 +0,0 @@ -package emulator - -import ( - "time" - - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/image" -) - -type Emulator interface { - // SetAudio sets the audio callback - SetAudio(func(*GameAudio)) - // SetVideo sets the video callback - SetVideo(func(*GameFrame)) - GetAudio() func(*GameAudio) - GetVideo() func(*GameFrame) - LoadMetadata(name string) - LoadGame(path string) error - GetFps() uint - GetSampleRate() uint - GetFrameSize() (w, h int) - HasVerticalFrame() bool - // Start is called after LoadGame - Start() - // SetViewport sets viewport size - SetViewport(width int, height int, scale int) - // SetMainSaveName sets distinct name for saves naming - SetMainSaveName(name string) - // SaveGameState save game state - SaveGameState() error - // LoadGameState load game state - LoadGameState() error - // GetHashPath returns the path emulator will save state to - GetHashPath() string - // Close will be called when the game is done - Close() - // ToggleMultitap toggles multitap controller. - ToggleMultitap() - // Input passes input to the emulator - Input(player int, data []byte) -} - -type Metadata struct { - LibPath string // the full path to some emulator lib - AudioSampleRate int - Fps float64 - BaseWidth int - BaseHeight int - Rotation image.Rotate - IsGlAllowed bool - UsesLibCo bool - AutoGlContext bool - HasMultitap bool - HasVFR bool - Options map[string]string - Hacks []string -} - -func (m Metadata) HasHack(h string) bool { - for _, n := range m.Hacks { - if h == n { - return true - } - } - return false -} - -type ( - GameFrame struct { - Data *image.Frame - Duration time.Duration - } - GameAudio struct { - Data *[]int16 - Duration time.Duration - } - InputEvent struct { - RawState []byte - } -) diff --git a/pkg/worker/emulator/graphics/context.go b/pkg/worker/emulator/graphics/context.go deleted file mode 100644 index 6ac446c7..00000000 --- a/pkg/worker/emulator/graphics/context.go +++ /dev/null @@ -1,18 +0,0 @@ -package graphics - -import "math" - -type Context int - -const ( - CtxNone Context = iota - CtxOpenGl - CtxOpenGlEs2 - CtxOpenGlCore - CtxOpenGlEs3 - CtxOpenGlEsVersion - CtxVulkan - - CtxUnknown = math.MaxInt32 - 1 - CtxDummy = math.MaxInt32 -) diff --git a/pkg/worker/emulator/libretro/frontend.go b/pkg/worker/emulator/libretro/frontend.go deleted file mode 100644 index 86697777..00000000 --- a/pkg/worker/emulator/libretro/frontend.go +++ /dev/null @@ -1,285 +0,0 @@ -package libretro - -import ( - "errors" - "fmt" - "path/filepath" - "sync" - "sync/atomic" - "time" - - "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/os" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/image" -) - -type Frontend struct { - onVideo func(*emulator.GameFrame) - onAudio func(*emulator.GameAudio) - - input InputState - - conf config.Emulator - storage Storage - - // out frame size - vw, vh int - // draw threads - th int - - stopped atomic.Bool - - Canvas *image.Canvas - DisableCanvasPool bool - - done chan struct{} - log *logger.Logger - - mu sync.Mutex -} - -// InputState stores full controller state. -// It consists of: -// - uint16 button values -// - int16 analog stick values -type ( - InputState [maxPort]State - State struct { - keys uint32 - axes [dpadAxes]int32 - } -) - -const ( - maxPort = 4 - dpadAxes = 4 - KeyPressed = 1 - KeyReleased = 0 -) - -var ( - noAudio = func(*emulator.GameAudio) {} - noVideo = func(*emulator.GameFrame) {} -) - -// NewFrontend implements Emulator interface for a Libretro frontend. -func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { - log = log.Extend(log.With().Str("m", "Libretro")) - ll := log.Extend(log.Level(logger.Level(conf.Libretro.LogLevel)).With()) - SetLibretroLogger(ll) - - // Check if room is on local storage, if not, pull from GCS to local storage - log.Info().Msgf("Local storage path: %v", conf.Storage) - if err := os.CheckCreateDir(conf.Storage); err != nil { - return nil, fmt.Errorf("failed to create local storage path: %v, %w", conf.Storage, err) - } - - path, err := filepath.Abs(conf.LocalPath) - if err != nil { - return nil, fmt.Errorf("failed to use emulator path: %v, %w", conf.LocalPath, err) - } - if err := os.CheckCreateDir(path); err != nil { - return nil, fmt.Errorf("failed to create local path: %v, %w", conf.LocalPath, err) - } - log.Info().Msgf("Emulator save path is %v", path) - Init(path) - - var store Storage = &StateStorage{Path: conf.Storage} - if conf.Libretro.SaveCompression { - store = &ZipStorage{Storage: store} - } - - last := frontend - if last != nil { - last.mu.Lock() - } - // set global link to the Libretro - frontend = &Frontend{ - conf: conf, - storage: store, - input: NewGameSessionInput(), - done: make(chan struct{}), - th: conf.Threads, - log: log, - onAudio: noAudio, - onVideo: noVideo, - } - if last != nil { - last.mu.Unlock() - } - return frontend, nil -} - -func (f *Frontend) LoadMetadata(emu string) { - conf := f.conf.GetLibretroCoreConfig(emu) - meta := emulator.Metadata{ - AutoGlContext: conf.AutoGlContext, - Hacks: conf.Hacks, - HasMultitap: conf.HasMultitap, - HasVFR: conf.VFR, - IsGlAllowed: conf.IsGlAllowed, - LibPath: conf.Lib, - Options: conf.Options, - UsesLibCo: conf.UsesLibCo, - } - f.mu.Lock() - coreLoad(meta) - f.mu.Unlock() -} - -func (f *Frontend) Start() { - // start only when it is available - <-nano.reserved - f.log.Debug().Msgf("Frontend start") - - ticker := time.NewTicker(time.Second / time.Duration(nano.sysAvInfo.timing.fps)) - defer func() { - f.log.Debug().Msgf("run loop cleanup") - ticker.Stop() - f.mu.Lock() - nanoarchShutdown() - frontend.Canvas.Clear() - f.SetAudio(noAudio) - f.SetVideo(noVideo) - f.mu.Unlock() - f.log.Debug().Msgf("run loop finished") - }() - - // start time for the first frame - lastFrameTime = time.Now().UnixNano() - - // advance 1 frame for Mupen save state - if usesLibCo { - f.mu.Lock() - run() - f.mu.Unlock() - } - - if err := f.LoadGameState(); err != nil { - f.log.Error().Err(err).Msg("couldn't load a save file") - } - - for { - // selection from just two channels may freeze on - // ticker, ignoring the close chan for some reason - select { - case <-f.done: - return - default: - select { - case <-ticker.C: - f.mu.Lock() - run() - f.mu.Unlock() - case <-f.done: - return - } - } - } -} - -func (f *Frontend) GetFrameSize() (int, int) { - return int(nano.sysAvInfo.geometry.base_width), int(nano.sysAvInfo.geometry.base_height) -} - -func (f *Frontend) SetAudio(ff func(*emulator.GameAudio)) { f.onAudio = ff } -func (f *Frontend) GetAudio() func(*emulator.GameAudio) { return f.onAudio } -func (f *Frontend) SetVideo(ff func(*emulator.GameFrame)) { f.onVideo = ff } -func (f *Frontend) GetVideo() func(*emulator.GameFrame) { return f.onVideo } -func (f *Frontend) GetFps() uint { return uint(nano.sysAvInfo.timing.fps) } -func (f *Frontend) GetHashPath() string { return f.storage.GetSavePath() } -func (f *Frontend) GetSRAMPath() string { return f.storage.GetSRAMPath() } -func (f *Frontend) GetSampleRate() uint { return uint(nano.sysAvInfo.timing.sample_rate) } -func (f *Frontend) Input(player int, data []byte) { f.input.setInput(player, data) } -func (f *Frontend) LoadGame(path string) error { return LoadGame(path) } -func (f *Frontend) LoadGameState() error { return f.Load() } -func (f *Frontend) HasVerticalFrame() bool { return nano.rot != nil && nano.rot.IsEven } -func (f *Frontend) SaveGameState() error { return f.Save() } -func (f *Frontend) SetMainSaveName(name string) { f.storage.SetMainSaveName(name) } -func (f *Frontend) SetViewport(width int, height int, scale int) { - f.mu.Lock() - f.vw, f.vh = width, height - size := int(nano.sysAvInfo.geometry.max_width) * scale * int(nano.sysAvInfo.geometry.max_height) * scale - f.Canvas = image.NewCanvas(width, height, size) - if f.DisableCanvasPool { - f.Canvas.SetEnabled(false) - } - f.mu.Unlock() -} -func (f *Frontend) ToggleMultitap() { toggleMultitap() } - -func (f *Frontend) Close() { - f.log.Debug().Msgf("frontend close called") - close(f.done) - frontend.stopped.Store(true) - nano.reserved <- struct{}{} -} - -// Save writes the current state to the filesystem. -func (f *Frontend) Save() error { - f.mu.Lock() - defer f.mu.Unlock() - - ss, err := getSaveState() - if err != nil { - return err - } - if err := f.storage.Save(f.GetHashPath(), ss); err != nil { - return err - } - ss = nil - - if sram := getSaveRAM(); sram != nil { - if err := f.storage.Save(f.GetSRAMPath(), sram); err != nil { - return err - } - sram = nil - } - return nil -} - -// Load restores the state from the filesystem. -func (f *Frontend) Load() error { - f.mu.Lock() - defer f.mu.Unlock() - - ss, err := f.storage.Load(f.GetHashPath()) - if err != nil && !errors.Is(err, os.ErrNotExist) { - return err - } - if err := restoreSaveState(ss); err != nil { - return err - } - - sram, err := f.storage.Load(f.GetSRAMPath()) - if err != nil && !errors.Is(err, os.ErrNotExist) { - return err - } - if sram != nil { - restoreSaveRAM(sram) - } - return nil -} - -func NewGameSessionInput() InputState { return [maxPort]State{} } - -// setInput sets input state for some player in a game session. -func (s *InputState) setInput(player int, data []byte) { - atomic.StoreUint32(&s[player].keys, uint32(uint16(data[1])<<8+uint16(data[0]))) - for i, axes := 0, len(data); i < dpadAxes && i<<1+3 < axes; i++ { - axis := i<<1 + 2 - atomic.StoreInt32(&s[player].axes[i], int32(data[axis+1])<<8+int32(data[axis])) - } -} - -// isKeyPressed checks if some button is pressed by any player. -func (s *InputState) isKeyPressed(port uint, key int) int { - return int((atomic.LoadUint32(&s[port].keys) >> uint(key)) & 1) -} - -// isDpadTouched checks if D-pad is used by any player. -func (s *InputState) isDpadTouched(port uint, axis uint) (shift int16) { - return int16(atomic.LoadInt32(&s[port].axes[axis])) -} diff --git a/pkg/worker/emulator/libretro/frontend_test.go b/pkg/worker/emulator/libretro/frontend_test.go deleted file mode 100644 index 2e0b56ee..00000000 --- a/pkg/worker/emulator/libretro/frontend_test.go +++ /dev/null @@ -1,263 +0,0 @@ -package libretro - -import ( - "fmt" - "math/rand" - "sync" - "testing" - "time" - - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" -) - -// Tests a successful emulator state save. -func TestSave(t *testing.T) { - tests := []testRun{ - { - room: "test_save_ok_00", - system: "gba", - rom: "Sushi The Cat.gba", - emulationTicks: 100, - }, - { - room: "test_save_ok_01", - system: "gba", - rom: "anguna.gba", - emulationTicks: 10, - }, - } - - for _, test := range tests { - t.Logf("Testing [%v] save with [%v]\n", test.system, test.rom) - - mock := GetDefaultEmulatorMock(test.room, test.system, test.rom) - - for test.emulationTicks > 0 { - mock.emulateOneFrame() - test.emulationTicks-- - } - - fmt.Printf("[%-14v] ", "before save") - _, _ = mock.dumpState() - if err := mock.Save(); err != nil { - t.Errorf("Save fail %v", err) - } - fmt.Printf("[%-14v] ", "after save") - snapshot1, snapshot2 := mock.dumpState() - - if snapshot1 != snapshot2 { - t.Errorf("It seems rom state save has failed: %v != %v", snapshot1, snapshot2) - } - - mock.shutdownEmulator() - } -} - -// Tests save and restore function: -// -// Emulate n ticks. -// Call save (a). -// Emulate n ticks again. -// Call load from the save (b). -// Compare states (a) and (b), should be =. -func TestLoad(t *testing.T) { - t.Skip() - tests := []testRun{ - { - room: "test_load_00", - system: "nes", - rom: "Alwa's Awakening (Demo).nes", - emulationTicks: 100, - }, - { - room: "test_load_01", - system: "gba", - rom: "Sushi The Cat.gba", - emulationTicks: 1000, - }, - { - room: "test_load_02", - system: "gba", - rom: "anguna.gba", - emulationTicks: 100, - }, - } - - for _, test := range tests { - t.Logf("Testing [%v] load with [%v]\n", test.system, test.rom) - - mock := GetDefaultEmulatorMock(test.room, test.system, test.rom) - - fmt.Printf("[%-14v] ", "initial") - mock.dumpState() - - for ticks := test.emulationTicks; ticks > 0; ticks-- { - mock.emulateOneFrame() - } - fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.emulationTicks)) - mock.dumpState() - - if err := mock.Save(); err != nil { - t.Errorf("Save fail %v", err) - } - fmt.Printf("[%-14v] ", "saved") - snapshot1, _ := mock.dumpState() - - for ticks := test.emulationTicks; ticks > 0; ticks-- { - mock.emulateOneFrame() - } - fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.emulationTicks)) - mock.dumpState() - - if err := mock.Load(); err != nil { - t.Errorf("Load fail %v", err) - } - fmt.Printf("[%-14v] ", "restored") - snapshot2, _ := mock.dumpState() - - if snapshot1 != snapshot2 { - t.Errorf("It seems rom state restore has failed: %v != %v", snapshot1, snapshot2) - } - - mock.shutdownEmulator() - } -} - -func TestStateConcurrency(t *testing.T) { - tests := []struct { - run testRun - // determine random - seed int - }{ - { - run: testRun{ - room: "test_concurrency_00", - system: "gba", - rom: "Sushi The Cat.gba", - emulationTicks: 120, - }, - seed: 42, - }, - { - run: testRun{ - room: "test_concurrency_01", - system: "gba", - rom: "anguna.gba", - emulationTicks: 300, - }, - seed: 42 + 42, - }, - } - - for _, test := range tests { - t.Logf("Testing [%v] concurrency with [%v]\n", test.run.system, test.run.rom) - - mock := GetEmulatorMock(test.run.room, test.run.system) - ops := &sync.WaitGroup{} - // quantum lock - qLock := &sync.Mutex{} - op := 0 - <-nano.reserved - - mock.loadRom(test.run.rom) - mock.handleVideo(func(frame *emulator.GameFrame) { - if len(frame.Data.Pix) == 0 { - t.Errorf("It seems that rom video frame was empty, which is strange!") - } - }) - mock.handleAudio(func(_ *emulator.GameAudio) {}) - - t.Logf("Random seed is [%v]\n", test.seed) - t.Logf("Save path is [%v]\n", mock.paths.save) - - _ = mock.Save() - - // emulation fps ROM cap - ticker := time.NewTicker(time.Second / time.Duration(mock.GetFps())) - t.Logf("FPS limit is [%v]\n", mock.GetFps()) - - for range ticker.C { - select { - case <-mock.done: - mock.shutdownEmulator() - return - default: - } - - op++ - if op > test.run.emulationTicks { - mock.Close() - } else { - qLock.Lock() - mock.emulateOneFrame() - qLock.Unlock() - - if lucky() && !lucky() { - ops.Add(1) - go func() { - qLock.Lock() - defer qLock.Unlock() - - mock.dumpState() - // remove save to reproduce the bug - _ = mock.Save() - _, snapshot1 := mock.dumpState() - _ = mock.Load() - snapshot2, _ := mock.dumpState() - - // Bug or feature? - // When you load a state from the file - // without immediate preceding save, - // it won't be in the loaded state - // even without calling retro_run. - // But if you pause the threads with a debugger - // and run the code step by step, then it will work as expected. - // Possible background emulation? - - if snapshot1 != snapshot2 { - t.Errorf("States are inconsistent %v != %v on tick %v\n", snapshot1, snapshot2, op) - } - ops.Done() - }() - } - } - } - - ops.Wait() - ticker.Stop() - } -} - -// lucky returns random boolean. -func lucky() bool { return rand.Intn(2) == 1 } - -func TestConcurrentInput(t *testing.T) { - players := NewGameSessionInput() - - events := 1000 - var wg sync.WaitGroup - - wg.Add(events * 2) - - go func() { - for i := 0; i < events; i++ { - player := rand.Intn(maxPort) - go func() { - players.setInput(player, []byte{0, 1}) - wg.Done() - }() - } - }() - - go func() { - for i := 0; i < events; i++ { - player := rand.Intn(maxPort) - go func() { - players.isKeyPressed(uint(player), 100) - wg.Done() - }() - } - }() - - wg.Wait() -} diff --git a/pkg/worker/emulator/libretro/nanoarch_test.go b/pkg/worker/emulator/libretro/nanoarch_test.go deleted file mode 100644 index 7b08f534..00000000 --- a/pkg/worker/emulator/libretro/nanoarch_test.go +++ /dev/null @@ -1,228 +0,0 @@ -package libretro - -import ( - "crypto/md5" - "fmt" - "io" - "log" - "os" - "path" - "path/filepath" - "testing" - "unsafe" - - "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" -) - -type testRun struct { - room string - system string - rom string - emulationTicks int -} - -// EmulatorMock contains Frontend mocking data. -type EmulatorMock struct { - Frontend - - // Libretro compiled lib core name - core string - // shared core paths (can't be changed) - paths EmulatorPaths -} - -// EmulatorPaths defines various emulator file paths. -type EmulatorPaths struct { - assets string - cores string - games string - save string -} - -// GetEmulatorMock returns a properly stubbed emulator instance. -// Due to extensive use of globals -- one mock instance is allowed per a test run. -// Don't forget to init one image channel consumer, it will lock-out otherwise. -// Make sure you call shutdownEmulator(). -func GetEmulatorMock(room string, system string) *EmulatorMock { - rootPath := getRootPath() - - var conf config.WorkerConfig - if _, err := config.LoadConfig(&conf, ""); err != nil { - panic(err) - } - - meta := conf.Emulator.GetLibretroCoreConfig(system) - - l := logger.Default() - l2 := l.Extend(l.Level(logger.ErrorLevel).With()) - SetLibretroLogger(l2) - - // an emu - emu := &EmulatorMock{ - Frontend: Frontend{ - conf: conf.Emulator, - storage: &StateStorage{ - Path: os.TempDir(), - MainSave: room, - }, - input: NewGameSessionInput(), - done: make(chan struct{}), - th: conf.Emulator.Threads, - log: l2, - }, - - core: path.Base(meta.Lib), - - paths: EmulatorPaths{ - assets: cleanPath(rootPath), - cores: cleanPath(rootPath + "assets/cores/"), - games: cleanPath(rootPath + "assets/games/"), - }, - } - - emu.paths.save = cleanPath(emu.GetHashPath()) - frontend = &emu.Frontend - - Init(cleanPath(conf.Emulator.LocalPath)) - - return emu -} - -// GetDefaultEmulatorMock returns initialized emulator mock with default params. -// Spawns audio/image channels consumers. -// Don't forget to close emulator mock with shutdownEmulator(). -func GetDefaultEmulatorMock(room string, system string, rom string) *EmulatorMock { - mock := GetEmulatorMock(room, system) - mock.loadRom(rom) - mock.handleVideo(func(_ *emulator.GameFrame) {}) - mock.handleAudio(func(_ *emulator.GameAudio) {}) - - return mock -} - -// loadRom loads a ROM into the emulator. -// The rom will be loaded from emulators' games path. -func (emu *EmulatorMock) loadRom(game string) { - fmt.Printf("%v %v\n", emu.paths.cores, emu.core) - coreLoad(emulator.Metadata{LibPath: emu.paths.cores + emu.core}) - err := LoadGame(emu.paths.games + game) - if err != nil { - log.Fatal(err) - } - w, h := emu.GetFrameSize() - if emu.conf.Scale == 0 { - emu.conf.Scale = 1 - } - emu.SetViewport(w, h, emu.conf.Scale) -} - -// shutdownEmulator closes the emulator and cleans its resources. -func (emu *EmulatorMock) shutdownEmulator() { - _ = os.Remove(emu.GetHashPath()) - _ = os.Remove(emu.GetSRAMPath()) - - nanoarchShutdown() -} - -// emulateOneFrame emulates one frame with exclusive lock. -func (emu *EmulatorMock) emulateOneFrame() { - emu.mu.Lock() - run() - emu.mu.Unlock() -} - -// Who needs generics anyway? -// handleVideo is a custom message handler for the video channel. -func (emu *EmulatorMock) handleVideo(handler func(image *emulator.GameFrame)) { - emu.Frontend.onVideo = handler -} - -// handleAudio is a custom message handler for the audio channel. -func (emu *EmulatorMock) handleAudio(handler func(sample *emulator.GameAudio)) { - emu.Frontend.onAudio = handler -} - -// dumpState returns the current emulator state and -// the latest saved state for its session. -// Locks the emulator. -func (emu *EmulatorMock) dumpState() (string, string) { - emu.mu.Lock() - bytes, _ := os.ReadFile(emu.paths.save) - persistedStateHash := getHash(bytes) - emu.mu.Unlock() - - stateHash := emu.getStateHash() - fmt.Printf("mem: %v, dat: %v\n", stateHash, persistedStateHash) - return stateHash, persistedStateHash -} - -// getStateHash returns the current emulator state hash. -// Locks the emulator. -func (emu *EmulatorMock) getStateHash() string { - emu.mu.Lock() - state, _ := getSaveState() - emu.mu.Unlock() - - return getHash(state) -} - -func (emu *EmulatorMock) Close() { - emu.Frontend.Close() - <-nano.reserved -} - -// getRootPath returns absolute path to the root directory. -func getRootPath() string { - p, _ := filepath.Abs("../../../../") - return p + string(filepath.Separator) -} - -// getHash returns MD5 hash. -func getHash(bytes []byte) string { - return fmt.Sprintf("%x", md5.Sum(bytes)) -} - -// cleanPath returns a proper file path for current OS. -func cleanPath(path string) string { - return filepath.FromSlash(path) -} - -// benchmarkEmulator is a generic function for -// measuring emulator performance for one emulation frame. -func benchmarkEmulator(system string, rom string, b *testing.B) { - b.StopTimer() - log.SetOutput(io.Discard) - os.Stdout, _ = os.Open(os.DevNull) - libretroLogger = logger.New(false) - - s := GetDefaultEmulatorMock("bench_"+system+"_performance", system, rom) - - b.StartTimer() - for i := 0; i < b.N; i++ { - s.emulateOneFrame() - } - s.shutdownEmulator() -} - -func BenchmarkEmulatorGba(b *testing.B) { - benchmarkEmulator("gba", "Sushi The Cat.gba", b) -} - -func BenchmarkEmulatorNes(b *testing.B) { - benchmarkEmulator("nes", "Alwa's Awakening (Demo).nes", b) -} - -func TestSwap(t *testing.T) { - data := []byte{1, 254, 255, 32} - pixel := *(*uint32)(unsafe.Pointer(&data[0])) - // 0 1 2 3 - // 2 1 0 3 - ll := ((pixel >> 16) & 0xff) | (pixel & 0xff00) | ((pixel << 16) & 0xff0000) | 0xff000000 - - rez := []byte{0, 0, 0, 0} - *(*uint32)(unsafe.Pointer(&rez[0])) = ll - - log.Printf("%v\n%v", data, rez) -} diff --git a/pkg/worker/emulator/libretro/repo/raw/repository.go b/pkg/worker/emulator/libretro/repo/raw/repository.go deleted file mode 100644 index 47fb8878..00000000 --- a/pkg/worker/emulator/libretro/repo/raw/repository.go +++ /dev/null @@ -1,20 +0,0 @@ -package raw - -import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" -) - -type Repo struct { - Address string - Compression string -} - -// NewRawRepo defines a simple zip file containing -// all the cores that will be extracted as is. -func NewRawRepo(address string) Repo { - return Repo{Address: address, Compression: "zip"} -} - -func (r Repo) GetCoreUrl(_ string, _ libretro.ArchInfo) string { - return r.Address -} diff --git a/pkg/worker/media.go b/pkg/worker/media/media.go similarity index 53% rename from pkg/worker/media.go rename to pkg/worker/media/media.go index 9a13ab58..e6d0cab9 100644 --- a/pkg/worker/media.go +++ b/pkg/worker/media/media.go @@ -1,21 +1,22 @@ -package worker +package media import ( + "fmt" "sync" "time" "unsafe" "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" "github.com/giongto35/cloud-game/v3/pkg/worker/encoder" "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/h264" "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/opus" "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/vpx" - webrtc "github.com/pion/webrtc/v3/pkg/media" ) const ( - dstHz = 48000 + audioHz = 48000 sampleBufLen = 1024 * 4 ) @@ -33,7 +34,6 @@ type ( var ( encoderOnce = sync.Once{} opusCoder *opus.Encoder - samplePool sync.Pool audioPool = sync.Pool{New: func() any { b := make([]int16, sampleBufLen); return &b }} ) @@ -70,6 +70,18 @@ func (b *buffer) write(s samples, onFull func(samples)) (r int) { return } +func DefaultOpus() (*opus.Encoder, error) { + var err error + encoderOnce.Do(func() { opusCoder, err = opus.NewEncoder(audioHz) }) + if err != nil { + return nil, err + } + if err = opusCoder.Reset(); err != nil { + return nil, err + } + return opusCoder, nil +} + // frame calculates an audio stereo frame size, i.e. 48k*frame/1000*2 func frame(hz int, frame int) int { return hz * frame / 1000 * 2 } @@ -90,84 +102,90 @@ func (s samples) stretch(size int) []int16 { return out } -func (r *Room) initAudio(srcHz int, conf config.Audio) { - encoderOnce.Do(func() { - enc, err := opus.NewEncoder(dstHz) - if err != nil { - r.log.Fatal().Err(err).Msg("couldn't create audio encoder") - } - opusCoder = enc - }) - if err := opusCoder.Reset(); err != nil { - r.log.Error().Err(err).Msgf("opus state reset fail") - } - r.log.Debug().Msgf("Opus: %v", opusCoder.GetInfo()) +type WebrtcMediaPipe struct { + onAudio func([]byte) + opus *opus.Encoder + audioBuf buffer + log *logger.Logger + enc *encoder.VideoEncoder - buf := newBuffer(frame(srcHz, conf.Frame)) - if srcHz != dstHz { - buf.enableStretch(frame(dstHz, conf.Frame)) - r.log.Debug().Msgf("Resample %vHz -> %vHz", srcHz, dstHz) - } - frameDur := time.Duration(conf.Frame) * time.Millisecond + aConf config.Audio + vConf config.Video - r.emulator.SetAudio(func(raw *emulator.GameAudio) { - buf.write(*raw.Data, func(pcm samples) { - data, err := opusCoder.Encode(pcm) - audioPool.Put((*[]int16)(&pcm)) - if err != nil { - r.log.Error().Err(err).Msgf("opus encode fail") - return - } - r.handleSample(data, frameDur, func(u *Session, s *webrtc.Sample) error { return u.SendAudio(s) }) - }) - }) + AudioSrcHz int + AudioFrame int + VideoW, VideoH int } -// initVideo processes videoFrames images with an encoder (codec) then pushes the result to WebRTC. -func (r *Room) initVideo(w, h int, conf config.Video) { +func NewWebRtcMediaPipe(ac config.Audio, vc config.Video, log *logger.Logger) *WebrtcMediaPipe { + return &WebrtcMediaPipe{log: log, aConf: ac, vConf: vc} +} + +func (wmp *WebrtcMediaPipe) SetAudioCb(cb func([]byte, int32)) { + fr := int32(time.Duration(wmp.AudioFrame) * time.Millisecond) + wmp.onAudio = func(bytes []byte) { cb(bytes, fr) } +} +func (wmp *WebrtcMediaPipe) Destroy() { + if wmp.enc != nil { + wmp.enc.Stop() + } +} +func (wmp *WebrtcMediaPipe) PushAudio(audio []int16) { wmp.audioBuf.write(audio, wmp.encodeAudio) } + +func (wmp *WebrtcMediaPipe) Init() error { + if err := wmp.initAudio(wmp.AudioSrcHz, wmp.AudioFrame); err != nil { + return err + } + if err := wmp.initVideo(wmp.VideoW, wmp.VideoH, wmp.vConf); err != nil { + return err + } + return nil +} + +func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSize int) error { + au, err := DefaultOpus() + if err != nil { + return fmt.Errorf("opus fail: %w", err) + } + wmp.log.Debug().Msgf("Opus: %v", au.GetInfo()) + wmp.opus = au + buf := newBuffer(frame(srcHz, frameSize)) + dstHz, _ := au.SampleRate() + if srcHz != dstHz { + buf.enableStretch(frame(dstHz, frameSize)) + wmp.log.Debug().Msgf("Resample %vHz -> %vHz", srcHz, dstHz) + } + wmp.audioBuf = buf + return nil +} + +func (wmp *WebrtcMediaPipe) encodeAudio(pcm samples) { + data, err := wmp.opus.Encode(pcm) + audioPool.Put((*[]int16)(&pcm)) + if err != nil { + wmp.log.Error().Err(err).Msgf("opus encode fail") + return + } + wmp.onAudio(data) +} + +func (wmp *WebrtcMediaPipe) initVideo(w, h int, conf config.Video) error { var enc encoder.Encoder var err error - - r.log.Info().Msgf("Video codec: %v", conf.Codec) + wmp.log.Info().Msgf("Video codec: %v", conf.Codec) if conf.Codec == string(encoder.H264) { - r.log.Debug().Msgf("x264: build v%v", h264.LibVersion()) + wmp.log.Debug().Msgf("x264: build v%v", h264.LibVersion()) opts := h264.Options(conf.H264) enc, err = h264.NewEncoder(w, h, &opts) } else { opts := vpx.Options(conf.Vpx) enc, err = vpx.NewEncoder(w, h, &opts) } - if err != nil { - r.log.Error().Err(err).Msg("couldn't create a video encoder") - return + return fmt.Errorf("couldn't create a video encoder: %w", err) } - - r.vEncoder = encoder.NewVideoEncoder(enc, w, h, conf.Concurrency, r.log) - - r.emulator.SetVideo(func(raw *emulator.GameFrame) { - data := r.vEncoder.Encode(raw.Data.RGBA) - if data == nil { - r.log.Warn().Msgf("no data after video encoding") - return - } - r.handleSample(data, raw.Duration, func(u *Session, s *webrtc.Sample) error { return u.SendVideo(s) }) - }) + wmp.enc = encoder.NewVideoEncoder(enc, w, h, conf.Concurrency, wmp.log) + return nil } -func (r *Room) handleSample(b []byte, d time.Duration, fn func(*Session, *webrtc.Sample) error) { - sample, _ := samplePool.Get().(*webrtc.Sample) - if sample == nil { - sample = new(webrtc.Sample) - } - sample.Data = b - sample.Duration = d - r.users.ForEach(func(u *Session) { - if u.IsConnected() { - if err := fn(u, sample); err != nil { - r.log.Error().Err(err).Send() - } - } - }) - samplePool.Put(sample) -} +func (wmp *WebrtcMediaPipe) ProcessVideo(v app.Video) []byte { return wmp.enc.Encode(&v.Frame) } diff --git a/pkg/worker/media_test.go b/pkg/worker/media/media_test.go similarity index 97% rename from pkg/worker/media_test.go rename to pkg/worker/media/media_test.go index 4e5a03f6..70aea225 100644 --- a/pkg/worker/media_test.go +++ b/pkg/worker/media/media_test.go @@ -1,4 +1,4 @@ -package worker +package media import ( "image" @@ -94,19 +94,11 @@ func TestResampleStretch(t *testing.T) { want []int16 }{ //1764:1920 - { - name: "", - args: args{ - pcm: gen(1764), - size: 1920, - }, - want: nil, - }, + {name: "", args: args{pcm: gen(1764), size: 1920}, want: nil}, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { rez2 := tt.args.pcm.stretch(tt.args.size) - if rez2[0] != tt.args.pcm[0] || rez2[1] != tt.args.pcm[1] || rez2[len(rez2)-1] != tt.args.pcm[len(tt.args.pcm)-1] || rez2[len(rez2)-2] != tt.args.pcm[len(tt.args.pcm)-2] { diff --git a/pkg/worker/recorder/recorder.go b/pkg/worker/recorder/recorder.go index 961e9191..24edc4c8 100644 --- a/pkg/worker/recorder/recorder.go +++ b/pkg/worker/recorder/recorder.go @@ -56,7 +56,7 @@ type videoStream interface { type ( Audio struct { - Samples *[]int16 + Samples []int16 Duration time.Duration } Video struct { @@ -133,9 +133,11 @@ func (r *Recording) Stop() (err error) { func (r *Recording) Set(enable bool, user string) { r.Lock() + r.meta.UserName = user if !r.enabled && enable { r.Unlock() r.Start() + r.log.Debug().Msgf("[REC] set: +, user: %v", user) r.Lock() } else { if r.enabled && !enable { @@ -148,10 +150,12 @@ func (r *Recording) Set(enable bool, user string) { } } r.enabled = enable - r.meta.UserName = user r.Unlock() } +func (r *Recording) SetFramerate(fps float64) { r.opts.Fps = fps } +func (r *Recording) SetAudioFrequency(fq int) { r.opts.Frequency = fq } + func (r *Recording) Enabled() bool { r.Lock() defer r.Unlock() diff --git a/pkg/worker/recorder/recorder_test.go b/pkg/worker/recorder/recorder_test.go index 0e923214..e4441749 100644 --- a/pkg/worker/recorder/recorder_test.go +++ b/pkg/worker/recorder/recorder_test.go @@ -36,7 +36,7 @@ func TestName(t *testing.T) { Game: fmt.Sprintf("test_game_%v", rand.Int()), ImageCompressionLevel: 0, Name: "test", - Zip: true, + Zip: false, }) recorder.Set(true, "test_user") @@ -53,7 +53,7 @@ func TestName(t *testing.T) { imgWg.Done() }() go func() { - recorder.WriteAudio(Audio{&[]int16{0, 0, 0, 0, 0, 1, 11, 11, 11, 1}, 1}) + recorder.WriteAudio(Audio{[]int16{0, 0, 0, 0, 0, 1, 11, 11, 11, 1}, 1}) audioWg.Done() }() } @@ -125,7 +125,7 @@ func benchmarkRecorder(w, h int, comp int, b *testing.B) { ticks.Done() }() go func() { - recorder.WriteAudio(Audio{&samples, 1}) + recorder.WriteAudio(Audio{samples, 1}) atomic.AddInt64(&bytes, int64(len(samples)*2)) ticks.Done() }() diff --git a/pkg/worker/recorder/wavstream.go b/pkg/worker/recorder/wavstream.go index f63ea70e..7b4e0b09 100644 --- a/pkg/worker/recorder/wavstream.go +++ b/pkg/worker/recorder/wavstream.go @@ -52,7 +52,7 @@ func (w *wavStream) Close() (err error) { } func (w *wavStream) Write(data Audio) { - pcm := *data.Samples + pcm := data.Samples bs := make([]byte, len(pcm)*2) // int & 0xFF + (int >> 8) & 0xFF for i, ln := 0, len(pcm); i < ln; i++ { diff --git a/pkg/worker/recording.go b/pkg/worker/recording.go deleted file mode 100644 index c912c16c..00000000 --- a/pkg/worker/recording.go +++ /dev/null @@ -1,69 +0,0 @@ -package worker - -import ( - "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" - "github.com/giongto35/cloud-game/v3/pkg/worker/recorder" -) - -type RecordingRoom struct { - GamingRoom - rec *recorder.Recording -} - -func WithRecording(room GamingRoom, rec bool, recUser string, game string, conf config.WorkerConfig) *RecordingRoom { - rr := &RecordingRoom{GamingRoom: room, rec: recorder.NewRecording( - recorder.Meta{UserName: recUser}, - room.GetLog(), - recorder.Options{ - Dir: conf.Recording.Folder, - Fps: float64(room.GetEmulator().GetFps()), - Frequency: int(room.GetEmulator().GetSampleRate()), - Game: game, - ImageCompressionLevel: conf.Recording.CompressLevel, - Name: conf.Recording.Name, - Zip: conf.Recording.Zip, - Vsync: true, - })} - rr.ToggleRecording(rec, recUser) - rr.captureAudio() - rr.captureVideo() - return rr -} - -func (r *RecordingRoom) captureAudio() { - handler := r.GetEmulator().GetAudio() - r.GetEmulator().SetAudio(func(samples *emulator.GameAudio) { - if r.IsRecording() { - r.rec.WriteAudio(recorder.Audio{Samples: samples.Data, Duration: samples.Duration}) - } - handler(samples) - }) -} - -func (r *RecordingRoom) captureVideo() { - handler := r.GetEmulator().GetVideo() - r.GetEmulator().SetVideo(func(frame *emulator.GameFrame) { - if r.IsRecording() { - r.rec.WriteVideo(recorder.Video{Image: frame.Data, Duration: frame.Duration}) - } - handler(frame) - }) -} - -func (r *RecordingRoom) ToggleRecording(active bool, user string) { - if r.rec == nil { - return - } - r.GetLog().Debug().Msgf("[REC] set: %v, user: %v", active, user) - r.rec.Set(active, user) -} - -func (r *RecordingRoom) IsRecording() bool { return r.rec != nil && r.rec.Enabled() } - -func (r *RecordingRoom) Close() { - r.GamingRoom.Close() - if r.rec != nil { - r.rec.Set(false, "") - } -} diff --git a/pkg/worker/room.go b/pkg/worker/room.go deleted file mode 100644 index d7e4f51a..00000000 --- a/pkg/worker/room.go +++ /dev/null @@ -1,190 +0,0 @@ -package worker - -import ( - "time" - - "github.com/giongto35/cloud-game/v3/pkg/com" - "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/games" - "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/os" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder" -) - -type GamingRoom interface { - GetId() string - Close() - CleanupUser(*Session) - HasSave() bool - StartEmulator() - SaveGame() error - LoadGame() error - ToggleMultitap() - HasUser(*Session) bool - AddUser(*Session) - PollUserInput(*Session) - EnableAutosave(periodS int) - GetEmulator() emulator.Emulator - GetLog() *logger.Logger -} - -type Room struct { - id string - done chan struct{} - vEncoder *encoder.VideoEncoder - users com.NetMap[*Session] // a list of users in the room - emulator emulator.Emulator - onClose func(self *Room) - closed bool - log *logger.Logger -} - -func NewRoom(id string, game games.GameMetadata, onClose func(*Room), conf config.WorkerConfig, log *logger.Logger) *Room { - if id == "" { - id = games.GenerateRoomID(game.Name) - } - log = log.Extend(log.With().Str("room", id[:5])) - log.Info().Str("game", game.Name).Send() - room := &Room{id: id, users: com.NewNetMap[*Session](), done: make(chan struct{}), onClose: onClose, log: log} - - nano, err := libretro.NewFrontend(conf.Emulator, log) - if err != nil { - log.Fatal().Err(err).Send() - } - if conf.Recording.Enabled { - nano.DisableCanvasPool = true - } - room.emulator = nano - room.emulator.SetMainSaveName(id) - room.emulator.LoadMetadata(game.System) - err = room.emulator.LoadGame(game.FullPath(conf.Worker.Library.BasePath)) - if err != nil { - log.Fatal().Err(err).Msgf("couldn't load the game %v", game) - } - // calc output frame size and rotation - w, h := room.whatsFrame(conf.Emulator) - if room.emulator.HasVerticalFrame() { - w, h = h, w - } - room.emulator.SetViewport(w, h, conf.Emulator.Scale) - - room.initVideo(w, h, conf.Encoder.Video) - room.initAudio(int(room.emulator.GetSampleRate()), conf.Encoder.Audio) - - log.Info().Str("room", room.GetId()). - Str("game", game.Name). - Msg("New room") - return room -} - -func (r *Room) GetEmulator() emulator.Emulator { return r.emulator } -func (r *Room) GetId() string { return r.id } -func (r *Room) GetLog() *logger.Logger { return r.log } -func (r *Room) HasSave() bool { return os.Exists(r.emulator.GetHashPath()) } -func (r *Room) HasUser(u *Session) bool { return r != nil && r.users.Has(u.id) } -func (r *Room) IsEmpty() bool { return r.users.Len() == 0 } -func (r *Room) LoadGame() error { return r.emulator.LoadGameState() } -func (r *Room) SaveGame() error { return r.emulator.SaveGameState() } -func (r *Room) StartEmulator() { go r.emulator.Start() } -func (r *Room) ToggleMultitap() { r.emulator.ToggleMultitap() } - -func (r *Room) EnableAutosave(periodSec int) { - r.log.Info().Msgf("Autosave every [%vs]", periodSec) - ticker := time.NewTicker(time.Duration(periodSec) * time.Second) - defer ticker.Stop() - - for { - select { - case <-ticker.C: - if r.closed { - continue - } - if err := r.emulator.SaveGameState(); err != nil { - r.log.Error().Msgf("Autosave failed: %v", err) - } else { - r.log.Debug().Msgf("Autosave done") - } - case <-r.done: - return - } - } -} - -func (r *Room) whatsFrame(conf config.Emulator) (ww int, hh int) { - w, h := r.emulator.GetFrameSize() - // nwidth, nheight are the WebRTC output size - var nwidth, nheight int - emu, ar := conf, conf.AspectRatio - - if ar.Keep { - baseAspectRatio := float64(w) / float64(ar.Height) - nwidth, nheight = ar.ResizeToAspect(baseAspectRatio, ar.Width, ar.Height) - r.log.Info().Msgf("Viewport size will be changed from %dx%d (%f) -> %dx%d", ar.Width, ar.Height, - baseAspectRatio, nwidth, nheight) - } else { - nwidth, nheight = w, h - r.log.Info().Msgf("Viewport resolution: %dx%d", nwidth, nheight) - } - - if emu.Scale > 1 { - nwidth, nheight = nwidth*emu.Scale, nheight*emu.Scale - r.log.Info().Msgf("Viewport size has scaled to %dx%d", nwidth, nheight) - } - - // set game frame size considering its orientation - ww, hh = nwidth, nheight - return -} - -func (r *Room) PollUserInput(session *Session) { - r.log.Debug().Msg("Start session input poll") - session.GetPeerConn().OnMessage = func(data []byte) { r.emulator.Input(session.GetPlayerIndex(), data) } -} - -func (r *Room) AddUser(user *Session) { - r.users.Add(user) - user.SetRoom(r) - r.log.Debug().Str("user", user.Id().String()).Msg("User has joined the room") -} - -func (r *Room) CleanupUser(user *Session) { - user.SetRoom(nil) - if r.HasUser(user) { - r.users.Remove(user) - r.log.Debug().Str("user", user.Id().String()).Msg("User has left the room") - } - if r.IsEmpty() { - r.log.Debug().Msg("The room is empty") - r.Close() - } -} - -func (r *Room) Close() { - r.log.Debug().Msg("Closing the room") - if r.closed { - r.log.Debug().Msg("Close room skip") - return - } - - r.closed = true - - // Save game before quit. Only save for game which was previous saved to avoid flooding database - if r.HasSave() { - r.log.Debug().Msg("Save game before closing room") - if err := r.SaveGame(); err != nil { - r.log.Error().Err(err).Msg("couldn't save the game during close") - } - } - r.emulator.Close() - close(r.done) - - if r.vEncoder != nil { - r.vEncoder.Stop() - } - - if r.onClose != nil { - r.onClose(r) - } -} diff --git a/pkg/worker/room/cast.go b/pkg/worker/room/cast.go new file mode 100644 index 00000000..d8a9710f --- /dev/null +++ b/pkg/worker/room/cast.go @@ -0,0 +1,22 @@ +package room + +import ( + "github.com/giongto35/cloud-game/v3/pkg/com" + "github.com/giongto35/cloud-game/v3/pkg/network/webrtc" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro" +) + +type GameRouter struct { + Router[*GameSession] +} + +func NewGameRouter() *GameRouter { + u := com.NewNetMap[string, *GameSession]() + return &GameRouter{Router: Router[*GameSession]{users: &u}} +} + +func WithEmulator(wtf any) *libretro.Caged { return wtf.(*libretro.Caged) } +func WithRecorder(wtf any) *libretro.RecordingFrontend { + return (WithEmulator(wtf).Emulator).(*libretro.RecordingFrontend) +} +func WithWebRTC(wtf Session) *webrtc.Peer { return wtf.(*webrtc.Peer) } diff --git a/pkg/worker/room/cast_test.go b/pkg/worker/room/cast_test.go new file mode 100644 index 00000000..cf50dc69 --- /dev/null +++ b/pkg/worker/room/cast_test.go @@ -0,0 +1,36 @@ +package room + +import ( + "testing" + + "github.com/giongto35/cloud-game/v3/pkg/network/webrtc" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro" +) + +func TestGoodWithRecorder(t *testing.T) { + WithRecorder(&libretro.Caged{Emulator: &libretro.RecordingFrontend{}}) +} + +func TestBadWithRecorder(t *testing.T) { + defer func() { _ = recover() }() + WithEmulator(libretro.Caged{}) + t.Errorf("no panic") +} + +func TestGoodWithEmulator(t *testing.T) { WithEmulator(&libretro.Caged{}) } + +func TestBadWithEmulator(t *testing.T) { + defer func() { _ = recover() }() + WithEmulator(libretro.Caged{}) // not a pointer + t.Errorf("no panic") +} + +func TestGoodWithWebRTCCast(t *testing.T) { + WithWebRTC(GameSession{AppSession: AppSession{Session: &webrtc.Peer{}}}.Session) +} + +func TestBadWithWebRTCCast(t *testing.T) { + defer func() { _ = recover() }() + WithWebRTC(GameSession{}) // not a Session due to deep nesting + t.Errorf("no panic") +} diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go new file mode 100644 index 00000000..0acbcf02 --- /dev/null +++ b/pkg/worker/room/room.go @@ -0,0 +1,139 @@ +package room + +import "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + +type MediaPipe interface { + // Destroy frees all allocated resources. + Destroy() + // Init initializes the pipe: allocates needed resources. + Init() error + // PushAudio pushes the 16bit PCM audio frames into an encoder. + // Because we need to fill the buffer, the SetAudioCb should be + // used in order to get the result. + PushAudio([]int16) + // ProcessVideo returns encoded video frame. + ProcessVideo(app.Video) []byte + // SetAudioCb sets a callback for encoded audio data with its frame duration (ns). + SetAudioCb(func(data []byte, duration int32)) +} + +type SessionManager[T Session] interface { + Add(T) bool + Find(string) (T, bool) + ForEach(func(T)) + Len() int + Remove(T) + // Reset used for proper cleanup of the resources if needed. + Reset() +} + +type Session interface { + Disconnect() + SendAudio([]byte, int32) + SendVideo([]byte, int32) + SendData([]byte) +} + +type Uid interface { + Id() string +} + +type Room[T Session] struct { + app app.App + id string + media MediaPipe + users SessionManager[T] + + closed bool + HandleClose func() +} + +func NewRoom[T Session](id string, app app.App, um SessionManager[T], media MediaPipe) *Room[T] { + room := &Room[T]{id: id, app: app, users: um, media: media} + room.InitVideo() + room.InitAudio() + return room +} + +func (r *Room[T]) InitAudio() { + r.app.SetAudioCb(func(a app.Audio) { r.media.PushAudio(a.Data) }) + r.media.SetAudioCb(func(d []byte, l int32) { r.users.ForEach(func(u T) { u.SendAudio(d, l) }) }) +} + +func (r *Room[T]) InitVideo() { + r.app.SetVideoCb(func(v app.Video) { + data := r.media.ProcessVideo(v) + r.users.ForEach(func(u T) { u.SendVideo(data, v.Duration) }) + }) +} + +func (r *Room[T]) App() app.App { return r.app } +func (r *Room[T]) Id() string { return r.id } +func (r *Room[T]) StartApp() { r.app.Start() } + +func (r *Room[T]) Close() { + if r.closed { + return + } + r.closed = true + + if r.app != nil { + r.app.Close() + } + if r.media != nil { + r.media.Destroy() + } + if r.HandleClose != nil { + r.HandleClose() + } +} + +// Router tracks and routes freshly connected users to an app room. +// Rooms and users has 1-to-n relationship. +type Router[T Session] struct { + room *Room[T] + users SessionManager[T] +} + +func (r *Router[T]) AddUser(user T) { r.users.Add(user) } +func (r *Router[T]) Close() { + if r.room != nil { + r.room.Close() + r.room = nil + } +} +func (r *Router[T]) FindRoom(id string) *Room[T] { + if r.room != nil && r.room.Id() == id { + return r.room + } + return nil +} +func (r *Router[T]) FindUser(uid Uid) T { sess, _ := r.users.Find(uid.Id()); return sess } +func (r *Router[T]) Remove(user T) { + r.users.Remove(user) + if r.users.Len() == 0 { + if r.room != nil { + r.room.Close() + } + r.users.Reset() + } +} +func (r *Router[T]) SetRoom(room *Room[T]) { r.room = room } +func (r *Router[T]) Users() SessionManager[T] { return r.users } + +type AppSession struct { + Uid + Session + uid string +} + +func (p AppSession) Id() string { return p.uid } + +type GameSession struct { + AppSession + Index int // track user Index (i.e. player 1,2,3,4 select) +} + +func NewGameSession(id Uid, s Session) *GameSession { + return &GameSession{AppSession: AppSession{uid: id.Id(), Session: s}} +} diff --git a/pkg/worker/room/room_test.go b/pkg/worker/room/room_test.go new file mode 100644 index 00000000..d74924e9 --- /dev/null +++ b/pkg/worker/room/room_test.go @@ -0,0 +1,301 @@ +package room + +import ( + "flag" + "fmt" + "hash/crc32" + "image" + "image/color" + "image/draw" + "image/png" + "log" + "os" + "path/filepath" + "runtime" + "sync" + "testing" + "time" + + "github.com/giongto35/cloud-game/v3/pkg/com" + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/games" + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + canvas "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/image" + "github.com/giongto35/cloud-game/v3/pkg/worker/encoder" + "github.com/giongto35/cloud-game/v3/pkg/worker/media" + "github.com/giongto35/cloud-game/v3/pkg/worker/thread" + "golang.org/x/image/font" + "golang.org/x/image/font/basicfont" + "golang.org/x/image/math/fixed" +) + +var ( + renderFrames bool + outputPath string + autoGlContext bool +) + +type testRoom struct { + *Room[*GameSession] + started bool +} + +type codec = encoder.VideoCodec + +type conf struct { + roomName string + game games.GameMetadata + codec codec + autoGlContext bool + autoAppStart bool + noLog bool +} + +func (r testRoom) Close() { + r.Room.Close() + time.Sleep(2 * time.Second) // hack: wait room destruction (atm impossible to tell) +} + +func (r testRoom) WaitFrames(n int) canvas.Frame { + var frame canvas.Frame + var wg sync.WaitGroup + wg.Add(n) + WithEmulator(r.app).SetVideoCb(func(v app.Video) { + if n > 0 { + frame = (&canvas.Frame{RGBA: v.Frame}).Copy() + wg.Done() + } + n-- + }) + if !r.started { + r.StartApp() + } + wg.Wait() + return frame +} + +type testParams struct { + system string + game games.GameMetadata + codecs []codec + frames int +} + +// Store absolute path to test games +var testTempDir = filepath.Join(os.TempDir(), "cloud-game-core-tests") +var root = "" + +// games +var ( + alwas = games.GameMetadata{Name: "Alwa's Awakening (Demo)", Type: "nes", Path: "Alwa's Awakening (Demo).nes", System: "nes"} + sushi = games.GameMetadata{Name: "Sushi The Cat", Type: "gba", Path: "Sushi The Cat.gba", System: "gba"} + fd = games.GameMetadata{Name: "Florian Demo", Type: "n64", Path: "Sample Demo by Florian (PD).z64", System: "n64"} +) + +func init() { + runtime.LockOSThread() + p, _ := filepath.Abs("../../../") + root = p + string(filepath.Separator) +} + +func TestMain(m *testing.M) { + flag.BoolVar(&renderFrames, "renderFrames", false, "Render frames for eye testing purposes") + flag.StringVar(&outputPath, "outputPath", "./", "Output path for generated files") + flag.BoolVar(&autoGlContext, "autoGlContext", false, "Set auto GL context choose for headless machines") + + thread.Wrap(func() { os.Exit(m.Run()) }) +} + +func TestRoom(t *testing.T) { + tests := []testParams{ + {game: alwas, codecs: []codec{encoder.H264}, frames: 300}, + } + + for _, test := range tests { + room := room(conf{codec: test.codecs[0], game: test.game}) + room.WaitFrames(test.frames) + room.Close() + } +} + +func TestAll(t *testing.T) { + tests := []testParams{ + {game: sushi, frames: 150}, + {game: alwas, frames: 50}, + {game: fd, frames: 50, system: "main-thread"}, + } + + crc32q := crc32.MakeTable(0xD5828281) + + for _, test := range tests { + room := room(conf{game: test.game, codec: encoder.VP8, autoGlContext: autoGlContext, autoAppStart: false}) + var frame canvas.Frame + if test.system == "main-thread" { + thread.Main(func() { + frame = room.WaitFrames(test.frames) + room.Close() + }) + } else { + frame = room.WaitFrames(test.frames) + room.Close() + } + if renderFrames { + tag := fmt.Sprintf("%v-%v-0x%08x", runtime.GOOS, test.game.Type, crc32.Checksum(frame.Pix, crc32q)) + dumpCanvas(&frame, tag, fmt.Sprintf("%v [%v]", tag, test.frames), outputPath) + } + } +} + +func dumpCanvas(frame *canvas.Frame, name string, caption string, path string) { + // slap 'em caption + if caption != "" { + draw.Draw(frame, image.Rect(8, 8, 8+len(caption)*7+3, 24), &image.Uniform{C: color.RGBA{}}, image.Point{}, draw.Src) + (&font.Drawer{ + Dst: frame, + Src: image.NewUniform(color.RGBA{R: 255, G: 255, B: 255, A: 255}), + Face: basicfont.Face7x13, + Dot: fixed.Point26_6{X: fixed.Int26_6(10 * 64), Y: fixed.Int26_6(20 * 64)}, + }).DrawString(caption) + } + + outPath := testTempDir + if path != "" { + outPath = path + } + + if err := os.MkdirAll(outPath, 0770); err != nil { + log.Printf("Couldn't create target dir for the output images, %v", err) + return + } + + if f, err := os.Create(filepath.Join(outPath, name+".png")); err == nil { + if err = png.Encode(f, frame); err != nil { + log.Printf("Couldn't encode the image, %v", err) + } + _ = f.Close() + } else { + log.Printf("Couldn't create the image, %v", err) + } +} + +// room returns mocked Room struct. +func room(cfg conf) testRoom { + var conf config.WorkerConfig + if _, err := config.LoadConfig(&conf, ""); err != nil { + panic(err) + } + + conf.Worker.Library.BasePath = filepath.FromSlash(root + "/assets/games") + + fixEmulators(&conf, cfg.autoGlContext) + l := logger.NewConsole(conf.Worker.Debug, "w", false) + if cfg.noLog { + logger.SetGlobalLevel(logger.Disabled) + } + + conf.Encoder.Video.Codec = string(cfg.codec) + + id := cfg.roomName + if id == "" { + id = games.GenerateRoomID(cfg.game.Name) + } + + manager := caged.NewManager(l) + if err := manager.Load(caged.Libretro, conf); err != nil { + l.Fatal().Msgf("couldn't cage libretro: %v", err) + } + + emu := WithEmulator(manager.Get(caged.Libretro)) + emu.ReloadFrontend() + emu.SetSessionId(id) + if err := emu.Load(cfg.game, conf.Worker.Library.BasePath); err != nil { + l.Fatal().Err(err).Msgf("couldn't load the game %v", cfg.game) + } + + m := media.NewWebRtcMediaPipe(conf.Encoder.Audio, conf.Encoder.Video, l) + m.AudioSrcHz = emu.AudioSampleRate() + m.AudioFrame = conf.Encoder.Audio.Frame + m.VideoW, m.VideoH = emu.ViewportSize() + if err := m.Init(); err != nil { + l.Fatal().Err(err).Msgf("no init") + } + + room := NewRoom[*GameSession](id, emu, &com.NetMap[string, *GameSession]{}, m) + if cfg.autoAppStart { + room.StartApp() + } + + return testRoom{Room: room, started: cfg.autoAppStart} +} + +// fixEmulators makes absolute game paths in global GameList and passes GL context config. +// hack: emulator paths should be absolute and visible to the tests. +func fixEmulators(config *config.WorkerConfig, autoGlContext bool) { + config.Emulator.Libretro.Cores.Paths.Libs = + filepath.FromSlash(root + config.Emulator.Libretro.Cores.Paths.Libs) + config.Emulator.LocalPath = filepath.FromSlash(filepath.Join(root, "tests", config.Emulator.LocalPath)) + config.Emulator.Storage = filepath.FromSlash(filepath.Join(root, "tests", "storage")) + + for k, conf := range config.Emulator.Libretro.Cores.List { + if conf.IsGlAllowed && autoGlContext { + conf.AutoGlContext = true + } + config.Emulator.Libretro.Cores.List[k] = conf + } +} + +// Measures emulation performance of various +// emulators and encoding options. +func BenchmarkRoom(b *testing.B) { + benches := []testParams{ + // warm up + {system: "gba", game: sushi, codecs: []codec{encoder.VP8}, frames: 50}, + {system: "gba", game: sushi, codecs: []codec{encoder.VP8, encoder.H264}, frames: 100}, + {system: "nes", game: alwas, codecs: []codec{encoder.VP8, encoder.H264}, frames: 100}, + } + + for _, bench := range benches { + for _, cod := range bench.codecs { + b.Run(fmt.Sprintf("%s-%v-%d", bench.system, cod, bench.frames), func(b *testing.B) { + for i := 0; i < b.N; i++ { + b.StopTimer() + room := room(conf{game: bench.game, codec: cod, noLog: true}) + b.StartTimer() + room.WaitFrames(bench.frames) + b.StopTimer() + room.Room.Close() + } + }) + } + } +} + +type tSession struct{} + +func (t tSession) SendAudio([]byte, int32) {} +func (t tSession) SendVideo([]byte, int32) {} +func (t tSession) SendData([]byte) {} +func (t tSession) Disconnect() {} +func (t tSession) Id() string { return "1" } + +func TestRouter(t *testing.T) { + u := com.NewNetMap[string, *tSession]() + router := Router[*tSession]{users: &u} + + var r *Room[*tSession] + + router.SetRoom(&Room[*tSession]{id: "test001"}) + room := router.FindRoom("test001") + if room == nil { + t.Errorf("no room, but should be") + } + router.SetRoom(r) + room = router.FindRoom("x") + if room != nil { + t.Errorf("a room, but should not be") + } + router.SetRoom(nil) + router.Close() +} diff --git a/pkg/worker/room_test.go b/pkg/worker/room_test.go deleted file mode 100644 index 91c09b20..00000000 --- a/pkg/worker/room_test.go +++ /dev/null @@ -1,323 +0,0 @@ -package worker - -import ( - "flag" - "fmt" - "hash/crc32" - "image" - "image/color" - "image/draw" - "image/png" - "log" - "os" - "path/filepath" - "runtime" - "sync" - "testing" - "time" - - "github.com/giongto35/cloud-game/v3/pkg/config" - "github.com/giongto35/cloud-game/v3/pkg/games" - "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator" - image2 "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/image" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/manager/remotehttp" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder" - "github.com/giongto35/cloud-game/v3/pkg/worker/thread" - "golang.org/x/image/font" - "golang.org/x/image/font/basicfont" - "golang.org/x/image/math/fixed" -) - -var ( - renderFrames bool - outputPath string - autoGlContext bool -) - -type roomMock struct { - *Room - startEmulator bool -} - -func (rm roomMock) Close() { - rm.Room.Close() - // hack: wait room destruction - time.Sleep(2 * time.Second) -} - -func (rm roomMock) CloseNowait() { rm.Room.Close() } - -type roomMockConfig struct { - roomName string - gamesPath string - game games.GameMetadata - vCodec encoder.VideoCodec - autoGlContext bool - dontStartEmulator bool - noLog bool -} - -// Store absolute path to test games -var whereIsGames = getRootPath() + "assets/games/" -var testTempDir = filepath.Join(os.TempDir(), "cloud-game-core-tests") - -// games -var ( - alwas = games.GameMetadata{Name: "Alwa's Awakening (Demo)", Type: "nes", Path: "Alwa's Awakening (Demo).nes", System: "nes"} - sushi = games.GameMetadata{Name: "Sushi The Cat", Type: "gba", Path: "Sushi The Cat.gba", System: "gba"} - fd = games.GameMetadata{Name: "Florian Demo", Type: "n64", Path: "Sample Demo by Florian (PD).z64", System: "n64"} -) - -func init() { - runtime.LockOSThread() -} - -func TestMain(m *testing.M) { - flag.BoolVar(&renderFrames, "renderFrames", false, "Render frames for eye testing purposes") - flag.StringVar(&outputPath, "outputPath", "./", "Output path for generated files") - flag.BoolVar(&autoGlContext, "autoGlContext", false, "Set auto GL context choose for headless machines") - - thread.Wrap(func() { os.Exit(m.Run()) }) -} - -func TestRoom(t *testing.T) { - tests := []struct { - roomName string - game games.GameMetadata - vCodec encoder.VideoCodec - frames int - }{ - { - game: alwas, - vCodec: encoder.H264, - frames: 300, - }, - } - - for _, test := range tests { - room := getRoomMock(roomMockConfig{ - roomName: test.roomName, - gamesPath: whereIsGames, - game: test.game, - vCodec: test.vCodec, - }) - - t.Logf("The game [%v] has been loaded", test.game.Name) - waitNFrames(test.frames, room) - room.Close() - } -} - -func TestRoomWithGL(t *testing.T) { - tests := []struct { - game games.GameMetadata - vCodec encoder.VideoCodec - frames int - }{ - {game: fd, vCodec: encoder.VP8, frames: 50}, - } - - run := func() { - for _, test := range tests { - room := getRoomMock(roomMockConfig{ - gamesPath: whereIsGames, - game: test.game, - vCodec: test.vCodec, - }) - t.Logf("The game [%v] has been loaded", test.game.Name) - waitNFrames(test.frames, room) - room.Close() - } - } - - thread.Main(run) -} - -func TestAllEmulatorRooms(t *testing.T) { - tests := []struct { - game games.GameMetadata - frames int - }{ - {game: sushi, frames: 150}, - {game: alwas, frames: 50}, - {game: fd, frames: 50}, - } - - crc32q := crc32.MakeTable(0xD5828281) - - for _, test := range tests { - room := getRoomMock(roomMockConfig{ - gamesPath: whereIsGames, - game: test.game, - vCodec: encoder.VP8, - autoGlContext: autoGlContext, - dontStartEmulator: true, - }) - t.Logf("The game [%v] has been loaded", test.game.Name) - frame := waitNFrames(test.frames, room) - - if renderFrames { - tag := fmt.Sprintf("%v-%v-0x%08x", runtime.GOOS, test.game.Type, crc32.Checksum(frame.Data.Pix, crc32q)) - dumpCanvas(frame.Data, tag, fmt.Sprintf("%v [%v]", tag, test.frames), outputPath) - } - room.Close() - } -} - -func dumpCanvas(frame *image2.Frame, name string, caption string, path string) { - // slap 'em caption - if len(caption) > 0 { - draw.Draw(frame, image.Rect(8, 8, 8+len(caption)*7+3, 24), &image.Uniform{C: color.RGBA{}}, image.Point{}, draw.Src) - (&font.Drawer{ - Dst: frame, - Src: image.NewUniform(color.RGBA{R: 255, G: 255, B: 255, A: 255}), - Face: basicfont.Face7x13, - Dot: fixed.Point26_6{X: fixed.Int26_6(10 * 64), Y: fixed.Int26_6(20 * 64)}, - }).DrawString(caption) - } - - var outPath string - if len(path) > 0 { - outPath = path - } else { - outPath = testTempDir - } - - // really like Go's error handling - if err := os.MkdirAll(outPath, 0770); err != nil { - log.Printf("Couldn't create target dir for the output images, %v", err) - return - } - - if f, err := os.Create(filepath.Join(outPath, name+".png")); err == nil { - if err = png.Encode(f, frame); err != nil { - log.Printf("Couldn't encode the image, %v", err) - } - _ = f.Close() - } else { - log.Printf("Couldn't create the image, %v", err) - } -} - -// getRoomMock returns mocked Room struct. -func getRoomMock(cfg roomMockConfig) roomMock { - var conf config.WorkerConfig - if _, err := config.LoadConfig(&conf, ""); err != nil { - panic(err) - } - - conf.Worker.Library.BasePath = cfg.gamesPath - - fixEmulators(&conf, cfg.autoGlContext) - l := logger.NewConsole(conf.Worker.Debug, "w", false) - if cfg.noLog { - logger.SetGlobalLevel(logger.Disabled) - } - - // sync cores - if err := remotehttp.CheckCores(conf.Emulator, l); err != nil { - l.Error().Err(err).Msg("cores sync error") - } - conf.Encoder.Video.Codec = string(cfg.vCodec) - - room := NewRoom(cfg.roomName, cfg.game, nil, conf, l) - - if !cfg.dontStartEmulator { - room.StartEmulator() - } - - return roomMock{Room: room, startEmulator: !cfg.dontStartEmulator} -} - -// fixEmulators makes absolute game paths in global GameList and passes GL context config. -// hack: emulator paths should be absolute and visible to the tests. -func fixEmulators(config *config.WorkerConfig, autoGlContext bool) { - rootPath := getRootPath() - - config.Emulator.Libretro.Cores.Paths.Libs = - filepath.FromSlash(rootPath + config.Emulator.Libretro.Cores.Paths.Libs) - config.Emulator.LocalPath = filepath.FromSlash(filepath.Join(rootPath, "tests", config.Emulator.LocalPath)) - config.Emulator.Storage = filepath.FromSlash(filepath.Join(rootPath, "tests", "storage")) - - for k, conf := range config.Emulator.Libretro.Cores.List { - if conf.IsGlAllowed && autoGlContext { - conf.AutoGlContext = true - } - config.Emulator.Libretro.Cores.List[k] = conf - } -} - -// getRootPath returns absolute path to the assets. -func getRootPath() string { - p, _ := filepath.Abs("../../") - return p + string(filepath.Separator) -} - -func waitNFrames(n int, room roomMock) *emulator.GameFrame { - var frame emulator.GameFrame - var wg sync.WaitGroup - wg.Add(n) - handler := room.emulator.GetVideo() - room.emulator.SetVideo(func(video *emulator.GameFrame) { - handler(video) - if n > 0 { - v := video.Data.Copy() - frame = emulator.GameFrame{Duration: video.Duration, Data: &v} - wg.Done() - } - n-- - }) - if !room.startEmulator { - room.StartEmulator() - } - wg.Wait() - return &frame -} - -// Measures emulation performance of various -// emulators and encoding options. -func BenchmarkRoom(b *testing.B) { - benches := []struct { - system string - game games.GameMetadata - codecs []encoder.VideoCodec - frames int - }{ - // warm up - { - system: "gba", - game: sushi, - codecs: []encoder.VideoCodec{encoder.VP8}, - frames: 50, - }, - { - system: "gba", - game: sushi, - codecs: []encoder.VideoCodec{encoder.VP8, encoder.H264}, - frames: 100, - }, - { - system: "nes", - game: alwas, - codecs: []encoder.VideoCodec{encoder.VP8, encoder.H264}, - frames: 100, - }, - } - - for _, bench := range benches { - for _, cod := range bench.codecs { - b.Run(fmt.Sprintf("%s-%v-%d", bench.system, cod, bench.frames), func(b *testing.B) { - for i := 0; i < b.N; i++ { - b.StopTimer() - room := getRoomMock( - roomMockConfig{gamesPath: whereIsGames, game: bench.game, vCodec: cod, noLog: true}) - b.StartTimer() - waitNFrames(bench.frames, room) - b.StopTimer() - room.Room.Close() - } - }) - } - } -} diff --git a/pkg/worker/router.go b/pkg/worker/router.go deleted file mode 100644 index d3878cff..00000000 --- a/pkg/worker/router.go +++ /dev/null @@ -1,55 +0,0 @@ -package worker - -import ( - "github.com/giongto35/cloud-game/v3/pkg/com" - "github.com/giongto35/cloud-game/v3/pkg/network/webrtc" - "github.com/pion/webrtc/v3/pkg/media" -) - -// Router tracks and routes freshly connected users to a game room. -// Basically, it holds user connection data until some user makes (connects to) -// a new room (game), then it manages all the cross-references between room and users. -// Rooms and users has 1-to-n relationship. -type Router struct { - room GamingRoom - users com.NetMap[*Session] -} - -// Session represents WebRTC connection of the user. -type Session struct { - id com.Uid - conn *webrtc.Peer - pi int // player index - room GamingRoom // back reference -} - -func NewRouter() Router { return Router{users: com.NewNetMap[*Session]()} } - -func (r *Router) SetRoom(room GamingRoom) { r.room = room } -func (r *Router) AddUser(user *Session) { r.users.Add(user) } -func (r *Router) Close() { - if r.room != nil { - r.room.Close() - } -} -func (r *Router) GetRoom(id string) GamingRoom { - if r.room != nil && r.room.GetId() == id { - return r.room - } - return nil -} -func (r *Router) GetUser(uid com.Uid) *Session { sess, _ := r.users.Find(uid); return sess } -func (r *Router) RemoveDisconnect(user *Session) { r.users.Remove(user); user.Disconnect() } - -func NewSession(rtc *webrtc.Peer, id com.Uid) *Session { return &Session{id: id, conn: rtc} } - -func (s *Session) Disconnect() { s.conn.Disconnect() } -func (s *Session) GetPeerConn() *webrtc.Peer { return s.conn } -func (s *Session) GetPlayerIndex() int { return s.pi } -func (s *Session) GetSetRoom(v GamingRoom) GamingRoom { vv := s.room; s.room = v; return vv } -func (s *Session) Id() com.Uid { return s.id } -func (s *Session) IsConnected() bool { return s.conn.IsConnected() } -func (s *Session) SendAudio(sample *media.Sample) error { return s.conn.WriteAudio(sample) } -func (s *Session) SendVideo(sample *media.Sample) error { return s.conn.WriteVideo(sample) } -func (s *Session) SetPlayerIndex(index int) { s.pi = index } -func (s *Session) SetRoom(room GamingRoom) { s.room = room } diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 99dea997..56fc8e03 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -9,7 +9,9 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/monitoring" "github.com/giongto35/cloud-game/v3/pkg/network/httpx" - "github.com/giongto35/cloud-game/v3/pkg/worker/emulator/libretro/manager/remotehttp" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged" + "github.com/giongto35/cloud-game/v3/pkg/worker/cloud" + "github.com/giongto35/cloud-game/v3/pkg/worker/room" ) type Worker struct { @@ -17,24 +19,25 @@ type Worker struct { conf config.WorkerConfig cord *coordinator log *logger.Logger - router Router - services [2]runnable - storage CloudStorage + mana *caged.Manager + router *room.GameRouter + services [2]interface { + Run() + Stop() error + } + storage cloud.Storage } -type runnable interface { - Run() - Stop() error -} +func (w *Worker) Reset() { w.router.Close() } const retry = 10 * time.Second func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { - if err := remotehttp.CheckCores(conf.Emulator, log); err != nil { - log.Warn().Err(err).Msgf("a Libretro cores sync fail") + manager := caged.NewManager(log) + if err := manager.Load(caged.Libretro, conf); err != nil { + return nil, fmt.Errorf("couldn't cage libretro: %v", err) } - - worker := &Worker{conf: conf, log: log, router: NewRouter()} + worker := &Worker{conf: conf, log: log, mana: manager, router: room.NewGameRouter()} h, err := httpx.NewServer( conf.Worker.GetAddr(), @@ -58,9 +61,9 @@ func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { if conf.Worker.Monitoring.IsEnabled() { worker.services[1] = monitoring.New(conf.Worker.Monitoring, h.GetHost(), log) } - st, err := GetCloudStorage(conf.Storage.Provider, conf.Storage.Key) + st, err := cloud.Store(conf.Storage.Provider, conf.Storage.Key) if err != nil { - log.Warn().Err(err).Msgf("cloud storage fail, using dummy cloud storage instead") + log.Warn().Err(err).Msgf("cloud storage fail, using no storage") } worker.storage = st @@ -79,7 +82,7 @@ func (w *Worker) Start(done chan struct{}) { if w.cord != nil { w.cord.Disconnect() } - w.router.Close() + w.Reset() }() for { @@ -96,7 +99,7 @@ func (w *Worker) Start(done chan struct{}) { w.cord = cord w.cord.log.Info().Msgf("Connected to the coordinator %v", remoteAddr) <-w.cord.HandleRequests(w) - w.router.Close() + w.Reset() } } }() From 8dd9e9c9be67458289976a2abb5cbc21c8ba9c26 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 20 Sep 2023 18:16:36 +0300 Subject: [PATCH 093/361] Use buffered file writer --- pkg/os/os.go | 39 ++++++++++++++++ .../caged/libretro/nanoarch/nanoarch.go | 45 ++++++++++--------- pkg/worker/caged/libretro/storage.go | 2 +- pkg/worker/cloud/cloudstore.go | 3 +- 4 files changed, 67 insertions(+), 22 deletions(-) diff --git a/pkg/os/os.go b/pkg/os/os.go index 117e41ad..142ffcc1 100644 --- a/pkg/os/os.go +++ b/pkg/os/os.go @@ -1,7 +1,10 @@ package os import ( + "bufio" + "bytes" "errors" + "io" "io/fs" "os" "os/signal" @@ -9,6 +12,8 @@ import ( "syscall" ) +const ReadChunk = 1024 + var ErrNotExist = os.ErrNotExist func Exists(path string) bool { @@ -45,3 +50,37 @@ func GetUserHome() (string, error) { func WriteFile(name string, data []byte, perm os.FileMode) error { return os.WriteFile(name, data, perm) } + +func ReadFile(name string) (dat []byte, err error) { + f, err := os.Open(name) + if err != nil { + return nil, err + } + defer func() { _ = f.Close() }() + + r := bufio.NewReader(f) + buf := bytes.NewBuffer(make([]byte, 0)) + chunk := make([]byte, ReadChunk) + + c := 0 + for { + if c, err = r.Read(chunk); err != nil { + break + } + buf.Write(chunk[:c]) + } + + if err == io.EOF { + err = nil + } + + return buf.Bytes(), err +} + +func StatSize(path string) (int64, error) { + fi, err := os.Stat(path) + if err != nil { + return 0, err + } + return fi.Size(), nil +} diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index d75f2c96..a8105e25 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -3,7 +3,6 @@ package nanoarch import ( "errors" "fmt" - "os" "runtime" "strings" "sync/atomic" @@ -11,6 +10,7 @@ import ( "unsafe" "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/os" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/graphics" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/image" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" @@ -115,10 +115,9 @@ func init() { Nan0.reserved <- struct{}{} } func NewNano(localPath string) *Nanoarch { nano := &Nan0 - nano.cSaveDirectory = C.CString(localPath + string(os.PathSeparator) + "legacy_save") - nano.cSystemDirectory = C.CString(localPath + string(os.PathSeparator) + "system") + nano.cSaveDirectory = C.CString(localPath + "/legacy_save") + nano.cSystemDirectory = C.CString(localPath + "/system") nano.cUserName = C.CString("retro") - return nano } @@ -209,29 +208,33 @@ func (n *Nanoarch) CoreLoad(meta Metadata) { } func (n *Nanoarch) LoadGame(path string) error { - fi, err := os.Stat(path) - if err != nil { - return err - } - fileSize := fi.Size() + game := C.struct_retro_game_info{} - n.log.Debug().Msgf("ROM size: %v", byteCountBinary(fileSize)) - - fPath := C.CString(path) - defer C.free(unsafe.Pointer(fPath)) - gi := C.struct_retro_game_info{path: fPath, size: C.size_t(fileSize)} - - if !bool(n.sysInfo.need_fullpath) { + big := bool(n.sysInfo.need_fullpath) // big ROMs are loaded by cores later + if big { + size, err := os.StatSize(path) + if err != nil { + return err + } + game.size = C.size_t(size) + } else { bytes, err := os.ReadFile(path) if err != nil { return err } - dataPtr := unsafe.Pointer(C.CBytes(bytes)) - gi.data = dataPtr - defer C.free(dataPtr) + // !to pin in 1.21 + ptr := unsafe.Pointer(C.CBytes(bytes)) + game.data = ptr + game.size = C.size_t(len(bytes)) + defer C.free(ptr) } + fp := C.CString(path) + defer C.free(unsafe.Pointer(fp)) + game.path = fp - if ok := C.bridge_retro_load_game(retroLoadGame, &gi); !ok { + n.log.Debug().Msgf("ROM - big: %v, size: %v", big, byteCountBinary(int64(game.size))) + + if ok := C.bridge_retro_load_game(retroLoadGame, &game); !ok { return fmt.Errorf("core failed to load ROM: %v", path) } @@ -467,6 +470,7 @@ func SaveRAM() State { func RestoreSaveRAM(st State) { if len(st) > 0 { if memory := ptSaveRAM(); memory != nil { + //noinspection GoRedundantConversion copy(unsafe.Slice((*byte)(memory.ptr), memory.size), st) } } @@ -573,6 +577,7 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { var data_ []byte if data != C.RETRO_HW_FRAME_BUFFER_VALID { + //noinspection GoRedundantConversion data_ = unsafe.Slice((*byte)(data), bytes) } else { // if Libretro renders frame with OpenGL context diff --git a/pkg/worker/caged/libretro/storage.go b/pkg/worker/caged/libretro/storage.go index 9f3691d6..e7c488a0 100644 --- a/pkg/worker/caged/libretro/storage.go +++ b/pkg/worker/caged/libretro/storage.go @@ -1,10 +1,10 @@ package libretro import ( - "os" "path/filepath" "strings" + "github.com/giongto35/cloud-game/v3/pkg/os" "github.com/giongto35/cloud-game/v3/pkg/worker/compression/zip" ) diff --git a/pkg/worker/cloud/cloudstore.go b/pkg/worker/cloud/cloudstore.go index 76d0f616..2413a7a5 100644 --- a/pkg/worker/cloud/cloudstore.go +++ b/pkg/worker/cloud/cloudstore.go @@ -8,8 +8,9 @@ import ( "fmt" "io" "net/http" - "os" "time" + + "github.com/giongto35/cloud-game/v3/pkg/os" ) // !to replace all with unified s3 api From 85cef0dfec1fcadfb56b772d0d52d2cecfd748d2 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 22 Sep 2023 17:46:00 +0300 Subject: [PATCH 094/361] Convert colors in C --- pkg/worker/caged/libretro/image/canvas.c | 142 +++++++++ pkg/worker/caged/libretro/image/canvas.go | 120 +++----- pkg/worker/caged/libretro/image/canvas.h | 42 +++ .../caged/libretro/image/canvas_test.go | 290 ++++++++++++++++-- pkg/worker/caged/libretro/image/rotation.go | 87 ------ .../caged/libretro/image/rotation_test.go | 247 --------------- pkg/worker/caged/libretro/image/scale.go | 27 -- .../caged/libretro/nanoarch/nanoarch.go | 44 +-- 8 files changed, 513 insertions(+), 486 deletions(-) create mode 100644 pkg/worker/caged/libretro/image/canvas.c create mode 100644 pkg/worker/caged/libretro/image/canvas.h delete mode 100644 pkg/worker/caged/libretro/image/rotation.go delete mode 100644 pkg/worker/caged/libretro/image/rotation_test.go delete mode 100644 pkg/worker/caged/libretro/image/scale.go diff --git a/pkg/worker/caged/libretro/image/canvas.c b/pkg/worker/caged/libretro/image/canvas.c new file mode 100644 index 00000000..66b00cd8 --- /dev/null +++ b/pkg/worker/caged/libretro/image/canvas.c @@ -0,0 +1,142 @@ +#include "canvas.h" + +__inline int rot_x(int t, int x, int y, int w, int h) { + switch (t) { + case 1: + return r90_x(x,y,w,h); + break; + case 2: + return r180_x(x,y,w,h); + break; + case 3: + return r270_x(x,y,w,h); + break; + case 4: + return fy180_x(x,y,w,h); + break; + } + return x; +} + +__inline int rot_y(int t, int x, int y, int w, int h) { + switch (t) { + case 1: + return r90_y(x,y,w,h); + break; + case 2: + return r180_y(x,y,w,h); + break; + case 3: + return r270_y(x,y,w,h); + break; + case 4: + return fy180_y(x,y,w,h); + break; + } + return y; + } + + +void RGBA(int pix, void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot) { + switch (pix) { + case BIT_SHORT5551: + break; + case BIT_INT_8888REV: + if (rot == 0) { + i8888(destination, source, yy, yn, xw, pad); + } else { + i8888r(destination, source, yy, yn, xw, xh, dw, pad, rot); + } + break; + case BIT_SHORT565: + if (rot == 0) { + i565(destination, source, yy, yn, xw, pad); + } else { + i565r(destination, source, yy, yn, xw, xh, dw, pad, rot); + } + break; + } +} + +void i565(void *destination, void *source, int yy, int yn, int xw, int pad) { + uint8_t *src = source; // must be in bytes because of possible padding in bytes + uint32_t *dst = destination; + + int y, x; + uint32_t px; + + for (y = yy; y < yn; ++y) { + for (x = 0; x < xw; ++x) { + px = *(uint16_t *)src; + src += 2; + *dst++ = _565(px); + } + src += pad; + } +} + +void i565r(void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot) { + uint8_t *src = source; + uint32_t *dst = destination; + + uint32_t px; + + int x, y, dx, dy; + + for (y = yy; y < yn; ++y) { + for (x = 0; x < xw; ++x) { + px = *(uint16_t *)src; + src += 2; + + dx = rot_x(rot, x, y, xw, xh); + dy = rot_y(rot, x, y, xw, xh); + + dst[dx+dy*dw] = _565(px); + } + src += pad; + } +} + +void i8888r(void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot) { + uint8_t *src = source; + uint32_t *dst = destination; + + int y, x; + uint32_t px; + + int dx, dy; + + for (y = yy; y < yn; ++y) { + for (x = 0; x < xw; ++x) { + px = *(uint32_t *)src; + + dx = rot_x(rot, x, y, xw, xh); + dy = rot_y(rot, x, y, xw, xh); + + dst[dx+dy*dw] = _8888rev(px); + src += 4; + } + src += pad; + } +} + +void i8888(void *destination, void *source, int yy, int yn, int xw, int pad) { + uint8_t *src = source; // must be in bytes because of possible padding in bytes + uint32_t *dst = destination; + + int y, x; + uint32_t px; + + for (y = yy; y < yn; ++y) { + for (x = 0; x < xw; ++x) { + px = *(uint32_t *)src; + src += 4; + *dst++ = _8888rev(px); + } + src += pad; + } +} + +uint32_t px8888rev(uint32_t px) { + return _8888rev(px); +} diff --git a/pkg/worker/caged/libretro/image/canvas.go b/pkg/worker/caged/libretro/image/canvas.go index c5f321ca..035876a5 100644 --- a/pkg/worker/caged/libretro/image/canvas.go +++ b/pkg/worker/caged/libretro/image/canvas.go @@ -2,11 +2,18 @@ package image import ( "image" - "math/bits" "sync" "unsafe" + + "golang.org/x/image/draw" ) +/* +#cgo CFLAGS: -Wall +#include "canvas.h" +*/ +import "C" + // Canvas is a stateful drawing surface, i.e. image.RGBA type Canvas struct { enabled bool @@ -30,6 +37,35 @@ const ( BitFormatShort565 // BIT_FORMAT_SHORT_5_6_5 has 5 bits R, 6 bits G, 5 bits ) +const ( + ScaleNot = iota // skips image interpolation + ScaleNearestNeighbour // nearest neighbour interpolation + ScaleBilinear // bilinear interpolation +) + +func Resize(scaleType int, src *image.RGBA, out *image.RGBA) { + // !to do set it once instead switching on each iteration + switch scaleType { + case ScaleBilinear: + draw.ApproxBiLinear.Scale(out, out.Bounds(), src, src.Bounds(), draw.Src, nil) + case ScaleNot: + fallthrough + case ScaleNearestNeighbour: + fallthrough + default: + draw.NearestNeighbor.Scale(out, out.Bounds(), src, src.Bounds(), draw.Src, nil) + } +} + +type Rotation uint + +const ( + A90 Rotation = iota + 1 + A180 + A270 + F180 // F180 is flipped Y +) + func NewCanvas(w, h, size int) *Canvas { return &Canvas{ enabled: true, @@ -66,17 +102,17 @@ func (c *Canvas) Put(i *Frame) { func (c *Canvas) Clear() { c.wg = sync.WaitGroup{} } func (c *Canvas) SetEnabled(enabled bool) { c.enabled = enabled } -func (c *Canvas) Draw(encoding uint32, rot *Rotate, w, h, packedW, bpp int, data []byte, th int) *Frame { +func (c *Canvas) Draw(encoding uint32, rot Rotation, w, h, packedW, bpp int, data []byte, th int) *Frame { dst := c.Get(w, h) if th == 0 { - frame(encoding, dst, data, 0, h, h, w, packedW, bpp, rot) + frame(encoding, dst, data, 0, h, w, h, packedW, bpp, rot) } else { hn := h / th c.wg.Add(th) for i := 0; i < th; i++ { xx := hn * i go func() { - frame(encoding, dst, data, xx, hn, h, w, packedW, bpp, rot) + frame(encoding, dst, data, xx, hn, w, h, packedW, bpp, rot) c.wg.Done() }() } @@ -100,77 +136,23 @@ func (c *Canvas) Draw(encoding uint32, rot *Rotate, w, h, packedW, bpp int, data return dst } -func frame(encoding uint32, dst *Frame, data []byte, yy int, hn int, h int, w int, pwb int, bpp int, rot *Rotate) { +func frame(encoding uint32, dst *Frame, data []byte, yy int, hn int, w int, h int, pwb int, bpp int, rot Rotation) { sPtr := unsafe.Pointer(&data[yy*pwb]) dPtr := unsafe.Pointer(&dst.Pix[yy*dst.Stride]) // some cores can zero-right-pad rows to the packed width value pad := pwb - w*bpp - yn := yy + hn - - if rot == nil { - // LE, BE might not work - switch encoding { - case BitFormatShort565: - for y := yy; y < yn; y++ { - for x := 0; x < w; x++ { - i565((*uint32)(dPtr), uint32(*(*uint16)(sPtr))) - sPtr = unsafe.Add(sPtr, uintptr(bpp)) - dPtr = unsafe.Add(dPtr, uintptr(4)) - } - if pad > 0 { - sPtr = unsafe.Add(sPtr, uintptr(pad)) - } - } - case BitFormatInt8888Rev: - for y := yy; y < yn; y++ { - for x := 0; x < w; x++ { - ix8888((*uint32)(dPtr), *(*uint32)(sPtr)) - sPtr = unsafe.Add(sPtr, uintptr(bpp)) - dPtr = unsafe.Add(dPtr, uintptr(4)) - } - if pad > 0 { - sPtr = unsafe.Add(sPtr, uintptr(pad)) - } - } - } - } else { - switch encoding { - case BitFormatShort565: - for y := yy; y < yn; y++ { - for x, k := 0, 0; x < w; x++ { - dx, dy := rot.Call(x, y, w, h) - k = dx<<2 + dy*dst.Stride - dPtr = unsafe.Pointer(&dst.Pix[k]) - i565((*uint32)(dPtr), uint32(*(*uint16)(sPtr))) - sPtr = unsafe.Add(sPtr, uintptr(bpp)) - } - if pad > 0 { - sPtr = unsafe.Add(sPtr, uintptr(pad)) - } - } - case BitFormatInt8888Rev: - for y := yy; y < yn; y++ { - for x, k := 0, 0; x < w; x++ { - dx, dy := rot.Call(x, y, w, h) - k = dx<<2 + dy*dst.Stride - dPtr = unsafe.Pointer(&dst.Pix[k]) - ix8888((*uint32)(dPtr), *(*uint32)(sPtr)) - sPtr = unsafe.Add(sPtr, uintptr(bpp)) - } - if pad > 0 { - sPtr = unsafe.Add(sPtr, uintptr(pad)) - } - } - } + if pad < 0 { + pad = 0 } + if rot != 0 { + dPtr = unsafe.Pointer(&dst.Pix[0]) + } + C.RGBA(C.int(encoding), dPtr, sPtr, C.int(yy), C.int(yy+hn), C.int(w), C.int(h), C.int(dst.Stride>>2), C.int(pad), C.int(rot)) } -func i565(dst *uint32, px uint32) { - *dst = (px >> 8 & 0xf8) | ((px >> 3 & 0xfc) << 8) | ((px << 3 & 0xfc) << 16) // | 0xff000000 - // setting the last byte to 255 allows saving RGBA images to PNG not as black squares -} +func _8888rev(px uint32) uint32 { return uint32(C.px8888rev(C.uint32_t(px))) } -func ix8888(dst *uint32, px uint32) { - //*dst = ((px >> 16) & 0xff) | (px & 0xff00) | ((px << 16) & 0xff0000) + 0xff000000 - *dst = bits.ReverseBytes32(px << 8) //| 0xff000000 +func rotate(t int, x int, y int, w int, h int) (int, int) { + return int(C.rot_x(C.int(t), C.int(x), C.int(y), C.int(w), C.int(h))), + int(C.rot_y(C.int(t), C.int(x), C.int(y), C.int(w), C.int(h))) } diff --git a/pkg/worker/caged/libretro/image/canvas.h b/pkg/worker/caged/libretro/image/canvas.h new file mode 100644 index 00000000..f89a0f27 --- /dev/null +++ b/pkg/worker/caged/libretro/image/canvas.h @@ -0,0 +1,42 @@ +#ifndef CANVAS_H__ +#define CANVAS_H__ + +#include + +#define BIT_SHORT5551 0 +#define BIT_INT_8888REV 1 +#define BIT_SHORT565 2 + +// Rotate90 is 90° CCW or 270° CW. +#define r90_x(x, y, w, h) ( y ) +#define r90_y(x, y, w, h) ( (w - 1) - x ) + +// Rotate180 is 180° CCW. +#define r180_x(x, y, w, h) ( (w - 1) - x ) +#define r180_y(x, y, w, h) ( (h - 1) - y ) + +// Rotate270 is 270° CCW or 90° CW. +#define r270_x(x, y, w, h) ( (h - 1) - y ) +#define r270_y(x, y, w, h) ( x ) + +// Flip Y +#define fy180_x(x, y, w, h) ( x ) +#define fy180_y(x, y, w, h) ( (h - 1) - y ) + +int rot_x(int t, int x, int y, int w, int h); +int rot_y(int t, int x, int y, int w, int h); + +#define _565(x) ((x >> 8 & 0xf8) | ((x >> 3 & 0xfc) << 8) | ((x << 3 & 0xfc) << 16)); // | 0xff000000 +#define _8888rev(px) (((px >> 16) & 0xff) | (px & 0xff00) | ((px << 16) & 0xff0000)); // | 0xff000000) + + +void RGBA(int pix, void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot); + +void i565(void *destination, void *source, int yy, int yn, int xw, int pad); +void i8888(void *destination, void *source, int yy, int yn, int xw, int pad); +void i565r(void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot); +void i8888r(void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot); + +uint32_t px8888rev(uint32_t px); + +#endif diff --git a/pkg/worker/caged/libretro/image/canvas_test.go b/pkg/worker/caged/libretro/image/canvas_test.go index a7bc47af..b1def658 100644 --- a/pkg/worker/caged/libretro/image/canvas_test.go +++ b/pkg/worker/caged/libretro/image/canvas_test.go @@ -1,14 +1,18 @@ package image import ( + "bytes" "fmt" "testing" ) func BenchmarkDraw(b *testing.B) { + w1, h1 := 256, 240 + w2, h2 := 640, 480 + type args struct { encoding uint32 - rot *Rotate + rot Rotation scaleType int w int h int @@ -24,35 +28,52 @@ func BenchmarkDraw(b *testing.B) { args args }{ { - name: "0th", + name: "565_0th", args: args{ - encoding: BitFormatInt8888Rev, - rot: nil, - scaleType: ScaleNearestNeighbour, - w: 256, - h: 240, - packedW: 256, - bpp: 4, - data: make([]uint8, 256*240*4), - dw: 256, - dh: 240, - th: 0, + encoding: BitFormatShort565, scaleType: ScaleNearestNeighbour, + w: w1, h: h1, packedW: w1, bpp: 2, data: make([]uint8, w1*h1*2), dw: w1, dh: h1, th: 0, }, }, { - name: "4th", + name: "565_0th_90", args: args{ - encoding: BitFormatInt8888Rev, - rot: nil, - scaleType: ScaleNearestNeighbour, - w: 256, - h: 240, - packedW: 256, - bpp: 4, - data: make([]uint8, 256*240*4), - dw: 256, - dh: 240, - th: 4, + encoding: BitFormatShort565, rot: A90, scaleType: ScaleNearestNeighbour, + w: h1, h: w1, packedW: h1, bpp: 2, data: make([]uint8, w1*h1*2), dw: w1, dh: h1, th: 0, + }, + }, + { + name: "565_0th", + args: args{ + encoding: BitFormatShort565, scaleType: ScaleNearestNeighbour, + w: w2, h: h2, packedW: w1, bpp: 2, data: make([]uint8, w2*h2*2), dw: w2, dh: h2, th: 0, + }, + }, + { + name: "565_4th", + args: args{ + encoding: BitFormatShort565, scaleType: ScaleNearestNeighbour, + w: w1, h: h1, packedW: w1, bpp: 2, data: make([]uint8, w1*h1*2), dw: w1, dh: h1, th: 4, + }, + }, + { + name: "565_4th", + args: args{ + encoding: BitFormatShort565, scaleType: ScaleNearestNeighbour, + w: w2, h: h2, packedW: w2, bpp: 2, data: make([]uint8, w2*h2*2), dw: w2, dh: h2, th: 4, + }, + }, + { + name: "8888 - 0th", + args: args{ + encoding: BitFormatInt8888Rev, scaleType: ScaleNearestNeighbour, + w: w1, h: h1, packedW: w1, bpp: 4, data: make([]uint8, w1*h1*4), dw: w1, dh: h1, th: 0, + }, + }, + { + name: "8888 - 4th", + args: args{ + encoding: BitFormatInt8888Rev, scaleType: ScaleNearestNeighbour, + w: w1, h: h1, packedW: w1, bpp: 4, data: make([]uint8, w1*h1*4), dw: w1, dh: h1, th: 4, }, }, } @@ -64,7 +85,7 @@ func BenchmarkDraw(b *testing.B) { img2 := c.Get(bn.args.dw, bn.args.dh) c.Put(img2) b.ResetTimer() - b.Run(fmt.Sprintf("%v", bn.name), func(b *testing.B) { + b.Run(fmt.Sprintf("%vx%v_%v", bn.args.w, bn.args.h, bn.name), func(b *testing.B) { for i := 0; i < b.N; i++ { p := c.Draw(bn.args.encoding, bn.args.rot, bn.args.w, bn.args.h, bn.args.packedW, bn.args.bpp, bn.args.data, bn.args.th) c.Put(p) @@ -95,10 +116,225 @@ func Test_ix8888(t *testing.T) { } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { - ix8888(tt.args.dst, tt.args.px) + *tt.args.dst = _8888rev(tt.args.px) if *tt.args.dst != tt.args.expect { t.Errorf("nope, %x %x", *tt.args.dst, tt.args.expect) } }) } } + +type dimensions struct { + w int + h int +} + +func TestRotate(t *testing.T) { + tests := []struct { + // packed bytes from a 2D matrix + input []byte + // original matrix's width + w int + // original matrix's height + h int + // rotation algorithm + rotateHow []Rotation + expected [][]byte + }{ + { + // a cross + []byte{ + 0, 1, 0, + 1, 1, 1, + 0, 1, 0, + }, + 3, 3, []Rotation{0, A90, A180, A270}, + [][]byte{ + { + 0, 1, 0, + 1, 1, 1, + 0, 1, 0, + }, + { + 0, 1, 0, + 1, 1, 1, + 0, 1, 0, + }, + { + 0, 1, 0, + 1, 1, 1, + 0, 1, 0, + }, + { + 0, 1, 0, + 1, 1, 1, + 0, 1, 0, + }, + }, + }, + { + []byte{ + 1, 2, + 3, 4, + 5, 6, + 7, 8, + }, + 2, 4, []Rotation{0, A90, A180, A270}, + [][]byte{ + { + 1, 2, + 3, 4, + 5, 6, + 7, 8, + }, + { + 2, 4, 6, 8, + 1, 3, 5, 7, + }, + { + 8, 7, + 6, 5, + 4, 3, + 2, 1, + }, + { + 7, 5, 3, 1, + 8, 6, 4, 2, + }, + }, + }, + { + // a square + []byte{ + 1, 0, 0, 0, 0, 0, 0, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 1, 0, 0, 0, 0, 1, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 0, 0, 0, 0, 0, 0, 1, + }, + 8, 6, []Rotation{0, A90, A180, A270}, + [][]byte{ + { + // L // R + 1, 0, 0, 0, 0, 0, 0, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 1, 0, 0, 0, 0, 1, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 0, 0, 0, 0, 0, 0, 1, + }, + { + 0, 0, 0, 0, 0, 1, + 0, 1, 1, 1, 1, 0, + 0, 1, 1, 0, 1, 0, + 0, 1, 1, 0, 1, 0, + 0, 1, 1, 0, 1, 0, + 0, 1, 1, 0, 1, 0, + 0, 1, 1, 1, 1, 0, + 1, 0, 0, 0, 0, 0, + }, + + { + 1, 0, 0, 0, 0, 0, 0, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 1, 0, 0, 0, 0, 1, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 0, 0, 0, 0, 0, 0, 0, 1, + }, + { + 0, 0, 0, 0, 0, 1, + 0, 1, 1, 1, 1, 0, + 0, 1, 0, 1, 1, 0, + 0, 1, 0, 1, 1, 0, + 0, 1, 0, 1, 1, 0, + 0, 1, 0, 1, 1, 0, + 0, 1, 1, 1, 1, 0, + 1, 0, 0, 0, 0, 0, + }, + }, + }, + } + + for _, test := range tests { + for i, rot := range test.rotateHow { + if output := exampleRotate(test.input, test.w, test.h, rot); !bytes.Equal(output, test.expected[i]) { + t.Errorf( + "Test fail for angle %v with %v that should be \n%v but it's \n%v", + rot, test.input, test.expected[i], output) + } + } + } +} + +func TestBoundsAfterRotation(t *testing.T) { + tests := []struct { + dim []dimensions + rotateHow []Rotation + }{ + { + // a combinatorics lib would be nice instead + []dimensions{ + // square + {w: 100, h: 100}, + // even w/h + {w: 100, h: 50}, + // even h/w + {w: 50, h: 100}, + // odd even w/h + {w: 77, h: 32}, + // even odd h/w + {w: 32, h: 77}, + // just odd + {w: 13, h: 19}, + }, + []Rotation{0, A90, A180, A270}, + }, + } + + for _, test := range tests { + for _, rot := range test.rotateHow { + for _, dim := range test.dim { + + for y := 0; y < dim.h; y++ { + for x := 0; x < dim.w; x++ { + + xx, yy := rotate(int(rot), x, y, dim.w, dim.h) + + if rot == A90 || rot == A270 { // is even + yy, xx = xx, yy + } + + if xx < 0 || xx > dim.w { + t.Errorf("Rot %v, coordinate x should be in range [0; %v]: %v", rot, dim.w-1, xx) + } + + if yy < 0 || yy > dim.h { + t.Errorf("Rot %v, coordinate y should be in range [0; %v]: %v", rot, dim.h-1, yy) + } + } + } + } + } + } +} + +// exampleRotate is an example of rotation usage. +// +// [1 2 3 4 5 6 7 8 9] +// [7 4 1 8 5 2 9 6 3] +func exampleRotate(data []uint8, w int, h int, rot Rotation) []uint8 { + dest := make([]uint8, len(data)) + for y := 0; y < h; y++ { + for x := 0; x < w; x++ { + nx, ny := rotate(int(rot), x, y, w, h) + stride := w + if rot == A90 || rot == A270 { // is even + stride = h + } + dest[nx+ny*stride] = data[x+y*w] + } + } + return dest +} diff --git a/pkg/worker/caged/libretro/image/rotation.go b/pkg/worker/caged/libretro/image/rotation.go deleted file mode 100644 index 950c89a2..00000000 --- a/pkg/worker/caged/libretro/image/rotation.go +++ /dev/null @@ -1,87 +0,0 @@ -// Package image contains functions for rotations of points in a 2-dimensional space. -package image - -type Angle uint - -const ( - Angle0 Angle = iota - Angle90 - Angle180 - Angle270 - Flip180 -) - -// Angles is a helper to choose appropriate rotation based on its angle. -var Angles = [5]Rotate{ - Angle0: {Angle: Angle0, Call: Rotate0}, - Angle90: {Angle: Angle90, Call: Rotate90, IsEven: true}, - Angle180: {Angle: Angle180, Call: Rotate180}, - Angle270: {Angle: Angle270, Call: Rotate270, IsEven: true}, - Flip180: {Angle: Flip180, Call: Invert180}, -} - -func GetRotation(angle Angle) Rotate { return Angles[angle] } - -// Rotate is an interface for rotation of a given point. -// -// With the coordinates x, y in the matrix of w x h. -// Returns a pair of new coordinates x, y in the resulting matrix. -// Be aware that w / h values are 0 index-based, -// and it's meant to be used with h corresponded -// to matrix height and y coordinate, and with w to x coordinate. -type Rotate struct { - Angle Angle - Call func(x, y, w, h int) (int, int) - IsEven bool -} - -// Rotate0 is 0° or the original orientation. -// -// 1 2 3 1 2 3 -// 4 5 6 -> 4 5 6 -// 7 8 9 7 8 9 -func Rotate0(x, y, _, _ int) (int, int) { return x, y } - -// Rotate90 is 90° CCW or 270° CW. -// -// 1 2 3 3 6 9 -// 4 5 6 -> 2 5 8 -// 7 8 9 1 4 7 -func Rotate90(x, y, w, _ int) (int, int) { return y, (w - 1) - x } - -// Rotate180 is 180° CCW. -// -// 1 2 3 9 8 7 -// 4 5 6 -> 6 5 4 -// 7 8 9 3 2 1 -func Rotate180(x, y, w, h int) (int, int) { return (w - 1) - x, (h - 1) - y } - -// Rotate270 is 270° CCW or 90° CW. -// -// 1 2 3 7 4 1 -// 4 5 6 -> 8 5 2 -// 7 8 9 9 6 3 -func Rotate270(x, y, _, h int) (int, int) { return (h - 1) - y, x } - -func Invert180(x, y, _, h int) (int, int) { return x, (h - 1) - y } - -// ExampleRotate is an example of rotation usage. -// -// [1 2 3 4 5 6 7 8 9] -// [7 4 1 8 5 2 9 6 3] -func ExampleRotate(data []uint8, w int, h int, angle Angle) []uint8 { - dest := make([]uint8, len(data)) - rotationFn := Angles[angle] - for y := 0; y < h; y++ { - for x := 0; x < w; x++ { - nx, ny := rotationFn.Call(x, y, w, h) - stride := w - if rotationFn.IsEven { - stride = h - } - //fmt.Printf("%v:%v (%v) -> %v:%v (%v)\n", x, y, n1, nx, ny, n2) - dest[nx+ny*stride] = data[x+y*w] - } - } - return dest -} diff --git a/pkg/worker/caged/libretro/image/rotation_test.go b/pkg/worker/caged/libretro/image/rotation_test.go deleted file mode 100644 index ec00ea6c..00000000 --- a/pkg/worker/caged/libretro/image/rotation_test.go +++ /dev/null @@ -1,247 +0,0 @@ -package image - -import ( - "bytes" - "testing" -) - -type dimensions struct { - w int - h int -} - -func TestRotate(t *testing.T) { - tests := []struct { - // packed bytes from a 2D matrix - input []byte - // original matrix's width - w int - // original matrix's height - h int - // rotation algorithm - rotateHow []Angle - expected [][]byte - }{ - { - // a cross - []byte{ - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - 3, 3, []Angle{Angle0, Angle90, Angle180, Angle270}, - [][]byte{ - { - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - { - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - { - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - { - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - }, - }, - { - []byte{ - 1, 2, - 3, 4, - 5, 6, - 7, 8, - }, - 2, 4, []Angle{Angle0, Angle90, Angle180, Angle270}, - [][]byte{ - { - 1, 2, - 3, 4, - 5, 6, - 7, 8, - }, - { - 2, 4, 6, 8, - 1, 3, 5, 7, - }, - { - 8, 7, - 6, 5, - 4, 3, - 2, 1, - }, - { - 7, 5, 3, 1, - 8, 6, 4, 2, - }, - }, - }, - { - // a square - []byte{ - 1, 0, 0, 0, 0, 0, 0, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 0, 0, 0, 0, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 0, 0, 0, 0, 0, 0, 1, - }, - 8, 6, []Angle{Angle0, Angle90, Angle180, Angle270}, - [][]byte{ - { - // L // R - 1, 0, 0, 0, 0, 0, 0, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 0, 0, 0, 0, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 0, 0, 0, 0, 0, 0, 1, - }, - { - 0, 0, 0, 0, 0, 1, - 0, 1, 1, 1, 1, 0, - 0, 1, 1, 0, 1, 0, - 0, 1, 1, 0, 1, 0, - 0, 1, 1, 0, 1, 0, - 0, 1, 1, 0, 1, 0, - 0, 1, 1, 1, 1, 0, - 1, 0, 0, 0, 0, 0, - }, - - { - 1, 0, 0, 0, 0, 0, 0, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 0, 0, 0, 0, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 0, 0, 0, 0, 0, 0, 1, - }, - { - 0, 0, 0, 0, 0, 1, - 0, 1, 1, 1, 1, 0, - 0, 1, 0, 1, 1, 0, - 0, 1, 0, 1, 1, 0, - 0, 1, 0, 1, 1, 0, - 0, 1, 0, 1, 1, 0, - 0, 1, 1, 1, 1, 0, - 1, 0, 0, 0, 0, 0, - }, - }, - }, - } - - for _, test := range tests { - for i, rot := range test.rotateHow { - if output := ExampleRotate(test.input, test.w, test.h, rot); !bytes.Equal(output, test.expected[i]) { - t.Errorf( - "Test fail for angle %v with %v that should be \n%v but it's \n%v", - rot, test.input, test.expected[i], output) - } - } - } -} - -func TestBoundsAfterRotation(t *testing.T) { - tests := []struct { - dim []dimensions - rotateHow []Angle - }{ - { - // a combinatorics lib would be nice instead - []dimensions{ - // square - {w: 100, h: 100}, - // even w/h - {w: 100, h: 50}, - // even h/w - {w: 50, h: 100}, - // odd even w/h - {w: 77, h: 32}, - // even odd h/w - {w: 32, h: 77}, - // just odd - {w: 13, h: 19}, - }, - []Angle{Angle0, Angle90, Angle180, Angle270}, - }, - } - - for _, test := range tests { - for _, rot := range test.rotateHow { - rotationFn := Angles[rot] - for _, dim := range test.dim { - - for y := 0; y < dim.h; y++ { - for x := 0; x < dim.w; x++ { - - xx, yy := rotationFn.Call(x, y, dim.w, dim.h) - - if rotationFn.IsEven { - yy, xx = xx, yy - } - - if xx < 0 || xx > dim.w { - t.Errorf("Rot %v, coordinate x should be in range [0; %v]: %v", rot, dim.w-1, xx) - } - - if yy < 0 || yy > dim.h { - t.Errorf("Rot %v, coordinate y should be in range [0; %v]: %v", rot, dim.h-1, yy) - } - } - } - } - } - } -} - -func BenchmarkDirect(b *testing.B) { - for i := 0; i < b.N; i++ { - _, _ = Rotate90(1, 1, 2, 2) - } -} - -func BenchmarkLiteral(b *testing.B) { - fn := Rotate90 - for i := 0; i < b.N; i++ { - _, _ = fn(1, 1, 2, 2) - } -} - -func BenchmarkAssign(b *testing.B) { - fn := Angles[Angle90].Call - for i := 0; i < b.N; i++ { - _, _ = fn(1, 1, 2, 2) - } -} - -func BenchmarkMapReassign(b *testing.B) { - fn := Angles[Angle90].Call - for i := 0; i < b.N; i++ { - fn2 := fn - _, _ = fn2(1, 1, 2, 2) - } -} - -func BenchmarkMapDirect(b *testing.B) { - for i := 0; i < b.N; i++ { - _, _ = Angles[Angle90].Call(1, 1, 2, 2) - } -} - -func BenchmarkNewMapDirect(b *testing.B) { - fns := map[Angle]func(x, y, w, h int) (int, int){ - Angle90: Rotate90, - } - - for i := 0; i < b.N; i++ { - _, _ = fns[Angle90](1, 1, 2, 2) - } -} diff --git a/pkg/worker/caged/libretro/image/scale.go b/pkg/worker/caged/libretro/image/scale.go deleted file mode 100644 index 32750d73..00000000 --- a/pkg/worker/caged/libretro/image/scale.go +++ /dev/null @@ -1,27 +0,0 @@ -package image - -import ( - "image" - - "golang.org/x/image/draw" -) - -const ( - ScaleNot = iota // skips image interpolation - ScaleNearestNeighbour // nearest neighbour interpolation - ScaleBilinear // bilinear interpolation -) - -func Resize(scaleType int, src *image.RGBA, out *image.RGBA) { - // !to do set it once instead switching on each iteration - switch scaleType { - case ScaleBilinear: - draw.ApproxBiLinear.Scale(out, out.Bounds(), src, src.Bounds(), draw.Src, nil) - case ScaleNot: - fallthrough - case ScaleNearestNeighbour: - fallthrough - default: - draw.NearestNeighbor.Scale(out, out.Bounds(), src, src.Bounds(), draw.Src, nil) - } -} diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index a8105e25..e92defea 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -44,7 +44,7 @@ type Nanoarch struct { } options *map[string]string reserved chan struct{} // limits concurrent use - Rot *image.Rotate + Rot image.Rotation serializeSize C.size_t stopped atomic.Bool sysAvInfo C.struct_retro_system_av_info @@ -82,19 +82,14 @@ type FrameInfo struct { } type Metadata struct { - LibPath string // the full path to some emulator lib - AudioSampleRate int - Fps float64 - BaseWidth int - BaseHeight int - Rotation image.Rotate - IsGlAllowed bool - UsesLibCo bool - AutoGlContext bool - HasMultitap bool - HasVFR bool - Options map[string]string - Hacks []string + LibPath string // the full path to some emulator lib + IsGlAllowed bool + UsesLibCo bool + AutoGlContext bool + HasMultitap bool + HasVFR bool + Options map[string]string + Hacks []string } // Nan0 is a global link for C callbacks to Go @@ -123,7 +118,7 @@ func NewNano(localPath string) *Nanoarch { func (n *Nanoarch) AudioSampleRate() int { return int(n.sysAvInfo.timing.sample_rate) } func (n *Nanoarch) VideoFramerate() int { return int(n.sysAvInfo.timing.fps) } -func (n *Nanoarch) IsPortrait() bool { return n.Rot != nil && n.Rot.IsEven } +func (n *Nanoarch) IsPortrait() bool { return n.Rot == image.A90 || n.Rot == image.A270 } func (n *Nanoarch) GeometryBase() (int, int) { return int(n.sysAvInfo.geometry.base_width), int(n.sysAvInfo.geometry.base_height) } @@ -256,8 +251,7 @@ func (n *Nanoarch) LoadGame(path string) error { n.stopped.Store(false) if n.Video.gl.enabled { - // flip Y coordinates of OpenGL - setRotation(uint(image.Flip180)) + setRotation(image.F180) // flip Y coordinates of OpenGL bufS := uint(n.sysAvInfo.geometry.max_width*n.sysAvInfo.geometry.max_height) * n.Video.BPP graphics.SetBuffer(int(bufS)) n.log.Info().Msgf("Set buffer: %v", byteCountBinary(int64(bufS))) @@ -387,17 +381,9 @@ func videoSetPixelFormat(format uint32) (C.bool, error) { return true, nil } -func setRotation(rotation uint) { - if Nan0.Rot != nil && rotation == uint(Nan0.Rot.Angle) { - return - } - if rotation > 0 { - r := image.GetRotation(image.Angle(rotation)) - Nan0.Rot = &r - } else { - Nan0.Rot = nil - } - Nan0.log.Debug().Msgf("Image rotated %v°", map[uint]uint{0: 0, 1: 90, 2: 180, 3: 270}[rotation]) +func setRotation(rotation image.Rotation) { + Nan0.Rot = rotation + Nan0.log.Debug().Msgf("Image rotated %v°", map[uint]uint{0: 0, 1: 90, 2: 180, 3: 270}[uint(rotation)]) } func printOpenGLDriverInfo() { @@ -679,7 +665,7 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { switch cmd { case C.RETRO_ENVIRONMENT_SET_ROTATION: - setRotation(*(*uint)(data) % 4) + setRotation(image.Rotation(*(*uint)(data) % 4)) return true case C.RETRO_ENVIRONMENT_GET_CAN_DUPE: *(*C.bool)(data) = C.bool(true) From 56d8c4a9289c6463a87fe8b399a45fbb23c95283 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 23 Sep 2023 20:25:32 +0300 Subject: [PATCH 095/361] Clean canvas drawing functions --- pkg/worker/caged/libretro/image/canvas.c | 178 +++++++--------------- pkg/worker/caged/libretro/image/canvas.go | 13 +- pkg/worker/caged/libretro/image/canvas.h | 25 +-- 3 files changed, 79 insertions(+), 137 deletions(-) diff --git a/pkg/worker/caged/libretro/image/canvas.c b/pkg/worker/caged/libretro/image/canvas.c index 66b00cd8..59af9772 100644 --- a/pkg/worker/caged/libretro/image/canvas.c +++ b/pkg/worker/caged/libretro/image/canvas.c @@ -1,142 +1,82 @@ #include "canvas.h" -__inline int rot_x(int t, int x, int y, int w, int h) { +__inline xy rotate(int t, int x, int y, int w, int h) { + xy p = {x, y}; switch (t) { - case 1: - return r90_x(x,y,w,h); + case A90: + p.x = r90_x(x,y,w,h); + p.y = r90_y(x,y,w,h); break; - case 2: - return r180_x(x,y,w,h); + case A180: + p.x = r180_x(x,y,w,h); + p.y = r180_y(x,y,w,h); break; - case 3: - return r270_x(x,y,w,h); + case A270: + p.x = r270_x(x,y,w,h); + p.y = r270_y(x,y,w,h); break; - case 4: - return fy180_x(x,y,w,h); + case F180: + p.x = fy180_x(x,y,w,h); + p.y = fy180_y(x,y,w,h); break; } - return x; + return p; } -__inline int rot_y(int t, int x, int y, int w, int h) { - switch (t) { - case 1: - return r90_y(x,y,w,h); - break; - case 2: - return r180_y(x,y,w,h); - break; - case 3: - return r270_y(x,y,w,h); - break; - case 4: - return fy180_y(x,y,w,h); - break; - } - return y; - } +__inline uint32_t _565(uint32_t x) { + return ((x >> 8 & 0xf8) | ((x >> 3 & 0xfc) << 8) | ((x << 3 & 0xfc) << 16)); // | 0xff000000 +} +__inline uint32_t _8888rev(uint32_t px) { + return (((px >> 16) & 0xff) | (px & 0xff00) | ((px << 16) & 0xff0000)); // | 0xff000000) +} + +void RGBA(int pix, uint32_t *__restrict dst, void *__restrict source, int y, int h, int w, int hh, int dw, int pad, int rot) { + int x; + xy rxy; -void RGBA(int pix, void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot) { switch (pix) { - case BIT_SHORT5551: - break; + //case BIT_SHORT5551: + // break; case BIT_INT_8888REV: - if (rot == 0) { - i8888(destination, source, yy, yn, xw, pad); + uint32_t *src32 = source; + int pad32 = pad >> 2; + if (rot == NO_ROT) { + for (; y < h; ++y) { + for (x = 0; x < w; ++x) { + *dst++ = _8888rev(*src32++); + } + src32 += pad32; + } } else { - i8888r(destination, source, yy, yn, xw, xh, dw, pad, rot); + for (; y < h; ++y) { + for (x = 0; x < w; ++x) { + rxy = rotate(rot, x, y, w, hh); + dst[rxy.x+rxy.y*w] = _8888rev(*src32++); + } + src32 += pad32; + } } break; case BIT_SHORT565: - if (rot == 0) { - i565(destination, source, yy, yn, xw, pad); + uint16_t *src16 = source; + int pad16 = pad >> 1; + if (rot == NO_ROT) { + for (; y < h; ++y) { + for (x = 0; x < w; ++x) { + *dst++ = _565(*src16++); + } + src16 += pad16; + } } else { - i565r(destination, source, yy, yn, xw, xh, dw, pad, rot); + for (; y < h; ++y) { + for (x = 0; x < w; ++x) { + rxy = rotate(rot, x, y, w, hh); + dst[rxy.x+rxy.y*dw] = _565(*src16++); + } + src16 += pad16; + } } break; } } - -void i565(void *destination, void *source, int yy, int yn, int xw, int pad) { - uint8_t *src = source; // must be in bytes because of possible padding in bytes - uint32_t *dst = destination; - - int y, x; - uint32_t px; - - for (y = yy; y < yn; ++y) { - for (x = 0; x < xw; ++x) { - px = *(uint16_t *)src; - src += 2; - *dst++ = _565(px); - } - src += pad; - } -} - -void i565r(void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot) { - uint8_t *src = source; - uint32_t *dst = destination; - - uint32_t px; - - int x, y, dx, dy; - - for (y = yy; y < yn; ++y) { - for (x = 0; x < xw; ++x) { - px = *(uint16_t *)src; - src += 2; - - dx = rot_x(rot, x, y, xw, xh); - dy = rot_y(rot, x, y, xw, xh); - - dst[dx+dy*dw] = _565(px); - } - src += pad; - } -} - -void i8888r(void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot) { - uint8_t *src = source; - uint32_t *dst = destination; - - int y, x; - uint32_t px; - - int dx, dy; - - for (y = yy; y < yn; ++y) { - for (x = 0; x < xw; ++x) { - px = *(uint32_t *)src; - - dx = rot_x(rot, x, y, xw, xh); - dy = rot_y(rot, x, y, xw, xh); - - dst[dx+dy*dw] = _8888rev(px); - src += 4; - } - src += pad; - } -} - -void i8888(void *destination, void *source, int yy, int yn, int xw, int pad) { - uint8_t *src = source; // must be in bytes because of possible padding in bytes - uint32_t *dst = destination; - - int y, x; - uint32_t px; - - for (y = yy; y < yn; ++y) { - for (x = 0; x < xw; ++x) { - px = *(uint32_t *)src; - src += 4; - *dst++ = _8888rev(px); - } - src += pad; - } -} - -uint32_t px8888rev(uint32_t px) { - return _8888rev(px); -} diff --git a/pkg/worker/caged/libretro/image/canvas.go b/pkg/worker/caged/libretro/image/canvas.go index 035876a5..31d9750b 100644 --- a/pkg/worker/caged/libretro/image/canvas.go +++ b/pkg/worker/caged/libretro/image/canvas.go @@ -138,21 +138,22 @@ func (c *Canvas) Draw(encoding uint32, rot Rotation, w, h, packedW, bpp int, dat func frame(encoding uint32, dst *Frame, data []byte, yy int, hn int, w int, h int, pwb int, bpp int, rot Rotation) { sPtr := unsafe.Pointer(&data[yy*pwb]) - dPtr := unsafe.Pointer(&dst.Pix[yy*dst.Stride]) // some cores can zero-right-pad rows to the packed width value pad := pwb - w*bpp if pad < 0 { pad = 0 } - if rot != 0 { - dPtr = unsafe.Pointer(&dst.Pix[0]) + ds := 0 + if rot == 0 { + ds = yy * dst.Stride } + dPtr := (*C.uint32_t)(unsafe.Pointer(&dst.Pix[ds])) C.RGBA(C.int(encoding), dPtr, sPtr, C.int(yy), C.int(yy+hn), C.int(w), C.int(h), C.int(dst.Stride>>2), C.int(pad), C.int(rot)) } -func _8888rev(px uint32) uint32 { return uint32(C.px8888rev(C.uint32_t(px))) } +func _8888rev(px uint32) uint32 { return uint32(C._8888rev(C.uint32_t(px))) } func rotate(t int, x int, y int, w int, h int) (int, int) { - return int(C.rot_x(C.int(t), C.int(x), C.int(y), C.int(w), C.int(h))), - int(C.rot_y(C.int(t), C.int(x), C.int(y), C.int(w), C.int(h))) + var rot C.xy = C.rotate(C.int(t), C.int(x), C.int(y), C.int(w), C.int(h)) + return int(rot.x), int(rot.y) } diff --git a/pkg/worker/caged/libretro/image/canvas.h b/pkg/worker/caged/libretro/image/canvas.h index f89a0f27..93b5d7e6 100644 --- a/pkg/worker/caged/libretro/image/canvas.h +++ b/pkg/worker/caged/libretro/image/canvas.h @@ -7,6 +7,12 @@ #define BIT_INT_8888REV 1 #define BIT_SHORT565 2 +#define NO_ROT 0 +#define A90 1 +#define A180 2 +#define A270 3 +#define F180 4 + // Rotate90 is 90° CCW or 270° CW. #define r90_x(x, y, w, h) ( y ) #define r90_y(x, y, w, h) ( (w - 1) - x ) @@ -23,20 +29,15 @@ #define fy180_x(x, y, w, h) ( x ) #define fy180_y(x, y, w, h) ( (h - 1) - y ) -int rot_x(int t, int x, int y, int w, int h); -int rot_y(int t, int x, int y, int w, int h); +typedef struct XY { + int x, y; +} xy; -#define _565(x) ((x >> 8 & 0xf8) | ((x >> 3 & 0xfc) << 8) | ((x << 3 & 0xfc) << 16)); // | 0xff000000 -#define _8888rev(px) (((px >> 16) & 0xff) | (px & 0xff00) | ((px << 16) & 0xff0000)); // | 0xff000000) +xy rotate(int t, int x, int y, int w, int h); +void RGBA(int pix, uint32_t *dst, void *source, int y, int h, int w, int hh, int dw, int pad, int rot); -void RGBA(int pix, void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot); - -void i565(void *destination, void *source, int yy, int yn, int xw, int pad); -void i8888(void *destination, void *source, int yy, int yn, int xw, int pad); -void i565r(void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot); -void i8888r(void *destination, void *source, int yy, int yn, int xw, int xh, int dw, int pad, int rot); - -uint32_t px8888rev(uint32_t px); +uint32_t _565(uint32_t x); +uint32_t _8888rev(uint32_t px); #endif From e83614068f3f6646160d75f93e2cee0ed07937cb Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 23 Sep 2023 20:25:32 +0300 Subject: [PATCH 096/361] MacOS fix --- pkg/worker/caged/libretro/image/canvas.c | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/pkg/worker/caged/libretro/image/canvas.c b/pkg/worker/caged/libretro/image/canvas.c index 59af9772..48d0b4b4 100644 --- a/pkg/worker/caged/libretro/image/canvas.c +++ b/pkg/worker/caged/libretro/image/canvas.c @@ -34,12 +34,14 @@ __inline uint32_t _8888rev(uint32_t px) { void RGBA(int pix, uint32_t *__restrict dst, void *__restrict source, int y, int h, int w, int hh, int dw, int pad, int rot) { int x; xy rxy; + uint16_t *src16; + uint32_t *src32; switch (pix) { //case BIT_SHORT5551: // break; case BIT_INT_8888REV: - uint32_t *src32 = source; + src32 = (uint32_t *)source; int pad32 = pad >> 2; if (rot == NO_ROT) { for (; y < h; ++y) { @@ -59,7 +61,7 @@ void RGBA(int pix, uint32_t *__restrict dst, void *__restrict source, int y, int } break; case BIT_SHORT565: - uint16_t *src16 = source; + src16 = (uint16_t *)source; int pad16 = pad >> 1; if (rot == NO_ROT) { for (; y < h; ++y) { From da516396250d9298e8be2d76695b21f72a6cb7e4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 24 Sep 2023 01:55:18 +0300 Subject: [PATCH 097/361] Clean canvas.c --- pkg/worker/caged/libretro/image/canvas.c | 34 +++++++++++++----------- pkg/worker/caged/libretro/image/canvas.h | 18 +------------ 2 files changed, 20 insertions(+), 32 deletions(-) diff --git a/pkg/worker/caged/libretro/image/canvas.c b/pkg/worker/caged/libretro/image/canvas.c index 48d0b4b4..03753014 100644 --- a/pkg/worker/caged/libretro/image/canvas.c +++ b/pkg/worker/caged/libretro/image/canvas.c @@ -3,21 +3,25 @@ __inline xy rotate(int t, int x, int y, int w, int h) { xy p = {x, y}; switch (t) { + // 90° CCW or 270° CW case A90: - p.x = r90_x(x,y,w,h); - p.y = r90_y(x,y,w,h); + p.x = y; + p.y = w - 1 - x; break; + // 180° CCW case A180: - p.x = r180_x(x,y,w,h); - p.y = r180_y(x,y,w,h); + p.x = w - 1 - x; + p.y = h - 1 - y; break; + // 270° CCW or 90° CW case A270: - p.x = r270_x(x,y,w,h); - p.y = r270_y(x,y,w,h); + p.x = h - 1 - y; + p.y = x; break; + // flip Y case F180: - p.x = fy180_x(x,y,w,h); - p.y = fy180_y(x,y,w,h); + //p.x = x; + p.y = h - 1 - y; break; } return p; @@ -28,20 +32,20 @@ __inline uint32_t _565(uint32_t x) { } __inline uint32_t _8888rev(uint32_t px) { - return (((px >> 16) & 0xff) | (px & 0xff00) | ((px << 16) & 0xff0000)); // | 0xff000000) + return (((px >> 16) & 0xff) | (px & 0xff00) | ((px << 16) & 0xff0000)); // | 0xff000000 } -void RGBA(int pix, uint32_t *__restrict dst, void *__restrict source, int y, int h, int w, int hh, int dw, int pad, int rot) { +void RGBA(int pix, uint32_t *__restrict dst, const void *__restrict source, int y, int h, int w, int hh, int dw, int pad, int rot) { int x; xy rxy; - uint16_t *src16; - uint32_t *src32; + const uint16_t *src16; + const uint32_t *src32; switch (pix) { //case BIT_SHORT5551: // break; case BIT_INT_8888REV: - src32 = (uint32_t *)source; + src32 = (const uint32_t *)source; int pad32 = pad >> 2; if (rot == NO_ROT) { for (; y < h; ++y) { @@ -54,14 +58,14 @@ void RGBA(int pix, uint32_t *__restrict dst, void *__restrict source, int y, int for (; y < h; ++y) { for (x = 0; x < w; ++x) { rxy = rotate(rot, x, y, w, hh); - dst[rxy.x+rxy.y*w] = _8888rev(*src32++); + dst[rxy.x+rxy.y*dw] = _8888rev(*src32++); } src32 += pad32; } } break; case BIT_SHORT565: - src16 = (uint16_t *)source; + src16 = (const uint16_t *)source; int pad16 = pad >> 1; if (rot == NO_ROT) { for (; y < h; ++y) { diff --git a/pkg/worker/caged/libretro/image/canvas.h b/pkg/worker/caged/libretro/image/canvas.h index 93b5d7e6..5ee04a86 100644 --- a/pkg/worker/caged/libretro/image/canvas.h +++ b/pkg/worker/caged/libretro/image/canvas.h @@ -13,29 +13,13 @@ #define A270 3 #define F180 4 -// Rotate90 is 90° CCW or 270° CW. -#define r90_x(x, y, w, h) ( y ) -#define r90_y(x, y, w, h) ( (w - 1) - x ) - -// Rotate180 is 180° CCW. -#define r180_x(x, y, w, h) ( (w - 1) - x ) -#define r180_y(x, y, w, h) ( (h - 1) - y ) - -// Rotate270 is 270° CCW or 90° CW. -#define r270_x(x, y, w, h) ( (h - 1) - y ) -#define r270_y(x, y, w, h) ( x ) - -// Flip Y -#define fy180_x(x, y, w, h) ( x ) -#define fy180_y(x, y, w, h) ( (h - 1) - y ) - typedef struct XY { int x, y; } xy; xy rotate(int t, int x, int y, int w, int h); -void RGBA(int pix, uint32_t *dst, void *source, int y, int h, int w, int hh, int dw, int pad, int rot); +void RGBA(int pix, uint32_t *dst, const void *source, int y, int h, int w, int hh, int dw, int pad, int rot); uint32_t _565(uint32_t x); uint32_t _8888rev(uint32_t px); From 87033090903591e95cf00bfbd0d58744ab526930 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 24 Sep 2023 01:57:44 +0300 Subject: [PATCH 098/361] Remove old ping/pong handlers --- web/js/controller.js | 22 ---------------------- 1 file changed, 22 deletions(-) diff --git a/web/js/controller.js b/web/js/controller.js index 489590ca..a905daa2 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -10,8 +10,6 @@ // first user interaction let interacted = false; - // ping-pong - // let pingPong = 0; const menuScreen = document.getElementById('menu-screen'); const helpOverlay = document.getElementById('help-overlay'); const playerIndex = document.getElementById('playeridx'); @@ -56,23 +54,7 @@ message.show('Now you can share you game!'); }; - // const onWebrtcMessage = () => { - // event.pub(PING_RESPONSE); - // }; - const onConnectionReady = () => { - // ping / pong - // if (pingPong === 0) { - // pingPong = setInterval(() => { - // if (!webrtc.message('x')) { - // clearInterval(pingPong); - // pingPong = 0; - // log.info("ping-pong was disabled due to remote channel error"); - // } - // event.pub(PING_REQUEST, {time: Date.now()}) - // }, 10000); - // } - // start a game right away or show the menu if (room.getId()) { startGame(); @@ -471,10 +453,6 @@ event.sub(WEBRTC_CONNECTION_READY, onConnectionReady); event.sub(WEBRTC_CONNECTION_CLOSED, () => { input.poll.disable(); - // if (pingPong > 0) { - // clearInterval(pingPong); - // pingPong = 0; - // } webrtc.stop(); }); event.sub(LATENCY_CHECK_REQUESTED, onLatencyCheck); From 226bb0384ee559464acf30567b72e4f0c636aaa7 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 24 Sep 2023 01:59:38 +0300 Subject: [PATCH 099/361] Remove Quit notification --- web/js/controller.js | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/web/js/controller.js b/web/js/controller.js index a905daa2..78457be9 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -381,8 +381,6 @@ case KEY.FULL: stream.video.toggleFullscreen(); break; - - // update player index case KEY.PAD1: updatePlayerIndex(0); break; @@ -395,24 +393,15 @@ case KEY.PAD4: updatePlayerIndex(3); break; - - // toggle multitap case KEY.MULTITAP: api.game.toggleMultitap(); break; - - // quit case KEY.QUIT: input.poll.disable(); - api.game.quit(room.getId()); room.reset(); - - message.show('Quit!'); - window.location = window.location.pathname; break; - case KEY.STATS: event.pub(STATS_TOGGLE); break; From a901c84d99e52649b084bdbb8082117e1428bb3c Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 26 Sep 2023 21:01:19 +0300 Subject: [PATCH 100/361] Update dependencies --- go.mod | 4 ++-- go.sum | 11 ++++------- 2 files changed, 6 insertions(+), 9 deletions(-) diff --git a/go.mod b/go.mod index 86da4b88..5850d017 100644 --- a/go.mod +++ b/go.mod @@ -16,7 +16,7 @@ require ( github.com/pion/logging v0.2.2 github.com/pion/webrtc/v4 v4.0.0-beta.3 github.com/rs/xid v1.5.0 - github.com/rs/zerolog v1.30.0 + github.com/rs/zerolog v1.31.0 github.com/veandco/go-sdl2 v0.4.35 golang.org/x/crypto v0.13.0 golang.org/x/image v0.12.0 @@ -36,7 +36,7 @@ require ( github.com/pion/mdns v0.0.9 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.10 // indirect - github.com/pion/rtp v1.8.1 // indirect + github.com/pion/rtp v1.8.2 // indirect github.com/pion/sctp v1.8.9 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect github.com/pion/srtp/v3 v3.0.0 // indirect diff --git a/go.sum b/go.sum index 04e3441d..2cda3f38 100644 --- a/go.sum +++ b/go.sum @@ -43,10 +43,8 @@ github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORN github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= github.com/kr/text v0.1.0 h1:45sCR5RtlFHMR4UwH9sdQ5TC8v0qDQCHnXt+kaKSTVE= github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= -github.com/mattn/go-colorable v0.1.12/go.mod h1:u5H1YNBxpqRaxsYJYSkiCWKzEfiAb1Gb520KVy5xxl4= github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA= github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg= -github.com/mattn/go-isatty v0.0.14/go.mod h1:7GGIvUiUoEMVVmxf/4nioHXj79iQHKdU27kJ6hsGG94= github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM= github.com/mattn/go-isatty v0.0.19 h1:JITubQf0MOLdlGRuRq+jtsDlekdYPia9ZFsB8h/APPA= github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= @@ -82,8 +80,9 @@ github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.10 h1:nkr3uj+8Sp97zyItdN60tE/S6vk4al5CPRR6Gejsdjc= github.com/pion/rtcp v1.2.10/go.mod h1:ztfEwXZNLGyF1oQDttz/ZKIBaeeg/oWbRYqzBM9TL1I= -github.com/pion/rtp v1.8.1 h1:26OxTc6lKg/qLSGir5agLyj0QKaOv8OP5wps2SFnVNQ= github.com/pion/rtp v1.8.1/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= +github.com/pion/rtp v1.8.2 h1:oKMM0K1/QYQ5b5qH+ikqDSZRipP5mIxPJcgcvw5sH0w= +github.com/pion/rtp v1.8.2/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/sctp v1.8.5/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= github.com/pion/sctp v1.8.9 h1:TP5ZVxV5J7rz7uZmbyvnUvsn7EJ2x/5q9uhsTtXbI3g= github.com/pion/sctp v1.8.9/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= @@ -109,8 +108,8 @@ github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZb github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/rs/xid v1.5.0 h1:mKX4bl4iPYJtEIxp6CYiUuLQ/8DYMoz0PUdtGgMFRVc= github.com/rs/xid v1.5.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg= -github.com/rs/zerolog v1.30.0 h1:SymVODrcRsaRaSInD9yQtKbtWqwsfoPcRff/oRXLj4c= -github.com/rs/zerolog v1.30.0/go.mod h1:/tk+P47gFdPXq4QYjvCmT5/Gsug2nagsFWBWhAiSi1w= +github.com/rs/zerolog v1.31.0 h1:FcTR3NnLWW+NnTwwhFWiJSZr4ECLpqCm6QsEnyvbV4A= +github.com/rs/zerolog v1.31.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss= github.com/sclevine/agouti v3.0.0+incompatible/go.mod h1:b4WX9W9L1sfQKXeJf1mUTLZKJ48R1S7H23Ji7oFO5Bw= github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= @@ -177,8 +176,6 @@ golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7w golang.org/x/sys v0.0.0-20210112080510-489259a85091/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.0.0-20210630005230-0f9fa26af87c/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.0.0-20210927094055-39ccf1dd6fa6/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= From c1c4731640501422c6bd12d47bb3f5e925b108be Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 29 Sep 2023 22:29:59 +0300 Subject: [PATCH 101/361] Use faster Y flip of the video encoders (OpenGL/N64) --- pkg/worker/caged/libretro/frontend.go | 2 ++ pkg/worker/caged/libretro/nanoarch/nanoarch.go | 3 ++- pkg/worker/coordinatorhandlers.go | 3 +++ pkg/worker/encoder/encoder.go | 3 +++ pkg/worker/encoder/h264/libx264.go | 4 ++-- pkg/worker/encoder/h264/x264.go | 8 ++++++++ pkg/worker/encoder/vpx/libvpx.go | 7 +++++++ pkg/worker/media/media.go | 2 ++ 8 files changed, 29 insertions(+), 3 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index a9c50fcd..bf7651b4 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -24,6 +24,7 @@ type Emulator interface { LoadCore(name string) LoadGame(path string) error FPS() int + Flipped() bool AudioSampleRate() int IsPortrait() bool // Start is called after LoadGame @@ -239,6 +240,7 @@ func (f *Frontend) Start() { } } +func (f *Frontend) Flipped() bool { return f.nano.IsGL() } func (f *Frontend) FrameSize() (int, int) { return f.nano.GeometryBase() } func (f *Frontend) FPS() int { return f.nano.VideoFramerate() } func (f *Frontend) HashPath() string { return f.storage.GetSavePath() } diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index e92defea..841ae8c4 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -251,7 +251,7 @@ func (n *Nanoarch) LoadGame(path string) error { n.stopped.Store(false) if n.Video.gl.enabled { - setRotation(image.F180) // flip Y coordinates of OpenGL + //setRotation(image.F180) // flip Y coordinates of OpenGL bufS := uint(n.sysAvInfo.geometry.max_width*n.sysAvInfo.geometry.max_height) * n.Video.BPP graphics.SetBuffer(int(bufS)) n.log.Info().Msgf("Set buffer: %v", byteCountBinary(int64(bufS))) @@ -351,6 +351,7 @@ func (n *Nanoarch) Run() { } } +func (n *Nanoarch) IsGL() bool { return n.Video.gl.enabled } func (n *Nanoarch) IsStopped() bool { return n.stopped.Load() } func videoSetPixelFormat(format uint32) (C.bool, error) { diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index b04fa412..159f3dd3 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -112,6 +112,9 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke app.Close() return api.EmptyPacket } + if app.Flipped() { + m.SetVideoFlip(true) + } // make the room r = room.NewRoom[*room.GameSession](uid, app, w.router.Users(), m) diff --git a/pkg/worker/encoder/encoder.go b/pkg/worker/encoder/encoder.go index 15822d63..dd5fd486 100644 --- a/pkg/worker/encoder/encoder.go +++ b/pkg/worker/encoder/encoder.go @@ -16,6 +16,7 @@ type ( LoadBuf(input []byte) Encode() []byte IntraRefresh() + SetFlip(bool) Shutdown() error } ) @@ -65,6 +66,8 @@ func (vp *VideoEncoder) Encode(img InFrame) OutFrame { return nil } +func (vp *VideoEncoder) SetFlip(b bool) { vp.encoder.SetFlip(b) } + func (vp *VideoEncoder) Stop() { vp.stopped.Store(true) vp.mu.Lock() diff --git a/pkg/worker/encoder/h264/libx264.go b/pkg/worker/encoder/h264/libx264.go index cafac4fd..775f9563 100644 --- a/pkg/worker/encoder/h264/libx264.go +++ b/pkg/worker/encoder/h264/libx264.go @@ -44,7 +44,8 @@ type Nal struct { const RcCrf = 1 const ( - CspI420 = 0x0002 // yuv 4:2:0 planar + CspI420 = 0x0002 // yuv 4:2:0 planar + CspVflip = 0x1000 /* the csp is vertically flipped */ // CspMask = 0x00ff /* */ // CspNone = 0x0000 /* Invalid mode */ @@ -65,7 +66,6 @@ const ( //CspBgra = 0x000f /* packed bgr 32bits */ //CspRgb = 0x0010 /* packed rgb 24bits */ //CspMax = 0x0011 /* end of list */ - //CspVflip = 0x1000 /* the csp is vertically flipped */ //CspHighDepth = 0x2000 /* the csp has a depth of 16 bits per pixel component */ ) diff --git a/pkg/worker/encoder/h264/x264.go b/pkg/worker/encoder/h264/x264.go index 2c87e9f2..c4b4ea00 100644 --- a/pkg/worker/encoder/h264/x264.go +++ b/pkg/worker/encoder/h264/x264.go @@ -139,6 +139,14 @@ func (e *H264) IntraRefresh() { // !to implement } +func (e *H264) SetFlip(b bool) { + if b { + e.in.Img.ICsp |= CspVflip + } else { + e.in.Img.ICsp &= ^CspVflip + } +} + func (e *H264) Shutdown() error { e.y = nil e.u = nil diff --git a/pkg/worker/encoder/vpx/libvpx.go b/pkg/worker/encoder/vpx/libvpx.go index c9047e18..ca423e0d 100644 --- a/pkg/worker/encoder/vpx/libvpx.go +++ b/pkg/worker/encoder/vpx/libvpx.go @@ -84,8 +84,11 @@ type Vpx struct { image C.vpx_image_t codecCtx C.vpx_codec_ctx_t kfi C.int + flipped bool } +func (vpx *Vpx) SetFlip(b bool) { vpx.flipped = b } + type Options struct { // Target bandwidth to use for this stream, in kilobits per second. Bitrate uint @@ -134,6 +137,9 @@ func NewEncoder(w, h int, opts *Options) (*Vpx, error) { func (vpx *Vpx) LoadBuf(yuv []byte) { C.vpx_img_read(&vpx.image, unsafe.Pointer(&yuv[0])) + if vpx.flipped { + C.vpx_img_flip(&vpx.image) + } } // Encode encodes yuv image with the VPX8 encoder. @@ -166,5 +172,6 @@ func (vpx *Vpx) Shutdown() error { C.vpx_img_free(&vpx.image) //} C.vpx_codec_destroy(&vpx.codecCtx) + vpx.flipped = false return nil } diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index e6d0cab9..15400641 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -189,3 +189,5 @@ func (wmp *WebrtcMediaPipe) initVideo(w, h int, conf config.Video) error { } func (wmp *WebrtcMediaPipe) ProcessVideo(v app.Video) []byte { return wmp.enc.Encode(&v.Frame) } + +func (wmp *WebrtcMediaPipe) SetVideoFlip(b bool) { wmp.enc.SetFlip(b) } From cddf081b8fee274f07e704668cb346b50381e8d3 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 6 Oct 2023 01:12:27 +0300 Subject: [PATCH 102/361] Use locks in router with rooms --- pkg/com/com.go | 1 + pkg/com/map.go | 29 +++++++++++++++++++++++++---- pkg/com/map_test.go | 4 ++-- pkg/coordinator/worker.go | 2 +- pkg/coordinator/workerhandlers.go | 2 +- pkg/worker/coordinatorhandlers.go | 12 ++++++------ pkg/worker/room/room.go | 31 +++++++++++++++++++------------ pkg/worker/worker.go | 6 +++++- 8 files changed, 60 insertions(+), 27 deletions(-) diff --git a/pkg/com/com.go b/pkg/com/com.go index d6cc5ca7..5a738039 100644 --- a/pkg/com/com.go +++ b/pkg/com/com.go @@ -15,6 +15,7 @@ func NewNetMap[K comparable, T NetClient[K]]() NetMap[K, T] { func (m *NetMap[K, T]) Add(client T) bool { return m.Put(client.Id(), client) } func (m *NetMap[K, T]) Remove(client T) { m.Map.Remove(client.Id()) } +func (m *NetMap[K, T]) RemoveL(client T) int { return m.Map.RemoveL(client.Id()) } func (m *NetMap[K, T]) Reset() { m.Map = Map[K, T]{m: make(map[K]T, 10)} } func (m *NetMap[K, T]) RemoveDisconnect(client T) { client.Disconnect(); m.Remove(client) } diff --git a/pkg/com/map.go b/pkg/com/map.go index a144c0e3..6a4df33a 100644 --- a/pkg/com/map.go +++ b/pkg/com/map.go @@ -1,6 +1,9 @@ package com -import "sync" +import ( + "fmt" + "sync" +) // Map defines a concurrent-safe map structure. // Keep in mind that the underlying map structure will grow indefinitely. @@ -9,7 +12,7 @@ type Map[K comparable, V any] struct { mu sync.Mutex } -func (m *Map[K, _]) Has(key K) bool { _, ok := m.Find(key); return ok } +func (m *Map[K, _]) Has(key K) bool { _, ok := m.Contains(key); return ok } func (m *Map[_, _]) Len() int { m.mu.Lock(); defer m.mu.Unlock(); return len(m.m) } func (m *Map[K, V]) Pop(key K) V { m.mu.Lock() @@ -26,9 +29,22 @@ func (m *Map[K, V]) Put(key K, v V) bool { return ok } func (m *Map[K, _]) Remove(key K) { m.mu.Lock(); delete(m.m, key); m.mu.Unlock() } +func (m *Map[K, _]) RemoveL(key K) int { + m.mu.Lock() + delete(m.m, key) + k := len(m.m) + m.mu.Unlock() + return k +} +func (m *Map[K, V]) String() string { + m.mu.Lock() + s := fmt.Sprintf("%v", m.m) + m.mu.Unlock() + return s +} -// Find returns the first value found and a boolean flag if its found or not. -func (m *Map[K, V]) Find(key K) (v V, ok bool) { +// Contains returns the first value found and a boolean flag if its found or not. +func (m *Map[K, V]) Contains(key K) (v V, ok bool) { m.mu.Lock() defer m.mu.Unlock() if vv, ok := m.m[key]; ok { @@ -37,6 +53,11 @@ func (m *Map[K, V]) Find(key K) (v V, ok bool) { return v, false } +func (m *Map[K, V]) Find(key K) V { + v, _ := m.Contains(key) + return v +} + // FindBy searches the first key-value with the provided predicate function. func (m *Map[K, V]) FindBy(fn func(v V) bool) (v V, ok bool) { m.mu.Lock() diff --git a/pkg/com/map_test.go b/pkg/com/map_test.go index fb2b19f7..8de5c306 100644 --- a/pkg/com/map_test.go +++ b/pkg/com/map_test.go @@ -17,11 +17,11 @@ func TestMap_Base(t *testing.T) { if !m.Has(k) { t.Errorf("should have the key %v, %v", k, m.m) } - v, ok := m.Find(k) + v, ok := m.Contains(k) if v != 0 && !ok { t.Errorf("should have the key %v and ok, %v %v", k, ok, m.m) } - _, ok = m.Find(k + 1) + _, ok = m.Contains(k + 1) if ok { t.Errorf("should not find anything, %v %v", ok, m.m) } diff --git a/pkg/coordinator/worker.go b/pkg/coordinator/worker.go index dd0221fb..32b8f147 100644 --- a/pkg/coordinator/worker.go +++ b/pkg/coordinator/worker.go @@ -29,7 +29,7 @@ type RegionalClient interface { } type HasUserRegistry interface { - Find(com.Uid) (*User, bool) + Find(com.Uid) *User } func NewWorker(sock *com.Connection, handshake api.ConnectionRequest[com.Uid], log *logger.Logger) *Worker { diff --git a/pkg/coordinator/workerhandlers.go b/pkg/coordinator/workerhandlers.go index 97a7839d..6f50d126 100644 --- a/pkg/coordinator/workerhandlers.go +++ b/pkg/coordinator/workerhandlers.go @@ -14,7 +14,7 @@ func (w *Worker) HandleCloseRoom(rq api.CloseRoomRequest) { } func (w *Worker) HandleIceCandidate(rq api.WebrtcIceCandidateRequest[com.Uid], users HasUserRegistry) error { - if usr, ok := users.Find(rq.Id); ok { + if usr := users.Find(rq.Id); usr != nil { usr.SendWebrtcIceCandidate(rq.Candidate) } else { w.log.Warn().Str("id", rq.Id.String()).Msg("unknown session") diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 159f3dd3..4d3548db 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -49,8 +49,10 @@ func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest[com.Uid], w *Wor } user := room.NewGameSession(rq.Id, peer) // use user uid from the coordinator - w.router.AddUser(user) c.log.Info().Msgf("Peer connection: %s", user.Id()) + c.log.Debug().Msgf("Users before add: %v", w.router.Users()) + w.router.AddUser(user) + c.log.Debug().Msgf("Users after add: %v", w.router.Users()) return api.Out{Payload: sdp} } @@ -118,11 +120,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke // make the room r = room.NewRoom[*room.GameSession](uid, app, w.router.Users(), m) - r.HandleClose = func() { - w.router.Close() - c.CloseRoom(uid) - w.log.Debug().Msgf("Closed room %v", uid) - } + r.HandleClose = func() { c.CloseRoom(uid) } w.router.SetRoom(r) c.log.Info().Str("room", r.Id()).Str("game", game.Name).Msg("New room") @@ -148,8 +146,10 @@ func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com. // HandleQuitGame handles cases when a user manually exits the game. func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) { + w.log.Debug().Msgf("Users before remove: %v", w.router.Users()) if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) + w.log.Debug().Msgf("Users after remove: %v", w.router.Users()) } } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index 0acbcf02..a7cfe123 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -1,6 +1,10 @@ package room -import "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" +import ( + "sync" + + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" +) type MediaPipe interface { // Destroy frees all allocated resources. @@ -19,10 +23,9 @@ type MediaPipe interface { type SessionManager[T Session] interface { Add(T) bool - Find(string) (T, bool) + Find(string) T ForEach(func(T)) - Len() int - Remove(T) + RemoveL(T) int // Reset used for proper cleanup of the resources if needed. Reset() } @@ -93,32 +96,36 @@ func (r *Room[T]) Close() { type Router[T Session] struct { room *Room[T] users SessionManager[T] + mu sync.Mutex } func (r *Router[T]) AddUser(user T) { r.users.Add(user) } + func (r *Router[T]) Close() { + r.mu.Lock() if r.room != nil { r.room.Close() r.room = nil } + r.mu.Unlock() } + func (r *Router[T]) FindRoom(id string) *Room[T] { + r.mu.Lock() + defer r.mu.Unlock() if r.room != nil && r.room.Id() == id { return r.room } return nil } -func (r *Router[T]) FindUser(uid Uid) T { sess, _ := r.users.Find(uid.Id()); return sess } + func (r *Router[T]) Remove(user T) { - r.users.Remove(user) - if r.users.Len() == 0 { - if r.room != nil { - r.room.Close() - } - r.users.Reset() + if left := r.users.RemoveL(user); left == 0 { + r.Close() } } -func (r *Router[T]) SetRoom(room *Room[T]) { r.room = room } +func (r *Router[T]) FindUser(uid Uid) T { return r.users.Find(uid.Id()) } +func (r *Router[T]) SetRoom(room *Room[T]) { r.mu.Lock(); r.room = room; r.mu.Unlock() } func (r *Router[T]) Users() SessionManager[T] { return r.users } type AppSession struct { diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 56fc8e03..c74375db 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -28,7 +28,11 @@ type Worker struct { storage cloud.Storage } -func (w *Worker) Reset() { w.router.Close() } +func (w *Worker) Reset() { + w.log.Debug().Msgf("Users before close: %v", w.router.Users()) + w.router.Close() + w.log.Debug().Msgf("Users after close: %v", w.router.Users()) +} const retry = 10 * time.Second From f875d3fc423b169253e562f36ed36690f5160ef3 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 6 Oct 2023 13:30:10 +0300 Subject: [PATCH 103/361] Guard room creation with a mutex Possible fix for the concurrent room creation while other is not destroyed properly. --- pkg/worker/coordinatorhandlers.go | 33 ++++++++++++++++++------------- pkg/worker/room/room.go | 16 ++++++++++----- 2 files changed, 30 insertions(+), 19 deletions(-) diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 4d3548db..aa32e8a1 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -50,9 +50,7 @@ func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest[com.Uid], w *Wor user := room.NewGameSession(rq.Id, peer) // use user uid from the coordinator c.log.Info().Msgf("Peer connection: %s", user.Id()) - c.log.Debug().Msgf("Users before add: %v", w.router.Users()) w.router.AddUser(user) - c.log.Debug().Msgf("Users after add: %v", w.router.Users()) return api.Out{Payload: sdp} } @@ -83,11 +81,23 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke r := w.router.FindRoom(rq.Rid) - if r == nil { + if r == nil { // new room uid := rq.Room.Rid if uid == "" { uid = games.GenerateRoomID(rq.Game.Name) } + game := games.GameMetadata(rq.Game) + + r = room.NewRoom[*room.GameSession](uid, nil, w.router.Users(), nil) + r.HandleClose = func() { c.CloseRoom(uid) } + + if other := w.router.Room(); other != nil { + c.log.Error().Msgf("concurrent room creation: %v", uid) + return api.EmptyPacket + } + + w.router.SetRoom(r) + c.log.Info().Str("room", r.Id()).Str("game", game.Name).Msg("New room") // start the emulator app := room.WithEmulator(w.mana.Get(caged.Libretro)) @@ -97,13 +107,14 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke app.EnableCloudStorage(uid, w.storage) app.EnableRecording(rq.Record, rq.RecordUser, rq.Game.Name) - w.log.Info().Msgf("Starting game: %v", rq.Game.Name) - game := games.GameMetadata(rq.Game) + w.log.Info().Msgf("Starting the game: %v", rq.Game.Name) if err := app.Load(game, w.conf.Worker.Library.BasePath); err != nil { c.log.Error().Err(err).Msgf("couldn't load the game %v", game) app.Close() + w.router.SetRoom(nil) return api.EmptyPacket } + r.SetApp(app) m := media.NewWebRtcMediaPipe(w.conf.Encoder.Audio, w.conf.Encoder.Video, w.log) m.AudioSrcHz = app.AudioSampleRate() @@ -112,19 +123,15 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke if err := m.Init(); err != nil { c.log.Error().Err(err).Msgf("couldn't init the media") app.Close() + w.router.SetRoom(nil) return api.EmptyPacket } if app.Flipped() { m.SetVideoFlip(true) } + r.SetMedia(m) - // make the room - r = room.NewRoom[*room.GameSession](uid, app, w.router.Users(), m) - r.HandleClose = func() { c.CloseRoom(uid) } - - w.router.SetRoom(r) - c.log.Info().Str("room", r.Id()).Str("game", game.Name).Msg("New room") - + r.BindAppMedia() r.StartApp() } @@ -146,10 +153,8 @@ func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com. // HandleQuitGame handles cases when a user manually exits the game. func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) { - w.log.Debug().Msgf("Users before remove: %v", w.router.Users()) if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) - w.log.Debug().Msgf("Users after remove: %v", w.router.Users()) } } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index a7cfe123..7c2aef78 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -53,8 +53,10 @@ type Room[T Session] struct { func NewRoom[T Session](id string, app app.App, um SessionManager[T], media MediaPipe) *Room[T] { room := &Room[T]{id: id, app: app, users: um, media: media} - room.InitVideo() - room.InitAudio() + if app != nil && media != nil { + room.InitVideo() + room.InitAudio() + } return room } @@ -70,9 +72,12 @@ func (r *Room[T]) InitVideo() { }) } -func (r *Room[T]) App() app.App { return r.app } -func (r *Room[T]) Id() string { return r.id } -func (r *Room[T]) StartApp() { r.app.Start() } +func (r *Room[T]) App() app.App { return r.app } +func (r *Room[T]) BindAppMedia() { r.InitAudio(); r.InitVideo() } +func (r *Room[T]) Id() string { return r.id } +func (r *Room[T]) SetApp(app app.App) { r.app = app } +func (r *Room[T]) SetMedia(m MediaPipe) { r.media = m } +func (r *Room[T]) StartApp() { r.app.Start() } func (r *Room[T]) Close() { if r.closed { @@ -124,6 +129,7 @@ func (r *Router[T]) Remove(user T) { r.Close() } } +func (r *Router[T]) Room() *Room[T] { r.mu.Lock(); defer r.mu.Unlock(); return r.room } func (r *Router[T]) FindUser(uid Uid) T { return r.users.Find(uid.Id()) } func (r *Router[T]) SetRoom(room *Room[T]) { r.mu.Lock(); r.room = room; r.mu.Unlock() } func (r *Router[T]) Users() SessionManager[T] { return r.users } From 92aea18a8c05c561bcccb11c555b31e48c2f6474 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 13 Oct 2023 11:13:27 +0300 Subject: [PATCH 104/361] Update dependencies --- go.mod | 12 ++++++------ go.sum | 23 ++++++++++++++--------- 2 files changed, 20 insertions(+), 15 deletions(-) diff --git a/go.mod b/go.mod index 5850d017..a5880268 100644 --- a/go.mod +++ b/go.mod @@ -12,14 +12,14 @@ require ( github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.0.1 github.com/pion/ice/v3 v3.0.1 - github.com/pion/interceptor v0.1.19 + github.com/pion/interceptor v0.1.22 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.0-beta.3 + github.com/pion/webrtc/v4 v4.0.0-beta.5 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.31.0 github.com/veandco/go-sdl2 v0.4.35 - golang.org/x/crypto v0.13.0 - golang.org/x/image v0.12.0 + golang.org/x/crypto v0.14.0 + golang.org/x/image v0.13.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -48,7 +48,7 @@ require ( github.com/stretchr/testify v1.8.4 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.15.0 // indirect - golang.org/x/sys v0.12.0 // indirect + golang.org/x/net v0.17.0 // indirect + golang.org/x/sys v0.13.0 // indirect golang.org/x/text v0.13.0 // indirect ) diff --git a/go.sum b/go.sum index 2cda3f38..62291f5c 100644 --- a/go.sum +++ b/go.sum @@ -69,8 +69,8 @@ github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= github.com/pion/ice/v3 v3.0.1 h1:dwWGgIFDlYrKrCW13LihifuFabGw375hoU0347S9wNw= github.com/pion/ice/v3 v3.0.1/go.mod h1:j4tfTlj4aSEQN9gP3IdliSHcUTWTu9tlOZL0c59MFXo= -github.com/pion/interceptor v0.1.19 h1:tq0TGBzuZQqipyBhaC1mVUCfCh8XjDKUuibq9rIl5t4= -github.com/pion/interceptor v0.1.19/go.mod h1:VANhFxdJezB8mwToMMmrmyHyP9gym6xLqIUch31xryg= +github.com/pion/interceptor v0.1.22 h1:khhimAF0/VmGaIfeE+bA3X1jm0lD8C8HOGcU7vpWcPA= +github.com/pion/interceptor v0.1.22/go.mod h1:wkbPYAak5zKsfpVDYMtEfWEy8D4zL+rpxCxPImLOg3Y= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= github.com/pion/mdns v0.0.8/go.mod h1:hYE72WX8WDveIhg7fmXgMKivD3Puklk0Ymzog0lSyaI= @@ -101,8 +101,8 @@ github.com/pion/transport/v3 v3.0.1 h1:gDTlPJwROfSfz6QfSi0ZmeCSkFcnWWiiR9ES0ouAN github.com/pion/transport/v3 v3.0.1/go.mod h1:UY7kiITrlMv7/IKgd5eTUcaahZx5oUN3l9SzK5f5xE0= github.com/pion/turn/v3 v3.0.1 h1:wLi7BTQr6/Q20R0vt/lHbjv6y4GChFtC33nkYbasoT8= github.com/pion/turn/v3 v3.0.1/go.mod h1:MrJDKgqryDyWy1/4NT9TWfXWGMC7UHT6pJIv1+gMeNE= -github.com/pion/webrtc/v4 v4.0.0-beta.3 h1:QWnz0PtSrXLmzW5sO/iF4+ORNyfaxZ4RrG1rm65pR1U= -github.com/pion/webrtc/v4 v4.0.0-beta.3/go.mod h1:du0swJWWJPiVe+Dybe2wMaLPgPPk6pifZwd3EI/Ly3U= +github.com/pion/webrtc/v4 v4.0.0-beta.5 h1:mW4Z8I50IG2ATa9i6tgClGMTdvTUHrxfAefReI0V2QE= +github.com/pion/webrtc/v4 v4.0.0-beta.5/go.mod h1:epqb0qKpAf5GWPMeDmK1W9Za+dJqlDcx4iKp7+aem6I= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -136,10 +136,11 @@ golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5y golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= golang.org/x/crypto v0.10.0/go.mod h1:o4eNf7Ede1fv+hwOwZsTHl9EsPFO6q6ZvYR8vYfY45I= golang.org/x/crypto v0.12.0/go.mod h1:NF0Gs7EO5K4qLn+Ylc+fih8BSTeIjAP05siRnAh98yw= -golang.org/x/crypto v0.13.0 h1:mvySKfSWJ+UKUii46M40LOvyWfN0s2U+46/jDd0e6Ck= golang.org/x/crypto v0.13.0/go.mod h1:y6Z2r+Rw4iayiXXAIxJIDAJ1zMW4yaTpebo8fPOliYc= -golang.org/x/image v0.12.0 h1:w13vZbU4o5rKOFFR8y7M+c4A5jXDC0uXTdHYRP8X2DQ= -golang.org/x/image v0.12.0/go.mod h1:Lu90jvHG7GfemOIcldsh9A2hS01ocl6oNO7ype5mEnk= +golang.org/x/crypto v0.14.0 h1:wBqGXzWJW6m1XrIKlAH0Hs1JJ7+9KBwnIO8v66Q9cHc= +golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= +golang.org/x/image v0.13.0 h1:3cge/F/QTkNLauhf2QoE9zp+7sr+ZcL4HnoZmdwg9sg= +golang.org/x/image v0.13.0/go.mod h1:6mmbMOeV28HuMTgA6OSRkdXKYw/t5W9Uwn2Yv1r3Yxk= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= @@ -157,8 +158,10 @@ golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= golang.org/x/net v0.11.0/go.mod h1:2L/ixqYpgIVXmeoSA/4Lu7BzTG4KIyPIryS4IsOd1oQ= golang.org/x/net v0.14.0/go.mod h1:PpSgVXXLK0OxS0F31C1/tv6XNguvCrnXIDrFMspZIUI= -golang.org/x/net v0.15.0 h1:ugBLEUaxABaB5AJqW9enI0ACdci2RUd4eP51NTBvuJ8= golang.org/x/net v0.15.0/go.mod h1:idbUs1IY1+zTqbi8yxTbhexhEEk5ur9LInksu6HrEpk= +golang.org/x/net v0.16.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= +golang.org/x/net v0.17.0 h1:pVaXccu2ozPjCXewfr1S7xza/zcXTity9cCdXQYSjIM= +golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -188,8 +191,9 @@ golang.org/x/sys v0.7.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.9.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.12.0 h1:CM0HF96J0hcLAwsHPJZjfdNzs0gftsLfgKt57wWHJ0o= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.13.0 h1:Af8nKPmuFypiUBjVoU9V20FiaFXOcuZI21p0ycVYYGE= +golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= @@ -199,6 +203,7 @@ golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= golang.org/x/term v0.9.0/go.mod h1:M6DEAAIenWoTxdKrOltXcmDY3rSplQUkrvaDU5FcQyo= golang.org/x/term v0.11.0/go.mod h1:zC9APTIj3jG3FdV/Ons+XE1riIZXG4aZ4GTHiPZJPIU= golang.org/x/term v0.12.0/go.mod h1:owVbMEjm3cBLCHdkQu9b1opXd4ETQWc3BhuQGKgXgvU= +golang.org/x/term v0.13.0/go.mod h1:LTmsnFJwVN6bCy1rVCoS+qHT1HhALEFxKncY3WNNh4U= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= From 989d3b1c85ae58c3aa9ad0f81625a3d5512ced8a Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 1 Oct 2023 19:34:27 +0300 Subject: [PATCH 105/361] Move encoding libs to the top package level --- pkg/{worker => }/encoder/encoder.go | 2 +- pkg/{worker => }/encoder/h264/libx264.go | 0 pkg/{worker => }/encoder/h264/x264.go | 0 pkg/{worker => }/encoder/opus/opus.go | 0 pkg/{worker => }/encoder/vpx/libvpx.go | 0 pkg/{worker => }/encoder/yuv/yuv.c | 0 pkg/{worker => }/encoder/yuv/yuv.go | 0 pkg/{worker => }/encoder/yuv/yuv.h | 0 pkg/{worker => }/encoder/yuv/yuv_test.go | 0 pkg/worker/media/media.go | 8 ++++---- pkg/worker/media/media_test.go | 6 +++--- pkg/worker/room/room_test.go | 2 +- 12 files changed, 9 insertions(+), 9 deletions(-) rename pkg/{worker => }/encoder/encoder.go (96%) rename pkg/{worker => }/encoder/h264/libx264.go (100%) rename pkg/{worker => }/encoder/h264/x264.go (100%) rename pkg/{worker => }/encoder/opus/opus.go (100%) rename pkg/{worker => }/encoder/vpx/libvpx.go (100%) rename pkg/{worker => }/encoder/yuv/yuv.c (100%) rename pkg/{worker => }/encoder/yuv/yuv.go (100%) rename pkg/{worker => }/encoder/yuv/yuv.h (100%) rename pkg/{worker => }/encoder/yuv/yuv_test.go (100%) diff --git a/pkg/worker/encoder/encoder.go b/pkg/encoder/encoder.go similarity index 96% rename from pkg/worker/encoder/encoder.go rename to pkg/encoder/encoder.go index dd5fd486..66827d9e 100644 --- a/pkg/worker/encoder/encoder.go +++ b/pkg/encoder/encoder.go @@ -5,8 +5,8 @@ import ( "sync" "sync/atomic" + "github.com/giongto35/cloud-game/v3/pkg/encoder/yuv" "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/yuv" ) type ( diff --git a/pkg/worker/encoder/h264/libx264.go b/pkg/encoder/h264/libx264.go similarity index 100% rename from pkg/worker/encoder/h264/libx264.go rename to pkg/encoder/h264/libx264.go diff --git a/pkg/worker/encoder/h264/x264.go b/pkg/encoder/h264/x264.go similarity index 100% rename from pkg/worker/encoder/h264/x264.go rename to pkg/encoder/h264/x264.go diff --git a/pkg/worker/encoder/opus/opus.go b/pkg/encoder/opus/opus.go similarity index 100% rename from pkg/worker/encoder/opus/opus.go rename to pkg/encoder/opus/opus.go diff --git a/pkg/worker/encoder/vpx/libvpx.go b/pkg/encoder/vpx/libvpx.go similarity index 100% rename from pkg/worker/encoder/vpx/libvpx.go rename to pkg/encoder/vpx/libvpx.go diff --git a/pkg/worker/encoder/yuv/yuv.c b/pkg/encoder/yuv/yuv.c similarity index 100% rename from pkg/worker/encoder/yuv/yuv.c rename to pkg/encoder/yuv/yuv.c diff --git a/pkg/worker/encoder/yuv/yuv.go b/pkg/encoder/yuv/yuv.go similarity index 100% rename from pkg/worker/encoder/yuv/yuv.go rename to pkg/encoder/yuv/yuv.go diff --git a/pkg/worker/encoder/yuv/yuv.h b/pkg/encoder/yuv/yuv.h similarity index 100% rename from pkg/worker/encoder/yuv/yuv.h rename to pkg/encoder/yuv/yuv.h diff --git a/pkg/worker/encoder/yuv/yuv_test.go b/pkg/encoder/yuv/yuv_test.go similarity index 100% rename from pkg/worker/encoder/yuv/yuv_test.go rename to pkg/encoder/yuv/yuv_test.go diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 15400641..5f53324a 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -7,12 +7,12 @@ import ( "unsafe" "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/encoder" + "github.com/giongto35/cloud-game/v3/pkg/encoder/h264" + "github.com/giongto35/cloud-game/v3/pkg/encoder/opus" + "github.com/giongto35/cloud-game/v3/pkg/encoder/vpx" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/h264" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/opus" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/vpx" ) const ( diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 70aea225..612be7a2 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -6,10 +6,10 @@ import ( "reflect" "testing" + "github.com/giongto35/cloud-game/v3/pkg/encoder" + "github.com/giongto35/cloud-game/v3/pkg/encoder/h264" + "github.com/giongto35/cloud-game/v3/pkg/encoder/vpx" "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/h264" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder/vpx" ) var l = logger.New(false) diff --git a/pkg/worker/room/room_test.go b/pkg/worker/room/room_test.go index d74924e9..36bd25d4 100644 --- a/pkg/worker/room/room_test.go +++ b/pkg/worker/room/room_test.go @@ -18,12 +18,12 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/com" "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/encoder" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/caged" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" canvas "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/image" - "github.com/giongto35/cloud-game/v3/pkg/worker/encoder" "github.com/giongto35/cloud-game/v3/pkg/worker/media" "github.com/giongto35/cloud-game/v3/pkg/worker/thread" "golang.org/x/image/font" From 072b674fb1ffd7435441dbf92336a04801cdab37 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 7 Oct 2023 13:54:35 +0300 Subject: [PATCH 106/361] Clean room init/deinit handlers --- pkg/worker/coordinatorhandlers.go | 15 +++++++++++---- pkg/worker/room/room.go | 18 +++++------------- pkg/worker/worker.go | 8 ++------ 3 files changed, 18 insertions(+), 23 deletions(-) diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index aa32e8a1..ebce6062 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -107,29 +107,34 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke app.EnableCloudStorage(uid, w.storage) app.EnableRecording(rq.Record, rq.RecordUser, rq.Game.Name) + r.SetApp(app) + w.log.Info().Msgf("Starting the game: %v", rq.Game.Name) if err := app.Load(game, w.conf.Worker.Library.BasePath); err != nil { c.log.Error().Err(err).Msgf("couldn't load the game %v", game) - app.Close() + r.Close() w.router.SetRoom(nil) return api.EmptyPacket } - r.SetApp(app) m := media.NewWebRtcMediaPipe(w.conf.Encoder.Audio, w.conf.Encoder.Video, w.log) m.AudioSrcHz = app.AudioSampleRate() m.AudioFrame = w.conf.Encoder.Audio.Frame m.VideoW, m.VideoH = app.ViewportSize() + + r.SetMedia(m) + if err := m.Init(); err != nil { c.log.Error().Err(err).Msgf("couldn't init the media") - app.Close() + r.Close() w.router.SetRoom(nil) return api.EmptyPacket } if app.Flipped() { m.SetVideoFlip(true) } - r.SetMedia(m) + m.SetPixFmt(app.PixFormat()) + m.SetRot(app.Rotation()) r.BindAppMedia() r.StartApp() @@ -148,6 +153,7 @@ func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com. if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) user.Disconnect() + w.router.SetRoom(nil) } } @@ -155,6 +161,7 @@ func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com. func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) + w.router.SetRoom(nil) } } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index 7c2aef78..b2341b4e 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -80,7 +80,7 @@ func (r *Room[T]) SetMedia(m MediaPipe) { r.media = m } func (r *Room[T]) StartApp() { r.app.Start() } func (r *Room[T]) Close() { - if r.closed { + if r == nil || r.closed { return } r.closed = true @@ -104,17 +104,6 @@ type Router[T Session] struct { mu sync.Mutex } -func (r *Router[T]) AddUser(user T) { r.users.Add(user) } - -func (r *Router[T]) Close() { - r.mu.Lock() - if r.room != nil { - r.room.Close() - r.room = nil - } - r.mu.Unlock() -} - func (r *Router[T]) FindRoom(id string) *Room[T] { r.mu.Lock() defer r.mu.Unlock() @@ -129,8 +118,11 @@ func (r *Router[T]) Remove(user T) { r.Close() } } -func (r *Router[T]) Room() *Room[T] { r.mu.Lock(); defer r.mu.Unlock(); return r.room } + +func (r *Router[T]) AddUser(user T) { r.users.Add(user) } +func (r *Router[T]) Close() { r.mu.Lock(); r.room.Close(); r.room = nil; r.mu.Unlock() } func (r *Router[T]) FindUser(uid Uid) T { return r.users.Find(uid.Id()) } +func (r *Router[T]) Room() *Room[T] { r.mu.Lock(); defer r.mu.Unlock(); return r.room } func (r *Router[T]) SetRoom(room *Room[T]) { r.mu.Lock(); r.room = room; r.mu.Unlock() } func (r *Router[T]) Users() SessionManager[T] { return r.users } diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index c74375db..0c0f1d5a 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -28,12 +28,6 @@ type Worker struct { storage cloud.Storage } -func (w *Worker) Reset() { - w.log.Debug().Msgf("Users before close: %v", w.router.Users()) - w.router.Close() - w.log.Debug().Msgf("Users after close: %v", w.router.Users()) -} - const retry = 10 * time.Second func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { @@ -74,6 +68,8 @@ func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { return worker, nil } +func (w *Worker) Reset() { w.router.Close() } + func (w *Worker) Start(done chan struct{}) { for _, s := range w.services { if s != nil { From b1b33713d64cad90e0659362e8dcb37a207d1868 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 4 Oct 2023 15:14:31 +0300 Subject: [PATCH 107/361] Add the initial libyuv support The main benefit of libyuv, apart from shortening the video pipeline, is quite noticeable latency and CPU usage decrease due to various assembler/SIMD optimizations of the library. However, there is a drawback for macOS systems: libyuv cannot be downloaded as a compiled library and can only be built from the source, which means we should include a cropped source code of the library (~10K LoC) into the app or rise the complexity of macOS dev and run toolchains. The main target system -- Linux, and Windows will use compiled lib from the package managers and macOS will use the lib included as a shortened source-code. Building the app with the no_libyuv tag will force it to use libyuv from the provided source files. --- .github/workflows/build.yml | 29 +- .../workflows/cd/cloudretro.io/config.yaml | 6 +- Dockerfile | 1 + Makefile | 5 + README.md | 4 +- pkg/config/config.yaml | 16 +- pkg/config/emulator.go | 2 +- pkg/config/shared.go | 9 +- pkg/config/worker.go | 5 +- pkg/encoder/color/bgra/bgra.go | 56 + pkg/encoder/color/rgb565/rgb565.go | 62 + pkg/encoder/color/rgba/rgba.go | 24 + pkg/encoder/encoder.go | 82 +- pkg/encoder/yuv/libyuv/LICENSE | 29 + pkg/encoder/yuv/libyuv/basic_types.h | 29 + pkg/encoder/yuv/libyuv/convert.c | 336 +++ pkg/encoder/yuv/libyuv/convert.h | 113 + pkg/encoder/yuv/libyuv/convert_argb.h | 24 + pkg/encoder/yuv/libyuv/convert_to_i420.c | 116 + pkg/encoder/yuv/libyuv/cpu_id.c | 204 ++ pkg/encoder/yuv/libyuv/cpu_id.h | 106 + pkg/encoder/yuv/libyuv/libyuv.go | 142 + pkg/encoder/yuv/libyuv/libyuv2.go | 89 + pkg/encoder/yuv/libyuv/planar_functions.c | 68 + pkg/encoder/yuv/libyuv/planar_functions.h | 46 + pkg/encoder/yuv/libyuv/rotate.c | 217 ++ pkg/encoder/yuv/libyuv/rotate.h | 79 + pkg/encoder/yuv/libyuv/rotate_any.c | 54 + pkg/encoder/yuv/libyuv/rotate_common.c | 77 + pkg/encoder/yuv/libyuv/rotate_gcc.c | 370 +++ pkg/encoder/yuv/libyuv/rotate_row.h | 106 + pkg/encoder/yuv/libyuv/row.h | 426 +++ pkg/encoder/yuv/libyuv/row_any.c | 206 ++ pkg/encoder/yuv/libyuv/row_common.c | 887 ++++++ pkg/encoder/yuv/libyuv/row_gcc.c | 1090 +++++++ pkg/encoder/yuv/libyuv/scale.c | 946 ++++++ pkg/encoder/yuv/libyuv/scale.h | 53 + pkg/encoder/yuv/libyuv/scale_any.c | 632 ++++ pkg/encoder/yuv/libyuv/scale_common.c | 930 ++++++ pkg/encoder/yuv/libyuv/scale_gcc.c | 2651 +++++++++++++++++ pkg/encoder/yuv/libyuv/scale_row.h | 768 +++++ pkg/encoder/yuv/libyuv/version.h | 16 + pkg/encoder/yuv/libyuv/video_common.c | 50 + pkg/encoder/yuv/libyuv/video_common.h | 212 ++ pkg/encoder/yuv/yuv.c | 130 - pkg/encoder/yuv/yuv.go | 157 +- pkg/encoder/yuv/yuv.h | 18 - pkg/encoder/yuv/yuv_test.go | 346 ++- pkg/worker/caged/app/app.go | 10 +- pkg/worker/caged/libretro/caged.go | 6 +- pkg/worker/caged/libretro/frontend.go | 49 +- pkg/worker/caged/libretro/frontend_test.go | 289 +- pkg/worker/caged/libretro/image/canvas.c | 88 - pkg/worker/caged/libretro/image/canvas.go | 159 - pkg/worker/caged/libretro/image/canvas.h | 27 - .../caged/libretro/image/canvas_test.go | 340 --- pkg/worker/caged/libretro/manager/http.go | 22 +- .../caged/libretro/nanoarch/nanoarch.go | 67 +- pkg/worker/caged/libretro/recording.go | 33 +- pkg/worker/coordinatorhandlers.go | 1 + pkg/worker/media/media.go | 38 +- pkg/worker/media/media_test.go | 9 +- pkg/worker/recorder/ffmpegmux.go | 28 +- pkg/worker/recorder/options.go | 20 +- pkg/worker/recorder/pngstream.go | 72 - pkg/worker/recorder/rawstream.go | 66 + pkg/worker/recorder/recorder.go | 10 +- pkg/worker/recorder/recorder_test.go | 62 +- pkg/worker/room/room_test.go | 107 +- pkg/worker/thread/mainthread_darwin_test.go | 16 +- test/test.go | 17 + .../raw/000_name_fourcc_width_height_stride | 0 .../raw/001_alsa_ABGR_256_240_1024.raw.zip | Bin 0 -> 3748 bytes 73 files changed, 12017 insertions(+), 1543 deletions(-) create mode 100644 pkg/encoder/color/bgra/bgra.go create mode 100644 pkg/encoder/color/rgb565/rgb565.go create mode 100644 pkg/encoder/color/rgba/rgba.go create mode 100644 pkg/encoder/yuv/libyuv/LICENSE create mode 100644 pkg/encoder/yuv/libyuv/basic_types.h create mode 100644 pkg/encoder/yuv/libyuv/convert.c create mode 100644 pkg/encoder/yuv/libyuv/convert.h create mode 100644 pkg/encoder/yuv/libyuv/convert_argb.h create mode 100644 pkg/encoder/yuv/libyuv/convert_to_i420.c create mode 100644 pkg/encoder/yuv/libyuv/cpu_id.c create mode 100644 pkg/encoder/yuv/libyuv/cpu_id.h create mode 100644 pkg/encoder/yuv/libyuv/libyuv.go create mode 100644 pkg/encoder/yuv/libyuv/libyuv2.go create mode 100644 pkg/encoder/yuv/libyuv/planar_functions.c create mode 100644 pkg/encoder/yuv/libyuv/planar_functions.h create mode 100644 pkg/encoder/yuv/libyuv/rotate.c create mode 100644 pkg/encoder/yuv/libyuv/rotate.h create mode 100644 pkg/encoder/yuv/libyuv/rotate_any.c create mode 100644 pkg/encoder/yuv/libyuv/rotate_common.c create mode 100644 pkg/encoder/yuv/libyuv/rotate_gcc.c create mode 100644 pkg/encoder/yuv/libyuv/rotate_row.h create mode 100644 pkg/encoder/yuv/libyuv/row.h create mode 100644 pkg/encoder/yuv/libyuv/row_any.c create mode 100644 pkg/encoder/yuv/libyuv/row_common.c create mode 100644 pkg/encoder/yuv/libyuv/row_gcc.c create mode 100644 pkg/encoder/yuv/libyuv/scale.c create mode 100644 pkg/encoder/yuv/libyuv/scale.h create mode 100644 pkg/encoder/yuv/libyuv/scale_any.c create mode 100644 pkg/encoder/yuv/libyuv/scale_common.c create mode 100644 pkg/encoder/yuv/libyuv/scale_gcc.c create mode 100644 pkg/encoder/yuv/libyuv/scale_row.h create mode 100644 pkg/encoder/yuv/libyuv/version.h create mode 100644 pkg/encoder/yuv/libyuv/video_common.c create mode 100644 pkg/encoder/yuv/libyuv/video_common.h delete mode 100644 pkg/encoder/yuv/yuv.c delete mode 100644 pkg/encoder/yuv/yuv.h delete mode 100644 pkg/worker/caged/libretro/image/canvas.c delete mode 100644 pkg/worker/caged/libretro/image/canvas.go delete mode 100644 pkg/worker/caged/libretro/image/canvas.h delete mode 100644 pkg/worker/caged/libretro/image/canvas_test.go delete mode 100644 pkg/worker/recorder/pngstream.go create mode 100644 pkg/worker/recorder/rawstream.go create mode 100644 test/test.go create mode 100644 test/testdata/raw/000_name_fourcc_width_height_stride create mode 100644 test/testdata/raw/001_alsa_ABGR_256_240_1024.raw.zip diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 8a156e0f..ccae921f 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -1,5 +1,5 @@ # ------------------------------------------------------------ -# Build workflow (Linux x64, macOS x64, Windows x64) +# Build and test workflow (Linux x64, macOS x64, Windows x64) # ------------------------------------------------------------ name: build @@ -20,7 +20,7 @@ jobs: strategy: matrix: os: [ ubuntu-latest, macos-latest, windows-latest ] - step: [ build, check ] + step: [ build, test ] runs-on: ${{ matrix.os }} steps: - uses: actions/checkout@v3 @@ -33,7 +33,7 @@ jobs: if: matrix.os == 'ubuntu-latest' run: | sudo apt-get -qq update - sudo apt-get -qq install -y make pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libgl1-mesa-glx + sudo apt-get -qq install -y make pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev libgl1-mesa-glx - name: Get MacOS dev libraries and tools if: matrix.os == 'macos-latest' @@ -55,9 +55,10 @@ jobs: mingw-w64-x86_64-opus mingw-w64-x86_64-x264-git mingw-w64-x86_64-SDL2 + mingw-w64-x86_64-libyuv - name: Get Windows OpenGL drivers - if: matrix.step == 'check' && matrix.os == 'windows-latest' + if: matrix.step == 'test' && matrix.os == 'windows-latest' shell: msys2 {0} run: | wget -q https://github.com/pal1000/mesa-dist-win/releases/download/20.2.1/mesa3d-20.2.1-release-mingw.7z @@ -81,28 +82,28 @@ jobs: run: | make build - - name: Verify core rendering (windows-latest) - if: matrix.step == 'check' && matrix.os == 'windows-latest' && always() + - name: Test (windows-latest) + if: matrix.step == 'test' && matrix.os == 'windows-latest' && always() shell: msys2 {0} env: MESA_GL_VERSION_OVERRIDE: 3.3COMPAT run: | - GL_CTX=-autoGlContext make verify-cores + GL_CTX=-autoGlContext make test verify-cores - - name: Verify core rendering (ubuntu-latest) - if: matrix.step == 'check' && matrix.os == 'ubuntu-latest' && always() + - name: Test (ubuntu-latest) + if: matrix.step == 'test' && matrix.os == 'ubuntu-latest' && always() env: MESA_GL_VERSION_OVERRIDE: 3.3COMPAT run: | - GL_CTX=-autoGlContext xvfb-run --auto-servernum make verify-cores + GL_CTX=-autoGlContext xvfb-run --auto-servernum make test verify-cores - - name: Verify core rendering (macos-latest) - if: matrix.step == 'check' && matrix.os == 'macos-latest' && always() + - name: Test (macos-latest) + if: matrix.step == 'test' && matrix.os == 'macos-latest' && always() run: | - make verify-cores + make test verify-cores - uses: actions/upload-artifact@v3 - if: matrix.step == 'check' && always() + if: matrix.step == 'test' && always() with: name: emulator-test-frames path: _rendered/*.png diff --git a/.github/workflows/cd/cloudretro.io/config.yaml b/.github/workflows/cd/cloudretro.io/config.yaml index 9cfb0e7b..fa8b21a5 100644 --- a/.github/workflows/cd/cloudretro.io/config.yaml +++ b/.github/workflows/cd/cloudretro.io/config.yaml @@ -24,14 +24,16 @@ worker: domain: cloudretro.io emulator: - threads: 4 libretro: logLevel: 1 cores: list: mame: options: - "fbneo-cpu-speed-adjust": "200%" "fbneo-diagnostic-input": "Hold Start" + nes: + scale: 2 pcsx: altRepo: true + snes: + scale: 2 diff --git a/Dockerfile b/Dockerfile index 98a8a807..d874271d 100644 --- a/Dockerfile +++ b/Dockerfile @@ -51,6 +51,7 @@ RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ libopus-dev \ libsdl2-dev \ libvpx-dev \ + libyuv-dev \ libx264-dev \ pkg-config \ && rm -rf /var/lib/apt/lists/* diff --git a/Makefile b/Makefile index f8097ac0..f0afe6ad 100644 --- a/Makefile +++ b/Makefile @@ -6,6 +6,8 @@ CGO_CFLAGS='-g -O3 -funroll-loops' CGO_LDFLAGS='-g -O3' GO_TAGS=static +.PHONY: clean test + fmt: @goimports -w cmd pkg tests @gofmt -s -w cmd pkg tests @@ -32,6 +34,9 @@ build.worker: build: build.coordinator build.worker +test: + go test -v ./pkg/... + verify-cores: go test -run TestAll ./pkg/worker/room -v -renderFrames $(GL_CTX) -outputPath "../../../_rendered" diff --git a/README.md b/README.md index 66944fdc..b3f181c3 100644 --- a/README.md +++ b/README.md @@ -61,13 +61,13 @@ a better sense of performance. ``` # Ubuntu / Windows (WSL2) -apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev +apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev # MacOS brew install pkg-config libvpx x264 opus sdl2 # Windows (MSYS2) -pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,x264-git,SDL2} +pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,x264-git,SDL2,libyuv} ``` Because the coordinator and workers need to run simultaneously. Workers connect to the coordinator. diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 481269ad..30737b08 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -99,12 +99,9 @@ worker: tag: emulator: - # set output viewport scale factor - scale: 1 - # set the total number of threads for the image processing - # (experimental) - threads: 4 + # (removed) + threads: 0 aspectRatio: # enable aspect ratio changing @@ -163,6 +160,7 @@ emulator: # - altRepo (bool) prioritize secondary repo as the download source # - lib (string) # - roms ([]string) + # - scale (int) scales the output video frames by this factor. # - folder (string) # By default emulator selection is based on the folder named as cores # in the list (i.e. nes, snes) but if you specify folder param, @@ -244,8 +242,6 @@ encoder: video: # h264, vpx (VP8) codec: h264 - # concurrent execution units (0 - disabled) - concurrency: 0 # see: https://trac.ffmpeg.org/wiki/Encode/H.264 h264: # Constant Rate Factor (CRF) 0-51 (default: 23) @@ -273,12 +269,6 @@ encoder: # one additional FFMPEG concat demux file recording: enabled: false - # image compression level: - # 0 - default compression - # -1 - no compression - # -2 - best speed - # -3 - best compression - compressLevel: 0 # name contains the name of the recording dir (or zip) # format: # %date:go_time_format% -- refer: https://go.dev/src/time/format.go diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index 3b902518..dda7b486 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -7,7 +7,6 @@ import ( ) type Emulator struct { - Scale int Threads int AspectRatio struct { Keep bool @@ -54,6 +53,7 @@ type LibretroCoreConfig struct { Lib string Options map[string]string Roms []string + Scale float64 UsesLibCo bool VFR bool Width int diff --git a/pkg/config/shared.go b/pkg/config/shared.go index 856479f4..026b79d3 100644 --- a/pkg/config/shared.go +++ b/pkg/config/shared.go @@ -41,11 +41,10 @@ type Server struct { } type Recording struct { - Enabled bool - CompressLevel int - Name string - Folder string - Zip bool + Enabled bool + Name string + Folder string + Zip bool } func (s *Server) WithFlags() { diff --git a/pkg/config/worker.go b/pkg/config/worker.go index ed0145d4..ab6af2cc 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -52,9 +52,8 @@ type Audio struct { } type Video struct { - Codec string - Concurrency int - H264 struct { + Codec string + H264 struct { Crf uint8 LogLevel int32 Preset string diff --git a/pkg/encoder/color/bgra/bgra.go b/pkg/encoder/color/bgra/bgra.go new file mode 100644 index 00000000..39a50c22 --- /dev/null +++ b/pkg/encoder/color/bgra/bgra.go @@ -0,0 +1,56 @@ +package bgra + +import ( + "image" + "image/color" +) + +type BGRA struct { + image.RGBA +} + +var BGRAModel = color.ModelFunc(func(c color.Color) color.Color { + if _, ok := c.(BGRAColor); ok { + return c + } + r, g, b, a := c.RGBA() + return BGRAColor{uint8(r >> 8), uint8(g >> 8), uint8(b >> 8), uint8(a >> 8)} +}) + +// BGRAColor represents a BGRA color. +type BGRAColor struct { + R, G, B, A uint8 +} + +func (c BGRAColor) RGBA() (r, g, b, a uint32) { + r = uint32(c.B) + r |= r << 8 + g = uint32(c.G) + g |= g << 8 + b = uint32(c.R) + b |= b << 8 + a = uint32(255) //uint32(c.A) + a |= a << 8 + return +} + +func NewBGRA(r image.Rectangle) *BGRA { + return &BGRA{*image.NewRGBA(r)} +} + +func (p *BGRA) ColorModel() color.Model { return BGRAModel } +func (p *BGRA) At(x, y int) color.Color { + i := p.PixOffset(x, y) + s := p.Pix[i : i+4 : i+4] + return BGRAColor{s[0], s[1], s[2], s[3]} +} + +func (p *BGRA) Set(x, y int, c color.Color) { + i := p.PixOffset(x, y) + c1 := BGRAModel.Convert(c).(BGRAColor) + s := p.Pix[i : i+4 : i+4] + s[0] = c1.R + s[1] = c1.G + s[2] = c1.B + s[3] = 255 +} diff --git a/pkg/encoder/color/rgb565/rgb565.go b/pkg/encoder/color/rgb565/rgb565.go new file mode 100644 index 00000000..11c66c8b --- /dev/null +++ b/pkg/encoder/color/rgb565/rgb565.go @@ -0,0 +1,62 @@ +package rgb565 + +import ( + "encoding/binary" + "image" + "image/color" + "math" +) + +// RGB565 is an in-memory image whose At method returns RGB565 values. +type RGB565 struct { + // Pix holds the image's pixels, as RGB565 values in big-endian format. The pixel at + // (x, y) starts at Pix[(y-p.Rect.Min.Y)*p.Stride + (x-p.Rect.Min.X)*2]. + Pix []uint8 + // Stride is the Pix stride (in bytes) between vertically adjacent pixels. + Stride int + // Rect is the image's bounds. + Rect image.Rectangle +} + +// Model is the model for RGB565 colors. +var Model = color.ModelFunc(func(c color.Color) color.Color { + //if _, ok := c.(Color); ok { + // return c + //} + r, g, b, _ := c.RGBA() + return Color(uint16((r<<8)&rMask | (g<<3)&gMask | (b>>3)&bMask)) +}) + +const ( + rMask = 0b1111100000000000 + gMask = 0b0000011111100000 + bMask = 0b0000000000011111 +) + +// Color represents an RGB565 color. +type Color uint16 + +func (c Color) RGBA() (r, g, b, a uint32) { + return uint32(math.Round(float64(c&rMask>>11)*255.0/31.0)) << 8, + uint32(math.Round(float64(c&gMask>>5)*255.0/63.0)) << 8, + uint32(math.Round(float64(c&bMask)*255.0/31.0)) << 8, + 0xffff +} + +func NewRGB565(r image.Rectangle) *RGB565 { + return &RGB565{Pix: make([]uint8, r.Dx()*r.Dy()<<1), Stride: r.Dx() << 1, Rect: r} +} + +func (p *RGB565) Bounds() image.Rectangle { return p.Rect } +func (p *RGB565) ColorModel() color.Model { return Model } +func (p *RGB565) PixOffset(x, y int) int { return (x-p.Rect.Min.X)<<1 + (y-p.Rect.Min.Y)*p.Stride } + +func (p *RGB565) At(x, y int) color.Color { + i := p.PixOffset(x, y) + return Color(binary.LittleEndian.Uint16(p.Pix[i : i+2])) +} + +func (p *RGB565) Set(x, y int, c color.Color) { + i := p.PixOffset(x, y) + binary.LittleEndian.PutUint16(p.Pix[i:i+2], uint16(Model.Convert(c).(Color))) +} diff --git a/pkg/encoder/color/rgba/rgba.go b/pkg/encoder/color/rgba/rgba.go new file mode 100644 index 00000000..c37d6218 --- /dev/null +++ b/pkg/encoder/color/rgba/rgba.go @@ -0,0 +1,24 @@ +package rgba + +import ( + "image" + "image/color" +) + +func ToRGBA(img image.Image, flipped bool) *image.RGBA { + bounds := img.Bounds() + sw, sh := bounds.Dx(), bounds.Dy() + dst := image.NewRGBA(image.Rect(0, 0, sw, sh)) + for y := 0; y < sh; y++ { + yy := y + if flipped { + yy = sh - y + } + for x := 0; x < sw; x++ { + px := img.At(x, y) + rgba := color.RGBAModel.Convert(px).(color.RGBA) + dst.Set(x, yy, rgba) + } + } + return dst +} diff --git a/pkg/encoder/encoder.go b/pkg/encoder/encoder.go index 66827d9e..60e960d0 100644 --- a/pkg/encoder/encoder.go +++ b/pkg/encoder/encoder.go @@ -1,7 +1,7 @@ package encoder import ( - "image" + "fmt" "sync" "sync/atomic" @@ -10,7 +10,7 @@ import ( ) type ( - InFrame *image.RGBA + InFrame yuv.RawFrame OutFrame []byte Encoder interface { LoadBuf(input []byte) @@ -21,11 +21,13 @@ type ( } ) -type VideoEncoder struct { - encoder Encoder +type Video struct { + codec Encoder log *logger.Logger stopped atomic.Bool - y yuv.ImgProcessor + y yuv.Conv + pf yuv.PixFmt + rot uint mu sync.Mutex } @@ -41,39 +43,63 @@ const ( // converts them into YUV I420 format, // encodes with provided video encoder, and // puts the result into the output channel. -func NewVideoEncoder(enc Encoder, w, h int, concurrency int, log *logger.Logger) *VideoEncoder { - y := yuv.NewYuvImgProcessor(w, h, &yuv.Options{Threads: concurrency}) - if concurrency > 0 { - log.Info().Msgf("Use concurrent image processor: %v", concurrency) - } - return &VideoEncoder{encoder: enc, y: y, log: log} +func NewVideoEncoder(codec Encoder, w, h int, scale float64, log *logger.Logger) *Video { + return &Video{codec: codec, y: yuv.NewYuvConv(w, h, scale), log: log} } -func (vp *VideoEncoder) Encode(img InFrame) OutFrame { - vp.mu.Lock() - defer vp.mu.Unlock() - if vp.stopped.Load() { +func (v *Video) Encode(frame InFrame) OutFrame { + v.mu.Lock() + defer v.mu.Unlock() + if v.stopped.Load() { return nil } - yCbCr := vp.y.Process(img) - vp.encoder.LoadBuf(yCbCr) - vp.y.Put(&yCbCr) + yCbCr := v.y.Process(yuv.RawFrame(frame), v.rot, v.pf) + v.codec.LoadBuf(yCbCr) + v.y.Put(&yCbCr) - if frame := vp.encoder.Encode(); len(frame) > 0 { - return frame + if bytes := v.codec.Encode(); len(bytes) > 0 { + return bytes } return nil } -func (vp *VideoEncoder) SetFlip(b bool) { vp.encoder.SetFlip(b) } +func (v *Video) Info() string { return fmt.Sprintf("libyuv: %v", v.y.Version()) } -func (vp *VideoEncoder) Stop() { - vp.stopped.Store(true) - vp.mu.Lock() - defer vp.mu.Unlock() - - if err := vp.encoder.Shutdown(); err != nil { - vp.log.Error().Err(err).Msg("failed to close the encoder") +func (v *Video) SetPixFormat(f uint32) { + switch f { + case 1: + v.pf = yuv.PixFmt(yuv.FourccArgb) + case 2: + v.pf = yuv.PixFmt(yuv.FourccRgbp) + default: + v.pf = yuv.PixFmt(yuv.FourccAbgr) + } +} + +// SetRot sets the rotation angle of the frames. +func (v *Video) SetRot(r uint) { + switch r { + // de-rotate + case 90: + v.rot = 270 + case 270: + v.rot = 90 + default: + v.rot = r + } +} + +// SetFlip tells the encoder to flip the frames vertically. +func (v *Video) SetFlip(b bool) { v.codec.SetFlip(b) } + +func (v *Video) Stop() { + v.stopped.Store(true) + v.mu.Lock() + defer v.mu.Unlock() + v.rot = 0 + + if err := v.codec.Shutdown(); err != nil { + v.log.Error().Err(err).Msg("failed to close the encoder") } } diff --git a/pkg/encoder/yuv/libyuv/LICENSE b/pkg/encoder/yuv/libyuv/LICENSE new file mode 100644 index 00000000..c911747a --- /dev/null +++ b/pkg/encoder/yuv/libyuv/LICENSE @@ -0,0 +1,29 @@ +Copyright 2011 The LibYuv Project Authors. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + + * Neither the name of Google nor the names of its contributors may + be used to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/pkg/encoder/yuv/libyuv/basic_types.h b/pkg/encoder/yuv/libyuv/basic_types.h new file mode 100644 index 00000000..9c66a132 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/basic_types.h @@ -0,0 +1,29 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_BASIC_TYPES_H_ +#define INCLUDE_LIBYUV_BASIC_TYPES_H_ + +#include // For size_t and NULL + +#if !defined(INT_TYPES_DEFINED) && !defined(GG_LONGLONG) +#define INT_TYPES_DEFINED + +#include // for uintptr_t and C99 types + +#endif // INT_TYPES_DEFINED + +#if !defined(LIBYUV_API) +#define LIBYUV_API +#endif // LIBYUV_API + +#define LIBYUV_BOOL int + +#endif // INCLUDE_LIBYUV_BASIC_TYPES_H_ diff --git a/pkg/encoder/yuv/libyuv/convert.c b/pkg/encoder/yuv/libyuv/convert.c new file mode 100644 index 00000000..c59da3b1 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/convert.c @@ -0,0 +1,336 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "convert.h" + +#include "basic_types.h" +#include "cpu_id.h" +#include "planar_functions.h" +#include "row.h" + +// Subsample amount uses a shift. +// v is value +// a is amount to add to round up +// s is shift to subsample down +#define SUBSAMPLE(v, a, s) (v < 0) ? (-((-v + a) >> s)) : ((v + a) >> s) + +static __inline int Abs(int v) { + return v >= 0 ? v : -v; +} + +// Copy I420 with optional flipping. +// TODO(fbarchard): Use Scale plane which supports mirroring, but ensure +// is does row coalescing. +LIBYUV_API +int I420Copy(const uint8_t *src_y, + int src_stride_y, + const uint8_t *src_u, + int src_stride_u, + const uint8_t *src_v, + int src_stride_v, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height) { + int halfwidth = (width + 1) >> 1; + int halfheight = (height + 1) >> 1; + if ((!src_y && dst_y) || !src_u || !src_v || !dst_u || !dst_v || width <= 0 || + height == 0) { + return -1; + } + // Negative height means invert the image. + if (height < 0) { + height = -height; + halfheight = (height + 1) >> 1; + src_y = src_y + (height - 1) * src_stride_y; + src_u = src_u + (halfheight - 1) * src_stride_u; + src_v = src_v + (halfheight - 1) * src_stride_v; + src_stride_y = -src_stride_y; + src_stride_u = -src_stride_u; + src_stride_v = -src_stride_v; + } + + if (dst_y) { + CopyPlane(src_y, src_stride_y, dst_y, dst_stride_y, width, height); + } + // Copy UV planes. + CopyPlane(src_u, src_stride_u, dst_u, dst_stride_u, halfwidth, halfheight); + CopyPlane(src_v, src_stride_v, dst_v, dst_stride_v, halfwidth, halfheight); + return 0; +} + +// Convert ARGB to I420. +LIBYUV_API +int ARGBToI420(const uint8_t *src_argb, + int src_stride_argb, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height) { + int y; + void (*ARGBToUVRow)(const uint8_t *src_argb0, int src_stride_argb, + uint8_t *dst_u, uint8_t *dst_v, int width) = + ARGBToUVRow_C; + void (*ARGBToYRow)(const uint8_t *src_argb, uint8_t *dst_y, int width) = + ARGBToYRow_C; + if (!src_argb || !dst_y || !dst_u || !dst_v || width <= 0 || height == 0) { + return -1; + } + // Negative height means invert the image. + if (height < 0) { + height = -height; + src_argb = src_argb + (height - 1) * src_stride_argb; + src_stride_argb = -src_stride_argb; + } +#if defined(HAS_ARGBTOYROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + ARGBToYRow = ARGBToYRow_Any_SSSE3; + if (IS_ALIGNED(width, 16)) { + ARGBToYRow = ARGBToYRow_SSSE3; + } + } +#endif +#if defined(HAS_ARGBTOUVROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + ARGBToUVRow = ARGBToUVRow_Any_SSSE3; + if (IS_ALIGNED(width, 16)) { + ARGBToUVRow = ARGBToUVRow_SSSE3; + } + } +#endif +#if defined(HAS_ARGBTOYROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ARGBToYRow = ARGBToYRow_Any_AVX2; + if (IS_ALIGNED(width, 32)) { + ARGBToYRow = ARGBToYRow_AVX2; + } + } +#endif +#if defined(HAS_ARGBTOUVROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ARGBToUVRow = ARGBToUVRow_Any_AVX2; + if (IS_ALIGNED(width, 32)) { + ARGBToUVRow = ARGBToUVRow_AVX2; + } + } +#endif + + for (y = 0; y < height - 1; y += 2) { + ARGBToUVRow(src_argb, src_stride_argb, dst_u, dst_v, width); + ARGBToYRow(src_argb, dst_y, width); + ARGBToYRow(src_argb + src_stride_argb, dst_y + dst_stride_y, width); + src_argb += src_stride_argb * 2; + dst_y += dst_stride_y * 2; + dst_u += dst_stride_u; + dst_v += dst_stride_v; + } + if (height & 1) { + ARGBToUVRow(src_argb, 0, dst_u, dst_v, width); + ARGBToYRow(src_argb, dst_y, width); + } + return 0; +} + +// Convert ABGR to I420. +LIBYUV_API +int ABGRToI420(const uint8_t *src_abgr, + int src_stride_abgr, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height) { + int y; + void (*ABGRToUVRow)(const uint8_t *src_abgr0, int src_stride_abgr, + uint8_t *dst_u, uint8_t *dst_v, int width) = + ABGRToUVRow_C; + void (*ABGRToYRow)(const uint8_t *src_abgr, uint8_t *dst_y, int width) = + ABGRToYRow_C; + if (!src_abgr || !dst_y || !dst_u || !dst_v || width <= 0 || height == 0) { + return -1; + } + // Negative height means invert the image. + if (height < 0) { + height = -height; + src_abgr = src_abgr + (height - 1) * src_stride_abgr; + src_stride_abgr = -src_stride_abgr; + } +#if defined(HAS_ABGRTOYROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + ABGRToYRow = ABGRToYRow_Any_SSSE3; + if (IS_ALIGNED(width, 16)) { + ABGRToYRow = ABGRToYRow_SSSE3; + } + } +#endif +#if defined(HAS_ABGRTOUVROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + ABGRToUVRow = ABGRToUVRow_Any_SSSE3; + if (IS_ALIGNED(width, 16)) { + ABGRToUVRow = ABGRToUVRow_SSSE3; + } + } +#endif +#if defined(HAS_ABGRTOYROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ABGRToYRow = ABGRToYRow_Any_AVX2; + if (IS_ALIGNED(width, 32)) { + ABGRToYRow = ABGRToYRow_AVX2; + } + } +#endif +#if defined(HAS_ABGRTOUVROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ABGRToUVRow = ABGRToUVRow_Any_AVX2; + if (IS_ALIGNED(width, 32)) { + ABGRToUVRow = ABGRToUVRow_AVX2; + } + } +#endif + + for (y = 0; y < height - 1; y += 2) { + ABGRToUVRow(src_abgr, src_stride_abgr, dst_u, dst_v, width); + ABGRToYRow(src_abgr, dst_y, width); + ABGRToYRow(src_abgr + src_stride_abgr, dst_y + dst_stride_y, width); + src_abgr += src_stride_abgr * 2; + dst_y += dst_stride_y * 2; + dst_u += dst_stride_u; + dst_v += dst_stride_v; + } + if (height & 1) { + ABGRToUVRow(src_abgr, 0, dst_u, dst_v, width); + ABGRToYRow(src_abgr, dst_y, width); + } + return 0; +} + +// Convert RGB565 to I420. +LIBYUV_API +int RGB565ToI420(const uint8_t *src_rgb565, + int src_stride_rgb565, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height) { + int y; + void (*RGB565ToARGBRow)(const uint8_t *src_rgb, uint8_t *dst_argb, + int width) = RGB565ToARGBRow_C; + void (*ARGBToUVRow)(const uint8_t *src_argb0, int src_stride_argb, + uint8_t *dst_u, uint8_t *dst_v, int width) = + ARGBToUVRow_C; + void (*ARGBToYRow)(const uint8_t *src_argb, uint8_t *dst_y, int width) = + ARGBToYRow_C; + if (!src_rgb565 || !dst_y || !dst_u || !dst_v || width <= 0 || height == 0) { + return -1; + } + // Negative height means invert the image. + if (height < 0) { + height = -height; + src_rgb565 = src_rgb565 + (height - 1) * src_stride_rgb565; + src_stride_rgb565 = -src_stride_rgb565; + } + +#if defined(HAS_RGB565TOARGBROW_SSE2) + if (TestCpuFlag(kCpuHasSSE2)) { + RGB565ToARGBRow = RGB565ToARGBRow_Any_SSE2; + if (IS_ALIGNED(width, 8)) { + RGB565ToARGBRow = RGB565ToARGBRow_SSE2; + } + } +#endif +#if defined(HAS_RGB565TOARGBROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + RGB565ToARGBRow = RGB565ToARGBRow_Any_AVX2; + if (IS_ALIGNED(width, 16)) { + RGB565ToARGBRow = RGB565ToARGBRow_AVX2; + } + } +#endif +#if defined(HAS_ARGBTOYROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + ARGBToYRow = ARGBToYRow_Any_SSSE3; + if (IS_ALIGNED(width, 16)) { + ARGBToYRow = ARGBToYRow_SSSE3; + } + } +#endif +#if defined(HAS_ARGBTOUVROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + ARGBToUVRow = ARGBToUVRow_Any_SSSE3; + if (IS_ALIGNED(width, 16)) { + ARGBToUVRow = ARGBToUVRow_SSSE3; + } + } +#endif +#if defined(HAS_ARGBTOYROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ARGBToYRow = ARGBToYRow_Any_AVX2; + if (IS_ALIGNED(width, 32)) { + ARGBToYRow = ARGBToYRow_AVX2; + } + } +#endif +#if defined(HAS_ARGBTOUVROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ARGBToUVRow = ARGBToUVRow_Any_AVX2; + if (IS_ALIGNED(width, 32)) { + ARGBToUVRow = ARGBToUVRow_AVX2; + } + } +#endif + { +#if !(defined(HAS_RGB565TOYROW_NEON)) + // Allocate 2 rows of ARGB. + const int row_size = (width * 4 + 31) & ~31; + align_buffer_64(row, row_size * 2); +#endif + for (y = 0; y < height - 1; y += 2) { +#if (defined(HAS_RGB565TOYROW_NEON)) +#else + RGB565ToARGBRow(src_rgb565, row, width); + RGB565ToARGBRow(src_rgb565 + src_stride_rgb565, row + row_size, width); + ARGBToUVRow(row, row_size, dst_u, dst_v, width); + ARGBToYRow(row, dst_y, width); + ARGBToYRow(row + row_size, dst_y + dst_stride_y, width); +#endif + src_rgb565 += src_stride_rgb565 * 2; + dst_y += dst_stride_y * 2; + dst_u += dst_stride_u; + dst_v += dst_stride_v; + } + if (height & 1) { +#if (defined(HAS_RGB565TOYROW_NEON)) +#else + RGB565ToARGBRow(src_rgb565, row, width); + ARGBToUVRow(row, 0, dst_u, dst_v, width); + ARGBToYRow(row, dst_y, width); +#endif + } +#if !(defined(HAS_RGB565TOYROW_NEON)) + free_aligned_buffer_64(row); +#endif + } + return 0; +} diff --git a/pkg/encoder/yuv/libyuv/convert.h b/pkg/encoder/yuv/libyuv/convert.h new file mode 100644 index 00000000..9a81c509 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/convert.h @@ -0,0 +1,113 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_CONVERT_H_ +#define INCLUDE_LIBYUV_CONVERT_H_ + +#include "rotate.h" // For enum RotationMode. + +// Copy I420 to I420. +#define I420ToI420 I420Copy +LIBYUV_API +int I420Copy(const uint8_t *src_y, + int src_stride_y, + const uint8_t *src_u, + int src_stride_u, + const uint8_t *src_v, + int src_stride_v, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height); + +// ARGB little endian (bgra in memory) to I420. +LIBYUV_API +int ARGBToI420(const uint8_t *src_argb, + int src_stride_argb, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height); + +// ABGR little endian (rgba in memory) to I420. +LIBYUV_API +int ABGRToI420(const uint8_t *src_abgr, + int src_stride_abgr, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height); + +// RGB16 (RGBP fourcc) little endian to I420. +LIBYUV_API +int RGB565ToI420(const uint8_t *src_rgb565, + int src_stride_rgb565, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height); + +// Convert camera sample to I420 with cropping, rotation and vertical flip. +// "src_size" is needed to parse MJPG. +// "dst_stride_y" number of bytes in a row of the dst_y plane. +// Normally this would be the same as dst_width, with recommended alignment +// to 16 bytes for better efficiency. +// If rotation of 90 or 270 is used, stride is affected. The caller should +// allocate the I420 buffer according to rotation. +// "dst_stride_u" number of bytes in a row of the dst_u plane. +// Normally this would be the same as (dst_width + 1) / 2, with +// recommended alignment to 16 bytes for better efficiency. +// If rotation of 90 or 270 is used, stride is affected. +// "crop_x" and "crop_y" are starting position for cropping. +// To center, crop_x = (src_width - dst_width) / 2 +// crop_y = (src_height - dst_height) / 2 +// "src_width" / "src_height" is size of src_frame in pixels. +// "src_height" can be negative indicating a vertically flipped image source. +// "crop_width" / "crop_height" is the size to crop the src to. +// Must be less than or equal to src_width/src_height +// Cropping parameters are pre-rotation. +// "rotation" can be 0, 90, 180 or 270. +// "fourcc" is a fourcc. ie 'I420', 'YUY2' +// Returns 0 for successful; -1 for invalid parameter. Non-zero for failure. +LIBYUV_API +int ConvertToI420(const uint8_t *sample, + size_t sample_size, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int crop_x, + int crop_y, + int src_width, + int src_height, + int crop_width, + int crop_height, + enum RotationMode rotation, + uint32_t fourcc); + +#endif // INCLUDE_LIBYUV_CONVERT_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/convert_argb.h b/pkg/encoder/yuv/libyuv/convert_argb.h new file mode 100644 index 00000000..ac8e9716 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/convert_argb.h @@ -0,0 +1,24 @@ +/* + * Copyright 2012 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_CONVERT_ARGB_H_ +#define INCLUDE_LIBYUV_CONVERT_ARGB_H_ + +#include "basic_types.h" + +// Conversion matrix for YVU to BGR +LIBYUV_API extern const struct YuvConstants kYvuI601Constants; // BT.601 +LIBYUV_API extern const struct YuvConstants kYvuJPEGConstants; // BT.601 full +LIBYUV_API extern const struct YuvConstants kYvuH709Constants; // BT.709 +LIBYUV_API extern const struct YuvConstants kYvuF709Constants; // BT.709 full +LIBYUV_API extern const struct YuvConstants kYvu2020Constants; // BT.2020 +LIBYUV_API extern const struct YuvConstants kYvuV2020Constants; // BT.2020 full + +#endif // INCLUDE_LIBYUV_CONVERT_ARGB_H_ diff --git a/pkg/encoder/yuv/libyuv/convert_to_i420.c b/pkg/encoder/yuv/libyuv/convert_to_i420.c new file mode 100644 index 00000000..84802142 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/convert_to_i420.c @@ -0,0 +1,116 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include + +#include "convert.h" +#include "video_common.h" + +// Convert camera sample to I420 with cropping, rotation and vertical flip. +// src_width is used for source stride computation +// src_height is used to compute location of planes, and indicate inversion +// sample_size is measured in bytes and is the size of the frame. +// With MJPEG it is the compressed size of the frame. +LIBYUV_API +int ConvertToI420(const uint8_t *sample, + size_t sample_size, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int crop_x, + int crop_y, + int src_width, + int src_height, + int crop_width, + int crop_height, + enum RotationMode rotation, + uint32_t fourcc) { + uint32_t format = CanonicalFourCC(fourcc); + const uint8_t *src; + // TODO(nisse): Why allow crop_height < 0? + const int abs_crop_height = (crop_height < 0) ? -crop_height : crop_height; + int r = 0; + LIBYUV_BOOL need_buf = + (rotation && format != FOURCC_I420 && format != FOURCC_NV12 && + format != FOURCC_NV21 && format != FOURCC_YV12) || + dst_y == sample; + uint8_t *tmp_y = dst_y; + uint8_t *tmp_u = dst_u; + uint8_t *tmp_v = dst_v; + int tmp_y_stride = dst_stride_y; + int tmp_u_stride = dst_stride_u; + int tmp_v_stride = dst_stride_v; + uint8_t *rotate_buffer = NULL; + const int inv_crop_height = + (src_height < 0) ? -abs_crop_height : abs_crop_height; + + if (!dst_y || !dst_u || !dst_v || !sample || src_width <= 0 || + crop_width <= 0 || src_height == 0 || crop_height == 0) { + return -1; + } + + // One pass rotation is available for some formats. For the rest, convert + // to I420 (with optional vertical flipping) into a temporary I420 buffer, + // and then rotate the I420 to the final destination buffer. + // For in-place conversion, if destination dst_y is same as source sample, + // also enable temporary buffer. + if (need_buf) { + int y_size = crop_width * abs_crop_height; + int uv_size = ((crop_width + 1) / 2) * ((abs_crop_height + 1) / 2); + rotate_buffer = (uint8_t *) malloc(y_size + uv_size * 2); /* NOLINT */ + if (!rotate_buffer) { + return 1; // Out of memory runtime error. + } + dst_y = rotate_buffer; + dst_u = dst_y + y_size; + dst_v = dst_u + uv_size; + dst_stride_y = crop_width; + dst_stride_u = dst_stride_v = ((crop_width + 1) / 2); + } + + switch (format) { + // Single plane formats + case FOURCC_RGBP: + src = sample + (src_width * crop_y + crop_x) * 2; + r = RGB565ToI420(src, src_width * 2, dst_y, dst_stride_y, dst_u, + dst_stride_u, dst_v, dst_stride_v, crop_width, + inv_crop_height); + break; + case FOURCC_ARGB: + src = sample + (src_width * crop_y + crop_x) * 4; + r = ARGBToI420(src, src_width * 4, dst_y, dst_stride_y, dst_u, + dst_stride_u, dst_v, dst_stride_v, crop_width, + inv_crop_height); + break; + case FOURCC_ABGR: + src = sample + (src_width * crop_y + crop_x) * 4; + r = ABGRToI420(src, src_width * 4, dst_y, dst_stride_y, dst_u, + dst_stride_u, dst_v, dst_stride_v, crop_width, + inv_crop_height); + break; + default: + r = -1; // unknown fourcc - return failure code. + } + + if (need_buf) { + if (!r) { + r = I420Rotate(dst_y, dst_stride_y, dst_u, dst_stride_u, dst_v, + dst_stride_v, tmp_y, tmp_y_stride, tmp_u, tmp_u_stride, + tmp_v, tmp_v_stride, crop_width, abs_crop_height, + rotation); + } + free(rotate_buffer); + } + + return r; +} diff --git a/pkg/encoder/yuv/libyuv/cpu_id.c b/pkg/encoder/yuv/libyuv/cpu_id.c new file mode 100644 index 00000000..166057de --- /dev/null +++ b/pkg/encoder/yuv/libyuv/cpu_id.c @@ -0,0 +1,204 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "cpu_id.h" + +#if !defined(__pnacl__) && !defined(__CLR_VER) && \ + !defined(__native_client__) && (defined(_M_IX86) || defined(_M_X64)) && \ + defined(_MSC_FULL_VER) && (_MSC_FULL_VER >= 160040219) +#include // For _xgetbv() +#endif + +// For ArmCpuCaps() but unittested on all platforms +#include // For fopen() +#include + +// For functions that use the stack and have runtime checks for overflow, +// use SAFEBUFFERS to avoid additional check. +#define SAFEBUFFERS + +// cpu_info_ variable for SIMD instruction sets detected. +LIBYUV_API int cpu_info_ = 0; + +// Low level cpuid for X86. +#if (defined(_M_IX86) || defined(_M_X64) || defined(__i386__) || \ + defined(__x86_64__)) && \ + !defined(__pnacl__) && !defined(__CLR_VER) +LIBYUV_API +void CpuId(int info_eax, int info_ecx, int *cpu_info) { +#if defined(_MSC_VER) + // GCC version uses inline x86 assembly. +#else // defined(_MSC_VER) + int info_ebx, info_edx; + asm volatile( +#if defined(__i386__) && defined(__PIC__) + // Preserve ebx for fpic 32 bit. + "mov %%ebx, %%edi \n" + "cpuid \n" + "xchg %%edi, %%ebx \n" + : "=D"(info_ebx), +#else + "cpuid \n" + : "=b"(info_ebx), +#endif // defined( __i386__) && defined(__PIC__) + "+a"(info_eax), "+c"(info_ecx), "=d"(info_edx)); + cpu_info[0] = info_eax; + cpu_info[1] = info_ebx; + cpu_info[2] = info_ecx; + cpu_info[3] = info_edx; +#endif // defined(_MSC_VER) +} + +#else // (defined(_M_IX86) || defined(_M_X64) ... +LIBYUV_API +void CpuId(int eax, int ecx, int* cpu_info) { + (void)eax; + (void)ecx; + cpu_info[0] = cpu_info[1] = cpu_info[2] = cpu_info[3] = 0; +} +#endif + +// For VS2010 and earlier emit can be used: +// _asm _emit 0x0f _asm _emit 0x01 _asm _emit 0xd0 // For VS2010 and earlier. +// __asm { +// xor ecx, ecx // xcr 0 +// xgetbv +// mov xcr0, eax +// } +// For VS2013 and earlier 32 bit, the _xgetbv(0) optimizer produces bad code. +// https://code.google.com/p/libyuv/issues/detail?id=529 +#if defined(_M_IX86) && defined(_MSC_VER) && (_MSC_VER < 1900) +#pragma optimize("g", off) +#endif +#if (defined(_M_IX86) || defined(_M_X64) || defined(__i386__) || \ + defined(__x86_64__)) && \ + !defined(__pnacl__) && !defined(__CLR_VER) && !defined(__native_client__) + +// X86 CPUs have xgetbv to detect OS saves high parts of ymm registers. +static int GetXCR0() { + int xcr0 = 0; +#if defined(__i386__) || defined(__x86_64__) + asm(".byte 0x0f, 0x01, 0xd0" : "=a"(xcr0) : "c"(0) : "%edx"); +#endif // defined(__i386__) || defined(__x86_64__) + return xcr0; +} + +#else +// xgetbv unavailable to query for OSSave support. Return 0. +#define GetXCR0() 0 +#endif // defined(_M_IX86) || defined(_M_X64) .. +// Return optimization to previous setting. +#if defined(_M_IX86) && defined(_MSC_VER) && (_MSC_VER < 1900) +#pragma optimize("g", on) +#endif + +// Based on libvpx arm_cpudetect.c +// For Arm, but public to allow testing on any CPU +LIBYUV_API SAFEBUFFERS int ArmCpuCaps(const char *cpuinfo_name) { + char cpuinfo_line[512]; + FILE *f = fopen(cpuinfo_name, "re"); + if (!f) { + // Assume Neon if /proc/cpuinfo is unavailable. + // This will occur for Chrome sandbox for Pepper or Render process. + return kCpuHasNEON; + } + memset(cpuinfo_line, 0, sizeof(cpuinfo_line)); + while (fgets(cpuinfo_line, sizeof(cpuinfo_line), f)) { + if (memcmp(cpuinfo_line, "Features", 8) == 0) { + char *p = strstr(cpuinfo_line, " neon"); + if (p && (p[5] == ' ' || p[5] == '\n')) { + fclose(f); + return kCpuHasNEON; + } + // aarch64 uses asimd for Neon. + p = strstr(cpuinfo_line, " asimd"); + if (p) { + fclose(f); + return kCpuHasNEON; + } + } + } + fclose(f); + return 0; +} + +static SAFEBUFFERS int GetCpuFlags(void) { + int cpu_info = 0; +#if !defined(__pnacl__) && !defined(__CLR_VER) && \ + (defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || \ + defined(_M_IX86)) + int cpu_info0[4] = {0, 0, 0, 0}; + int cpu_info1[4] = {0, 0, 0, 0}; + int cpu_info7[4] = {0, 0, 0, 0}; + CpuId(0, 0, cpu_info0); + CpuId(1, 0, cpu_info1); + if (cpu_info0[0] >= 7) { + CpuId(7, 0, cpu_info7); + } + cpu_info = kCpuHasX86 | ((cpu_info1[3] & 0x04000000) ? kCpuHasSSE2 : 0) | + ((cpu_info1[2] & 0x00000200) ? kCpuHasSSSE3 : 0) | + ((cpu_info1[2] & 0x00080000) ? kCpuHasSSE41 : 0) | + ((cpu_info1[2] & 0x00100000) ? kCpuHasSSE42 : 0) | + ((cpu_info7[1] & 0x00000200) ? kCpuHasERMS : 0); + + // AVX requires OS saves YMM registers. + if (((cpu_info1[2] & 0x1c000000) == 0x1c000000) && // AVX and OSXSave + ((GetXCR0() & 6) == 6)) { // Test OS saves YMM registers + cpu_info |= kCpuHasAVX | ((cpu_info7[1] & 0x00000020) ? kCpuHasAVX2 : 0) | + ((cpu_info1[2] & 0x00001000) ? kCpuHasFMA3 : 0) | + ((cpu_info1[2] & 0x20000000) ? kCpuHasF16C : 0); + + // Detect AVX512bw + if ((GetXCR0() & 0xe0) == 0xe0) { + cpu_info |= (cpu_info7[1] & 0x40000000) ? kCpuHasAVX512BW : 0; + cpu_info |= (cpu_info7[1] & 0x80000000) ? kCpuHasAVX512VL : 0; + cpu_info |= (cpu_info7[2] & 0x00000002) ? kCpuHasAVX512VBMI : 0; + cpu_info |= (cpu_info7[2] & 0x00000040) ? kCpuHasAVX512VBMI2 : 0; + cpu_info |= (cpu_info7[2] & 0x00000800) ? kCpuHasAVX512VNNI : 0; + cpu_info |= (cpu_info7[2] & 0x00001000) ? kCpuHasAVX512VBITALG : 0; + cpu_info |= (cpu_info7[2] & 0x00004000) ? kCpuHasAVX512VPOPCNTDQ : 0; + cpu_info |= (cpu_info7[2] & 0x00000100) ? kCpuHasGFNI : 0; + } + } +#endif +#if defined(__arm__) || defined(__aarch64__) + // gcc -mfpu=neon defines __ARM_NEON__ + // __ARM_NEON__ generates code that requires Neon. NaCL also requires Neon. + // For Linux, /proc/cpuinfo can be tested but without that assume Neon. +#if defined(__ARM_NEON__) || defined(__native_client__) || !defined(__linux__) + cpu_info = kCpuHasNEON; + // For aarch64(arm64), /proc/cpuinfo's feature is not complete, e.g. no neon + // flag in it. + // So for aarch64, neon enabling is hard coded here. +#endif +#if defined(__aarch64__) + cpu_info = kCpuHasNEON; +#else + // Linux arm parse text file for neon detect. + cpu_info = ArmCpuCaps("/proc/cpuinfo"); +#endif + cpu_info |= kCpuHasARM; +#endif // __arm__ + cpu_info |= kCpuInitialized; + return cpu_info; +} + +// Note that use of this function is not thread safe. +LIBYUV_API +int MaskCpuFlags(int enable_flags) { + int cpu_info = GetCpuFlags() & enable_flags; + SetCpuFlags(cpu_info); + return cpu_info; +} + +LIBYUV_API +int InitCpuFlags(void) { + return MaskCpuFlags(-1); +} diff --git a/pkg/encoder/yuv/libyuv/cpu_id.h b/pkg/encoder/yuv/libyuv/cpu_id.h new file mode 100644 index 00000000..bf50b9cd --- /dev/null +++ b/pkg/encoder/yuv/libyuv/cpu_id.h @@ -0,0 +1,106 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_CPU_ID_H_ +#define INCLUDE_LIBYUV_CPU_ID_H_ + +#include "basic_types.h" + +// Internal flag to indicate cpuid requires initialization. +static const int kCpuInitialized = 0x1; + +// These flags are only valid on ARM processors. +static const int kCpuHasARM = 0x2; +static const int kCpuHasNEON = 0x4; +// 0x8 reserved for future ARM flag. + +// These flags are only valid on x86 processors. +static const int kCpuHasX86 = 0x10; +static const int kCpuHasSSE2 = 0x20; +static const int kCpuHasSSSE3 = 0x40; +static const int kCpuHasSSE41 = 0x80; +static const int kCpuHasSSE42 = 0x100; // unused at this time. +static const int kCpuHasAVX = 0x200; +static const int kCpuHasAVX2 = 0x400; +static const int kCpuHasERMS = 0x800; +static const int kCpuHasFMA3 = 0x1000; +static const int kCpuHasF16C = 0x2000; +static const int kCpuHasGFNI = 0x4000; +static const int kCpuHasAVX512BW = 0x8000; +static const int kCpuHasAVX512VL = 0x10000; +static const int kCpuHasAVX512VNNI = 0x20000; +static const int kCpuHasAVX512VBMI = 0x40000; +static const int kCpuHasAVX512VBMI2 = 0x80000; +static const int kCpuHasAVX512VBITALG = 0x100000; +static const int kCpuHasAVX512VPOPCNTDQ = 0x200000; + +// Optional init function. TestCpuFlag does an auto-init. +// Returns cpu_info flags. +LIBYUV_API +int InitCpuFlags(void); + +// Detect CPU has SSE2 etc. +// Test_flag parameter should be one of kCpuHas constants above. +// Returns non-zero if instruction set is detected +static __inline int TestCpuFlag(int test_flag) { + LIBYUV_API extern int cpu_info_; +#ifdef __ATOMIC_RELAXED + int cpu_info = __atomic_load_n(&cpu_info_, __ATOMIC_RELAXED); +#else + int cpu_info = cpu_info_; +#endif + return (!cpu_info ? InitCpuFlags() : cpu_info) & test_flag; +} + +// Internal function for parsing /proc/cpuinfo. +LIBYUV_API +int ArmCpuCaps(const char *cpuinfo_name); + +// For testing, allow CPU flags to be disabled. +// ie MaskCpuFlags(~kCpuHasSSSE3) to disable SSSE3. +// MaskCpuFlags(-1) to enable all cpu specific optimizations. +// MaskCpuFlags(1) to disable all cpu specific optimizations. +// MaskCpuFlags(0) to reset state so next call will auto init. +// Returns cpu_info flags. +LIBYUV_API +int MaskCpuFlags(int enable_flags); + +// Sets the CPU flags to |cpu_flags|, bypassing the detection code. |cpu_flags| +// should be a valid combination of the kCpuHas constants above and include +// kCpuInitialized. Use this method when running in a sandboxed process where +// the detection code might fail (as it might access /proc/cpuinfo). In such +// cases the cpu_info can be obtained from a non sandboxed process by calling +// InitCpuFlags() and passed to the sandboxed process (via command line +// parameters, IPC...) which can then call this method to initialize the CPU +// flags. +// Notes: +// - when specifying 0 for |cpu_flags|, the auto initialization is enabled +// again. +// - enabling CPU features that are not supported by the CPU will result in +// undefined behavior. +// TODO(fbarchard): consider writing a helper function that translates from +// other library CPU info to libyuv CPU info and add a .md doc that explains +// CPU detection. +static __inline void SetCpuFlags(int cpu_flags) { + LIBYUV_API extern int cpu_info_; +#ifdef __ATOMIC_RELAXED + __atomic_store_n(&cpu_info_, cpu_flags, __ATOMIC_RELAXED); +#else + cpu_info_ = cpu_flags; +#endif +} + +// Low level cpuid for X86. Returns zeros on other CPUs. +// eax is the info type that you want. +// ecx is typically the cpu number, and should normally be zero. +LIBYUV_API +void CpuId(int info_eax, int info_ecx, int *cpu_info); + +#endif // INCLUDE_LIBYUV_CPU_ID_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/libyuv.go b/pkg/encoder/yuv/libyuv/libyuv.go new file mode 100644 index 00000000..98d4276f --- /dev/null +++ b/pkg/encoder/yuv/libyuv/libyuv.go @@ -0,0 +1,142 @@ +//go:build !darwin && !no_libyuv + +package libyuv + +// see: https://chromium.googlesource.com/libyuv/libyuv + +/* +#cgo CFLAGS: -Wall +#cgo LDFLAGS: -lyuv + +#include +#include "libyuv/version.h" +#include "libyuv/video_common.h" + +// +typedef enum RotationMode { + kRotate0 = 0, // No rotation. + kRotate90 = 90, // Rotate 90 degrees clockwise. + kRotate180 = 180, // Rotate 180 degrees. + kRotate270 = 270, // Rotate 270 degrees clockwise. +} RotationModeEnum; + +// +LIBYUV_API +int ConvertToI420(const uint8_t* sample, + size_t sample_size, + uint8_t* dst_y, + int dst_stride_y, + uint8_t* dst_u, + int dst_stride_u, + uint8_t* dst_v, + int dst_stride_v, + int crop_x, + int crop_y, + int src_width, + int src_height, + int crop_width, + int crop_height, + enum RotationMode rotation, + uint32_t fourcc); + +// Supported filtering. +typedef enum FilterMode { + kFilterNone = 0, // Point sample; Fastest. + kFilterLinear = 1, // Filter horizontally only. + kFilterBilinear = 2, // Faster than box, but lower quality scaling down. + kFilterBox = 3 // Highest quality. +} FilterModeEnum; + +LIBYUV_API +int I420Scale(const uint8_t *src_y, + int src_stride_y, + const uint8_t *src_u, + int src_stride_u, + const uint8_t *src_v, + int src_stride_v, + int src_width, + int src_height, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int dst_width, + int dst_height, + enum FilterMode filtering); +*/ +import "C" +import "fmt" + +const FourccRgbp uint32 = C.FOURCC_RGBP +const FourccArgb uint32 = C.FOURCC_ARGB +const FourccAbgr uint32 = C.FOURCC_ABGR + +func Y420(src []byte, dst []byte, _, h, stride int, dw, dh int, rot uint, pix uint32, cx, cy int) { + cw := (dw + 1) / 2 + ch := (dh + 1) / 2 + i0 := dw * dh + i1 := i0 + cw*ch + yStride := dw + cStride := cw + + C.ConvertToI420( + (*C.uchar)(&src[0]), + C.size_t(0), + (*C.uchar)(&dst[0]), + C.int(yStride), + (*C.uchar)(&dst[i0]), + C.int(cStride), + (*C.uchar)(&dst[i1]), + C.int(cStride), + C.int(0), + C.int(0), + C.int(stride), + C.int(h), + C.int(cx), + C.int(cy), + C.enum_RotationMode(rot), + C.uint32_t(pix)) +} + +func Y420Scale(src []byte, dst []byte, w, h int, dw, dh int) { + srcWidthUV, dstWidthUV := (w+1)>>1, (dw+1)>>1 + srcHeightUV, dstHeightUV := (h+1)>>1, (dh+1)>>1 + + srcYPlaneSize, dstYPlaneSize := w*h, dw*dh + srcUVPlaneSize, dstUVPlaneSize := srcWidthUV*srcHeightUV, dstWidthUV*dstHeightUV + + srcStrideY, dstStrideY := w, dw + srcStrideU, dstStrideU := srcWidthUV, dstWidthUV + srcStrideV, dstStrideV := srcWidthUV, dstWidthUV + + srcY := (*C.uchar)(&src[0]) + srcU := (*C.uchar)(&src[srcYPlaneSize]) + srcV := (*C.uchar)(&src[srcYPlaneSize+srcUVPlaneSize]) + + dstY := (*C.uchar)(&dst[0]) + dstU := (*C.uchar)(&dst[dstYPlaneSize]) + dstV := (*C.uchar)(&dst[dstYPlaneSize+dstUVPlaneSize]) + + C.I420Scale( + srcY, + C.int(srcStrideY), + srcU, + C.int(srcStrideU), + srcV, + C.int(srcStrideV), + C.int(w), + C.int(h), + dstY, + C.int(dstStrideY), + dstU, + C.int(dstStrideU), + dstV, + C.int(dstStrideV), + C.int(dw), + C.int(dh), + C.enum_FilterMode(C.kFilterNone)) +} + +func Version() string { return fmt.Sprintf("%v", int(C.LIBYUV_VERSION)) } diff --git a/pkg/encoder/yuv/libyuv/libyuv2.go b/pkg/encoder/yuv/libyuv/libyuv2.go new file mode 100644 index 00000000..f4f6a68b --- /dev/null +++ b/pkg/encoder/yuv/libyuv/libyuv2.go @@ -0,0 +1,89 @@ +//go:build darwin || no_libyuv + +package libyuv + +/* +#cgo CFLAGS: -Wall + +#include "basic_types.h" +#include "version.h" +#include "video_common.h" +#include "rotate.h" +#include "scale.h" +#include "convert.h" + +*/ +import "C" +import "fmt" + +const FourccRgbp uint32 = C.FOURCC_RGBP +const FourccArgb uint32 = C.FOURCC_ARGB +const FourccAbgr uint32 = C.FOURCC_ABGR + +func Y420(src []byte, dst []byte, _, h, stride int, dw, dh int, rot uint, pix uint32, cx, cy int) { + cw := (dw + 1) / 2 + ch := (dh + 1) / 2 + i0 := dw * dh + i1 := i0 + cw*ch + yStride := dw + cStride := cw + + C.ConvertToI420( + (*C.uchar)(&src[0]), + C.size_t(0), + (*C.uchar)(&dst[0]), + C.int(yStride), + (*C.uchar)(&dst[i0]), + C.int(cStride), + (*C.uchar)(&dst[i1]), + C.int(cStride), + C.int(0), + C.int(0), + C.int(stride), + C.int(h), + C.int(cx), + C.int(cy), + C.enum_RotationMode(rot), + C.uint32_t(pix)) +} + +func Y420Scale(src []byte, dst []byte, w, h int, dw, dh int) { + srcWidthUV, dstWidthUV := (w+1)>>1, (dw+1)>>1 + srcHeightUV, dstHeightUV := (h+1)>>1, (dh+1)>>1 + + srcYPlaneSize, dstYPlaneSize := w*h, dw*dh + srcUVPlaneSize, dstUVPlaneSize := srcWidthUV*srcHeightUV, dstWidthUV*dstHeightUV + + srcStrideY, dstStrideY := w, dw + srcStrideU, dstStrideU := srcWidthUV, dstWidthUV + srcStrideV, dstStrideV := srcWidthUV, dstWidthUV + + srcY := (*C.uchar)(&src[0]) + srcU := (*C.uchar)(&src[srcYPlaneSize]) + srcV := (*C.uchar)(&src[srcYPlaneSize+srcUVPlaneSize]) + + dstY := (*C.uchar)(&dst[0]) + dstU := (*C.uchar)(&dst[dstYPlaneSize]) + dstV := (*C.uchar)(&dst[dstYPlaneSize+dstUVPlaneSize]) + + C.I420Scale( + srcY, + C.int(srcStrideY), + srcU, + C.int(srcStrideU), + srcV, + C.int(srcStrideV), + C.int(w), + C.int(h), + dstY, + C.int(dstStrideY), + dstU, + C.int(dstStrideU), + dstV, + C.int(dstStrideV), + C.int(dw), + C.int(dh), + C.enum_FilterMode(C.kFilterNone)) +} + +func Version() string { return fmt.Sprintf("%v mod", int(C.LIBYUV_VERSION)) } diff --git a/pkg/encoder/yuv/libyuv/planar_functions.c b/pkg/encoder/yuv/libyuv/planar_functions.c new file mode 100644 index 00000000..a5d543cc --- /dev/null +++ b/pkg/encoder/yuv/libyuv/planar_functions.c @@ -0,0 +1,68 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "planar_functions.h" + +#include "cpu_id.h" +#include "row.h" + +// Copy a plane of data +LIBYUV_API +void CopyPlane(const uint8_t *src_y, + int src_stride_y, + uint8_t *dst_y, + int dst_stride_y, + int width, + int height) { + int y; + void (*CopyRow)(const uint8_t *src, uint8_t *dst, int width) = CopyRow_C; + if (width <= 0 || height == 0) { + return; + } + // Negative height means invert the image. + if (height < 0) { + height = -height; + dst_y = dst_y + (height - 1) * dst_stride_y; + dst_stride_y = -dst_stride_y; + } + // Coalesce rows. + if (src_stride_y == width && dst_stride_y == width) { + width *= height; + height = 1; + src_stride_y = dst_stride_y = 0; + } + // Nothing to do. + if (src_y == dst_y && src_stride_y == dst_stride_y) { + return; + } + +#if defined(HAS_COPYROW_SSE2) + if (TestCpuFlag(kCpuHasSSE2)) { + CopyRow = IS_ALIGNED(width, 32) ? CopyRow_SSE2 : CopyRow_Any_SSE2; + } +#endif +#if defined(HAS_COPYROW_AVX) + if (TestCpuFlag(kCpuHasAVX)) { + CopyRow = IS_ALIGNED(width, 64) ? CopyRow_AVX : CopyRow_Any_AVX; + } +#endif +#if defined(HAS_COPYROW_ERMS) + if (TestCpuFlag(kCpuHasERMS)) { + CopyRow = CopyRow_ERMS; + } +#endif + + // Copy plane + for (y = 0; y < height; ++y) { + CopyRow(src_y, dst_y, width); + src_y += src_stride_y; + dst_y += dst_stride_y; + } +} diff --git a/pkg/encoder/yuv/libyuv/planar_functions.h b/pkg/encoder/yuv/libyuv/planar_functions.h new file mode 100644 index 00000000..222109cf --- /dev/null +++ b/pkg/encoder/yuv/libyuv/planar_functions.h @@ -0,0 +1,46 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_PLANAR_FUNCTIONS_H_ +#define INCLUDE_LIBYUV_PLANAR_FUNCTIONS_H_ + +#include "basic_types.h" + +// TODO(fbarchard): Move cpu macros to row.h +#if defined(__pnacl__) || defined(__CLR_VER) || \ + (defined(__native_client__) && defined(__x86_64__)) || \ + (defined(__i386__) && !defined(__SSE__) && !defined(__clang__)) +#define LIBYUV_DISABLE_X86 +#endif +// MemorySanitizer does not support assembly code yet. http://crbug.com/344505 +#if defined(__has_feature) +#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_NEON) +#define LIBYUV_DISABLE_NEON +#endif +#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_X86) +#define LIBYUV_DISABLE_X86 +#endif +#endif +// The following are available on all x86 platforms: +#if !defined(LIBYUV_DISABLE_X86) && \ + (defined(_M_IX86) || defined(__x86_64__) || defined(__i386__)) +#define HAS_ARGBAFFINEROW_SSE2 +#endif + +// Copy a plane of data. +LIBYUV_API +void CopyPlane(const uint8_t *src_y, + int src_stride_y, + uint8_t *dst_y, + int dst_stride_y, + int width, + int height); + +#endif // INCLUDE_LIBYUV_PLANAR_FUNCTIONS_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/rotate.c b/pkg/encoder/yuv/libyuv/rotate.c new file mode 100644 index 00000000..4aabae5b --- /dev/null +++ b/pkg/encoder/yuv/libyuv/rotate.c @@ -0,0 +1,217 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "rotate.h" + +#include "convert.h" +#include "cpu_id.h" +#include "rotate_row.h" +#include "row.h" + +LIBYUV_API +void TransposePlane(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height) { + int i = height; + + void (*TransposeWx8)(const uint8_t *src, int src_stride, uint8_t *dst, + int dst_stride, int width) = TransposeWx8_C; + +#if defined(HAS_TRANSPOSEWX8_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + TransposeWx8 = TransposeWx8_Any_SSSE3; + if (IS_ALIGNED(width, 8)) { + TransposeWx8 = TransposeWx8_SSSE3; + } + } +#endif +#if defined(HAS_TRANSPOSEWX8_FAST_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + TransposeWx8 = TransposeWx8_Fast_Any_SSSE3; + if (IS_ALIGNED(width, 16)) { + TransposeWx8 = TransposeWx8_Fast_SSSE3; + } + } +#endif + + // Work across the source in 8x8 tiles + while (i >= 8) { + TransposeWx8(src, src_stride, dst, dst_stride, width); + src += 8 * src_stride; // Go down 8 rows. + dst += 8; // Move over 8 columns. + i -= 8; + } + + if (i > 0) { + TransposeWxH_C(src, src_stride, dst, dst_stride, width, i); + } +} + +LIBYUV_API +void RotatePlane90(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height) { + // Rotate by 90 is a transpose with the source read + // from bottom to top. So set the source pointer to the end + // of the buffer and flip the sign of the source stride. + src += src_stride * (height - 1); + src_stride = -src_stride; + TransposePlane(src, src_stride, dst, dst_stride, width, height); +} + +LIBYUV_API +void RotatePlane270(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height) { + // Rotate by 270 is a transpose with the destination written + // from bottom to top. So set the destination pointer to the end + // of the buffer and flip the sign of the destination stride. + dst += dst_stride * (width - 1); + dst_stride = -dst_stride; + TransposePlane(src, src_stride, dst, dst_stride, width, height); +} + +LIBYUV_API +void RotatePlane180(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height) { + // Swap top and bottom row and mirror the content. Uses a temporary row. + align_buffer_64(row, width); + const uint8_t *src_bot = src + src_stride * (height - 1); + uint8_t *dst_bot = dst + dst_stride * (height - 1); + int half_height = (height + 1) >> 1; + int y; + void (*MirrorRow)(const uint8_t *src, uint8_t *dst, int width) = MirrorRow_C; + void (*CopyRow)(const uint8_t *src, uint8_t *dst, int width) = CopyRow_C; +#if defined(HAS_MIRRORROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + MirrorRow = MirrorRow_Any_SSSE3; + if (IS_ALIGNED(width, 16)) { + MirrorRow = MirrorRow_SSSE3; + } + } +#endif +#if defined(HAS_MIRRORROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + MirrorRow = MirrorRow_Any_AVX2; + if (IS_ALIGNED(width, 32)) { + MirrorRow = MirrorRow_AVX2; + } + } +#endif +#if defined(HAS_COPYROW_SSE2) + if (TestCpuFlag(kCpuHasSSE2)) { + CopyRow = IS_ALIGNED(width, 32) ? CopyRow_SSE2 : CopyRow_Any_SSE2; + } +#endif +#if defined(HAS_COPYROW_AVX) + if (TestCpuFlag(kCpuHasAVX)) { + CopyRow = IS_ALIGNED(width, 64) ? CopyRow_AVX : CopyRow_Any_AVX; + } +#endif +#if defined(HAS_COPYROW_ERMS) + if (TestCpuFlag(kCpuHasERMS)) { + CopyRow = CopyRow_ERMS; + } +#endif +#if defined(HAS_COPYROW_NEON) +#endif + // Odd height will harmlessly mirror the middle row twice. + for (y = 0; y < half_height; ++y) { + CopyRow(src, row, width); // Copy top row into buffer + MirrorRow(src_bot, dst, width); // Mirror bottom row into top row + MirrorRow(row, dst_bot, width); // Mirror buffer into bottom row + src += src_stride; + dst += dst_stride; + src_bot -= src_stride; + dst_bot -= dst_stride; + } + free_aligned_buffer_64(row); +} + +LIBYUV_API +int I420Rotate(const uint8_t *src_y, + int src_stride_y, + const uint8_t *src_u, + int src_stride_u, + const uint8_t *src_v, + int src_stride_v, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height, + enum RotationMode mode) { + int halfwidth = (width + 1) >> 1; + int halfheight = (height + 1) >> 1; + if ((!src_y && dst_y) || !src_u || !src_v || width <= 0 || height == 0 || + !dst_y || !dst_u || !dst_v) { + return -1; + } + + // Negative height means invert the image. + if (height < 0) { + height = -height; + halfheight = (height + 1) >> 1; + src_y = src_y + (height - 1) * src_stride_y; + src_u = src_u + (halfheight - 1) * src_stride_u; + src_v = src_v + (halfheight - 1) * src_stride_v; + src_stride_y = -src_stride_y; + src_stride_u = -src_stride_u; + src_stride_v = -src_stride_v; + } + + switch (mode) { + case kRotate0: + // copy frame + return I420Copy(src_y, src_stride_y, src_u, src_stride_u, src_v, + src_stride_v, dst_y, dst_stride_y, dst_u, dst_stride_u, + dst_v, dst_stride_v, width, height); + case kRotate90: + RotatePlane90(src_y, src_stride_y, dst_y, dst_stride_y, width, height); + RotatePlane90(src_u, src_stride_u, dst_u, dst_stride_u, halfwidth, + halfheight); + RotatePlane90(src_v, src_stride_v, dst_v, dst_stride_v, halfwidth, + halfheight); + return 0; + case kRotate270: + RotatePlane270(src_y, src_stride_y, dst_y, dst_stride_y, width, height); + RotatePlane270(src_u, src_stride_u, dst_u, dst_stride_u, halfwidth, + halfheight); + RotatePlane270(src_v, src_stride_v, dst_v, dst_stride_v, halfwidth, + halfheight); + return 0; + case kRotate180: + RotatePlane180(src_y, src_stride_y, dst_y, dst_stride_y, width, height); + RotatePlane180(src_u, src_stride_u, dst_u, dst_stride_u, halfwidth, + halfheight); + RotatePlane180(src_v, src_stride_v, dst_v, dst_stride_v, halfwidth, + halfheight); + return 0; + default: + break; + } + return -1; +} diff --git a/pkg/encoder/yuv/libyuv/rotate.h b/pkg/encoder/yuv/libyuv/rotate.h new file mode 100644 index 00000000..59b9ec3c --- /dev/null +++ b/pkg/encoder/yuv/libyuv/rotate.h @@ -0,0 +1,79 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_ROTATE_H_ +#define INCLUDE_LIBYUV_ROTATE_H_ + +#include "basic_types.h" + +// Supported rotation. +typedef enum RotationMode { + kRotate0 = 0, // No rotation. + kRotate90 = 90, // Rotate 90 degrees clockwise. + kRotate180 = 180, // Rotate 180 degrees. + kRotate270 = 270, // Rotate 270 degrees clockwise. +} RotationModeEnum; + +// Rotate I420 frame. +LIBYUV_API +int I420Rotate(const uint8_t *src_y, + int src_stride_y, + const uint8_t *src_u, + int src_stride_u, + const uint8_t *src_v, + int src_stride_v, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int width, + int height, + enum RotationMode mode); + +// Rotate planes by 90, 180, 270. Deprecated. +LIBYUV_API +void RotatePlane90(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height); + +LIBYUV_API +void RotatePlane180(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height); + +LIBYUV_API +void RotatePlane270(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height); + +// The 90 and 270 functions are based on transposes. +// Doing a transpose with reversing the read/write +// order will result in a rotation by +- 90 degrees. +// Deprecated. +LIBYUV_API +void TransposePlane(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height); + +#endif // INCLUDE_LIBYUV_ROTATE_H_ diff --git a/pkg/encoder/yuv/libyuv/rotate_any.c b/pkg/encoder/yuv/libyuv/rotate_any.c new file mode 100644 index 00000000..9af8c04a --- /dev/null +++ b/pkg/encoder/yuv/libyuv/rotate_any.c @@ -0,0 +1,54 @@ +/* + * Copyright 2015 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "rotate_row.h" + +#define TANY(NAMEANY, TPOS_SIMD, MASK) \ + void NAMEANY(const uint8_t* src, int src_stride, uint8_t* dst, \ + int dst_stride, int width) { \ + int r = width & MASK; \ + int n = width - r; \ + if (n > 0) { \ + TPOS_SIMD(src, src_stride, dst, dst_stride, n); \ + } \ + TransposeWx8_C(src + n, src_stride, dst + n * dst_stride, dst_stride, r); \ + } + +#ifdef HAS_TRANSPOSEWX8_SSSE3 + +TANY(TransposeWx8_Any_SSSE3, TransposeWx8_SSSE3, 7) + +#endif +#ifdef HAS_TRANSPOSEWX8_FAST_SSSE3 + +TANY(TransposeWx8_Fast_Any_SSSE3, TransposeWx8_Fast_SSSE3, 15) + +#endif +#undef TANY + +#define TUVANY(NAMEANY, TPOS_SIMD, MASK) \ + void NAMEANY(const uint8_t* src, int src_stride, uint8_t* dst_a, \ + int dst_stride_a, uint8_t* dst_b, int dst_stride_b, \ + int width) { \ + int r = width & MASK; \ + int n = width - r; \ + if (n > 0) { \ + TPOS_SIMD(src, src_stride, dst_a, dst_stride_a, dst_b, dst_stride_b, n); \ + } \ + TransposeUVWx8_C(src + n * 2, src_stride, dst_a + n * dst_stride_a, \ + dst_stride_a, dst_b + n * dst_stride_b, dst_stride_b, r); \ + } + +#ifdef HAS_TRANSPOSEUVWX8_SSE2 + +TUVANY(TransposeUVWx8_Any_SSE2, TransposeUVWx8_SSE2, 7) + +#endif +#undef TUVANY diff --git a/pkg/encoder/yuv/libyuv/rotate_common.c b/pkg/encoder/yuv/libyuv/rotate_common.c new file mode 100644 index 00000000..20c1481a --- /dev/null +++ b/pkg/encoder/yuv/libyuv/rotate_common.c @@ -0,0 +1,77 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "rotate_row.h" + +void TransposeWx8_C(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width) { + int i; + for (i = 0; i < width; ++i) { + dst[0] = src[0 * src_stride]; + dst[1] = src[1 * src_stride]; + dst[2] = src[2 * src_stride]; + dst[3] = src[3 * src_stride]; + dst[4] = src[4 * src_stride]; + dst[5] = src[5 * src_stride]; + dst[6] = src[6 * src_stride]; + dst[7] = src[7 * src_stride]; + ++src; + dst += dst_stride; + } +} + +void TransposeUVWx8_C(const uint8_t *src, + int src_stride, + uint8_t *dst_a, + int dst_stride_a, + uint8_t *dst_b, + int dst_stride_b, + int width) { + int i; + for (i = 0; i < width; ++i) { + dst_a[0] = src[0 * src_stride + 0]; + dst_b[0] = src[0 * src_stride + 1]; + dst_a[1] = src[1 * src_stride + 0]; + dst_b[1] = src[1 * src_stride + 1]; + dst_a[2] = src[2 * src_stride + 0]; + dst_b[2] = src[2 * src_stride + 1]; + dst_a[3] = src[3 * src_stride + 0]; + dst_b[3] = src[3 * src_stride + 1]; + dst_a[4] = src[4 * src_stride + 0]; + dst_b[4] = src[4 * src_stride + 1]; + dst_a[5] = src[5 * src_stride + 0]; + dst_b[5] = src[5 * src_stride + 1]; + dst_a[6] = src[6 * src_stride + 0]; + dst_b[6] = src[6 * src_stride + 1]; + dst_a[7] = src[7 * src_stride + 0]; + dst_b[7] = src[7 * src_stride + 1]; + src += 2; + dst_a += dst_stride_a; + dst_b += dst_stride_b; + } +} + +void TransposeWxH_C(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height) { + int i; + for (i = 0; i < width; ++i) { + int j; + for (j = 0; j < height; ++j) { + dst[i * dst_stride + j] = src[j * src_stride + i]; + } + } +} diff --git a/pkg/encoder/yuv/libyuv/rotate_gcc.c b/pkg/encoder/yuv/libyuv/rotate_gcc.c new file mode 100644 index 00000000..54fdafff --- /dev/null +++ b/pkg/encoder/yuv/libyuv/rotate_gcc.c @@ -0,0 +1,370 @@ +/* + * Copyright 2015 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "rotate_row.h" +#include "row.h" + +// This module is for GCC x86 and x64. +#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) + +// Transpose 8x8. 32 or 64 bit, but not NaCL for 64 bit. +#if defined(HAS_TRANSPOSEWX8_SSSE3) + +void TransposeWx8_SSSE3(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width) { + asm volatile( + // Read in the data from the source pointer. + // First round of bit swap. + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" + "movq (%0,%3),%%xmm1 \n" + "lea (%0,%3,2),%0 \n" + "punpcklbw %%xmm1,%%xmm0 \n" + "movq (%0),%%xmm2 \n" + "movdqa %%xmm0,%%xmm1 \n" + "palignr $0x8,%%xmm1,%%xmm1 \n" + "movq (%0,%3),%%xmm3 \n" + "lea (%0,%3,2),%0 \n" + "punpcklbw %%xmm3,%%xmm2 \n" + "movdqa %%xmm2,%%xmm3 \n" + "movq (%0),%%xmm4 \n" + "palignr $0x8,%%xmm3,%%xmm3 \n" + "movq (%0,%3),%%xmm5 \n" + "lea (%0,%3,2),%0 \n" + "punpcklbw %%xmm5,%%xmm4 \n" + "movdqa %%xmm4,%%xmm5 \n" + "movq (%0),%%xmm6 \n" + "palignr $0x8,%%xmm5,%%xmm5 \n" + "movq (%0,%3),%%xmm7 \n" + "lea (%0,%3,2),%0 \n" + "punpcklbw %%xmm7,%%xmm6 \n" + "neg %3 \n" + "movdqa %%xmm6,%%xmm7 \n" + "lea 0x8(%0,%3,8),%0 \n" + "palignr $0x8,%%xmm7,%%xmm7 \n" + "neg %3 \n" + // Second round of bit swap. + "punpcklwd %%xmm2,%%xmm0 \n" + "punpcklwd %%xmm3,%%xmm1 \n" + "movdqa %%xmm0,%%xmm2 \n" + "movdqa %%xmm1,%%xmm3 \n" + "palignr $0x8,%%xmm2,%%xmm2 \n" + "palignr $0x8,%%xmm3,%%xmm3 \n" + "punpcklwd %%xmm6,%%xmm4 \n" + "punpcklwd %%xmm7,%%xmm5 \n" + "movdqa %%xmm4,%%xmm6 \n" + "movdqa %%xmm5,%%xmm7 \n" + "palignr $0x8,%%xmm6,%%xmm6 \n" + "palignr $0x8,%%xmm7,%%xmm7 \n" + // Third round of bit swap. + // Write to the destination pointer. + "punpckldq %%xmm4,%%xmm0 \n" + "movq %%xmm0,(%1) \n" + "movdqa %%xmm0,%%xmm4 \n" + "palignr $0x8,%%xmm4,%%xmm4 \n" + "movq %%xmm4,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "punpckldq %%xmm6,%%xmm2 \n" + "movdqa %%xmm2,%%xmm6 \n" + "movq %%xmm2,(%1) \n" + "palignr $0x8,%%xmm6,%%xmm6 \n" + "punpckldq %%xmm5,%%xmm1 \n" + "movq %%xmm6,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "movdqa %%xmm1,%%xmm5 \n" + "movq %%xmm1,(%1) \n" + "palignr $0x8,%%xmm5,%%xmm5 \n" + "movq %%xmm5,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "punpckldq %%xmm7,%%xmm3 \n" + "movq %%xmm3,(%1) \n" + "movdqa %%xmm3,%%xmm7 \n" + "palignr $0x8,%%xmm7,%%xmm7 \n" + "sub $0x8,%2 \n" + "movq %%xmm7,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "jg 1b \n" + : "+r"(src), // %0 + "+r"(dst), // %1 + "+r"(width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif // defined(HAS_TRANSPOSEWX8_SSSE3) + +// Transpose 16x8. 64 bit +#if defined(HAS_TRANSPOSEWX8_FAST_SSSE3) + +void TransposeWx8_Fast_SSSE3(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width) { + asm volatile( + // Read in the data from the source pointer. + // First round of bit swap. + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu (%0,%3),%%xmm1 \n" + "lea (%0,%3,2),%0 \n" + "movdqa %%xmm0,%%xmm8 \n" + "punpcklbw %%xmm1,%%xmm0 \n" + "punpckhbw %%xmm1,%%xmm8 \n" + "movdqu (%0),%%xmm2 \n" + "movdqa %%xmm0,%%xmm1 \n" + "movdqa %%xmm8,%%xmm9 \n" + "palignr $0x8,%%xmm1,%%xmm1 \n" + "palignr $0x8,%%xmm9,%%xmm9 \n" + "movdqu (%0,%3),%%xmm3 \n" + "lea (%0,%3,2),%0 \n" + "movdqa %%xmm2,%%xmm10 \n" + "punpcklbw %%xmm3,%%xmm2 \n" + "punpckhbw %%xmm3,%%xmm10 \n" + "movdqa %%xmm2,%%xmm3 \n" + "movdqa %%xmm10,%%xmm11 \n" + "movdqu (%0),%%xmm4 \n" + "palignr $0x8,%%xmm3,%%xmm3 \n" + "palignr $0x8,%%xmm11,%%xmm11 \n" + "movdqu (%0,%3),%%xmm5 \n" + "lea (%0,%3,2),%0 \n" + "movdqa %%xmm4,%%xmm12 \n" + "punpcklbw %%xmm5,%%xmm4 \n" + "punpckhbw %%xmm5,%%xmm12 \n" + "movdqa %%xmm4,%%xmm5 \n" + "movdqa %%xmm12,%%xmm13 \n" + "movdqu (%0),%%xmm6 \n" + "palignr $0x8,%%xmm5,%%xmm5 \n" + "palignr $0x8,%%xmm13,%%xmm13 \n" + "movdqu (%0,%3),%%xmm7 \n" + "lea (%0,%3,2),%0 \n" + "movdqa %%xmm6,%%xmm14 \n" + "punpcklbw %%xmm7,%%xmm6 \n" + "punpckhbw %%xmm7,%%xmm14 \n" + "neg %3 \n" + "movdqa %%xmm6,%%xmm7 \n" + "movdqa %%xmm14,%%xmm15 \n" + "lea 0x10(%0,%3,8),%0 \n" + "palignr $0x8,%%xmm7,%%xmm7 \n" + "palignr $0x8,%%xmm15,%%xmm15 \n" + "neg %3 \n" + // Second round of bit swap. + "punpcklwd %%xmm2,%%xmm0 \n" + "punpcklwd %%xmm3,%%xmm1 \n" + "movdqa %%xmm0,%%xmm2 \n" + "movdqa %%xmm1,%%xmm3 \n" + "palignr $0x8,%%xmm2,%%xmm2 \n" + "palignr $0x8,%%xmm3,%%xmm3 \n" + "punpcklwd %%xmm6,%%xmm4 \n" + "punpcklwd %%xmm7,%%xmm5 \n" + "movdqa %%xmm4,%%xmm6 \n" + "movdqa %%xmm5,%%xmm7 \n" + "palignr $0x8,%%xmm6,%%xmm6 \n" + "palignr $0x8,%%xmm7,%%xmm7 \n" + "punpcklwd %%xmm10,%%xmm8 \n" + "punpcklwd %%xmm11,%%xmm9 \n" + "movdqa %%xmm8,%%xmm10 \n" + "movdqa %%xmm9,%%xmm11 \n" + "palignr $0x8,%%xmm10,%%xmm10 \n" + "palignr $0x8,%%xmm11,%%xmm11 \n" + "punpcklwd %%xmm14,%%xmm12 \n" + "punpcklwd %%xmm15,%%xmm13 \n" + "movdqa %%xmm12,%%xmm14 \n" + "movdqa %%xmm13,%%xmm15 \n" + "palignr $0x8,%%xmm14,%%xmm14 \n" + "palignr $0x8,%%xmm15,%%xmm15 \n" + // Third round of bit swap. + // Write to the destination pointer. + "punpckldq %%xmm4,%%xmm0 \n" + "movq %%xmm0,(%1) \n" + "movdqa %%xmm0,%%xmm4 \n" + "palignr $0x8,%%xmm4,%%xmm4 \n" + "movq %%xmm4,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "punpckldq %%xmm6,%%xmm2 \n" + "movdqa %%xmm2,%%xmm6 \n" + "movq %%xmm2,(%1) \n" + "palignr $0x8,%%xmm6,%%xmm6 \n" + "punpckldq %%xmm5,%%xmm1 \n" + "movq %%xmm6,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "movdqa %%xmm1,%%xmm5 \n" + "movq %%xmm1,(%1) \n" + "palignr $0x8,%%xmm5,%%xmm5 \n" + "movq %%xmm5,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "punpckldq %%xmm7,%%xmm3 \n" + "movq %%xmm3,(%1) \n" + "movdqa %%xmm3,%%xmm7 \n" + "palignr $0x8,%%xmm7,%%xmm7 \n" + "movq %%xmm7,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "punpckldq %%xmm12,%%xmm8 \n" + "movq %%xmm8,(%1) \n" + "movdqa %%xmm8,%%xmm12 \n" + "palignr $0x8,%%xmm12,%%xmm12 \n" + "movq %%xmm12,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "punpckldq %%xmm14,%%xmm10 \n" + "movdqa %%xmm10,%%xmm14 \n" + "movq %%xmm10,(%1) \n" + "palignr $0x8,%%xmm14,%%xmm14 \n" + "punpckldq %%xmm13,%%xmm9 \n" + "movq %%xmm14,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "movdqa %%xmm9,%%xmm13 \n" + "movq %%xmm9,(%1) \n" + "palignr $0x8,%%xmm13,%%xmm13 \n" + "movq %%xmm13,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "punpckldq %%xmm15,%%xmm11 \n" + "movq %%xmm11,(%1) \n" + "movdqa %%xmm11,%%xmm15 \n" + "palignr $0x8,%%xmm15,%%xmm15 \n" + "sub $0x10,%2 \n" + "movq %%xmm15,(%1,%4) \n" + "lea (%1,%4,2),%1 \n" + "jg 1b \n" + : "+r"(src), // %0 + "+r"(dst), // %1 + "+r"(width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7", "xmm8", "xmm9", "xmm10", "xmm11", "xmm12", "xmm13", "xmm14", + "xmm15"); +} + +#endif // defined(HAS_TRANSPOSEWX8_FAST_SSSE3) + +// Transpose UV 8x8. 64 bit. +#if defined(HAS_TRANSPOSEUVWX8_SSE2) + +void TransposeUVWx8_SSE2(const uint8_t *src, + int src_stride, + uint8_t *dst_a, + int dst_stride_a, + uint8_t *dst_b, + int dst_stride_b, + int width) { + asm volatile( + // Read in the data from the source pointer. + // First round of bit swap. + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu (%0,%4),%%xmm1 \n" + "lea (%0,%4,2),%0 \n" + "movdqa %%xmm0,%%xmm8 \n" + "punpcklbw %%xmm1,%%xmm0 \n" + "punpckhbw %%xmm1,%%xmm8 \n" + "movdqa %%xmm8,%%xmm1 \n" + "movdqu (%0),%%xmm2 \n" + "movdqu (%0,%4),%%xmm3 \n" + "lea (%0,%4,2),%0 \n" + "movdqa %%xmm2,%%xmm8 \n" + "punpcklbw %%xmm3,%%xmm2 \n" + "punpckhbw %%xmm3,%%xmm8 \n" + "movdqa %%xmm8,%%xmm3 \n" + "movdqu (%0),%%xmm4 \n" + "movdqu (%0,%4),%%xmm5 \n" + "lea (%0,%4,2),%0 \n" + "movdqa %%xmm4,%%xmm8 \n" + "punpcklbw %%xmm5,%%xmm4 \n" + "punpckhbw %%xmm5,%%xmm8 \n" + "movdqa %%xmm8,%%xmm5 \n" + "movdqu (%0),%%xmm6 \n" + "movdqu (%0,%4),%%xmm7 \n" + "lea (%0,%4,2),%0 \n" + "movdqa %%xmm6,%%xmm8 \n" + "punpcklbw %%xmm7,%%xmm6 \n" + "neg %4 \n" + "lea 0x10(%0,%4,8),%0 \n" + "punpckhbw %%xmm7,%%xmm8 \n" + "movdqa %%xmm8,%%xmm7 \n" + "neg %4 \n" + // Second round of bit swap. + "movdqa %%xmm0,%%xmm8 \n" + "movdqa %%xmm1,%%xmm9 \n" + "punpckhwd %%xmm2,%%xmm8 \n" + "punpckhwd %%xmm3,%%xmm9 \n" + "punpcklwd %%xmm2,%%xmm0 \n" + "punpcklwd %%xmm3,%%xmm1 \n" + "movdqa %%xmm8,%%xmm2 \n" + "movdqa %%xmm9,%%xmm3 \n" + "movdqa %%xmm4,%%xmm8 \n" + "movdqa %%xmm5,%%xmm9 \n" + "punpckhwd %%xmm6,%%xmm8 \n" + "punpckhwd %%xmm7,%%xmm9 \n" + "punpcklwd %%xmm6,%%xmm4 \n" + "punpcklwd %%xmm7,%%xmm5 \n" + "movdqa %%xmm8,%%xmm6 \n" + "movdqa %%xmm9,%%xmm7 \n" + // Third round of bit swap. + // Write to the destination pointer. + "movdqa %%xmm0,%%xmm8 \n" + "punpckldq %%xmm4,%%xmm0 \n" + "movlpd %%xmm0,(%1) \n" // Write back U channel + "movhpd %%xmm0,(%2) \n" // Write back V channel + "punpckhdq %%xmm4,%%xmm8 \n" + "movlpd %%xmm8,(%1,%5) \n" + "lea (%1,%5,2),%1 \n" + "movhpd %%xmm8,(%2,%6) \n" + "lea (%2,%6,2),%2 \n" + "movdqa %%xmm2,%%xmm8 \n" + "punpckldq %%xmm6,%%xmm2 \n" + "movlpd %%xmm2,(%1) \n" + "movhpd %%xmm2,(%2) \n" + "punpckhdq %%xmm6,%%xmm8 \n" + "movlpd %%xmm8,(%1,%5) \n" + "lea (%1,%5,2),%1 \n" + "movhpd %%xmm8,(%2,%6) \n" + "lea (%2,%6,2),%2 \n" + "movdqa %%xmm1,%%xmm8 \n" + "punpckldq %%xmm5,%%xmm1 \n" + "movlpd %%xmm1,(%1) \n" + "movhpd %%xmm1,(%2) \n" + "punpckhdq %%xmm5,%%xmm8 \n" + "movlpd %%xmm8,(%1,%5) \n" + "lea (%1,%5,2),%1 \n" + "movhpd %%xmm8,(%2,%6) \n" + "lea (%2,%6,2),%2 \n" + "movdqa %%xmm3,%%xmm8 \n" + "punpckldq %%xmm7,%%xmm3 \n" + "movlpd %%xmm3,(%1) \n" + "movhpd %%xmm3,(%2) \n" + "punpckhdq %%xmm7,%%xmm8 \n" + "sub $0x8,%3 \n" + "movlpd %%xmm8,(%1,%5) \n" + "lea (%1,%5,2),%1 \n" + "movhpd %%xmm8,(%2,%6) \n" + "lea (%2,%6,2),%2 \n" + "jg 1b \n" + : "+r"(src), // %0 + "+r"(dst_a), // %1 + "+r"(dst_b), // %2 + "+r"(width) // %3 + : "r"((intptr_t) (src_stride)), // %4 + "r"((intptr_t) (dst_stride_a)), // %5 + "r"((intptr_t) (dst_stride_b)) // %6 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7", "xmm8", "xmm9"); +} + +#endif // defined(HAS_TRANSPOSEUVWX8_SSE2) + +#endif // defined(__x86_64__) || defined(__i386__) diff --git a/pkg/encoder/yuv/libyuv/rotate_row.h b/pkg/encoder/yuv/libyuv/rotate_row.h new file mode 100644 index 00000000..afdae49f --- /dev/null +++ b/pkg/encoder/yuv/libyuv/rotate_row.h @@ -0,0 +1,106 @@ +/* + * Copyright 2013 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_ROTATE_ROW_H_ +#define INCLUDE_LIBYUV_ROTATE_ROW_H_ + +#include "basic_types.h" + +#if defined(__pnacl__) || defined(__CLR_VER) || \ + (defined(__native_client__) && defined(__x86_64__)) || \ + (defined(__i386__) && !defined(__SSE__) && !defined(__clang__)) +#define LIBYUV_DISABLE_X86 +#endif +#if defined(__native_client__) +#define LIBYUV_DISABLE_NEON +#endif +// MemorySanitizer does not support assembly code yet. http://crbug.com/344505 +#if defined(__has_feature) +#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_NEON) +#define LIBYUV_DISABLE_NEON +#endif +#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_X86) +#define LIBYUV_DISABLE_X86 +#endif +#endif + +// The following are available for GCC 32 or 64 bit: +#if !defined(LIBYUV_DISABLE_X86) && (defined(__i386__) || defined(__x86_64__)) +#define HAS_TRANSPOSEWX8_SSSE3 +#endif + +// The following are available for 64 bit GCC: +#if !defined(LIBYUV_DISABLE_X86) && defined(__x86_64__) +#define HAS_TRANSPOSEWX8_FAST_SSSE3 +#define HAS_TRANSPOSEUVWX8_SSE2 +#endif + +void TransposeWxH_C(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width, + int height); + +void TransposeWx8_C(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width); + +void TransposeWx8_SSSE3(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width); + +void TransposeWx8_Fast_SSSE3(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width); + +void TransposeWx8_Any_SSSE3(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width); + +void TransposeWx8_Fast_Any_SSSE3(const uint8_t *src, + int src_stride, + uint8_t *dst, + int dst_stride, + int width); + +void TransposeUVWx8_C(const uint8_t *src, + int src_stride, + uint8_t *dst_a, + int dst_stride_a, + uint8_t *dst_b, + int dst_stride_b, + int width); + +void TransposeUVWx8_SSE2(const uint8_t *src, + int src_stride, + uint8_t *dst_a, + int dst_stride_a, + uint8_t *dst_b, + int dst_stride_b, + int width); + +void TransposeUVWx8_Any_SSE2(const uint8_t *src, + int src_stride, + uint8_t *dst_a, + int dst_stride_a, + uint8_t *dst_b, + int dst_stride_b, + int width); + +#endif // INCLUDE_LIBYUV_ROTATE_ROW_H_ diff --git a/pkg/encoder/yuv/libyuv/row.h b/pkg/encoder/yuv/libyuv/row.h new file mode 100644 index 00000000..ca1c0c29 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/row.h @@ -0,0 +1,426 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_ROW_H_ +#define INCLUDE_LIBYUV_ROW_H_ + +#include // For NULL +#include // For malloc + +#include "basic_types.h" + +#if defined(__pnacl__) || defined(__CLR_VER) || \ + (defined(__native_client__) && defined(__x86_64__)) || \ + (defined(__i386__) && !defined(__SSE__) && !defined(__clang__)) +#define LIBYUV_DISABLE_X86 +#endif +#if defined(__native_client__) +#define LIBYUV_DISABLE_NEON +#endif +// MemorySanitizer does not support assembly code yet. http://crbug.com/344505 +#if defined(__has_feature) +#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_NEON) +#define LIBYUV_DISABLE_NEON +#endif +#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_X86) +#define LIBYUV_DISABLE_X86 +#endif +#endif + +// GCC >= 4.7.0 required for AVX2. +#if defined(__GNUC__) && (defined(__x86_64__) || defined(__i386__)) +#if (__GNUC__ > 4) || (__GNUC__ == 4 && (__GNUC_MINOR__ >= 7)) +#define GCC_HAS_AVX2 1 +#endif // GNUC >= 4.7 +#endif // __GNUC__ + +// The following are available on all x86 platforms: +#if !defined(LIBYUV_DISABLE_X86) && \ + (defined(_M_IX86) || defined(__x86_64__) || defined(__i386__)) +// Conversions: +#define HAS_ABGRTOYROW_SSSE3 +#define HAS_ARGBTOYROW_SSSE3 +#define HAS_BGRATOYROW_SSSE3 +#define HAS_COPYROW_ERMS +#define HAS_COPYROW_SSE2 +#define HAS_INTERPOLATEROW_SSSE3 +#define HAS_MIRRORROW_SSSE3 +#define HAS_MIRRORSPLITUVROW_SSSE3 +#if !defined(LIBYUV_BIT_EXACT) +#define HAS_ABGRTOUVROW_SSSE3 +#define HAS_ARGBTOUVROW_SSSE3 +#endif + +// Effects: +#define HAS_ARGBGRAYROW_SSSE3 +#define HAS_ARGBMIRRORROW_SSE2 + +#endif + +// The following are available on all x86 platforms, but +// require VS2012, clang 3.4 or gcc 4.7. +#if !defined(LIBYUV_DISABLE_X86) && \ + (defined(VISUALC_HAS_AVX2) || defined(CLANG_HAS_AVX2) || \ + defined(GCC_HAS_AVX2)) +#define HAS_ARGBEXTRACTALPHAROW_AVX2 +#define HAS_ARGBMIRRORROW_AVX2 +#define HAS_ARGBTOYROW_AVX2 +#define HAS_COPYROW_AVX +#define HAS_INTERPOLATEROW_AVX2 +#define HAS_MIRRORROW_AVX2 +#if !defined(LIBYUV_BIT_EXACT) +#define HAS_ARGBTOUVROW_AVX2 +#endif + +#endif + +// The following are available for gcc/clang x86 platforms: +// TODO(fbarchard): Port to Visual C +#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) +#define HAS_MIRRORUVROW_SSSE3 + +#endif + +// The following are available for AVX2 gcc/clang x86 platforms: +// TODO(fbarchard): Port to Visual C +#if !defined(LIBYUV_DISABLE_X86) && \ + (defined(__x86_64__) || defined(__i386__)) && \ + (defined(CLANG_HAS_AVX2) || defined(GCC_HAS_AVX2)) +#define HAS_ABGRTOYROW_AVX2 +#define HAS_MIRRORUVROW_AVX2 +#if !defined(LIBYUV_BIT_EXACT) +#define HAS_ABGRTOUVROW_AVX2 +#endif + +#endif + +#if defined(_MSC_VER) && !defined(__CLR_VER) && !defined(__clang__) + #if defined(VISUALC_HAS_AVX2) +#define SIMD_ALIGNED(var) __declspec(align(32)) var +#else +#define SIMD_ALIGNED(var) __declspec(align(16)) var +#endif +#define LIBYUV_NOINLINE __declspec(noinline) +typedef __declspec(align(16)) int16_t vec16[8]; +typedef __declspec(align(16)) int32_t vec32[4]; +typedef __declspec(align(16)) float vecf32[4]; +typedef __declspec(align(16)) int8_t vec8[16]; +typedef __declspec(align(16)) uint16_t uvec16[8]; +typedef __declspec(align(16)) uint32_t uvec32[4]; +typedef __declspec(align(16)) uint8_t uvec8[16]; +typedef __declspec(align(32)) int16_t lvec16[16]; +typedef __declspec(align(32)) int32_t lvec32[8]; +typedef __declspec(align(32)) int8_t lvec8[32]; +typedef __declspec(align(32)) uint16_t ulvec16[16]; +typedef __declspec(align(32)) uint32_t ulvec32[8]; +typedef __declspec(align(32)) uint8_t ulvec8[32]; +#elif !defined(__pnacl__) && (defined(__GNUC__) || defined(__clang__)) +// Caveat GCC 4.2 to 4.7 have a known issue using vectors with const. +#if defined(CLANG_HAS_AVX2) || defined(GCC_HAS_AVX2) +#define SIMD_ALIGNED(var) var __attribute__((aligned(32))) +#else +#define SIMD_ALIGNED(var) var __attribute__((aligned(16))) +#endif +#define LIBYUV_NOINLINE __attribute__((noinline)) +typedef int16_t __attribute__((vector_size(16))) vec16; +typedef int32_t __attribute__((vector_size(16))) vec32; +typedef float __attribute__((vector_size(16))) vecf32; +typedef int8_t __attribute__((vector_size(16))) vec8; +typedef uint16_t __attribute__((vector_size(16))) uvec16; +typedef uint32_t __attribute__((vector_size(16))) uvec32; +typedef uint8_t __attribute__((vector_size(16))) uvec8; +typedef int16_t __attribute__((vector_size(32))) lvec16; +typedef int32_t __attribute__((vector_size(32))) lvec32; +typedef int8_t __attribute__((vector_size(32))) lvec8; +typedef uint16_t __attribute__((vector_size(32))) ulvec16; +typedef uint32_t __attribute__((vector_size(32))) ulvec32; +typedef uint8_t __attribute__((vector_size(32))) ulvec8; +#else +#define SIMD_ALIGNED(var) var +#define LIBYUV_NOINLINE +typedef int16_t vec16[8]; +typedef int32_t vec32[4]; +typedef float vecf32[4]; +typedef int8_t vec8[16]; +typedef uint16_t uvec16[8]; +typedef uint32_t uvec32[4]; +typedef uint8_t uvec8[16]; +typedef int16_t lvec16[16]; +typedef int32_t lvec32[8]; +typedef int8_t lvec8[32]; +typedef uint16_t ulvec16[16]; +typedef uint32_t ulvec32[8]; +typedef uint8_t ulvec8[32]; +#endif + +#if !defined(__aarch64__) || !defined(__arm__) +// This struct is for Intel color conversion. +struct YuvConstants { + uint8_t kUVToB[32]; + uint8_t kUVToG[32]; + uint8_t kUVToR[32]; + int16_t kYToRgb[16]; + int16_t kYBiasToRgb[16]; +}; +#endif + +#define IS_ALIGNED(p, a) (!((uintptr_t)(p) & ((a)-1))) + +#define align_buffer_64(var, size) \ + void* var##_mem = malloc((size) + 63); /* NOLINT */ \ + uint8_t* var = (uint8_t*)(((intptr_t)var##_mem + 63) & ~63) /* NOLINT */ + +#define free_aligned_buffer_64(var) \ + free(var##_mem); \ + var = NULL + +#if defined(__APPLE__) || defined(__x86_64__) || defined(__llvm__) +#define OMITFP +#else +#define OMITFP __attribute__((optimize("omit-frame-pointer"))) +#endif + +// NaCL macros for GCC x86 and x64. +#if defined(__native_client__) +#define LABELALIGN ".p2align 5\n" +#else +#define LABELALIGN +#endif + +void ARGBToYRow_AVX2(const uint8_t *src_argb, uint8_t *dst_y, int width); + +void ARGBToYRow_Any_AVX2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void ABGRToYRow_AVX2(const uint8_t *src_abgr, uint8_t *dst_y, int width); + +void ABGRToYRow_Any_AVX2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void ARGBToYRow_SSSE3(const uint8_t *src_argb, uint8_t *dst_y, int width); + +void ABGRToYRow_SSSE3(const uint8_t *src_abgr, uint8_t *dst_y, int width); + +void BGRAToYRow_SSSE3(const uint8_t *src_bgra, uint8_t *dst_y, int width); + +void ABGRToYRow_SSSE3(const uint8_t *src_abgr, uint8_t *dst_y, int width); + +void ARGBToYRow_C(const uint8_t *src_rgb, uint8_t *dst_y, int width); + +void ABGRToYRow_C(const uint8_t *src_rgb, uint8_t *dst_y, int width); + +void RGB565ToYRow_C(const uint8_t *src_rgb565, uint8_t *dst_y, int width); + +void ARGBToYRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void BGRAToYRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void ABGRToYRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void ARGBToUVRow_AVX2(const uint8_t *src_argb, + int src_stride_argb, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ABGRToUVRow_AVX2(const uint8_t *src_abgr, + int src_stride_abgr, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ARGBToUVRow_SSSE3(const uint8_t *src_argb, + int src_stride_argb, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void BGRAToUVRow_SSSE3(const uint8_t *src_bgra, + int src_stride_bgra, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ABGRToUVRow_SSSE3(const uint8_t *src_abgr, + int src_stride_abgr, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void RGBAToUVRow_SSSE3(const uint8_t *src_rgba, + int src_stride_rgba, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ARGBToUVRow_Any_AVX2(const uint8_t *src_ptr, + int src_stride, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ABGRToUVRow_Any_AVX2(const uint8_t *src_ptr, + int src_stride, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ARGBToUVRow_Any_SSSE3(const uint8_t *src_ptr, + int src_stride, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void BGRAToUVRow_Any_SSSE3(const uint8_t *src_ptr, + int src_stride, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ABGRToUVRow_Any_SSSE3(const uint8_t *src_ptr, + int src_stride, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void RGBAToUVRow_Any_SSSE3(const uint8_t *src_ptr, + int src_stride, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ARGBToUVRow_C(const uint8_t *src_rgb, + int src_stride_rgb, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ARGBToUVRow_C(const uint8_t *src_rgb, + int src_stride_rgb, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void BGRAToUVRow_C(const uint8_t *src_rgb, + int src_stride_rgb, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void ABGRToUVRow_C(const uint8_t *src_rgb, + int src_stride_rgb, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void RGBAToUVRow_C(const uint8_t *src_rgb, + int src_stride_rgb, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void RGB565ToUVRow_C(const uint8_t *src_rgb565, + int src_stride_rgb565, + uint8_t *dst_u, + uint8_t *dst_v, + int width); + +void MirrorRow_AVX2(const uint8_t *src, uint8_t *dst, int width); + +void MirrorRow_SSSE3(const uint8_t *src, uint8_t *dst, int width); + +void MirrorRow_C(const uint8_t *src, uint8_t *dst, int width); + +void MirrorRow_Any_AVX2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void MirrorRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void MirrorRow_Any_SSE2(const uint8_t *src, uint8_t *dst, int width); + +void MirrorUVRow_AVX2(const uint8_t *src_uv, uint8_t *dst_uv, int width); + +void MirrorUVRow_SSSE3(const uint8_t *src_uv, uint8_t *dst_uv, int width); + +void MirrorUVRow_Any_AVX2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void MirrorUVRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void ARGBMirrorRow_AVX2(const uint8_t *src, uint8_t *dst, int width); + +void ARGBMirrorRow_SSE2(const uint8_t *src, uint8_t *dst, int width); + +void ARGBMirrorRow_C(const uint8_t *src, uint8_t *dst, int width); + +void ARGBMirrorRow_Any_AVX2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int width); + +void ARGBMirrorRow_Any_SSE2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int width); + +void CopyRow_SSE2(const uint8_t *src, uint8_t *dst, int width); + +void CopyRow_AVX(const uint8_t *src, uint8_t *dst, int width); + +void CopyRow_ERMS(const uint8_t *src, uint8_t *dst, int width); + +void CopyRow_C(const uint8_t *src, uint8_t *dst, int count); + +void CopyRow_Any_SSE2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void CopyRow_Any_AVX(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); + +void RGB565ToARGBRow_SSE2(const uint8_t *src, uint8_t *dst, int width); + +void RGB565ToARGBRow_AVX2(const uint8_t *src_rgb565, + uint8_t *dst_argb, + int width); + +void RGB565ToARGBRow_C(const uint8_t *src_rgb565, uint8_t *dst_argb, int width); + +void RGB565ToARGBRow_Any_SSE2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int width); + +void RGB565ToARGBRow_Any_AVX2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int width); + +// Used for I420Scale, ARGBScale, and ARGBInterpolate. +void InterpolateRow_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + ptrdiff_t src_stride, + int width, + int source_y_fraction); + +void InterpolateRow_SSSE3(uint8_t *dst_ptr, + const uint8_t *src_ptr, + ptrdiff_t src_stride, + int dst_width, + int source_y_fraction); + +void InterpolateRow_AVX2(uint8_t *dst_ptr, + const uint8_t *src_ptr, + ptrdiff_t src_stride, + int dst_width, + int source_y_fraction); + +void InterpolateRow_Any_SSSE3(uint8_t *dst_ptr, + const uint8_t *src_ptr, + ptrdiff_t src_stride_ptr, + int width, + int source_y_fraction); + +void InterpolateRow_Any_AVX2(uint8_t *dst_ptr, + const uint8_t *src_ptr, + ptrdiff_t src_stride_ptr, + int width, + int source_y_fraction); + +#endif // INCLUDE_LIBYUV_ROW_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/row_any.c b/pkg/encoder/yuv/libyuv/row_any.c new file mode 100644 index 00000000..fcc49c67 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/row_any.c @@ -0,0 +1,206 @@ +/* + * Copyright 2012 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "row.h" + +#include // For memset. + +// Subsampled source needs to be increase by 1 of not even. +#define SS(width, shift) (((width) + (1 << (shift)) - 1) >> (shift)) + +// Any 1 to 1. +#define ANY11(NAMEANY, ANY_SIMD, UVSHIFT, SBPP, BPP, MASK) \ + void NAMEANY(const uint8_t* src_ptr, uint8_t* dst_ptr, int width) { \ + SIMD_ALIGNED(uint8_t vin[128]); \ + SIMD_ALIGNED(uint8_t vout[128]); \ + memset(vin, 0, sizeof(vin)); /* for YUY2 and msan */ \ + int r = width & MASK; \ + int n = width & ~MASK; \ + if (n > 0) { \ + ANY_SIMD(src_ptr, dst_ptr, n); \ + } \ + memcpy(vin, src_ptr + (n >> UVSHIFT) * SBPP, SS(r, UVSHIFT) * SBPP); \ + ANY_SIMD(vin, vout, MASK + 1); \ + memcpy(dst_ptr + n * BPP, vout, r * BPP); \ + } + +#ifdef HAS_COPYROW_AVX + +ANY11(CopyRow_Any_AVX, CopyRow_AVX, 0, 1, 1, 63) + +#endif +#ifdef HAS_COPYROW_SSE2 + +ANY11(CopyRow_Any_SSE2, CopyRow_SSE2, 0, 1, 1, 31) + +#endif + +#ifdef HAS_ARGBTOYROW_AVX2 + +ANY11(ARGBToYRow_Any_AVX2, ARGBToYRow_AVX2, 0, 4, 1, 31) + +#endif +#ifdef HAS_ABGRTOYROW_AVX2 + +ANY11(ABGRToYRow_Any_AVX2, ABGRToYRow_AVX2, 0, 4, 1, 31) + +#endif +#ifdef HAS_ARGBTOYROW_SSSE3 + +ANY11(ARGBToYRow_Any_SSSE3, ARGBToYRow_SSSE3, 0, 4, 1, 15) + +#endif +#ifdef HAS_BGRATOYROW_SSSE3 + +ANY11(BGRAToYRow_Any_SSSE3, BGRAToYRow_SSSE3, 0, 4, 1, 15) + +ANY11(ABGRToYRow_Any_SSSE3, ABGRToYRow_SSSE3, 0, 4, 1, 15) + +#endif + +#undef ANY11 + +// Any 1 to 1 interpolate. Takes 2 rows of source via stride. +#define ANY11I(NAMEANY, ANY_SIMD, TD, TS, SBPP, BPP, MASK) \ + void NAMEANY(TD* dst_ptr, const TS* src_ptr, ptrdiff_t src_stride, \ + int width, int source_y_fraction) { \ + SIMD_ALIGNED(TS vin[64 * 2]); \ + SIMD_ALIGNED(TD vout[64]); \ + memset(vin, 0, sizeof(vin)); /* for msan */ \ + int r = width & MASK; \ + int n = width & ~MASK; \ + if (n > 0) { \ + ANY_SIMD(dst_ptr, src_ptr, src_stride, n, source_y_fraction); \ + } \ + memcpy(vin, src_ptr + n * SBPP, r * SBPP * sizeof(TS)); \ + if (source_y_fraction) { \ + memcpy(vin + 64, src_ptr + src_stride + n * SBPP, \ + r * SBPP * sizeof(TS)); \ + } \ + ANY_SIMD(vout, vin, 64, MASK + 1, source_y_fraction); \ + memcpy(dst_ptr + n * BPP, vout, r * BPP * sizeof(TD)); \ + } + +#ifdef HAS_INTERPOLATEROW_AVX2 + +ANY11I(InterpolateRow_Any_AVX2, InterpolateRow_AVX2, uint8_t, uint8_t, 1, 1, 31) + +#endif +#ifdef HAS_INTERPOLATEROW_SSSE3 + +ANY11I(InterpolateRow_Any_SSSE3, + InterpolateRow_SSSE3, + uint8_t, + uint8_t, + 1, + 1, + 15) + +#endif + +#undef ANY11I + +// Any 1 to 1 mirror. +#define ANY11M(NAMEANY, ANY_SIMD, BPP, MASK) \ + void NAMEANY(const uint8_t* src_ptr, uint8_t* dst_ptr, int width) { \ + SIMD_ALIGNED(uint8_t vin[64]); \ + SIMD_ALIGNED(uint8_t vout[64]); \ + memset(vin, 0, sizeof(vin)); /* for msan */ \ + int r = width & MASK; \ + int n = width & ~MASK; \ + if (n > 0) { \ + ANY_SIMD(src_ptr + r * BPP, dst_ptr, n); \ + } \ + memcpy(vin, src_ptr, r* BPP); \ + ANY_SIMD(vin, vout, MASK + 1); \ + memcpy(dst_ptr + n * BPP, vout + (MASK + 1 - r) * BPP, r * BPP); \ + } + +#ifdef HAS_MIRRORROW_AVX2 + +ANY11M(MirrorRow_Any_AVX2, MirrorRow_AVX2, 1, 31) + +#endif +#ifdef HAS_MIRRORROW_SSSE3 + +ANY11M(MirrorRow_Any_SSSE3, MirrorRow_SSSE3, 1, 15) + +#endif +#ifdef HAS_MIRRORUVROW_AVX2 + +ANY11M(MirrorUVRow_Any_AVX2, MirrorUVRow_AVX2, 2, 15) + +#endif +#ifdef HAS_MIRRORUVROW_SSSE3 + +ANY11M(MirrorUVRow_Any_SSSE3, MirrorUVRow_SSSE3, 2, 7) + +#endif +#ifdef HAS_ARGBMIRRORROW_AVX2 + +ANY11M(ARGBMirrorRow_Any_AVX2, ARGBMirrorRow_AVX2, 4, 7) + +#endif +#ifdef HAS_ARGBMIRRORROW_SSE2 + +ANY11M(ARGBMirrorRow_Any_SSE2, ARGBMirrorRow_SSE2, 4, 3) + +#endif +#undef ANY11M + +// Any 1 to 2 with source stride (2 rows of source). Outputs UV planes. +// 128 byte row allows for 32 avx ARGB pixels. +#define ANY12S(NAMEANY, ANY_SIMD, UVSHIFT, BPP, MASK) \ + void NAMEANY(const uint8_t* src_ptr, int src_stride, uint8_t* dst_u, \ + uint8_t* dst_v, int width) { \ + SIMD_ALIGNED(uint8_t vin[128 * 2]); \ + SIMD_ALIGNED(uint8_t vout[128 * 2]); \ + memset(vin, 0, sizeof(vin)); /* for msan */ \ + int r = width & MASK; \ + int n = width & ~MASK; \ + if (n > 0) { \ + ANY_SIMD(src_ptr, src_stride, dst_u, dst_v, n); \ + } \ + memcpy(vin, src_ptr + (n >> UVSHIFT) * BPP, SS(r, UVSHIFT) * BPP); \ + memcpy(vin + 128, src_ptr + src_stride + (n >> UVSHIFT) * BPP, \ + SS(r, UVSHIFT) * BPP); \ + if ((width & 1) && UVSHIFT == 0) { /* repeat last pixel for subsample */ \ + memcpy(vin + SS(r, UVSHIFT) * BPP, vin + SS(r, UVSHIFT) * BPP - BPP, \ + BPP); \ + memcpy(vin + 128 + SS(r, UVSHIFT) * BPP, \ + vin + 128 + SS(r, UVSHIFT) * BPP - BPP, BPP); \ + } \ + ANY_SIMD(vin, 128, vout, vout + 128, MASK + 1); \ + memcpy(dst_u + (n >> 1), vout, SS(r, 1)); \ + memcpy(dst_v + (n >> 1), vout + 128, SS(r, 1)); \ + } + +#ifdef HAS_ARGBTOUVROW_AVX2 + +ANY12S(ARGBToUVRow_Any_AVX2, ARGBToUVRow_AVX2, 0, 4, 31) + +#endif +#ifdef HAS_ABGRTOUVROW_AVX2 + +ANY12S(ABGRToUVRow_Any_AVX2, ABGRToUVRow_AVX2, 0, 4, 31) + +#endif +#ifdef HAS_ARGBTOUVROW_SSSE3 + +ANY12S(ARGBToUVRow_Any_SSSE3, ARGBToUVRow_SSSE3, 0, 4, 15) + +ANY12S(BGRAToUVRow_Any_SSSE3, BGRAToUVRow_SSSE3, 0, 4, 15) + +ANY12S(ABGRToUVRow_Any_SSSE3, ABGRToUVRow_SSSE3, 0, 4, 15) + +ANY12S(RGBAToUVRow_Any_SSSE3, RGBAToUVRow_SSSE3, 0, 4, 15) + +#endif +#undef ANY12S diff --git a/pkg/encoder/yuv/libyuv/row_common.c b/pkg/encoder/yuv/libyuv/row_common.c new file mode 100644 index 00000000..34a93a07 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/row_common.c @@ -0,0 +1,887 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "row.h" + +#include +#include // For memcpy and memset. + +#define STATIC_CAST(type, expr) (type)(expr) + +// This macro controls YUV to RGB using unsigned math to extend range of +// YUV to RGB coefficients to 0 to 4 instead of 0 to 2 for more accuracy on B: +// LIBYUV_UNLIMITED_DATA + +// Macros to enable unlimited data for each colorspace +// LIBYUV_UNLIMITED_BT601 +// LIBYUV_UNLIMITED_BT709 +// LIBYUV_UNLIMITED_BT2020 + +#if !defined(LIBYUV_BIT_EXACT) && (defined(__x86_64__) || defined(_M_X64) || \ + defined(__i386__) || defined(_M_IX86)) +#define LIBYUV_ARGBTOUV_PAVGB 1 +#define LIBYUV_RGBTOU_TRUNCATE 1 +#endif +#if defined(LIBYUV_BIT_EXACT) +#define LIBYUV_UNATTENUATE_DUP 1 +#endif + +// llvm x86 is poor at ternary operator, so use branchless min/max. + +#define USE_BRANCHLESS 1 +#if USE_BRANCHLESS + +static __inline int32_t clamp0(int32_t v) { + return -(v >= 0) & v; +} + +// TODO(fbarchard): make clamp255 preserve negative values. +static __inline int32_t clamp255(int32_t v) { + return (-(v >= 255) | v) & 255; +} + +static __inline int32_t clamp1023(int32_t v) { + return (-(v >= 1023) | v) & 1023; +} + +// clamp to max +static __inline int32_t ClampMax(int32_t v, int32_t max) { + return (-(v >= max) | v) & max; +} + +static __inline uint32_t Abs(int32_t v) { + int m = -(v < 0); + return (v + m) ^ m; +} + +#else // USE_BRANCHLESS +static __inline int32_t clamp0(int32_t v) { + return (v < 0) ? 0 : v; +} + +static __inline int32_t clamp255(int32_t v) { + return (v > 255) ? 255 : v; +} + +static __inline int32_t clamp1023(int32_t v) { + return (v > 1023) ? 1023 : v; +} + +static __inline int32_t ClampMax(int32_t v, int32_t max) { + return (v > max) ? max : v; +} + +static __inline uint32_t Abs(int32_t v) { + return (v < 0) ? -v : v; +} +#endif // USE_BRANCHLESS + +static __inline uint32_t Clamp(int32_t val) { + int v = clamp0(val); + return (uint32_t) (clamp255(v)); +} + +static __inline uint32_t Clamp10(int32_t val) { + int v = clamp0(val); + return (uint32_t) (clamp1023(v)); +} + +// Little Endian +#if defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || \ + defined(_M_IX86) || defined(__arm__) || defined(_M_ARM) || \ + (defined(__BYTE_ORDER__) && __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__) +#define WRITEWORD(p, v) *(uint32_t*)(p) = v +#else +static inline void WRITEWORD(uint8_t* p, uint32_t v) { + p[0] = (uint8_t)(v & 255); + p[1] = (uint8_t)((v >> 8) & 255); + p[2] = (uint8_t)((v >> 16) & 255); + p[3] = (uint8_t)((v >> 24) & 255); +} +#endif + +void RGB565ToARGBRow_C(const uint8_t *src_rgb565, + uint8_t *dst_argb, + int width) { + int x; + for (x = 0; x < width; ++x) { + uint8_t b = STATIC_CAST(uint8_t, src_rgb565[0] & 0x1f); + uint8_t g = STATIC_CAST( + uint8_t, (src_rgb565[0] >> 5) | ((src_rgb565[1] & 0x07) << 3)); + uint8_t r = STATIC_CAST(uint8_t, src_rgb565[1] >> 3); + dst_argb[0] = STATIC_CAST(uint8_t, (b << 3) | (b >> 2)); + dst_argb[1] = STATIC_CAST(uint8_t, (g << 2) | (g >> 4)); + dst_argb[2] = STATIC_CAST(uint8_t, (r << 3) | (r >> 2)); + dst_argb[3] = 255u; + dst_argb += 4; + src_rgb565 += 2; + } +} + +// 8 bit +// Intel SSE/AVX uses the following equivalent formula +// 0x7e80 = (66 + 129 + 25) * -128 + 0x1000 (for +16) and 0x0080 for round. +// return (66 * ((int)r - 128) + 129 * ((int)g - 128) + 25 * ((int)b - 128) + +// 0x7e80) >> 8; + +static __inline uint8_t RGBToY(uint8_t r, uint8_t g, uint8_t b) { + return STATIC_CAST(uint8_t, (66 * r + 129 * g + 25 * b + 0x1080) >> 8); +} + +#define AVGB(a, b) (((a) + (b) + 1) >> 1) + +// LIBYUV_RGBTOU_TRUNCATE mimics x86 code that does not round. +#ifdef LIBYUV_RGBTOU_TRUNCATE + +static __inline uint8_t RGBToU(uint8_t r, uint8_t g, uint8_t b) { + return STATIC_CAST(uint8_t, (112 * b - 74 * g - 38 * r + 0x8000) >> 8); +} + +static __inline uint8_t RGBToV(uint8_t r, uint8_t g, uint8_t b) { + return STATIC_CAST(uint8_t, (112 * r - 94 * g - 18 * b + 0x8000) >> 8); +} + +#else +// TODO(fbarchard): Add rounding to x86 SIMD and use this +static __inline uint8_t RGBToU(uint8_t r, uint8_t g, uint8_t b) { + return STATIC_CAST(uint8_t, (112 * b - 74 * g - 38 * r + 0x8080) >> 8); +} +static __inline uint8_t RGBToV(uint8_t r, uint8_t g, uint8_t b) { + return STATIC_CAST(uint8_t, (112 * r - 94 * g - 18 * b + 0x8080) >> 8); +} +#endif + +// LIBYUV_ARGBTOUV_PAVGB mimics x86 code that subsamples with 2 pavgb. +#if !defined(LIBYUV_ARGBTOUV_PAVGB) +static __inline int RGB2xToU(uint16_t r, uint16_t g, uint16_t b) { + return STATIC_CAST( + uint8_t, ((112 / 2) * b - (74 / 2) * g - (38 / 2) * r + 0x8080) >> 8); +} +static __inline int RGB2xToV(uint16_t r, uint16_t g, uint16_t b) { + return STATIC_CAST( + uint8_t, ((112 / 2) * r - (94 / 2) * g - (18 / 2) * b + 0x8080) >> 8); +} +#endif + +// ARGBToY_C and ARGBToUV_C +// Intel version mimic SSE/AVX which does 2 pavgb +#if LIBYUV_ARGBTOUV_PAVGB +#define MAKEROWY(NAME, R, G, B, BPP) \ + void NAME##ToYRow_C(const uint8_t* src_rgb, uint8_t* dst_y, int width) { \ + int x; \ + for (x = 0; x < width; ++x) { \ + dst_y[0] = RGBToY(src_rgb[R], src_rgb[G], src_rgb[B]); \ + src_rgb += BPP; \ + dst_y += 1; \ + } \ + } \ + void NAME##ToUVRow_C(const uint8_t* src_rgb, int src_stride_rgb, \ + uint8_t* dst_u, uint8_t* dst_v, int width) { \ + const uint8_t* src_rgb1 = src_rgb + src_stride_rgb; \ + int x; \ + for (x = 0; x < width - 1; x += 2) { \ + uint8_t ab = AVGB(AVGB(src_rgb[B], src_rgb1[B]), \ + AVGB(src_rgb[B + BPP], src_rgb1[B + BPP])); \ + uint8_t ag = AVGB(AVGB(src_rgb[G], src_rgb1[G]), \ + AVGB(src_rgb[G + BPP], src_rgb1[G + BPP])); \ + uint8_t ar = AVGB(AVGB(src_rgb[R], src_rgb1[R]), \ + AVGB(src_rgb[R + BPP], src_rgb1[R + BPP])); \ + dst_u[0] = RGBToU(ar, ag, ab); \ + dst_v[0] = RGBToV(ar, ag, ab); \ + src_rgb += BPP * 2; \ + src_rgb1 += BPP * 2; \ + dst_u += 1; \ + dst_v += 1; \ + } \ + if (width & 1) { \ + uint8_t ab = AVGB(src_rgb[B], src_rgb1[B]); \ + uint8_t ag = AVGB(src_rgb[G], src_rgb1[G]); \ + uint8_t ar = AVGB(src_rgb[R], src_rgb1[R]); \ + dst_u[0] = RGBToU(ar, ag, ab); \ + dst_v[0] = RGBToV(ar, ag, ab); \ + } \ + } +#else +// ARM version does sum / 2 then multiply by 2x smaller coefficients +#define MAKEROWY(NAME, R, G, B, BPP) \ + void NAME##ToYRow_C(const uint8_t* src_rgb, uint8_t* dst_y, int width) { \ + int x; \ + for (x = 0; x < width; ++x) { \ + dst_y[0] = RGBToY(src_rgb[R], src_rgb[G], src_rgb[B]); \ + src_rgb += BPP; \ + dst_y += 1; \ + } \ + } \ + void NAME##ToUVRow_C(const uint8_t* src_rgb, int src_stride_rgb, \ + uint8_t* dst_u, uint8_t* dst_v, int width) { \ + const uint8_t* src_rgb1 = src_rgb + src_stride_rgb; \ + int x; \ + for (x = 0; x < width - 1; x += 2) { \ + uint16_t ab = (src_rgb[B] + src_rgb[B + BPP] + src_rgb1[B] + \ + src_rgb1[B + BPP] + 1) >> \ + 1; \ + uint16_t ag = (src_rgb[G] + src_rgb[G + BPP] + src_rgb1[G] + \ + src_rgb1[G + BPP] + 1) >> \ + 1; \ + uint16_t ar = (src_rgb[R] + src_rgb[R + BPP] + src_rgb1[R] + \ + src_rgb1[R + BPP] + 1) >> \ + 1; \ + dst_u[0] = RGB2xToU(ar, ag, ab); \ + dst_v[0] = RGB2xToV(ar, ag, ab); \ + src_rgb += BPP * 2; \ + src_rgb1 += BPP * 2; \ + dst_u += 1; \ + dst_v += 1; \ + } \ + if (width & 1) { \ + uint16_t ab = src_rgb[B] + src_rgb1[B]; \ + uint16_t ag = src_rgb[G] + src_rgb1[G]; \ + uint16_t ar = src_rgb[R] + src_rgb1[R]; \ + dst_u[0] = RGB2xToU(ar, ag, ab); \ + dst_v[0] = RGB2xToV(ar, ag, ab); \ + } \ + } +#endif + +MAKEROWY(ARGB, 2, 1, 0, 4) + +MAKEROWY(BGRA, 1, 2, 3, 4) + +MAKEROWY(ABGR, 0, 1, 2, 4) + +MAKEROWY(RGBA, 3, 2, 1, 4) + +#undef MAKEROWY + +// JPeg uses a variation on BT.601-1 full range +// y = 0.29900 * r + 0.58700 * g + 0.11400 * b +// u = -0.16874 * r - 0.33126 * g + 0.50000 * b + center +// v = 0.50000 * r - 0.41869 * g - 0.08131 * b + center +// BT.601 Mpeg range uses: +// b 0.1016 * 255 = 25.908 = 25 +// g 0.5078 * 255 = 129.489 = 129 +// r 0.2578 * 255 = 65.739 = 66 +// JPeg 7 bit Y (deprecated) +// b 0.11400 * 128 = 14.592 = 15 +// g 0.58700 * 128 = 75.136 = 75 +// r 0.29900 * 128 = 38.272 = 38 +// JPeg 8 bit Y: +// b 0.11400 * 256 = 29.184 = 29 +// g 0.58700 * 256 = 150.272 = 150 +// r 0.29900 * 256 = 76.544 = 77 +// JPeg 8 bit U: +// b 0.50000 * 255 = 127.5 = 127 +// g -0.33126 * 255 = -84.4713 = -84 +// r -0.16874 * 255 = -43.0287 = -43 +// JPeg 8 bit V: +// b -0.08131 * 255 = -20.73405 = -20 +// g -0.41869 * 255 = -106.76595 = -107 +// r 0.50000 * 255 = 127.5 = 127 + +// 8 bit +static __inline uint8_t RGBToYJ(uint8_t r, uint8_t g, uint8_t b) { + return (77 * r + 150 * g + 29 * b + 128) >> 8; +} + +#if defined(LIBYUV_ARGBTOUV_PAVGB) + +static __inline uint8_t RGBToUJ(uint8_t r, uint8_t g, uint8_t b) { + return (127 * b - 84 * g - 43 * r + 0x8080) >> 8; +} + +static __inline uint8_t RGBToVJ(uint8_t r, uint8_t g, uint8_t b) { + return (127 * r - 107 * g - 20 * b + 0x8080) >> 8; +} + +#else +static __inline uint8_t RGB2xToUJ(uint16_t r, uint16_t g, uint16_t b) { + return ((127 / 2) * b - (84 / 2) * g - (43 / 2) * r + 0x8080) >> 8; +} +static __inline uint8_t RGB2xToVJ(uint16_t r, uint16_t g, uint16_t b) { + return ((127 / 2) * r - (107 / 2) * g - (20 / 2) * b + 0x8080) >> 8; +} +#endif + +// ARGBToYJ_C and ARGBToUVJ_C +// Intel version mimic SSE/AVX which does 2 pavgb +#if LIBYUV_ARGBTOUV_PAVGB +#define MAKEROWYJ(NAME, R, G, B, BPP) \ + void NAME##ToYJRow_C(const uint8_t* src_rgb, uint8_t* dst_y, int width) { \ + int x; \ + for (x = 0; x < width; ++x) { \ + dst_y[0] = RGBToYJ(src_rgb[R], src_rgb[G], src_rgb[B]); \ + src_rgb += BPP; \ + dst_y += 1; \ + } \ + } \ + void NAME##ToUVJRow_C(const uint8_t* src_rgb, int src_stride_rgb, \ + uint8_t* dst_u, uint8_t* dst_v, int width) { \ + const uint8_t* src_rgb1 = src_rgb + src_stride_rgb; \ + int x; \ + for (x = 0; x < width - 1; x += 2) { \ + uint8_t ab = AVGB(AVGB(src_rgb[B], src_rgb1[B]), \ + AVGB(src_rgb[B + BPP], src_rgb1[B + BPP])); \ + uint8_t ag = AVGB(AVGB(src_rgb[G], src_rgb1[G]), \ + AVGB(src_rgb[G + BPP], src_rgb1[G + BPP])); \ + uint8_t ar = AVGB(AVGB(src_rgb[R], src_rgb1[R]), \ + AVGB(src_rgb[R + BPP], src_rgb1[R + BPP])); \ + dst_u[0] = RGBToUJ(ar, ag, ab); \ + dst_v[0] = RGBToVJ(ar, ag, ab); \ + src_rgb += BPP * 2; \ + src_rgb1 += BPP * 2; \ + dst_u += 1; \ + dst_v += 1; \ + } \ + if (width & 1) { \ + uint8_t ab = AVGB(src_rgb[B], src_rgb1[B]); \ + uint8_t ag = AVGB(src_rgb[G], src_rgb1[G]); \ + uint8_t ar = AVGB(src_rgb[R], src_rgb1[R]); \ + dst_u[0] = RGBToUJ(ar, ag, ab); \ + dst_v[0] = RGBToVJ(ar, ag, ab); \ + } \ + } +#else +// ARM version does sum / 2 then multiply by 2x smaller coefficients +#define MAKEROWYJ(NAME, R, G, B, BPP) \ + void NAME##ToYJRow_C(const uint8_t* src_rgb, uint8_t* dst_y, int width) { \ + int x; \ + for (x = 0; x < width; ++x) { \ + dst_y[0] = RGBToYJ(src_rgb[R], src_rgb[G], src_rgb[B]); \ + src_rgb += BPP; \ + dst_y += 1; \ + } \ + } \ + void NAME##ToUVJRow_C(const uint8_t* src_rgb, int src_stride_rgb, \ + uint8_t* dst_u, uint8_t* dst_v, int width) { \ + const uint8_t* src_rgb1 = src_rgb + src_stride_rgb; \ + int x; \ + for (x = 0; x < width - 1; x += 2) { \ + uint16_t ab = (src_rgb[B] + src_rgb[B + BPP] + src_rgb1[B] + \ + src_rgb1[B + BPP] + 1) >> \ + 1; \ + uint16_t ag = (src_rgb[G] + src_rgb[G + BPP] + src_rgb1[G] + \ + src_rgb1[G + BPP] + 1) >> \ + 1; \ + uint16_t ar = (src_rgb[R] + src_rgb[R + BPP] + src_rgb1[R] + \ + src_rgb1[R + BPP] + 1) >> \ + 1; \ + dst_u[0] = RGB2xToUJ(ar, ag, ab); \ + dst_v[0] = RGB2xToVJ(ar, ag, ab); \ + src_rgb += BPP * 2; \ + src_rgb1 += BPP * 2; \ + dst_u += 1; \ + dst_v += 1; \ + } \ + if (width & 1) { \ + uint16_t ab = (src_rgb[B] + src_rgb1[B]); \ + uint16_t ag = (src_rgb[G] + src_rgb1[G]); \ + uint16_t ar = (src_rgb[R] + src_rgb1[R]); \ + dst_u[0] = RGB2xToUJ(ar, ag, ab); \ + dst_v[0] = RGB2xToVJ(ar, ag, ab); \ + } \ + } + +#endif + +MAKEROWYJ(ARGB, 2, 1, 0, 4) + +MAKEROWYJ(ABGR, 0, 1, 2, 4) + +MAKEROWYJ(RGBA, 3, 2, 1, 4) + +MAKEROWYJ(RGB24, 2, 1, 0, 3) + +MAKEROWYJ(RAW, 0, 1, 2, 3) + +#undef MAKEROWYJ + +void RGB565ToYRow_C(const uint8_t *src_rgb565, uint8_t *dst_y, int width) { + int x; + for (x = 0; x < width; ++x) { + uint8_t b = src_rgb565[0] & 0x1f; + uint8_t g = STATIC_CAST( + uint8_t, (src_rgb565[0] >> 5) | ((src_rgb565[1] & 0x07) << 3)); + uint8_t r = src_rgb565[1] >> 3; + b = STATIC_CAST(uint8_t, (b << 3) | (b >> 2)); + g = STATIC_CAST(uint8_t, (g << 2) | (g >> 4)); + r = STATIC_CAST(uint8_t, (r << 3) | (r >> 2)); + dst_y[0] = RGBToY(r, g, b); + src_rgb565 += 2; + dst_y += 1; + } +} + +void RGB565ToUVRow_C(const uint8_t *src_rgb565, + int src_stride_rgb565, + uint8_t *dst_u, + uint8_t *dst_v, + int width) { + const uint8_t *next_rgb565 = src_rgb565 + src_stride_rgb565; + int x; + for (x = 0; x < width - 1; x += 2) { + uint8_t b0 = STATIC_CAST(uint8_t, src_rgb565[0] & 0x1f); + uint8_t g0 = STATIC_CAST( + uint8_t, (src_rgb565[0] >> 5) | ((src_rgb565[1] & 0x07) << 3)); + uint8_t r0 = STATIC_CAST(uint8_t, src_rgb565[1] >> 3); + uint8_t b1 = STATIC_CAST(uint8_t, src_rgb565[2] & 0x1f); + uint8_t g1 = STATIC_CAST( + uint8_t, (src_rgb565[2] >> 5) | ((src_rgb565[3] & 0x07) << 3)); + uint8_t r1 = STATIC_CAST(uint8_t, src_rgb565[3] >> 3); + uint8_t b2 = STATIC_CAST(uint8_t, next_rgb565[0] & 0x1f); + uint8_t g2 = STATIC_CAST( + uint8_t, (next_rgb565[0] >> 5) | ((next_rgb565[1] & 0x07) << 3)); + uint8_t r2 = STATIC_CAST(uint8_t, next_rgb565[1] >> 3); + uint8_t b3 = STATIC_CAST(uint8_t, next_rgb565[2] & 0x1f); + uint8_t g3 = STATIC_CAST( + uint8_t, (next_rgb565[2] >> 5) | ((next_rgb565[3] & 0x07) << 3)); + uint8_t r3 = STATIC_CAST(uint8_t, next_rgb565[3] >> 3); + + b0 = STATIC_CAST(uint8_t, (b0 << 3) | (b0 >> 2)); + g0 = STATIC_CAST(uint8_t, (g0 << 2) | (g0 >> 4)); + r0 = STATIC_CAST(uint8_t, (r0 << 3) | (r0 >> 2)); + b1 = STATIC_CAST(uint8_t, (b1 << 3) | (b1 >> 2)); + g1 = STATIC_CAST(uint8_t, (g1 << 2) | (g1 >> 4)); + r1 = STATIC_CAST(uint8_t, (r1 << 3) | (r1 >> 2)); + b2 = STATIC_CAST(uint8_t, (b2 << 3) | (b2 >> 2)); + g2 = STATIC_CAST(uint8_t, (g2 << 2) | (g2 >> 4)); + r2 = STATIC_CAST(uint8_t, (r2 << 3) | (r2 >> 2)); + b3 = STATIC_CAST(uint8_t, (b3 << 3) | (b3 >> 2)); + g3 = STATIC_CAST(uint8_t, (g3 << 2) | (g3 >> 4)); + r3 = STATIC_CAST(uint8_t, (r3 << 3) | (r3 >> 2)); + +#if LIBYUV_ARGBTOUV_PAVGB + uint8_t ab = AVGB(AVGB(b0, b2), AVGB(b1, b3)); + uint8_t ag = AVGB(AVGB(g0, g2), AVGB(g1, g3)); + uint8_t ar = AVGB(AVGB(r0, r2), AVGB(r1, r3)); + dst_u[0] = RGBToU(ar, ag, ab); + dst_v[0] = RGBToV(ar, ag, ab); +#else + uint16_t b = (b0 + b1 + b2 + b3 + 1) >> 1; + uint16_t g = (g0 + g1 + g2 + g3 + 1) >> 1; + uint16_t r = (r0 + r1 + r2 + r3 + 1) >> 1; + dst_u[0] = RGB2xToU(r, g, b); + dst_v[0] = RGB2xToV(r, g, b); +#endif + + src_rgb565 += 4; + next_rgb565 += 4; + dst_u += 1; + dst_v += 1; + } + if (width & 1) { + uint8_t b0 = STATIC_CAST(uint8_t, src_rgb565[0] & 0x1f); + uint8_t g0 = STATIC_CAST( + uint8_t, (src_rgb565[0] >> 5) | ((src_rgb565[1] & 0x07) << 3)); + uint8_t r0 = STATIC_CAST(uint8_t, src_rgb565[1] >> 3); + uint8_t b2 = STATIC_CAST(uint8_t, next_rgb565[0] & 0x1f); + uint8_t g2 = STATIC_CAST( + uint8_t, (next_rgb565[0] >> 5) | ((next_rgb565[1] & 0x07) << 3)); + uint8_t r2 = STATIC_CAST(uint8_t, next_rgb565[1] >> 3); + b0 = STATIC_CAST(uint8_t, (b0 << 3) | (b0 >> 2)); + g0 = STATIC_CAST(uint8_t, (g0 << 2) | (g0 >> 4)); + r0 = STATIC_CAST(uint8_t, (r0 << 3) | (r0 >> 2)); + b2 = STATIC_CAST(uint8_t, (b2 << 3) | (b2 >> 2)); + g2 = STATIC_CAST(uint8_t, (g2 << 2) | (g2 >> 4)); + r2 = STATIC_CAST(uint8_t, (r2 << 3) | (r2 >> 2)); + +#if LIBYUV_ARGBTOUV_PAVGB + uint8_t ab = AVGB(b0, b2); + uint8_t ag = AVGB(g0, g2); + uint8_t ar = AVGB(r0, r2); + dst_u[0] = RGBToU(ar, ag, ab); + dst_v[0] = RGBToV(ar, ag, ab); +#else + uint16_t b = b0 + b2; + uint16_t g = g0 + g2; + uint16_t r = r0 + r2; + dst_u[0] = RGB2xToU(r, g, b); + dst_v[0] = RGB2xToV(r, g, b); +#endif + } +} + +#define REPEAT8(v) (v) | ((v) << 8) +#define SHADE(f, v) v* f >> 24 + +#undef REPEAT8 +#undef SHADE + +#define REPEAT8(v) (v) | ((v) << 8) +#define SHADE(f, v) v* f >> 16 + +#undef REPEAT8 +#undef SHADE + +#define SHADE(f, v) clamp255(v + f) + +#undef SHADE + +#define SHADE(f, v) clamp0(f - v) + +#undef SHADE + +// Macros to create SIMD specific yuv to rgb conversion constants. + +// clang-format off + +#if defined(__aarch64__) || defined(__arm__) +// Bias values include subtract 128 from U and V, bias from Y and rounding. +// For B and R bias is negative. For G bias is positive. +#define YUVCONSTANTSBODY(YG, YB, UB, UG, VG, VR) \ + {{UB, VR, UG, VG, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}, \ + {YG, (UB * 128 - YB), (UG * 128 + VG * 128 + YB), (VR * 128 - YB), YB, 0, \ + 0, 0}} +#else +#define YUVCONSTANTSBODY(YG, YB, UB, UG, VG, VR) \ + {{UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, \ + UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0}, \ + {UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, \ + UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG}, \ + {0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, \ + 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR}, \ + {YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG}, \ + {YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB}} +#endif + +// clang-format on + +#define MAKEYUVCONSTANTS(name, YG, YB, UB, UG, VG, VR) \ + const struct YuvConstants SIMD_ALIGNED(kYuv##name##Constants) = \ + YUVCONSTANTSBODY(YG, YB, UB, UG, VG, VR); \ + const struct YuvConstants SIMD_ALIGNED(kYvu##name##Constants) = \ + YUVCONSTANTSBODY(YG, YB, VR, VG, UG, UB); + +// TODO(fbarchard): Generate SIMD structures from float matrix. + +// BT.601 limited range YUV to RGB reference +// R = (Y - 16) * 1.164 + V * 1.596 +// G = (Y - 16) * 1.164 - U * 0.391 - V * 0.813 +// B = (Y - 16) * 1.164 + U * 2.018 +// KR = 0.299; KB = 0.114 + +// U and V contributions to R,G,B. +#if defined(LIBYUV_UNLIMITED_DATA) || defined(LIBYUV_UNLIMITED_BT601) +#define UB 129 /* round(2.018 * 64) */ +#else +#define UB 128 /* max(128, round(2.018 * 64)) */ +#endif +#define UG 25 /* round(0.391 * 64) */ +#define VG 52 /* round(0.813 * 64) */ +#define VR 102 /* round(1.596 * 64) */ + +// Y contribution to R,G,B. Scale and bias. +#define YG 18997 /* round(1.164 * 64 * 256 * 256 / 257) */ +#define YB -1160 /* 1.164 * 64 * -16 + 64 / 2 */ + +MAKEYUVCONSTANTS(I601, YG, YB, UB, UG, VG, VR) + +#undef YG +#undef YB +#undef UB +#undef UG +#undef VG +#undef VR + +// BT.601 full range YUV to RGB reference (aka JPEG) +// * R = Y + V * 1.40200 +// * G = Y - U * 0.34414 - V * 0.71414 +// * B = Y + U * 1.77200 +// KR = 0.299; KB = 0.114 + +// U and V contributions to R,G,B. +#define UB 113 /* round(1.77200 * 64) */ +#define UG 22 /* round(0.34414 * 64) */ +#define VG 46 /* round(0.71414 * 64) */ +#define VR 90 /* round(1.40200 * 64) */ + +// Y contribution to R,G,B. Scale and bias. +#define YG 16320 /* round(1.000 * 64 * 256 * 256 / 257) */ +#define YB 32 /* 64 / 2 */ + +MAKEYUVCONSTANTS(JPEG, YG, YB, UB, UG, VG, VR) + +#undef YG +#undef YB +#undef UB +#undef UG +#undef VG +#undef VR + +// BT.709 limited range YUV to RGB reference +// R = (Y - 16) * 1.164 + V * 1.793 +// G = (Y - 16) * 1.164 - U * 0.213 - V * 0.533 +// B = (Y - 16) * 1.164 + U * 2.112 +// KR = 0.2126, KB = 0.0722 + +// U and V contributions to R,G,B. +#if defined(LIBYUV_UNLIMITED_DATA) || defined(LIBYUV_UNLIMITED_BT709) +#define UB 135 /* round(2.112 * 64) */ +#else +#define UB 128 /* max(128, round(2.112 * 64)) */ +#endif +#define UG 14 /* round(0.213 * 64) */ +#define VG 34 /* round(0.533 * 64) */ +#define VR 115 /* round(1.793 * 64) */ + +// Y contribution to R,G,B. Scale and bias. +#define YG 18997 /* round(1.164 * 64 * 256 * 256 / 257) */ +#define YB -1160 /* 1.164 * 64 * -16 + 64 / 2 */ + +MAKEYUVCONSTANTS(H709, YG, YB, UB, UG, VG, VR) + +#undef YG +#undef YB +#undef UB +#undef UG +#undef VG +#undef VR + +// BT.709 full range YUV to RGB reference +// R = Y + V * 1.5748 +// G = Y - U * 0.18732 - V * 0.46812 +// B = Y + U * 1.8556 +// KR = 0.2126, KB = 0.0722 + +// U and V contributions to R,G,B. +#define UB 119 /* round(1.8556 * 64) */ +#define UG 12 /* round(0.18732 * 64) */ +#define VG 30 /* round(0.46812 * 64) */ +#define VR 101 /* round(1.5748 * 64) */ + +// Y contribution to R,G,B. Scale and bias. (same as jpeg) +#define YG 16320 /* round(1 * 64 * 256 * 256 / 257) */ +#define YB 32 /* 64 / 2 */ + +MAKEYUVCONSTANTS(F709, YG, YB, UB, UG, VG, VR) + +#undef YG +#undef YB +#undef UB +#undef UG +#undef VG +#undef VR + +// BT.2020 limited range YUV to RGB reference +// R = (Y - 16) * 1.164384 + V * 1.67867 +// G = (Y - 16) * 1.164384 - U * 0.187326 - V * 0.65042 +// B = (Y - 16) * 1.164384 + U * 2.14177 +// KR = 0.2627; KB = 0.0593 + +// U and V contributions to R,G,B. +#if defined(LIBYUV_UNLIMITED_DATA) || defined(LIBYUV_UNLIMITED_BT2020) +#define UB 137 /* round(2.142 * 64) */ +#else +#define UB 128 /* max(128, round(2.142 * 64)) */ +#endif +#define UG 12 /* round(0.187326 * 64) */ +#define VG 42 /* round(0.65042 * 64) */ +#define VR 107 /* round(1.67867 * 64) */ + +// Y contribution to R,G,B. Scale and bias. +#define YG 19003 /* round(1.164384 * 64 * 256 * 256 / 257) */ +#define YB -1160 /* 1.164384 * 64 * -16 + 64 / 2 */ + +MAKEYUVCONSTANTS(2020, YG, YB, UB, UG, VG, VR) + +#undef YG +#undef YB +#undef UB +#undef UG +#undef VG +#undef VR + +// BT.2020 full range YUV to RGB reference +// R = Y + V * 1.474600 +// G = Y - U * 0.164553 - V * 0.571353 +// B = Y + U * 1.881400 +// KR = 0.2627; KB = 0.0593 + +#define UB 120 /* round(1.881400 * 64) */ +#define UG 11 /* round(0.164553 * 64) */ +#define VG 37 /* round(0.571353 * 64) */ +#define VR 94 /* round(1.474600 * 64) */ + +// Y contribution to R,G,B. Scale and bias. (same as jpeg) +#define YG 16320 /* round(1 * 64 * 256 * 256 / 257) */ +#define YB 32 /* 64 / 2 */ + +MAKEYUVCONSTANTS(V2020, YG, YB, UB, UG, VG, VR) + +#undef YG +#undef YB +#undef UB +#undef UG +#undef VG +#undef VR + +#undef BB +#undef BG +#undef BR + +#undef MAKEYUVCONSTANTS + +#if defined(__aarch64__) || defined(__arm__) +#define LOAD_YUV_CONSTANTS \ + int ub = yuvconstants->kUVCoeff[0]; \ + int vr = yuvconstants->kUVCoeff[1]; \ + int ug = yuvconstants->kUVCoeff[2]; \ + int vg = yuvconstants->kUVCoeff[3]; \ + int yg = yuvconstants->kRGBCoeffBias[0]; \ + int bb = yuvconstants->kRGBCoeffBias[1]; \ + int bg = yuvconstants->kRGBCoeffBias[2]; \ + int br = yuvconstants->kRGBCoeffBias[3] + +#define CALC_RGB16 \ + int32_t y1 = (uint32_t)(y32 * yg) >> 16; \ + int b16 = y1 + (u * ub) - bb; \ + int g16 = y1 + bg - (u * ug + v * vg); \ + int r16 = y1 + (v * vr) - br +#else +#define LOAD_YUV_CONSTANTS \ + int ub = yuvconstants->kUVToB[0]; \ + int ug = yuvconstants->kUVToG[0]; \ + int vg = yuvconstants->kUVToG[1]; \ + int vr = yuvconstants->kUVToR[1]; \ + int yg = yuvconstants->kYToRgb[0]; \ + int yb = yuvconstants->kYBiasToRgb[0] + +#define CALC_RGB16 \ + int32_t y1 = ((uint32_t)(y32 * yg) >> 16) + yb; \ + int8_t ui = (int8_t)u; \ + int8_t vi = (int8_t)v; \ + ui -= 0x80; \ + vi -= 0x80; \ + int b16 = y1 + (ui * ub); \ + int g16 = y1 - (ui * ug + vi * vg); \ + int r16 = y1 + (vi * vr) +#endif + +void MirrorRow_C(const uint8_t *src, uint8_t *dst, int width) { + int x; + src += width - 1; + for (x = 0; x < width - 1; x += 2) { + dst[x] = src[0]; + dst[x + 1] = src[-1]; + src -= 2; + } + if (width & 1) { + dst[width - 1] = src[0]; + } +} + +// Use scale to convert lsb formats to msb, depending how many bits there are: +// 32768 = 9 bits +// 16384 = 10 bits +// 4096 = 12 bits +// 256 = 16 bits +// TODO(fbarchard): change scale to bits +#define C16TO8(v, scale) clamp255(((v) * (scale)) >> 16) + +void CopyRow_C(const uint8_t *src, uint8_t *dst, int count) { + memcpy(dst, src, count); +} + +// Divide source RGB by alpha and store to destination. +// b = (b * 255 + (a / 2)) / a; +// g = (g * 255 + (a / 2)) / a; +// r = (r * 255 + (a / 2)) / a; +// Reciprocal method is off by 1 on some values. ie 125 +// 8.8 fixed point inverse table with 1.0 in upper short and 1 / a in lower. +#define T(a) 0x01000000 + (0x10000 / a) +const uint32_t fixed_invtbl8[256] = { + 0x01000000, 0x0100ffff, T(0x02), T(0x03), T(0x04), T(0x05), T(0x06), + T(0x07), T(0x08), T(0x09), T(0x0a), T(0x0b), T(0x0c), T(0x0d), + T(0x0e), T(0x0f), T(0x10), T(0x11), T(0x12), T(0x13), T(0x14), + T(0x15), T(0x16), T(0x17), T(0x18), T(0x19), T(0x1a), T(0x1b), + T(0x1c), T(0x1d), T(0x1e), T(0x1f), T(0x20), T(0x21), T(0x22), + T(0x23), T(0x24), T(0x25), T(0x26), T(0x27), T(0x28), T(0x29), + T(0x2a), T(0x2b), T(0x2c), T(0x2d), T(0x2e), T(0x2f), T(0x30), + T(0x31), T(0x32), T(0x33), T(0x34), T(0x35), T(0x36), T(0x37), + T(0x38), T(0x39), T(0x3a), T(0x3b), T(0x3c), T(0x3d), T(0x3e), + T(0x3f), T(0x40), T(0x41), T(0x42), T(0x43), T(0x44), T(0x45), + T(0x46), T(0x47), T(0x48), T(0x49), T(0x4a), T(0x4b), T(0x4c), + T(0x4d), T(0x4e), T(0x4f), T(0x50), T(0x51), T(0x52), T(0x53), + T(0x54), T(0x55), T(0x56), T(0x57), T(0x58), T(0x59), T(0x5a), + T(0x5b), T(0x5c), T(0x5d), T(0x5e), T(0x5f), T(0x60), T(0x61), + T(0x62), T(0x63), T(0x64), T(0x65), T(0x66), T(0x67), T(0x68), + T(0x69), T(0x6a), T(0x6b), T(0x6c), T(0x6d), T(0x6e), T(0x6f), + T(0x70), T(0x71), T(0x72), T(0x73), T(0x74), T(0x75), T(0x76), + T(0x77), T(0x78), T(0x79), T(0x7a), T(0x7b), T(0x7c), T(0x7d), + T(0x7e), T(0x7f), T(0x80), T(0x81), T(0x82), T(0x83), T(0x84), + T(0x85), T(0x86), T(0x87), T(0x88), T(0x89), T(0x8a), T(0x8b), + T(0x8c), T(0x8d), T(0x8e), T(0x8f), T(0x90), T(0x91), T(0x92), + T(0x93), T(0x94), T(0x95), T(0x96), T(0x97), T(0x98), T(0x99), + T(0x9a), T(0x9b), T(0x9c), T(0x9d), T(0x9e), T(0x9f), T(0xa0), + T(0xa1), T(0xa2), T(0xa3), T(0xa4), T(0xa5), T(0xa6), T(0xa7), + T(0xa8), T(0xa9), T(0xaa), T(0xab), T(0xac), T(0xad), T(0xae), + T(0xaf), T(0xb0), T(0xb1), T(0xb2), T(0xb3), T(0xb4), T(0xb5), + T(0xb6), T(0xb7), T(0xb8), T(0xb9), T(0xba), T(0xbb), T(0xbc), + T(0xbd), T(0xbe), T(0xbf), T(0xc0), T(0xc1), T(0xc2), T(0xc3), + T(0xc4), T(0xc5), T(0xc6), T(0xc7), T(0xc8), T(0xc9), T(0xca), + T(0xcb), T(0xcc), T(0xcd), T(0xce), T(0xcf), T(0xd0), T(0xd1), + T(0xd2), T(0xd3), T(0xd4), T(0xd5), T(0xd6), T(0xd7), T(0xd8), + T(0xd9), T(0xda), T(0xdb), T(0xdc), T(0xdd), T(0xde), T(0xdf), + T(0xe0), T(0xe1), T(0xe2), T(0xe3), T(0xe4), T(0xe5), T(0xe6), + T(0xe7), T(0xe8), T(0xe9), T(0xea), T(0xeb), T(0xec), T(0xed), + T(0xee), T(0xef), T(0xf0), T(0xf1), T(0xf2), T(0xf3), T(0xf4), + T(0xf5), T(0xf6), T(0xf7), T(0xf8), T(0xf9), T(0xfa), T(0xfb), + T(0xfc), T(0xfd), T(0xfe), 0x01000100}; +#undef T + +// Blend 2 rows into 1. +static void HalfRow_C(const uint8_t *src_uv, + ptrdiff_t src_uv_stride, + uint8_t *dst_uv, + int width) { + int x; + for (x = 0; x < width; ++x) { + dst_uv[x] = (src_uv[x] + src_uv[src_uv_stride + x] + 1) >> 1; + } +} + +// C version 2x2 -> 2x1. +void InterpolateRow_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + ptrdiff_t src_stride, + int width, + int source_y_fraction) { + int y1_fraction = source_y_fraction; + int y0_fraction = 256 - y1_fraction; + const uint8_t *src_ptr1 = src_ptr + src_stride; + int x; + assert(source_y_fraction >= 0); + assert(source_y_fraction < 256); + + if (y1_fraction == 0) { + memcpy(dst_ptr, src_ptr, width); + return; + } + if (y1_fraction == 128) { + HalfRow_C(src_ptr, src_stride, dst_ptr, width); + return; + } + for (x = 0; x < width; ++x) { + dst_ptr[0] = STATIC_CAST( + uint8_t, + (src_ptr[0] * y0_fraction + src_ptr1[0] * y1_fraction + 128) >> 8); + ++src_ptr; + ++src_ptr1; + ++dst_ptr; + } +} + +// Work around GCC 7 punning warning -Wstrict-aliasing +#if defined(__GNUC__) +typedef uint32_t __attribute__((__may_alias__)) uint32_alias_t; +#else +typedef uint32_t uint32_alias_t; +#endif + +#undef STATIC_CAST diff --git a/pkg/encoder/yuv/libyuv/row_gcc.c b/pkg/encoder/yuv/libyuv/row_gcc.c new file mode 100644 index 00000000..07e795e6 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/row_gcc.c @@ -0,0 +1,1090 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "row.h" + +// This module is for GCC x86 and x64. +#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) + +#if defined(HAS_ARGBTOYROW_SSSE3) || defined(HAS_ARGBGRAYROW_SSSE3) + +// Constants for ARGB +static const uvec8 kARGBToY = {25u, 129u, 66u, 0u, 25u, 129u, 66u, 0u, + 25u, 129u, 66u, 0u, 25u, 129u, 66u, 0u}; + + +#endif // defined(HAS_ARGBTOYROW_SSSE3) || defined(HAS_ARGBGRAYROW_SSSE3) + +#if defined(HAS_ARGBTOYROW_SSSE3) || defined(HAS_I422TOARGBROW_SSSE3) + +static const vec8 kARGBToU = {112, -74, -38, 0, 112, -74, -38, 0, + 112, -74, -38, 0, 112, -74, -38, 0}; + +static const vec8 kARGBToV = {-18, -94, 112, 0, -18, -94, 112, 0, + -18, -94, 112, 0, -18, -94, 112, 0}; + +// Constants for BGRA +static const uvec8 kBGRAToY = {0u, 66u, 129u, 25u, 0u, 66u, 129u, 25u, + 0u, 66u, 129u, 25u, 0u, 66u, 129u, 25u}; + +static const vec8 kBGRAToU = {0, -38, -74, 112, 0, -38, -74, 112, + 0, -38, -74, 112, 0, -38, -74, 112}; + +static const vec8 kBGRAToV = {0, 112, -94, -18, 0, 112, -94, -18, + 0, 112, -94, -18, 0, 112, -94, -18}; + +// Constants for ABGR +static const uvec8 kABGRToY = {66u, 129u, 25u, 0u, 66u, 129u, 25u, 0u, + 66u, 129u, 25u, 0u, 66u, 129u, 25u, 0u}; + +static const vec8 kABGRToU = {-38, -74, 112, 0, -38, -74, 112, 0, + -38, -74, 112, 0, -38, -74, 112, 0}; + +static const vec8 kABGRToV = {112, -94, -18, 0, 112, -94, -18, 0, + 112, -94, -18, 0, 112, -94, -18, 0}; + +// Constants for RGBA. +//static const uvec8 kRGBAToY = {0u, 25u, 129u, 66u, 0u, 25u, 129u, 66u, +// 0u, 25u, 129u, 66u, 0u, 25u, 129u, 66u}; + +static const vec8 kRGBAToU = {0, 112, -74, -38, 0, 112, -74, -38, + 0, 112, -74, -38, 0, 112, -74, -38}; + +static const vec8 kRGBAToV = {0, -18, -94, 112, 0, -18, -94, 112, + 0, -18, -94, 112, 0, -18, -94, 112}; + +static const uvec16 kAddY16 = {0x7e80u, 0x7e80u, 0x7e80u, 0x7e80u, + 0x7e80u, 0x7e80u, 0x7e80u, 0x7e80u}; + +static const uvec8 kAddUV128 = {128u, 128u, 128u, 128u, 128u, 128u, 128u, 128u, + 128u, 128u, 128u, 128u, 128u, 128u, 128u, 128u}; + +static const uvec16 kSub128 = {0x8080u, 0x8080u, 0x8080u, 0x8080u, + 0x8080u, 0x8080u, 0x8080u, 0x8080u}; + +#endif // defined(HAS_ARGBTOYROW_SSSE3) || defined(HAS_I422TOARGBROW_SSSE3) + +// clang-format off + +// TODO(mraptis): Consider passing R, G, B multipliers as parameter. +// round parameter is register containing value to add before shift. +#define RGBTOY(round) \ + "1: \n" \ + "movdqu (%0),%%xmm0 \n" \ + "movdqu 0x10(%0),%%xmm1 \n" \ + "movdqu 0x20(%0),%%xmm2 \n" \ + "movdqu 0x30(%0),%%xmm3 \n" \ + "psubb %%xmm5,%%xmm0 \n" \ + "psubb %%xmm5,%%xmm1 \n" \ + "psubb %%xmm5,%%xmm2 \n" \ + "psubb %%xmm5,%%xmm3 \n" \ + "movdqu %%xmm4,%%xmm6 \n" \ + "pmaddubsw %%xmm0,%%xmm6 \n" \ + "movdqu %%xmm4,%%xmm0 \n" \ + "pmaddubsw %%xmm1,%%xmm0 \n" \ + "movdqu %%xmm4,%%xmm1 \n" \ + "pmaddubsw %%xmm2,%%xmm1 \n" \ + "movdqu %%xmm4,%%xmm2 \n" \ + "pmaddubsw %%xmm3,%%xmm2 \n" \ + "lea 0x40(%0),%0 \n" \ + "phaddw %%xmm0,%%xmm6 \n" \ + "phaddw %%xmm2,%%xmm1 \n" \ + "prefetcht0 1280(%0) \n" \ + "paddw %%" #round ",%%xmm6 \n" \ + "paddw %%" #round ",%%xmm1 \n" \ + "psrlw $0x8,%%xmm6 \n" \ + "psrlw $0x8,%%xmm1 \n" \ + "packuswb %%xmm1,%%xmm6 \n" \ + "movdqu %%xmm6,(%1) \n" \ + "lea 0x10(%1),%1 \n" \ + "sub $0x10,%2 \n" \ + "jg 1b \n" + +#define RGBTOY_AVX2(round) \ + "1: \n" \ + "vmovdqu (%0),%%ymm0 \n" \ + "vmovdqu 0x20(%0),%%ymm1 \n" \ + "vmovdqu 0x40(%0),%%ymm2 \n" \ + "vmovdqu 0x60(%0),%%ymm3 \n" \ + "vpsubb %%ymm5, %%ymm0, %%ymm0 \n" \ + "vpsubb %%ymm5, %%ymm1, %%ymm1 \n" \ + "vpsubb %%ymm5, %%ymm2, %%ymm2 \n" \ + "vpsubb %%ymm5, %%ymm3, %%ymm3 \n" \ + "vpmaddubsw %%ymm0,%%ymm4,%%ymm0 \n" \ + "vpmaddubsw %%ymm1,%%ymm4,%%ymm1 \n" \ + "vpmaddubsw %%ymm2,%%ymm4,%%ymm2 \n" \ + "vpmaddubsw %%ymm3,%%ymm4,%%ymm3 \n" \ + "lea 0x80(%0),%0 \n" \ + "vphaddw %%ymm1,%%ymm0,%%ymm0 \n" /* mutates. */ \ + "vphaddw %%ymm3,%%ymm2,%%ymm2 \n" \ + "prefetcht0 1280(%0) \n" \ + "vpaddw %%" #round ",%%ymm0,%%ymm0 \n" /* Add .5 for rounding. */ \ + "vpaddw %%" #round ",%%ymm2,%%ymm2 \n" \ + "vpsrlw $0x8,%%ymm0,%%ymm0 \n" \ + "vpsrlw $0x8,%%ymm2,%%ymm2 \n" \ + "vpackuswb %%ymm2,%%ymm0,%%ymm0 \n" /* mutates. */ \ + "vpermd %%ymm0,%%ymm6,%%ymm0 \n" /* unmutate. */ \ + "vmovdqu %%ymm0,(%1) \n" \ + "lea 0x20(%1),%1 \n" \ + "sub $0x20,%2 \n" \ + "jg 1b \n" \ + "vzeroupper \n" + +// clang-format on + +#ifdef HAS_ARGBTOYROW_SSSE3 + +// Convert 16 ARGB pixels (64 bytes) to 16 Y values. +void ARGBToYRow_SSSE3(const uint8_t *src_argb, uint8_t *dst_y, int width) { + asm volatile( + "movdqa %3,%%xmm4 \n" + "movdqa %4,%%xmm5 \n" + "movdqa %5,%%xmm7 \n" + + LABELALIGN RGBTOY(xmm7) + : "+r"(src_argb), // %0 + "+r"(dst_y), // %1 + "+r"(width) // %2 + : "m"(kARGBToY), // %3 + "m"(kSub128), // %4 + "m"(kAddY16) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif // HAS_ARGBTOYROW_SSSE3 + +#if defined(HAS_ARGBTOYROW_AVX2) || defined(HAS_ABGRTOYROW_AVX2) || \ + defined(HAS_ARGBEXTRACTALPHAROW_AVX2) +// vpermd for vphaddw + vpackuswb vpermd. +static const lvec32 kPermdARGBToY_AVX = {0, 4, 1, 5, 2, 6, 3, 7}; +#endif + +#ifdef HAS_ARGBTOYROW_AVX2 + +// Convert 32 ARGB pixels (128 bytes) to 32 Y values. +void ARGBToYRow_AVX2(const uint8_t *src_argb, uint8_t *dst_y, int width) { + asm volatile( + "vbroadcastf128 %3,%%ymm4 \n" + "vbroadcastf128 %4,%%ymm5 \n" + "vbroadcastf128 %5,%%ymm7 \n" + "vmovdqu %6,%%ymm6 \n" LABELALIGN RGBTOY_AVX2( + ymm7) "vzeroupper \n" + : "+r"(src_argb), // %0 + "+r"(dst_y), // %1 + "+r"(width) // %2 + : "m"(kARGBToY), // %3 + "m"(kSub128), // %4 + "m"(kAddY16), // %5 + "m"(kPermdARGBToY_AVX) // %6 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif // HAS_ARGBTOYROW_AVX2 + +#ifdef HAS_ABGRTOYROW_AVX2 + +// Convert 32 ABGR pixels (128 bytes) to 32 Y values. +void ABGRToYRow_AVX2(const uint8_t *src_abgr, uint8_t *dst_y, int width) { + asm volatile( + "vbroadcastf128 %3,%%ymm4 \n" + "vbroadcastf128 %4,%%ymm5 \n" + "vbroadcastf128 %5,%%ymm7 \n" + "vmovdqu %6,%%ymm6 \n" LABELALIGN RGBTOY_AVX2( + ymm7) "vzeroupper \n" + : "+r"(src_abgr), // %0 + "+r"(dst_y), // %1 + "+r"(width) // %2 + : "m"(kABGRToY), // %3 + "m"(kSub128), // %4 + "m"(kAddY16), // %5 + "m"(kPermdARGBToY_AVX) // %6 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif // HAS_ABGRTOYROW_AVX2 + +#ifdef HAS_ARGBTOUVROW_SSSE3 + +void ARGBToUVRow_SSSE3(const uint8_t *src_argb, + int src_stride_argb, + uint8_t *dst_u, + uint8_t *dst_v, + int width) { + asm volatile( + "movdqa %5,%%xmm3 \n" + "movdqa %6,%%xmm4 \n" + "movdqa %7,%%xmm5 \n" + "sub %1,%2 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x00(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "movdqu 0x10(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm1 \n" + "movdqu 0x20(%0),%%xmm2 \n" + "movdqu 0x20(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm2 \n" + "movdqu 0x30(%0),%%xmm6 \n" + "movdqu 0x30(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + + "lea 0x40(%0),%0 \n" + "movdqa %%xmm0,%%xmm7 \n" + "shufps $0x88,%%xmm1,%%xmm0 \n" + "shufps $0xdd,%%xmm1,%%xmm7 \n" + "pavgb %%xmm7,%%xmm0 \n" + "movdqa %%xmm2,%%xmm7 \n" + "shufps $0x88,%%xmm6,%%xmm2 \n" + "shufps $0xdd,%%xmm6,%%xmm7 \n" + "pavgb %%xmm7,%%xmm2 \n" + "movdqa %%xmm0,%%xmm1 \n" + "movdqa %%xmm2,%%xmm6 \n" + "pmaddubsw %%xmm4,%%xmm0 \n" + "pmaddubsw %%xmm4,%%xmm2 \n" + "pmaddubsw %%xmm3,%%xmm1 \n" + "pmaddubsw %%xmm3,%%xmm6 \n" + "phaddw %%xmm2,%%xmm0 \n" + "phaddw %%xmm6,%%xmm1 \n" + "psraw $0x8,%%xmm0 \n" + "psraw $0x8,%%xmm1 \n" + "packsswb %%xmm1,%%xmm0 \n" + "paddb %%xmm5,%%xmm0 \n" + "movlps %%xmm0,(%1) \n" + "movhps %%xmm0,0x00(%1,%2,1) \n" + "lea 0x8(%1),%1 \n" + "sub $0x10,%3 \n" + "jg 1b \n" + : "+r"(src_argb), // %0 + "+r"(dst_u), // %1 + "+r"(dst_v), // %2 + "+rm"(width) // %3 + : "r"((intptr_t) (src_stride_argb)), // %4 + "m"(kARGBToV), // %5 + "m"(kARGBToU), // %6 + "m"(kAddUV128) // %7 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm6", "xmm7"); +} + +#endif // HAS_ARGBTOUVROW_SSSE3 + +#if defined(HAS_ARGBTOUVROW_AVX2) || defined(HAS_ABGRTOUVROW_AVX2) || \ + defined(HAS_ARGBTOUVJROW_AVX2) || defined(HAS_ABGRTOUVJROW_AVX2) +// vpshufb for vphaddw + vpackuswb packed to shorts. +static const lvec8 kShufARGBToUV_AVX = { + 0, 1, 8, 9, 2, 3, 10, 11, 4, 5, 12, 13, 6, 7, 14, 15, + 0, 1, 8, 9, 2, 3, 10, 11, 4, 5, 12, 13, 6, 7, 14, 15}; +#endif + +#if defined(HAS_ARGBTOUVROW_AVX2) + +void ARGBToUVRow_AVX2(const uint8_t *src_argb, + int src_stride_argb, + uint8_t *dst_u, + uint8_t *dst_v, + int width) { + asm volatile( + "vbroadcastf128 %5,%%ymm5 \n" + "vbroadcastf128 %6,%%ymm6 \n" + "vbroadcastf128 %7,%%ymm7 \n" + "sub %1,%2 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" + "vmovdqu 0x20(%0),%%ymm1 \n" + "vmovdqu 0x40(%0),%%ymm2 \n" + "vmovdqu 0x60(%0),%%ymm3 \n" + "vpavgb 0x00(%0,%4,1),%%ymm0,%%ymm0 \n" + "vpavgb 0x20(%0,%4,1),%%ymm1,%%ymm1 \n" + "vpavgb 0x40(%0,%4,1),%%ymm2,%%ymm2 \n" + "vpavgb 0x60(%0,%4,1),%%ymm3,%%ymm3 \n" + "lea 0x80(%0),%0 \n" + "vshufps $0x88,%%ymm1,%%ymm0,%%ymm4 \n" + "vshufps $0xdd,%%ymm1,%%ymm0,%%ymm0 \n" + "vpavgb %%ymm4,%%ymm0,%%ymm0 \n" + "vshufps $0x88,%%ymm3,%%ymm2,%%ymm4 \n" + "vshufps $0xdd,%%ymm3,%%ymm2,%%ymm2 \n" + "vpavgb %%ymm4,%%ymm2,%%ymm2 \n" + + "vpmaddubsw %%ymm7,%%ymm0,%%ymm1 \n" + "vpmaddubsw %%ymm7,%%ymm2,%%ymm3 \n" + "vpmaddubsw %%ymm6,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm6,%%ymm2,%%ymm2 \n" + "vphaddw %%ymm3,%%ymm1,%%ymm1 \n" + "vphaddw %%ymm2,%%ymm0,%%ymm0 \n" + "vpsraw $0x8,%%ymm1,%%ymm1 \n" + "vpsraw $0x8,%%ymm0,%%ymm0 \n" + "vpacksswb %%ymm0,%%ymm1,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vpshufb %8,%%ymm0,%%ymm0 \n" + "vpaddb %%ymm5,%%ymm0,%%ymm0 \n" + + "vextractf128 $0x0,%%ymm0,(%1) \n" + "vextractf128 $0x1,%%ymm0,0x0(%1,%2,1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x20,%3 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_argb), // %0 + "+r"(dst_u), // %1 + "+r"(dst_v), // %2 + "+rm"(width) // %3 + : "r"((intptr_t) (src_stride_argb)), // %4 + "m"(kAddUV128), // %5 + "m"(kARGBToV), // %6 + "m"(kARGBToU), // %7 + "m"(kShufARGBToUV_AVX) // %8 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif // HAS_ARGBTOUVROW_AVX2 + +#ifdef HAS_ABGRTOUVROW_AVX2 + +void ABGRToUVRow_AVX2(const uint8_t *src_abgr, + int src_stride_abgr, + uint8_t *dst_u, + uint8_t *dst_v, + int width) { + asm volatile( + "vbroadcastf128 %5,%%ymm5 \n" + "vbroadcastf128 %6,%%ymm6 \n" + "vbroadcastf128 %7,%%ymm7 \n" + "sub %1,%2 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" + "vmovdqu 0x20(%0),%%ymm1 \n" + "vmovdqu 0x40(%0),%%ymm2 \n" + "vmovdqu 0x60(%0),%%ymm3 \n" + "vpavgb 0x00(%0,%4,1),%%ymm0,%%ymm0 \n" + "vpavgb 0x20(%0,%4,1),%%ymm1,%%ymm1 \n" + "vpavgb 0x40(%0,%4,1),%%ymm2,%%ymm2 \n" + "vpavgb 0x60(%0,%4,1),%%ymm3,%%ymm3 \n" + "lea 0x80(%0),%0 \n" + "vshufps $0x88,%%ymm1,%%ymm0,%%ymm4 \n" + "vshufps $0xdd,%%ymm1,%%ymm0,%%ymm0 \n" + "vpavgb %%ymm4,%%ymm0,%%ymm0 \n" + "vshufps $0x88,%%ymm3,%%ymm2,%%ymm4 \n" + "vshufps $0xdd,%%ymm3,%%ymm2,%%ymm2 \n" + "vpavgb %%ymm4,%%ymm2,%%ymm2 \n" + + "vpmaddubsw %%ymm7,%%ymm0,%%ymm1 \n" + "vpmaddubsw %%ymm7,%%ymm2,%%ymm3 \n" + "vpmaddubsw %%ymm6,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm6,%%ymm2,%%ymm2 \n" + "vphaddw %%ymm3,%%ymm1,%%ymm1 \n" + "vphaddw %%ymm2,%%ymm0,%%ymm0 \n" + "vpsraw $0x8,%%ymm1,%%ymm1 \n" + "vpsraw $0x8,%%ymm0,%%ymm0 \n" + "vpacksswb %%ymm0,%%ymm1,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vpshufb %8,%%ymm0,%%ymm0 \n" + "vpaddb %%ymm5,%%ymm0,%%ymm0 \n" + + "vextractf128 $0x0,%%ymm0,(%1) \n" + "vextractf128 $0x1,%%ymm0,0x0(%1,%2,1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x20,%3 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_abgr), // %0 + "+r"(dst_u), // %1 + "+r"(dst_v), // %2 + "+rm"(width) // %3 + : "r"((intptr_t) (src_stride_abgr)), // %4 + "m"(kAddUV128), // %5 + "m"(kABGRToV), // %6 + "m"(kABGRToU), // %7 + "m"(kShufARGBToUV_AVX) // %8 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif // HAS_ABGRTOUVROW_AVX2 + +void BGRAToYRow_SSSE3(const uint8_t *src_bgra, uint8_t *dst_y, int width) { + asm volatile( + "movdqa %3,%%xmm4 \n" + "movdqa %4,%%xmm5 \n" + "movdqa %5,%%xmm7 \n" + + LABELALIGN RGBTOY(xmm7) + : "+r"(src_bgra), // %0 + "+r"(dst_y), // %1 + "+r"(width) // %2 + : "m"(kBGRAToY), // %3 + "m"(kSub128), // %4 + "m"(kAddY16) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +void BGRAToUVRow_SSSE3(const uint8_t *src_bgra, + int src_stride_bgra, + uint8_t *dst_u, + uint8_t *dst_v, + int width) { + asm volatile( + "movdqa %5,%%xmm3 \n" + "movdqa %6,%%xmm4 \n" + "movdqa %7,%%xmm5 \n" + "sub %1,%2 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x00(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "movdqu 0x10(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm1 \n" + "movdqu 0x20(%0),%%xmm2 \n" + "movdqu 0x20(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm2 \n" + "movdqu 0x30(%0),%%xmm6 \n" + "movdqu 0x30(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + + "lea 0x40(%0),%0 \n" + "movdqa %%xmm0,%%xmm7 \n" + "shufps $0x88,%%xmm1,%%xmm0 \n" + "shufps $0xdd,%%xmm1,%%xmm7 \n" + "pavgb %%xmm7,%%xmm0 \n" + "movdqa %%xmm2,%%xmm7 \n" + "shufps $0x88,%%xmm6,%%xmm2 \n" + "shufps $0xdd,%%xmm6,%%xmm7 \n" + "pavgb %%xmm7,%%xmm2 \n" + "movdqa %%xmm0,%%xmm1 \n" + "movdqa %%xmm2,%%xmm6 \n" + "pmaddubsw %%xmm4,%%xmm0 \n" + "pmaddubsw %%xmm4,%%xmm2 \n" + "pmaddubsw %%xmm3,%%xmm1 \n" + "pmaddubsw %%xmm3,%%xmm6 \n" + "phaddw %%xmm2,%%xmm0 \n" + "phaddw %%xmm6,%%xmm1 \n" + "psraw $0x8,%%xmm0 \n" + "psraw $0x8,%%xmm1 \n" + "packsswb %%xmm1,%%xmm0 \n" + "paddb %%xmm5,%%xmm0 \n" + "movlps %%xmm0,(%1) \n" + "movhps %%xmm0,0x00(%1,%2,1) \n" + "lea 0x8(%1),%1 \n" + "sub $0x10,%3 \n" + "jg 1b \n" + : "+r"(src_bgra), // %0 + "+r"(dst_u), // %1 + "+r"(dst_v), // %2 + "+rm"(width) // %3 + : "r"((intptr_t) (src_stride_bgra)), // %4 + "m"(kBGRAToV), // %5 + "m"(kBGRAToU), // %6 + "m"(kAddUV128) // %7 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm6", "xmm7"); +} + +void ABGRToYRow_SSSE3(const uint8_t *src_abgr, uint8_t *dst_y, int width) { + asm volatile( + "movdqa %3,%%xmm4 \n" + "movdqa %4,%%xmm5 \n" + "movdqa %5,%%xmm7 \n" + + LABELALIGN RGBTOY(xmm7) + : "+r"(src_abgr), // %0 + "+r"(dst_y), // %1 + "+r"(width) // %2 + : "m"(kABGRToY), // %3 + "m"(kSub128), // %4 + "m"(kAddY16) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +void ABGRToUVRow_SSSE3(const uint8_t *src_abgr, + int src_stride_abgr, + uint8_t *dst_u, + uint8_t *dst_v, + int width) { + asm volatile( + "movdqa %5,%%xmm3 \n" + "movdqa %6,%%xmm4 \n" + "movdqa %7,%%xmm5 \n" + "sub %1,%2 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x00(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "movdqu 0x10(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm1 \n" + "movdqu 0x20(%0),%%xmm2 \n" + "movdqu 0x20(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm2 \n" + "movdqu 0x30(%0),%%xmm6 \n" + "movdqu 0x30(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + + "lea 0x40(%0),%0 \n" + "movdqa %%xmm0,%%xmm7 \n" + "shufps $0x88,%%xmm1,%%xmm0 \n" + "shufps $0xdd,%%xmm1,%%xmm7 \n" + "pavgb %%xmm7,%%xmm0 \n" + "movdqa %%xmm2,%%xmm7 \n" + "shufps $0x88,%%xmm6,%%xmm2 \n" + "shufps $0xdd,%%xmm6,%%xmm7 \n" + "pavgb %%xmm7,%%xmm2 \n" + "movdqa %%xmm0,%%xmm1 \n" + "movdqa %%xmm2,%%xmm6 \n" + "pmaddubsw %%xmm4,%%xmm0 \n" + "pmaddubsw %%xmm4,%%xmm2 \n" + "pmaddubsw %%xmm3,%%xmm1 \n" + "pmaddubsw %%xmm3,%%xmm6 \n" + "phaddw %%xmm2,%%xmm0 \n" + "phaddw %%xmm6,%%xmm1 \n" + "psraw $0x8,%%xmm0 \n" + "psraw $0x8,%%xmm1 \n" + "packsswb %%xmm1,%%xmm0 \n" + "paddb %%xmm5,%%xmm0 \n" + "movlps %%xmm0,(%1) \n" + "movhps %%xmm0,0x00(%1,%2,1) \n" + "lea 0x8(%1),%1 \n" + "sub $0x10,%3 \n" + "jg 1b \n" + : "+r"(src_abgr), // %0 + "+r"(dst_u), // %1 + "+r"(dst_v), // %2 + "+rm"(width) // %3 + : "r"((intptr_t) (src_stride_abgr)), // %4 + "m"(kABGRToV), // %5 + "m"(kABGRToU), // %6 + "m"(kAddUV128) // %7 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm6", "xmm7"); +} + +void RGBAToUVRow_SSSE3(const uint8_t *src_rgba, + int src_stride_rgba, + uint8_t *dst_u, + uint8_t *dst_v, + int width) { + asm volatile( + "movdqa %5,%%xmm3 \n" + "movdqa %6,%%xmm4 \n" + "movdqa %7,%%xmm5 \n" + "sub %1,%2 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x00(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "movdqu 0x10(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm1 \n" + "movdqu 0x20(%0),%%xmm2 \n" + "movdqu 0x20(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm2 \n" + "movdqu 0x30(%0),%%xmm6 \n" + "movdqu 0x30(%0,%4,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + + "lea 0x40(%0),%0 \n" + "movdqa %%xmm0,%%xmm7 \n" + "shufps $0x88,%%xmm1,%%xmm0 \n" + "shufps $0xdd,%%xmm1,%%xmm7 \n" + "pavgb %%xmm7,%%xmm0 \n" + "movdqa %%xmm2,%%xmm7 \n" + "shufps $0x88,%%xmm6,%%xmm2 \n" + "shufps $0xdd,%%xmm6,%%xmm7 \n" + "pavgb %%xmm7,%%xmm2 \n" + "movdqa %%xmm0,%%xmm1 \n" + "movdqa %%xmm2,%%xmm6 \n" + "pmaddubsw %%xmm4,%%xmm0 \n" + "pmaddubsw %%xmm4,%%xmm2 \n" + "pmaddubsw %%xmm3,%%xmm1 \n" + "pmaddubsw %%xmm3,%%xmm6 \n" + "phaddw %%xmm2,%%xmm0 \n" + "phaddw %%xmm6,%%xmm1 \n" + "psraw $0x8,%%xmm0 \n" + "psraw $0x8,%%xmm1 \n" + "packsswb %%xmm1,%%xmm0 \n" + "paddb %%xmm5,%%xmm0 \n" + "movlps %%xmm0,(%1) \n" + "movhps %%xmm0,0x00(%1,%2,1) \n" + "lea 0x8(%1),%1 \n" + "sub $0x10,%3 \n" + "jg 1b \n" + : "+r"(src_rgba), // %0 + "+r"(dst_u), // %1 + "+r"(dst_v), // %2 + "+rm"(width) // %3 + : "r"((intptr_t) (src_stride_rgba)), // %4 + "m"(kRGBAToV), // %5 + "m"(kRGBAToU), // %6 + "m"(kAddUV128) // %7 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm6", "xmm7"); +} + +#ifdef HAS_MIRRORROW_SSSE3 +// Shuffle table for reversing the bytes. +static const uvec8 kShuffleMirror = {15u, 14u, 13u, 12u, 11u, 10u, 9u, 8u, + 7u, 6u, 5u, 4u, 3u, 2u, 1u, 0u}; + +void MirrorRow_SSSE3(const uint8_t *src, uint8_t *dst, int width) { + intptr_t temp_width = (intptr_t) (width); + asm volatile( + + "movdqa %3,%%xmm5 \n" + + LABELALIGN + "1: \n" + "movdqu -0x10(%0,%2,1),%%xmm0 \n" + "pshufb %%xmm5,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src), // %0 + "+r"(dst), // %1 + "+r"(temp_width) // %2 + : "m"(kShuffleMirror) // %3 + : "memory", "cc", "xmm0", "xmm5"); +} + +#endif // HAS_MIRRORROW_SSSE3 + +#ifdef HAS_MIRRORROW_AVX2 + +void MirrorRow_AVX2(const uint8_t *src, uint8_t *dst, int width) { + intptr_t temp_width = (intptr_t) (width); + asm volatile( + + "vbroadcastf128 %3,%%ymm5 \n" + + LABELALIGN + "1: \n" + "vmovdqu -0x20(%0,%2,1),%%ymm0 \n" + "vpshufb %%ymm5,%%ymm0,%%ymm0 \n" + "vpermq $0x4e,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src), // %0 + "+r"(dst), // %1 + "+r"(temp_width) // %2 + : "m"(kShuffleMirror) // %3 + : "memory", "cc", "xmm0", "xmm5"); +} + +#endif // HAS_MIRRORROW_AVX2 + +#ifdef HAS_MIRRORUVROW_SSSE3 +// Shuffle table for reversing the UV. +static const uvec8 kShuffleMirrorUV = {14u, 15u, 12u, 13u, 10u, 11u, 8u, 9u, + 6u, 7u, 4u, 5u, 2u, 3u, 0u, 1u}; + +void MirrorUVRow_SSSE3(const uint8_t *src_uv, uint8_t *dst_uv, int width) { + intptr_t temp_width = (intptr_t) (width); + asm volatile( + + "movdqa %3,%%xmm5 \n" + + LABELALIGN + "1: \n" + "movdqu -0x10(%0,%2,2),%%xmm0 \n" + "pshufb %%xmm5,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x8,%2 \n" + "jg 1b \n" + : "+r"(src_uv), // %0 + "+r"(dst_uv), // %1 + "+r"(temp_width) // %2 + : "m"(kShuffleMirrorUV) // %3 + : "memory", "cc", "xmm0", "xmm5"); +} + +#endif // HAS_MIRRORUVROW_SSSE3 + +#ifdef HAS_MIRRORUVROW_AVX2 + +void MirrorUVRow_AVX2(const uint8_t *src_uv, uint8_t *dst_uv, int width) { + intptr_t temp_width = (intptr_t) (width); + asm volatile( + + "vbroadcastf128 %3,%%ymm5 \n" + + LABELALIGN + "1: \n" + "vmovdqu -0x20(%0,%2,2),%%ymm0 \n" + "vpshufb %%ymm5,%%ymm0,%%ymm0 \n" + "vpermq $0x4e,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_uv), // %0 + "+r"(dst_uv), // %1 + "+r"(temp_width) // %2 + : "m"(kShuffleMirrorUV) // %3 + : "memory", "cc", "xmm0", "xmm5"); +} + +#endif // HAS_MIRRORUVROW_AVX2 + +#ifdef HAS_MIRRORSPLITUVROW_SSSE3 +// Shuffle table for reversing the bytes of UV channels. +static const uvec8 kShuffleMirrorSplitUV = {14u, 12u, 10u, 8u, 6u, 4u, 2u, 0u, + 15u, 13u, 11u, 9u, 7u, 5u, 3u, 1u}; + +void MirrorSplitUVRow_SSSE3(const uint8_t *src, + uint8_t *dst_u, + uint8_t *dst_v, + int width) { + intptr_t temp_width = (intptr_t) (width); + asm volatile( + "movdqa %4,%%xmm1 \n" + "lea -0x10(%0,%3,2),%0 \n" + "sub %1,%2 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "lea -0x10(%0),%0 \n" + "pshufb %%xmm1,%%xmm0 \n" + "movlpd %%xmm0,(%1) \n" + "movhpd %%xmm0,0x00(%1,%2,1) \n" + "lea 0x8(%1),%1 \n" + "sub $8,%3 \n" + "jg 1b \n" + : "+r"(src), // %0 + "+r"(dst_u), // %1 + "+r"(dst_v), // %2 + "+r"(temp_width) // %3 + : "m"(kShuffleMirrorSplitUV) // %4 + : "memory", "cc", "xmm0", "xmm1"); +} + +#endif // HAS_MIRRORSPLITUVROW_SSSE3 + +#ifdef HAS_ARGBMIRRORROW_SSE2 + +void ARGBMirrorRow_SSE2(const uint8_t *src, uint8_t *dst, int width) { + intptr_t temp_width = (intptr_t) (width); + asm volatile( + + "lea -0x10(%0,%2,4),%0 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "pshufd $0x1b,%%xmm0,%%xmm0 \n" + "lea -0x10(%0),%0 \n" + "movdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x4,%2 \n" + "jg 1b \n" + : "+r"(src), // %0 + "+r"(dst), // %1 + "+r"(temp_width) // %2 + : + : "memory", "cc", "xmm0"); +} + +#endif // HAS_ARGBMIRRORROW_SSE2 + +#ifdef HAS_ARGBMIRRORROW_AVX2 +// Shuffle table for reversing the bytes. +static const ulvec32 kARGBShuffleMirror_AVX2 = {7u, 6u, 5u, 4u, 3u, 2u, 1u, 0u}; + +void ARGBMirrorRow_AVX2(const uint8_t *src, uint8_t *dst, int width) { + intptr_t temp_width = (intptr_t) (width); + asm volatile( + + "vmovdqu %3,%%ymm5 \n" + + LABELALIGN + "1: \n" + "vpermd -0x20(%0,%2,4),%%ymm5,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x8,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src), // %0 + "+r"(dst), // %1 + "+r"(temp_width) // %2 + : "m"(kARGBShuffleMirror_AVX2) // %3 + : "memory", "cc", "xmm0", "xmm5"); +} + +#endif // HAS_ARGBMIRRORROW_AVX2 + + +#ifdef HAS_COPYROW_SSE2 + +void CopyRow_SSE2(const uint8_t *src, uint8_t *dst, int width) { + asm volatile( + "test $0xf,%0 \n" + "jne 2f \n" + "test $0xf,%1 \n" + "jne 2f \n" + + LABELALIGN + "1: \n" + "movdqa (%0),%%xmm0 \n" + "movdqa 0x10(%0),%%xmm1 \n" + "lea 0x20(%0),%0 \n" + "movdqa %%xmm0,(%1) \n" + "movdqa %%xmm1,0x10(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 1b \n" + "jmp 9f \n" + + LABELALIGN + "2: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "lea 0x20(%0),%0 \n" + "movdqu %%xmm0,(%1) \n" + "movdqu %%xmm1,0x10(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 2b \n" + + LABELALIGN "9: \n" + : "+r"(src), // %0 + "+r"(dst), // %1 + "+r"(width) // %2 + : + : "memory", "cc", "xmm0", "xmm1"); +} + +#endif // HAS_COPYROW_SSE2 + +#ifdef HAS_COPYROW_AVX + +void CopyRow_AVX(const uint8_t *src, uint8_t *dst, int width) { + asm volatile( + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" + "vmovdqu 0x20(%0),%%ymm1 \n" + "lea 0x40(%0),%0 \n" + "vmovdqu %%ymm0,(%1) \n" + "vmovdqu %%ymm1,0x20(%1) \n" + "lea 0x40(%1),%1 \n" + "sub $0x40,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src), // %0 + "+r"(dst), // %1 + "+r"(width) // %2 + : + : "memory", "cc", "xmm0", "xmm1"); +} + +#endif // HAS_COPYROW_AVX + +#ifdef HAS_COPYROW_ERMS + +// Multiple of 1. +void CopyRow_ERMS(const uint8_t *src, uint8_t *dst, int width) { + size_t width_tmp = (size_t) (width); + asm volatile( + + "rep movsb \n" + : "+S"(src), // %0 + "+D"(dst), // %1 + "+c"(width_tmp) // %2 + : + : "memory", "cc"); +} + +#endif // HAS_COPYROW_ERMS + +#ifdef HAS_INTERPOLATEROW_SSSE3 + +// Bilinear filter 16x2 -> 16x1 +void InterpolateRow_SSSE3(uint8_t *dst_ptr, + const uint8_t *src_ptr, + ptrdiff_t src_stride, + int width, + int source_y_fraction) { + asm volatile( + "sub %1,%0 \n" + "cmp $0x0,%3 \n" + "je 100f \n" + "cmp $0x80,%3 \n" + "je 50f \n" + + "movd %3,%%xmm0 \n" + "neg %3 \n" + "add $0x100,%3 \n" + "movd %3,%%xmm5 \n" + "punpcklbw %%xmm0,%%xmm5 \n" + "punpcklwd %%xmm5,%%xmm5 \n" + "pshufd $0x0,%%xmm5,%%xmm5 \n" + "mov $0x80808080,%%eax \n" + "movd %%eax,%%xmm4 \n" + "pshufd $0x0,%%xmm4,%%xmm4 \n" + + // General purpose row blend. + LABELALIGN + "1: \n" + "movdqu (%1),%%xmm0 \n" + "movdqu 0x00(%1,%4,1),%%xmm2 \n" + "movdqa %%xmm0,%%xmm1 \n" + "punpcklbw %%xmm2,%%xmm0 \n" + "punpckhbw %%xmm2,%%xmm1 \n" + "psubb %%xmm4,%%xmm0 \n" + "psubb %%xmm4,%%xmm1 \n" + "movdqa %%xmm5,%%xmm2 \n" + "movdqa %%xmm5,%%xmm3 \n" + "pmaddubsw %%xmm0,%%xmm2 \n" + "pmaddubsw %%xmm1,%%xmm3 \n" + "paddw %%xmm4,%%xmm2 \n" + "paddw %%xmm4,%%xmm3 \n" + "psrlw $0x8,%%xmm2 \n" + "psrlw $0x8,%%xmm3 \n" + "packuswb %%xmm3,%%xmm2 \n" + "movdqu %%xmm2,0x00(%1,%0,1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + "jmp 99f \n" + + // Blend 50 / 50. + LABELALIGN + "50: \n" + "movdqu (%1),%%xmm0 \n" + "movdqu 0x00(%1,%4,1),%%xmm1 \n" + "pavgb %%xmm1,%%xmm0 \n" + "movdqu %%xmm0,0x00(%1,%0,1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 50b \n" + "jmp 99f \n" + + // Blend 100 / 0 - Copy row unchanged. + LABELALIGN + "100: \n" + "movdqu (%1),%%xmm0 \n" + "movdqu %%xmm0,0x00(%1,%0,1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 100b \n" + + "99: \n" + : "+r"(dst_ptr), // %0 + "+r"(src_ptr), // %1 + "+rm"(width), // %2 + "+r"(source_y_fraction) // %3 + : "r"((intptr_t) (src_stride)) // %4 + : "memory", "cc", "eax", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif // HAS_INTERPOLATEROW_SSSE3 + +#ifdef HAS_INTERPOLATEROW_AVX2 + +// Bilinear filter 32x2 -> 32x1 +void InterpolateRow_AVX2(uint8_t *dst_ptr, + const uint8_t *src_ptr, + ptrdiff_t src_stride, + int width, + int source_y_fraction) { + asm volatile( + "sub %1,%0 \n" + "cmp $0x0,%3 \n" + "je 100f \n" + "cmp $0x80,%3 \n" + "je 50f \n" + + "vmovd %3,%%xmm0 \n" + "neg %3 \n" + "add $0x100,%3 \n" + "vmovd %3,%%xmm5 \n" + "vpunpcklbw %%xmm0,%%xmm5,%%xmm5 \n" + "vpunpcklwd %%xmm5,%%xmm5,%%xmm5 \n" + "vbroadcastss %%xmm5,%%ymm5 \n" + "mov $0x80808080,%%eax \n" + "vmovd %%eax,%%xmm4 \n" + "vbroadcastss %%xmm4,%%ymm4 \n" + + // General purpose row blend. + LABELALIGN + "1: \n" + "vmovdqu (%1),%%ymm0 \n" + "vmovdqu 0x00(%1,%4,1),%%ymm2 \n" + "vpunpckhbw %%ymm2,%%ymm0,%%ymm1 \n" + "vpunpcklbw %%ymm2,%%ymm0,%%ymm0 \n" + "vpsubb %%ymm4,%%ymm1,%%ymm1 \n" + "vpsubb %%ymm4,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm1,%%ymm5,%%ymm1 \n" + "vpmaddubsw %%ymm0,%%ymm5,%%ymm0 \n" + "vpaddw %%ymm4,%%ymm1,%%ymm1 \n" + "vpaddw %%ymm4,%%ymm0,%%ymm0 \n" + "vpsrlw $0x8,%%ymm1,%%ymm1 \n" + "vpsrlw $0x8,%%ymm0,%%ymm0 \n" + "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,0x00(%1,%0,1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 1b \n" + "jmp 99f \n" + + // Blend 50 / 50. + LABELALIGN + "50: \n" + "vmovdqu (%1),%%ymm0 \n" + "vpavgb 0x00(%1,%4,1),%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,0x00(%1,%0,1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 50b \n" + "jmp 99f \n" + + // Blend 100 / 0 - Copy row unchanged. + LABELALIGN + "100: \n" + "vmovdqu (%1),%%ymm0 \n" + "vmovdqu %%ymm0,0x00(%1,%0,1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 100b \n" + + "99: \n" + "vzeroupper \n" + : "+r"(dst_ptr), // %0 + "+r"(src_ptr), // %1 + "+r"(width), // %2 + "+r"(source_y_fraction) // %3 + : "r"((intptr_t) (src_stride)) // %4 + : "memory", "cc", "eax", "xmm0", "xmm1", "xmm2", "xmm4", "xmm5"); +} + +#endif // HAS_INTERPOLATEROW_AVX2 + +#endif // defined(__x86_64__) || defined(__i386__) diff --git a/pkg/encoder/yuv/libyuv/scale.c b/pkg/encoder/yuv/libyuv/scale.c new file mode 100644 index 00000000..c4bd5b0b --- /dev/null +++ b/pkg/encoder/yuv/libyuv/scale.c @@ -0,0 +1,946 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "scale.h" + +#include +#include + +#include "cpu_id.h" +#include "planar_functions.h" // For CopyPlane +#include "row.h" +#include "scale_row.h" + +static __inline int Abs(int v) { + return v >= 0 ? v : -v; +} + +#define SUBSAMPLE(v, a, s) (v < 0) ? (-((-v + a) >> s)) : ((v + a) >> s) +#define CENTERSTART(dx, s) (dx < 0) ? -((-dx >> 1) + s) : ((dx >> 1) + s) + +// Scale plane, 1/2 +// This is an optimized version for scaling down a plane to 1/2 of +// its original size. + +static void ScalePlaneDown2(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr, + enum FilterMode filtering) { + int y; + void (*ScaleRowDown2)(const uint8_t *src_ptr, ptrdiff_t src_stride, + uint8_t *dst_ptr, int dst_width) = + filtering == kFilterNone + ? ScaleRowDown2_C + : (filtering == kFilterLinear ? ScaleRowDown2Linear_C + : ScaleRowDown2Box_C); + int row_stride = src_stride * 2; + (void) src_width; + (void) src_height; + if (!filtering) { + src_ptr += src_stride; // Point to odd rows. + src_stride = 0; + } + + +#if defined(HAS_SCALEROWDOWN2_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + ScaleRowDown2 = + filtering == kFilterNone + ? ScaleRowDown2_Any_SSSE3 + : (filtering == kFilterLinear ? ScaleRowDown2Linear_Any_SSSE3 + : ScaleRowDown2Box_Any_SSSE3); + if (IS_ALIGNED(dst_width, 16)) { + ScaleRowDown2 = + filtering == kFilterNone + ? ScaleRowDown2_SSSE3 + : (filtering == kFilterLinear ? ScaleRowDown2Linear_SSSE3 + : ScaleRowDown2Box_SSSE3); + } + } +#endif +#if defined(HAS_SCALEROWDOWN2_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ScaleRowDown2 = + filtering == kFilterNone + ? ScaleRowDown2_Any_AVX2 + : (filtering == kFilterLinear ? ScaleRowDown2Linear_Any_AVX2 + : ScaleRowDown2Box_Any_AVX2); + if (IS_ALIGNED(dst_width, 32)) { + ScaleRowDown2 = filtering == kFilterNone ? ScaleRowDown2_AVX2 + : (filtering == kFilterLinear + ? ScaleRowDown2Linear_AVX2 + : ScaleRowDown2Box_AVX2); + } + } +#endif + + if (filtering == kFilterLinear) { + src_stride = 0; + } + // TODO(fbarchard): Loop through source height to allow odd height. + for (y = 0; y < dst_height; ++y) { + ScaleRowDown2(src_ptr, src_stride, dst_ptr, dst_width); + src_ptr += row_stride; + dst_ptr += dst_stride; + } +} + +// Scale plane, 1/4 +// This is an optimized version for scaling down a plane to 1/4 of +// its original size. + +static void ScalePlaneDown4(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr, + enum FilterMode filtering) { + int y; + void (*ScaleRowDown4)(const uint8_t *src_ptr, ptrdiff_t src_stride, + uint8_t *dst_ptr, int dst_width) = + filtering ? ScaleRowDown4Box_C : ScaleRowDown4_C; + int row_stride = src_stride * 4; + (void) src_width; + (void) src_height; + if (!filtering) { + src_ptr += src_stride * 2; // Point to row 2. + src_stride = 0; + } + +#if defined(HAS_SCALEROWDOWN4_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + ScaleRowDown4 = + filtering ? ScaleRowDown4Box_Any_SSSE3 : ScaleRowDown4_Any_SSSE3; + if (IS_ALIGNED(dst_width, 8)) { + ScaleRowDown4 = filtering ? ScaleRowDown4Box_SSSE3 : ScaleRowDown4_SSSE3; + } + } +#endif +#if defined(HAS_SCALEROWDOWN4_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ScaleRowDown4 = + filtering ? ScaleRowDown4Box_Any_AVX2 : ScaleRowDown4_Any_AVX2; + if (IS_ALIGNED(dst_width, 16)) { + ScaleRowDown4 = filtering ? ScaleRowDown4Box_AVX2 : ScaleRowDown4_AVX2; + } + } +#endif + + if (filtering == kFilterLinear) { + src_stride = 0; + } + for (y = 0; y < dst_height; ++y) { + ScaleRowDown4(src_ptr, src_stride, dst_ptr, dst_width); + src_ptr += row_stride; + dst_ptr += dst_stride; + } +} + +// Scale plane down, 3/4 +static void ScalePlaneDown34(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr, + enum FilterMode filtering) { + int y; + void (*ScaleRowDown34_0)(const uint8_t *src_ptr, ptrdiff_t src_stride, + uint8_t *dst_ptr, int dst_width); + void (*ScaleRowDown34_1)(const uint8_t *src_ptr, ptrdiff_t src_stride, + uint8_t *dst_ptr, int dst_width); + const int filter_stride = (filtering == kFilterLinear) ? 0 : src_stride; + (void) src_width; + (void) src_height; + assert(dst_width % 3 == 0); + if (!filtering) { + ScaleRowDown34_0 = ScaleRowDown34_C; + ScaleRowDown34_1 = ScaleRowDown34_C; + } else { + ScaleRowDown34_0 = ScaleRowDown34_0_Box_C; + ScaleRowDown34_1 = ScaleRowDown34_1_Box_C; + } + +#if defined(HAS_SCALEROWDOWN34_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + if (!filtering) { + ScaleRowDown34_0 = ScaleRowDown34_Any_SSSE3; + ScaleRowDown34_1 = ScaleRowDown34_Any_SSSE3; + } else { + ScaleRowDown34_0 = ScaleRowDown34_0_Box_Any_SSSE3; + ScaleRowDown34_1 = ScaleRowDown34_1_Box_Any_SSSE3; + } + if (dst_width % 24 == 0) { + if (!filtering) { + ScaleRowDown34_0 = ScaleRowDown34_SSSE3; + ScaleRowDown34_1 = ScaleRowDown34_SSSE3; + } else { + ScaleRowDown34_0 = ScaleRowDown34_0_Box_SSSE3; + ScaleRowDown34_1 = ScaleRowDown34_1_Box_SSSE3; + } + } + } +#endif + + for (y = 0; y < dst_height - 2; y += 3) { + ScaleRowDown34_0(src_ptr, filter_stride, dst_ptr, dst_width); + src_ptr += src_stride; + dst_ptr += dst_stride; + ScaleRowDown34_1(src_ptr, filter_stride, dst_ptr, dst_width); + src_ptr += src_stride; + dst_ptr += dst_stride; + ScaleRowDown34_0(src_ptr + src_stride, -filter_stride, dst_ptr, dst_width); + src_ptr += src_stride * 2; + dst_ptr += dst_stride; + } + + // Remainder 1 or 2 rows with last row vertically unfiltered + if ((dst_height % 3) == 2) { + ScaleRowDown34_0(src_ptr, filter_stride, dst_ptr, dst_width); + src_ptr += src_stride; + dst_ptr += dst_stride; + ScaleRowDown34_1(src_ptr, 0, dst_ptr, dst_width); + } else if ((dst_height % 3) == 1) { + ScaleRowDown34_0(src_ptr, 0, dst_ptr, dst_width); + } +} + +// Scale plane, 3/8 +// This is an optimized version for scaling down a plane to 3/8 +// of its original size. +// +// Uses box filter arranges like this +// aaabbbcc -> abc +// aaabbbcc def +// aaabbbcc ghi +// dddeeeff +// dddeeeff +// dddeeeff +// ggghhhii +// ggghhhii +// Boxes are 3x3, 2x3, 3x2 and 2x2 + +static void ScalePlaneDown38(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr, + enum FilterMode filtering) { + int y; + void (*ScaleRowDown38_3)(const uint8_t *src_ptr, ptrdiff_t src_stride, + uint8_t *dst_ptr, int dst_width); + void (*ScaleRowDown38_2)(const uint8_t *src_ptr, ptrdiff_t src_stride, + uint8_t *dst_ptr, int dst_width); + const int filter_stride = (filtering == kFilterLinear) ? 0 : src_stride; + assert(dst_width % 3 == 0); + (void) src_width; + (void) src_height; + if (!filtering) { + ScaleRowDown38_3 = ScaleRowDown38_C; + ScaleRowDown38_2 = ScaleRowDown38_C; + } else { + ScaleRowDown38_3 = ScaleRowDown38_3_Box_C; + ScaleRowDown38_2 = ScaleRowDown38_2_Box_C; + } + +#if defined(HAS_SCALEROWDOWN38_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + if (!filtering) { + ScaleRowDown38_3 = ScaleRowDown38_Any_SSSE3; + ScaleRowDown38_2 = ScaleRowDown38_Any_SSSE3; + } else { + ScaleRowDown38_3 = ScaleRowDown38_3_Box_Any_SSSE3; + ScaleRowDown38_2 = ScaleRowDown38_2_Box_Any_SSSE3; + } + if (dst_width % 12 == 0 && !filtering) { + ScaleRowDown38_3 = ScaleRowDown38_SSSE3; + ScaleRowDown38_2 = ScaleRowDown38_SSSE3; + } + if (dst_width % 6 == 0 && filtering) { + ScaleRowDown38_3 = ScaleRowDown38_3_Box_SSSE3; + ScaleRowDown38_2 = ScaleRowDown38_2_Box_SSSE3; + } + } +#endif + + for (y = 0; y < dst_height - 2; y += 3) { + ScaleRowDown38_3(src_ptr, filter_stride, dst_ptr, dst_width); + src_ptr += src_stride * 3; + dst_ptr += dst_stride; + ScaleRowDown38_3(src_ptr, filter_stride, dst_ptr, dst_width); + src_ptr += src_stride * 3; + dst_ptr += dst_stride; + ScaleRowDown38_2(src_ptr, filter_stride, dst_ptr, dst_width); + src_ptr += src_stride * 2; + dst_ptr += dst_stride; + } + + // Remainder 1 or 2 rows with last row vertically unfiltered + if ((dst_height % 3) == 2) { + ScaleRowDown38_3(src_ptr, filter_stride, dst_ptr, dst_width); + src_ptr += src_stride * 3; + dst_ptr += dst_stride; + ScaleRowDown38_3(src_ptr, 0, dst_ptr, dst_width); + } else if ((dst_height % 3) == 1) { + ScaleRowDown38_3(src_ptr, 0, dst_ptr, dst_width); + } +} + +#define MIN1(x) ((x) < 1 ? 1 : (x)) + +static __inline uint32_t SumPixels(int iboxwidth, const uint16_t *src_ptr) { + uint32_t sum = 0u; + int x; + assert(iboxwidth > 0); + for (x = 0; x < iboxwidth; ++x) { + sum += src_ptr[x]; + } + return sum; +} + +static __inline uint32_t SumPixels_16(int iboxwidth, const uint32_t *src_ptr) { + uint32_t sum = 0u; + int x; + assert(iboxwidth > 0); + for (x = 0; x < iboxwidth; ++x) { + sum += src_ptr[x]; + } + return sum; +} + +static void ScaleAddCols2_C(int dst_width, + int boxheight, + int x, + int dx, + const uint16_t *src_ptr, + uint8_t *dst_ptr) { + int i; + int scaletbl[2]; + int minboxwidth = dx >> 16; + int boxwidth; + scaletbl[0] = 65536 / (MIN1(minboxwidth) * boxheight); + scaletbl[1] = 65536 / (MIN1(minboxwidth + 1) * boxheight); + for (i = 0; i < dst_width; ++i) { + int ix = x >> 16; + x += dx; + boxwidth = MIN1((x >> 16) - ix); + int scaletbl_index = boxwidth - minboxwidth; + assert((scaletbl_index == 0) || (scaletbl_index == 1)); + *dst_ptr++ = (uint8_t) (SumPixels(boxwidth, src_ptr + ix) * + scaletbl[scaletbl_index] >> + 16); + } +} + +static void ScaleAddCols0_C(int dst_width, + int boxheight, + int x, + int dx, + const uint16_t *src_ptr, + uint8_t *dst_ptr) { + int scaleval = 65536 / boxheight; + int i; + (void) dx; + src_ptr += (x >> 16); + for (i = 0; i < dst_width; ++i) { + *dst_ptr++ = (uint8_t) (src_ptr[i] * scaleval >> 16); + } +} + +static void ScaleAddCols1_C(int dst_width, + int boxheight, + int x, + int dx, + const uint16_t *src_ptr, + uint8_t *dst_ptr) { + int boxwidth = MIN1(dx >> 16); + int scaleval = 65536 / (boxwidth * boxheight); + int i; + x >>= 16; + for (i = 0; i < dst_width; ++i) { + *dst_ptr++ = (uint8_t) (SumPixels(boxwidth, src_ptr + x) * scaleval >> 16); + x += boxwidth; + } +} + +// Scale plane down to any dimensions, with interpolation. +// (boxfilter). +// +// Same method as SimpleScale, which is fixed point, outputting +// one pixel of destination using fixed point (16.16) to step +// through source, sampling a box of pixel with simple +// averaging. +static void ScalePlaneBox(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr) { + int j, k; + // Initial source x/y coordinate and step values as 16.16 fixed point. + int x = 0; + int y = 0; + int dx = 0; + int dy = 0; + const int max_y = (src_height << 16); + ScaleSlope(src_width, src_height, dst_width, dst_height, kFilterBox, &x, &y, + &dx, &dy); + src_width = Abs(src_width); + { + // Allocate a row buffer of uint16_t. + align_buffer_64(row16, src_width * 2); + void (*ScaleAddCols)(int dst_width, int boxheight, int x, int dx, + const uint16_t *src_ptr, uint8_t *dst_ptr) = + (dx & 0xffff) ? ScaleAddCols2_C + : ((dx != 0x10000) ? ScaleAddCols1_C : ScaleAddCols0_C); + void (*ScaleAddRow)(const uint8_t *src_ptr, uint16_t *dst_ptr, + int src_width) = ScaleAddRow_C; +#if defined(HAS_SCALEADDROW_SSE2) + if (TestCpuFlag(kCpuHasSSE2)) { + ScaleAddRow = ScaleAddRow_Any_SSE2; + if (IS_ALIGNED(src_width, 16)) { + ScaleAddRow = ScaleAddRow_SSE2; + } + } +#endif +#if defined(HAS_SCALEADDROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + ScaleAddRow = ScaleAddRow_Any_AVX2; + if (IS_ALIGNED(src_width, 32)) { + ScaleAddRow = ScaleAddRow_AVX2; + } + } +#endif + + + for (j = 0; j < dst_height; ++j) { + int boxheight; + int iy = y >> 16; + const uint8_t *src = src_ptr + iy * (int64_t) src_stride; + y += dy; + if (y > max_y) { + y = max_y; + } + boxheight = MIN1((y >> 16) - iy); + memset(row16, 0, src_width * 2); + for (k = 0; k < boxheight; ++k) { + ScaleAddRow(src, (uint16_t *) (row16), src_width); + src += src_stride; + } + ScaleAddCols(dst_width, boxheight, x, dx, (uint16_t *) (row16), dst_ptr); + dst_ptr += dst_stride; + } + free_aligned_buffer_64(row16); + } +} + +// Scale plane down with bilinear interpolation. +static void ScalePlaneBilinearDown(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr, + enum FilterMode filtering) { + // Initial source x/y coordinate and step values as 16.16 fixed point. + int x = 0; + int y = 0; + int dx = 0; + int dy = 0; + // TODO(fbarchard): Consider not allocating row buffer for kFilterLinear. + // Allocate a row buffer. + align_buffer_64(row, src_width); + + const int max_y = (src_height - 1) << 16; + int j; + void (*ScaleFilterCols)(uint8_t *dst_ptr, const uint8_t *src_ptr, + int dst_width, int x, int dx) = + (src_width >= 32768) ? ScaleFilterCols64_C : ScaleFilterCols_C; + void (*InterpolateRow)(uint8_t *dst_ptr, const uint8_t *src_ptr, + ptrdiff_t src_stride, int dst_width, + int source_y_fraction) = InterpolateRow_C; + ScaleSlope(src_width, src_height, dst_width, dst_height, filtering, &x, &y, + &dx, &dy); + src_width = Abs(src_width); + +#if defined(HAS_INTERPOLATEROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + InterpolateRow = InterpolateRow_Any_SSSE3; + if (IS_ALIGNED(src_width, 16)) { + InterpolateRow = InterpolateRow_SSSE3; + } + } +#endif +#if defined(HAS_INTERPOLATEROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + InterpolateRow = InterpolateRow_Any_AVX2; + if (IS_ALIGNED(src_width, 32)) { + InterpolateRow = InterpolateRow_AVX2; + } + } +#endif + +#if defined(HAS_SCALEFILTERCOLS_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3) && src_width < 32768) { + ScaleFilterCols = ScaleFilterCols_SSSE3; + } +#endif + + if (y > max_y) { + y = max_y; + } + + for (j = 0; j < dst_height; ++j) { + int yi = y >> 16; + const uint8_t *src = src_ptr + yi * (int64_t) src_stride; + if (filtering == kFilterLinear) { + ScaleFilterCols(dst_ptr, src, dst_width, x, dx); + } else { + int yf = (y >> 8) & 255; + InterpolateRow(row, src, src_stride, src_width, yf); + ScaleFilterCols(dst_ptr, row, dst_width, x, dx); + } + dst_ptr += dst_stride; + y += dy; + if (y > max_y) { + y = max_y; + } + } + free_aligned_buffer_64(row); +} + +// Scale up down with bilinear interpolation. +static void ScalePlaneBilinearUp(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr, + enum FilterMode filtering) { + int j; + // Initial source x/y coordinate and step values as 16.16 fixed point. + int x = 0; + int y = 0; + int dx = 0; + int dy = 0; + const int max_y = (src_height - 1) << 16; + void (*InterpolateRow)(uint8_t *dst_ptr, const uint8_t *src_ptr, + ptrdiff_t src_stride, int dst_width, + int source_y_fraction) = InterpolateRow_C; + void (*ScaleFilterCols)(uint8_t *dst_ptr, const uint8_t *src_ptr, + int dst_width, int x, int dx) = + filtering ? ScaleFilterCols_C : ScaleCols_C; + ScaleSlope(src_width, src_height, dst_width, dst_height, filtering, &x, &y, + &dx, &dy); + src_width = Abs(src_width); + +#if defined(HAS_INTERPOLATEROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + InterpolateRow = InterpolateRow_Any_SSSE3; + if (IS_ALIGNED(dst_width, 16)) { + InterpolateRow = InterpolateRow_SSSE3; + } + } +#endif +#if defined(HAS_INTERPOLATEROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + InterpolateRow = InterpolateRow_Any_AVX2; + if (IS_ALIGNED(dst_width, 32)) { + InterpolateRow = InterpolateRow_AVX2; + } + } +#endif + + if (filtering && src_width >= 32768) { + ScaleFilterCols = ScaleFilterCols64_C; + } +#if defined(HAS_SCALEFILTERCOLS_SSSE3) + if (filtering && TestCpuFlag(kCpuHasSSSE3) && src_width < 32768) { + ScaleFilterCols = ScaleFilterCols_SSSE3; + } +#endif + + if (!filtering && src_width * 2 == dst_width && x < 0x8000) { + ScaleFilterCols = ScaleColsUp2_C; +#if defined(HAS_SCALECOLS_SSE2) + if (TestCpuFlag(kCpuHasSSE2) && IS_ALIGNED(dst_width, 8)) { + ScaleFilterCols = ScaleColsUp2_SSE2; + } +#endif + } + + if (y > max_y) { + y = max_y; + } + { + int yi = y >> 16; + const uint8_t *src = src_ptr + yi * (int64_t) src_stride; + + // Allocate 2 row buffers. + const int row_size = (dst_width + 31) & ~31; + align_buffer_64(row, row_size * 2); + + uint8_t *rowptr = row; + int rowstride = row_size; + int lasty = yi; + + ScaleFilterCols(rowptr, src, dst_width, x, dx); + if (src_height > 1) { + src += src_stride; + } + ScaleFilterCols(rowptr + rowstride, src, dst_width, x, dx); + if (src_height > 2) { + src += src_stride; + } + + for (j = 0; j < dst_height; ++j) { + yi = y >> 16; + if (yi != lasty) { + if (y > max_y) { + y = max_y; + yi = y >> 16; + src = src_ptr + yi * (int64_t) src_stride; + } + if (yi != lasty) { + ScaleFilterCols(rowptr, src, dst_width, x, dx); + rowptr += rowstride; + rowstride = -rowstride; + lasty = yi; + if ((y + 65536) < max_y) { + src += src_stride; + } + } + } + if (filtering == kFilterLinear) { + InterpolateRow(dst_ptr, rowptr, 0, dst_width, 0); + } else { + int yf = (y >> 8) & 255; + InterpolateRow(dst_ptr, rowptr, rowstride, dst_width, yf); + } + dst_ptr += dst_stride; + y += dy; + } + free_aligned_buffer_64(row); + } +} + +// Scale plane, horizontally up by 2 times. +// Uses linear filter horizontally, nearest vertically. +// This is an optimized version for scaling up a plane to 2 times of +// its original width, using linear interpolation. +// This is used to scale U and V planes of I422 to I444. +static void ScalePlaneUp2_Linear(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr) { + void (*ScaleRowUp)(const uint8_t *src_ptr, uint8_t *dst_ptr, int dst_width) = + ScaleRowUp2_Linear_Any_C; + int i; + int y; + int dy; + + (void) src_width; + // This function can only scale up by 2 times horizontally. + assert(src_width == ((dst_width + 1) / 2)); + +#ifdef HAS_SCALEROWUP2_LINEAR_SSE2 + if (TestCpuFlag(kCpuHasSSE2)) { + ScaleRowUp = ScaleRowUp2_Linear_Any_SSE2; + } +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_SSSE3 + if (TestCpuFlag(kCpuHasSSSE3)) { + ScaleRowUp = ScaleRowUp2_Linear_Any_SSSE3; + } +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_AVX2 + if (TestCpuFlag(kCpuHasAVX2)) { + ScaleRowUp = ScaleRowUp2_Linear_Any_AVX2; + } +#endif + + + if (dst_height == 1) { + ScaleRowUp(src_ptr + ((src_height - 1) / 2) * (int64_t) src_stride, dst_ptr, + dst_width); + } else { + dy = FixedDiv(src_height - 1, dst_height - 1); + y = (1 << 15) - 1; + for (i = 0; i < dst_height; ++i) { + ScaleRowUp(src_ptr + (y >> 16) * (int64_t) src_stride, dst_ptr, dst_width); + dst_ptr += dst_stride; + y += dy; + } + } +} + +// Scale plane, up by 2 times. +// This is an optimized version for scaling up a plane to 2 times of +// its original size, using bilinear interpolation. +// This is used to scale U and V planes of I420 to I444. +static void ScalePlaneUp2_Bilinear(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr) { + void (*Scale2RowUp)(const uint8_t *src_ptr, ptrdiff_t src_stride, + uint8_t *dst_ptr, ptrdiff_t dst_stride, int dst_width) = + ScaleRowUp2_Bilinear_Any_C; + int x; + + (void) src_width; + // This function can only scale up by 2 times. + assert(src_width == ((dst_width + 1) / 2)); + assert(src_height == ((dst_height + 1) / 2)); + +#ifdef HAS_SCALEROWUP2_BILINEAR_SSE2 + if (TestCpuFlag(kCpuHasSSE2)) { + Scale2RowUp = ScaleRowUp2_Bilinear_Any_SSE2; + } +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_SSSE3 + if (TestCpuFlag(kCpuHasSSSE3)) { + Scale2RowUp = ScaleRowUp2_Bilinear_Any_SSSE3; + } +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_AVX2 + if (TestCpuFlag(kCpuHasAVX2)) { + Scale2RowUp = ScaleRowUp2_Bilinear_Any_AVX2; + } +#endif + + + Scale2RowUp(src_ptr, 0, dst_ptr, 0, dst_width); + dst_ptr += dst_stride; + for (x = 0; x < src_height - 1; ++x) { + Scale2RowUp(src_ptr, src_stride, dst_ptr, dst_stride, dst_width); + src_ptr += src_stride; + // TODO(fbarchard): Test performance of writing one row of destination at a + // time. + dst_ptr += 2 * dst_stride; + } + if (!(dst_height & 1)) { + Scale2RowUp(src_ptr, 0, dst_ptr, 0, dst_width); + } +} + +// Scale Plane to/from any dimensions, without interpolation. +// Fixed point math is used for performance: The upper 16 bits +// of x and dx is the integer part of the source position and +// the lower 16 bits are the fixed decimal part. + +static void ScalePlaneSimple(int src_width, + int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_ptr, + uint8_t *dst_ptr) { + int i; + void (*ScaleCols)(uint8_t *dst_ptr, const uint8_t *src_ptr, int dst_width, + int x, int dx) = ScaleCols_C; + // Initial source x/y coordinate and step values as 16.16 fixed point. + int x = 0; + int y = 0; + int dx = 0; + int dy = 0; + ScaleSlope(src_width, src_height, dst_width, dst_height, kFilterNone, &x, &y, + &dx, &dy); + src_width = Abs(src_width); + + if (src_width * 2 == dst_width && x < 0x8000) { + ScaleCols = ScaleColsUp2_C; +#if defined(HAS_SCALECOLS_SSE2) + if (TestCpuFlag(kCpuHasSSE2) && IS_ALIGNED(dst_width, 8)) { + ScaleCols = ScaleColsUp2_SSE2; + } +#endif + } + + for (i = 0; i < dst_height; ++i) { + ScaleCols(dst_ptr, src_ptr + (y >> 16) * (int64_t) src_stride, dst_width, x, + dx); + dst_ptr += dst_stride; + y += dy; + } +} + +// Scale a plane. +// This function dispatches to a specialized scaler based on scale factor. +LIBYUV_API +void ScalePlane(const uint8_t *src, + int src_stride, + int src_width, + int src_height, + uint8_t *dst, + int dst_stride, + int dst_width, + int dst_height, + enum FilterMode filtering) { + // Simplify filtering when possible. + filtering = ScaleFilterReduce(src_width, src_height, dst_width, dst_height, + filtering); + + // Negative height means invert the image. + if (src_height < 0) { + src_height = -src_height; + src = src + (src_height - 1) * (int64_t) src_stride; + src_stride = -src_stride; + } + // Use specialized scales to improve performance for common resolutions. + // For example, all the 1/2 scalings will use ScalePlaneDown2() + if (dst_width == src_width && dst_height == src_height) { + // Straight copy. + CopyPlane(src, src_stride, dst, dst_stride, dst_width, dst_height); + return; + } + if (dst_width == src_width && filtering != kFilterBox) { + int dy = 0; + int y = 0; + // When scaling down, use the center 2 rows to filter. + // When scaling up, last row of destination uses the last 2 source rows. + if (dst_height <= src_height) { + dy = FixedDiv(src_height, dst_height); + y = CENTERSTART(dy, -32768); // Subtract 0.5 (32768) to center filter. + } else if (src_height > 1 && dst_height > 1) { + dy = FixedDiv1(src_height, dst_height); + } + // Arbitrary scale vertically, but unscaled horizontally. + ScalePlaneVertical(src_height, dst_width, dst_height, src_stride, + dst_stride, src, dst, 0, y, dy, /*bpp=*/1, filtering); + return; + } + if (dst_width <= Abs(src_width) && dst_height <= src_height) { + // Scale down. + if (4 * dst_width == 3 * src_width && 4 * dst_height == 3 * src_height) { + // optimized, 3/4 + ScalePlaneDown34(src_width, src_height, dst_width, dst_height, src_stride, + dst_stride, src, dst, filtering); + return; + } + if (2 * dst_width == src_width && 2 * dst_height == src_height) { + // optimized, 1/2 + ScalePlaneDown2(src_width, src_height, dst_width, dst_height, src_stride, + dst_stride, src, dst, filtering); + return; + } + // 3/8 rounded up for odd sized chroma height. + if (8 * dst_width == 3 * src_width && 8 * dst_height == 3 * src_height) { + // optimized, 3/8 + ScalePlaneDown38(src_width, src_height, dst_width, dst_height, src_stride, + dst_stride, src, dst, filtering); + return; + } + if (4 * dst_width == src_width && 4 * dst_height == src_height && + (filtering == kFilterBox || filtering == kFilterNone)) { + // optimized, 1/4 + ScalePlaneDown4(src_width, src_height, dst_width, dst_height, src_stride, + dst_stride, src, dst, filtering); + return; + } + } + if (filtering == kFilterBox && dst_height * 2 < src_height) { + ScalePlaneBox(src_width, src_height, dst_width, dst_height, src_stride, + dst_stride, src, dst); + return; + } + if ((dst_width + 1) / 2 == src_width && filtering == kFilterLinear) { + ScalePlaneUp2_Linear(src_width, src_height, dst_width, dst_height, + src_stride, dst_stride, src, dst); + return; + } + if ((dst_height + 1) / 2 == src_height && (dst_width + 1) / 2 == src_width && + (filtering == kFilterBilinear || filtering == kFilterBox)) { + ScalePlaneUp2_Bilinear(src_width, src_height, dst_width, dst_height, + src_stride, dst_stride, src, dst); + return; + } + if (filtering && dst_height > src_height) { + ScalePlaneBilinearUp(src_width, src_height, dst_width, dst_height, + src_stride, dst_stride, src, dst, filtering); + return; + } + if (filtering) { + ScalePlaneBilinearDown(src_width, src_height, dst_width, dst_height, + src_stride, dst_stride, src, dst, filtering); + return; + } + ScalePlaneSimple(src_width, src_height, dst_width, dst_height, src_stride, + dst_stride, src, dst); +} + +LIBYUV_API +int I420Scale(const uint8_t *src_y, + int src_stride_y, + const uint8_t *src_u, + int src_stride_u, + const uint8_t *src_v, + int src_stride_v, + int src_width, + int src_height, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int dst_width, + int dst_height, + enum FilterMode filtering) { + int src_halfwidth = SUBSAMPLE(src_width, 1, 1); + int src_halfheight = SUBSAMPLE(src_height, 1, 1); + int dst_halfwidth = SUBSAMPLE(dst_width, 1, 1); + int dst_halfheight = SUBSAMPLE(dst_height, 1, 1); + + if (!src_y || !src_u || !src_v || src_width <= 0 || src_height == 0 || + src_width > 32768 || src_height > 32768 || !dst_y || !dst_u || !dst_v || + dst_width <= 0 || dst_height <= 0) { + return -1; + } + + ScalePlane(src_y, src_stride_y, src_width, src_height, dst_y, dst_stride_y, + dst_width, dst_height, filtering); + ScalePlane(src_u, src_stride_u, src_halfwidth, src_halfheight, dst_u, + dst_stride_u, dst_halfwidth, dst_halfheight, filtering); + ScalePlane(src_v, src_stride_v, src_halfwidth, src_halfheight, dst_v, + dst_stride_v, dst_halfwidth, dst_halfheight, filtering); + return 0; +} diff --git a/pkg/encoder/yuv/libyuv/scale.h b/pkg/encoder/yuv/libyuv/scale.h new file mode 100644 index 00000000..ed0a1983 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/scale.h @@ -0,0 +1,53 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_SCALE_H_ +#define INCLUDE_LIBYUV_SCALE_H_ + +#include "basic_types.h" + +// Supported filtering. +typedef enum FilterMode { + kFilterNone = 0, // Point sample; Fastest. + kFilterLinear = 1, // Filter horizontally only. + kFilterBilinear = 2, // Faster than box, but lower quality scaling down. + kFilterBox = 3 // Highest quality. +} FilterModeEnum; + +// Scales a YUV 4:2:0 image from the src width and height to the +// dst width and height. +// If filtering is kFilterNone, a simple nearest-neighbor algorithm is +// used. This produces basic (blocky) quality at the fastest speed. +// If filtering is kFilterBilinear, interpolation is used to produce a better +// quality image, at the expense of speed. +// If filtering is kFilterBox, averaging is used to produce ever better +// quality image, at further expense of speed. +// Returns 0 if successful. + +LIBYUV_API +int I420Scale(const uint8_t *src_y, + int src_stride_y, + const uint8_t *src_u, + int src_stride_u, + const uint8_t *src_v, + int src_stride_v, + int src_width, + int src_height, + uint8_t *dst_y, + int dst_stride_y, + uint8_t *dst_u, + int dst_stride_u, + uint8_t *dst_v, + int dst_stride_v, + int dst_width, + int dst_height, + enum FilterMode filtering); + +#endif // INCLUDE_LIBYUV_SCALE_H_ diff --git a/pkg/encoder/yuv/libyuv/scale_any.c b/pkg/encoder/yuv/libyuv/scale_any.c new file mode 100644 index 00000000..f05e55b6 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/scale_any.c @@ -0,0 +1,632 @@ +/* + * Copyright 2015 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "scale_row.h" + +// Fixed scale down. +// Mask may be non-power of 2, so use MOD +#define SDANY(NAMEANY, SCALEROWDOWN_SIMD, SCALEROWDOWN_C, FACTOR, BPP, MASK) \ + void NAMEANY(const uint8_t* src_ptr, ptrdiff_t src_stride, uint8_t* dst_ptr, \ + int dst_width) { \ + int r = (int)((unsigned int)dst_width % (MASK + 1)); /* NOLINT */ \ + int n = dst_width - r; \ + if (n > 0) { \ + SCALEROWDOWN_SIMD(src_ptr, src_stride, dst_ptr, n); \ + } \ + SCALEROWDOWN_C(src_ptr + (n * FACTOR) * BPP, src_stride, \ + dst_ptr + n * BPP, r); \ + } + +// Fixed scale down for odd source width. Used by I420Blend subsampling. +// Since dst_width is (width + 1) / 2, this function scales one less pixel +// and copies the last pixel. +#define SDODD(NAMEANY, SCALEROWDOWN_SIMD, SCALEROWDOWN_C, FACTOR, BPP, MASK) \ + void NAMEANY(const uint8_t* src_ptr, ptrdiff_t src_stride, uint8_t* dst_ptr, \ + int dst_width) { \ + int r = (int)((unsigned int)(dst_width - 1) % (MASK + 1)); /* NOLINT */ \ + int n = (dst_width - 1) - r; \ + if (n > 0) { \ + SCALEROWDOWN_SIMD(src_ptr, src_stride, dst_ptr, n); \ + } \ + SCALEROWDOWN_C(src_ptr + (n * FACTOR) * BPP, src_stride, \ + dst_ptr + n * BPP, r + 1); \ + } + +#ifdef HAS_SCALEROWDOWN2_SSSE3 + +SDANY(ScaleRowDown2_Any_SSSE3, ScaleRowDown2_SSSE3, ScaleRowDown2_C, 2, 1, 15) + +SDANY(ScaleRowDown2Linear_Any_SSSE3, + ScaleRowDown2Linear_SSSE3, + ScaleRowDown2Linear_C, + 2, + 1, + 15) + +SDANY(ScaleRowDown2Box_Any_SSSE3, + ScaleRowDown2Box_SSSE3, + ScaleRowDown2Box_C, + 2, + 1, + 15) + +SDODD(ScaleRowDown2Box_Odd_SSSE3, + ScaleRowDown2Box_SSSE3, + ScaleRowDown2Box_Odd_C, + 2, + 1, + 15) + +#endif +#ifdef HAS_SCALEUVROWDOWN2BOX_SSSE3 + +SDANY(ScaleUVRowDown2Box_Any_SSSE3, + ScaleUVRowDown2Box_SSSE3, + ScaleUVRowDown2Box_C, + 2, + 2, + 3) + +#endif +#ifdef HAS_SCALEUVROWDOWN2BOX_AVX2 + +SDANY(ScaleUVRowDown2Box_Any_AVX2, + ScaleUVRowDown2Box_AVX2, + ScaleUVRowDown2Box_C, + 2, + 2, + 7) + +#endif +#ifdef HAS_SCALEROWDOWN2_AVX2 + +SDANY(ScaleRowDown2_Any_AVX2, ScaleRowDown2_AVX2, ScaleRowDown2_C, 2, 1, 31) + +SDANY(ScaleRowDown2Linear_Any_AVX2, + ScaleRowDown2Linear_AVX2, + ScaleRowDown2Linear_C, + 2, + 1, + 31) + +SDANY(ScaleRowDown2Box_Any_AVX2, + ScaleRowDown2Box_AVX2, + ScaleRowDown2Box_C, + 2, + 1, + 31) + +SDODD(ScaleRowDown2Box_Odd_AVX2, + ScaleRowDown2Box_AVX2, + ScaleRowDown2Box_Odd_C, + 2, + 1, + 31) + +#endif +#ifdef HAS_SCALEROWDOWN4_SSSE3 + +SDANY(ScaleRowDown4_Any_SSSE3, ScaleRowDown4_SSSE3, ScaleRowDown4_C, 4, 1, 7) + +SDANY(ScaleRowDown4Box_Any_SSSE3, + ScaleRowDown4Box_SSSE3, + ScaleRowDown4Box_C, + 4, + 1, + 7) + +#endif +#ifdef HAS_SCALEROWDOWN4_AVX2 + +SDANY(ScaleRowDown4_Any_AVX2, ScaleRowDown4_AVX2, ScaleRowDown4_C, 4, 1, 15) + +SDANY(ScaleRowDown4Box_Any_AVX2, + ScaleRowDown4Box_AVX2, + ScaleRowDown4Box_C, + 4, + 1, + 15) + +#endif +#ifdef HAS_SCALEROWDOWN34_SSSE3 + +SDANY(ScaleRowDown34_Any_SSSE3, + ScaleRowDown34_SSSE3, + ScaleRowDown34_C, + 4 / 3, + 1, + 23) + +SDANY(ScaleRowDown34_0_Box_Any_SSSE3, + ScaleRowDown34_0_Box_SSSE3, + ScaleRowDown34_0_Box_C, + 4 / 3, + 1, + 23) + +SDANY(ScaleRowDown34_1_Box_Any_SSSE3, + ScaleRowDown34_1_Box_SSSE3, + ScaleRowDown34_1_Box_C, + 4 / 3, + 1, + 23) + +#endif + +#ifdef HAS_SCALEROWDOWN38_SSSE3 + +SDANY(ScaleRowDown38_Any_SSSE3, + ScaleRowDown38_SSSE3, + ScaleRowDown38_C, + 8 / 3, + 1, + 11) + +SDANY(ScaleRowDown38_3_Box_Any_SSSE3, + ScaleRowDown38_3_Box_SSSE3, + ScaleRowDown38_3_Box_C, + 8 / 3, + 1, + 5) + +SDANY(ScaleRowDown38_2_Box_Any_SSSE3, + ScaleRowDown38_2_Box_SSSE3, + ScaleRowDown38_2_Box_C, + 8 / 3, + 1, + 5) + +#endif + + +#undef SDANY + +// Scale down by even scale factor. +#define SDAANY(NAMEANY, SCALEROWDOWN_SIMD, SCALEROWDOWN_C, BPP, MASK) \ + void NAMEANY(const uint8_t* src_ptr, ptrdiff_t src_stride, int src_stepx, \ + uint8_t* dst_ptr, int dst_width) { \ + int r = dst_width & MASK; \ + int n = dst_width & ~MASK; \ + if (n > 0) { \ + SCALEROWDOWN_SIMD(src_ptr, src_stride, src_stepx, dst_ptr, n); \ + } \ + SCALEROWDOWN_C(src_ptr + (n * src_stepx) * BPP, src_stride, src_stepx, \ + dst_ptr + n * BPP, r); \ + } + + + +#ifdef SASIMDONLY +// This also works and uses memcpy and SIMD instead of C, but is slower on ARM + +// Add rows box filter scale down. Using macro from row_any +#define SAROW(NAMEANY, ANY_SIMD, SBPP, BPP, MASK) \ + void NAMEANY(const uint8_t* src_ptr, uint16_t* dst_ptr, int width) { \ + SIMD_ALIGNED(uint16_t dst_temp[32]); \ + SIMD_ALIGNED(uint8_t src_temp[32]); \ + memset(dst_temp, 0, 32 * 2); /* for msan */ \ + int r = width & MASK; \ + int n = width & ~MASK; \ + if (n > 0) { \ + ANY_SIMD(src_ptr, dst_ptr, n); \ + } \ + memcpy(src_temp, src_ptr + n * SBPP, r * SBPP); \ + memcpy(dst_temp, dst_ptr + n * BPP, r * BPP); \ + ANY_SIMD(src_temp, dst_temp, MASK + 1); \ + memcpy(dst_ptr + n * BPP, dst_temp, r * BPP); \ + } + +#ifdef HAS_SCALEADDROW_SSE2 +SAROW(ScaleAddRow_Any_SSE2, ScaleAddRow_SSE2, 1, 2, 15) +#endif +#ifdef HAS_SCALEADDROW_AVX2 +SAROW(ScaleAddRow_Any_AVX2, ScaleAddRow_AVX2, 1, 2, 31) +#endif +#undef SAANY + +#else + +// Add rows box filter scale down. +#define SAANY(NAMEANY, SCALEADDROW_SIMD, SCALEADDROW_C, MASK) \ + void NAMEANY(const uint8_t* src_ptr, uint16_t* dst_ptr, int src_width) { \ + int n = src_width & ~MASK; \ + if (n > 0) { \ + SCALEADDROW_SIMD(src_ptr, dst_ptr, n); \ + } \ + SCALEADDROW_C(src_ptr + n, dst_ptr + n, src_width & MASK); \ + } + +#ifdef HAS_SCALEADDROW_SSE2 + +SAANY(ScaleAddRow_Any_SSE2, ScaleAddRow_SSE2, ScaleAddRow_C, 15) + +#endif +#ifdef HAS_SCALEADDROW_AVX2 + +SAANY(ScaleAddRow_Any_AVX2, ScaleAddRow_AVX2, ScaleAddRow_C, 31) + +#endif +#undef SAANY + +#endif // SASIMDONLY + +// Scale up horizontally 2 times using linear filter. +#define SUH2LANY(NAME, SIMD, C, MASK, PTYPE) \ + void NAME(const PTYPE* src_ptr, PTYPE* dst_ptr, int dst_width) { \ + int work_width = (dst_width - 1) & ~1; \ + int r = work_width & MASK; \ + int n = work_width & ~MASK; \ + dst_ptr[0] = src_ptr[0]; \ + if (work_width > 0) { \ + if (n != 0) { \ + SIMD(src_ptr, dst_ptr + 1, n); \ + } \ + C(src_ptr + (n / 2), dst_ptr + n + 1, r); \ + } \ + dst_ptr[dst_width - 1] = src_ptr[(dst_width - 1) / 2]; \ + } + +// Even the C versions need to be wrapped, because boundary pixels have to +// be handled differently + +SUH2LANY(ScaleRowUp2_Linear_Any_C, + ScaleRowUp2_Linear_C, + ScaleRowUp2_Linear_C, + 0, + uint8_t) + +SUH2LANY(ScaleRowUp2_Linear_16_Any_C, + ScaleRowUp2_Linear_16_C, + ScaleRowUp2_Linear_16_C, + 0, + uint16_t) + +#ifdef HAS_SCALEROWUP2_LINEAR_SSE2 + +SUH2LANY(ScaleRowUp2_Linear_Any_SSE2, + ScaleRowUp2_Linear_SSE2, + ScaleRowUp2_Linear_C, + 15, + uint8_t) + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_SSSE3 + +SUH2LANY(ScaleRowUp2_Linear_Any_SSSE3, + ScaleRowUp2_Linear_SSSE3, + ScaleRowUp2_Linear_C, + 15, + uint8_t) + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_12_SSSE3 + +SUH2LANY(ScaleRowUp2_Linear_12_Any_SSSE3, + ScaleRowUp2_Linear_12_SSSE3, + ScaleRowUp2_Linear_16_C, + 15, + uint16_t) + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_16_SSE2 + +SUH2LANY(ScaleRowUp2_Linear_16_Any_SSE2, + ScaleRowUp2_Linear_16_SSE2, + ScaleRowUp2_Linear_16_C, + 7, + uint16_t) + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_AVX2 + +SUH2LANY(ScaleRowUp2_Linear_Any_AVX2, + ScaleRowUp2_Linear_AVX2, + ScaleRowUp2_Linear_C, + 31, + uint8_t) + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_12_AVX2 + +SUH2LANY(ScaleRowUp2_Linear_12_Any_AVX2, + ScaleRowUp2_Linear_12_AVX2, + ScaleRowUp2_Linear_16_C, + 31, + uint16_t) + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_16_AVX2 + +SUH2LANY(ScaleRowUp2_Linear_16_Any_AVX2, + ScaleRowUp2_Linear_16_AVX2, + ScaleRowUp2_Linear_16_C, + 15, + uint16_t) + +#endif +#undef SUH2LANY + +// Scale up 2 times using bilinear filter. +// This function produces 2 rows at a time. +#define SU2BLANY(NAME, SIMD, C, MASK, PTYPE) \ + void NAME(const PTYPE* src_ptr, ptrdiff_t src_stride, PTYPE* dst_ptr, \ + ptrdiff_t dst_stride, int dst_width) { \ + int work_width = (dst_width - 1) & ~1; \ + int r = work_width & MASK; \ + int n = work_width & ~MASK; \ + const PTYPE* sa = src_ptr; \ + const PTYPE* sb = src_ptr + src_stride; \ + PTYPE* da = dst_ptr; \ + PTYPE* db = dst_ptr + dst_stride; \ + da[0] = (3 * sa[0] + sb[0] + 2) >> 2; \ + db[0] = (sa[0] + 3 * sb[0] + 2) >> 2; \ + if (work_width > 0) { \ + if (n != 0) { \ + SIMD(sa, sb - sa, da + 1, db - da, n); \ + } \ + C(sa + (n / 2), sb - sa, da + n + 1, db - da, r); \ + } \ + da[dst_width - 1] = \ + (3 * sa[(dst_width - 1) / 2] + sb[(dst_width - 1) / 2] + 2) >> 2; \ + db[dst_width - 1] = \ + (sa[(dst_width - 1) / 2] + 3 * sb[(dst_width - 1) / 2] + 2) >> 2; \ + } + +SU2BLANY(ScaleRowUp2_Bilinear_Any_C, + ScaleRowUp2_Bilinear_C, + ScaleRowUp2_Bilinear_C, + 0, + uint8_t) + +SU2BLANY(ScaleRowUp2_Bilinear_16_Any_C, + ScaleRowUp2_Bilinear_16_C, + ScaleRowUp2_Bilinear_16_C, + 0, + uint16_t) + +#ifdef HAS_SCALEROWUP2_BILINEAR_SSE2 + +SU2BLANY(ScaleRowUp2_Bilinear_Any_SSE2, + ScaleRowUp2_Bilinear_SSE2, + ScaleRowUp2_Bilinear_C, + 15, + uint8_t) + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_12_SSSE3 + +SU2BLANY(ScaleRowUp2_Bilinear_12_Any_SSSE3, + ScaleRowUp2_Bilinear_12_SSSE3, + ScaleRowUp2_Bilinear_16_C, + 15, + uint16_t) + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_16_SSE2 + +SU2BLANY(ScaleRowUp2_Bilinear_16_Any_SSE2, + ScaleRowUp2_Bilinear_16_SSE2, + ScaleRowUp2_Bilinear_16_C, + 7, + uint16_t) + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_SSSE3 + +SU2BLANY(ScaleRowUp2_Bilinear_Any_SSSE3, + ScaleRowUp2_Bilinear_SSSE3, + ScaleRowUp2_Bilinear_C, + 15, + uint8_t) + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_AVX2 + +SU2BLANY(ScaleRowUp2_Bilinear_Any_AVX2, + ScaleRowUp2_Bilinear_AVX2, + ScaleRowUp2_Bilinear_C, + 31, + uint8_t) + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_12_AVX2 + +SU2BLANY(ScaleRowUp2_Bilinear_12_Any_AVX2, + ScaleRowUp2_Bilinear_12_AVX2, + ScaleRowUp2_Bilinear_16_C, + 15, + uint16_t) + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_16_AVX2 + +SU2BLANY(ScaleRowUp2_Bilinear_16_Any_AVX2, + ScaleRowUp2_Bilinear_16_AVX2, + ScaleRowUp2_Bilinear_16_C, + 15, + uint16_t) + +#endif + +#undef SU2BLANY + +// Scale bi-planar plane up horizontally 2 times using linear filter. +#define SBUH2LANY(NAME, SIMD, C, MASK, PTYPE) \ + void NAME(const PTYPE* src_ptr, PTYPE* dst_ptr, int dst_width) { \ + int work_width = (dst_width - 1) & ~1; \ + int r = work_width & MASK; \ + int n = work_width & ~MASK; \ + dst_ptr[0] = src_ptr[0]; \ + dst_ptr[1] = src_ptr[1]; \ + if (work_width > 0) { \ + if (n != 0) { \ + SIMD(src_ptr, dst_ptr + 2, n); \ + } \ + C(src_ptr + n, dst_ptr + 2 * n + 2, r); \ + } \ + dst_ptr[2 * dst_width - 2] = src_ptr[((dst_width + 1) & ~1) - 2]; \ + dst_ptr[2 * dst_width - 1] = src_ptr[((dst_width + 1) & ~1) - 1]; \ + } + +SBUH2LANY(ScaleUVRowUp2_Linear_Any_C, + ScaleUVRowUp2_Linear_C, + ScaleUVRowUp2_Linear_C, + 0, + uint8_t) + +SBUH2LANY(ScaleUVRowUp2_Linear_16_Any_C, + ScaleUVRowUp2_Linear_16_C, + ScaleUVRowUp2_Linear_16_C, + 0, + uint16_t) + +#ifdef HAS_SCALEUVROWUP2_LINEAR_SSSE3 + +SBUH2LANY(ScaleUVRowUp2_Linear_Any_SSSE3, + ScaleUVRowUp2_Linear_SSSE3, + ScaleUVRowUp2_Linear_C, + 7, + uint8_t) + +#endif + +#ifdef HAS_SCALEUVROWUP2_LINEAR_AVX2 + +SBUH2LANY(ScaleUVRowUp2_Linear_Any_AVX2, + ScaleUVRowUp2_Linear_AVX2, + ScaleUVRowUp2_Linear_C, + 15, + uint8_t) + +#endif + +#ifdef HAS_SCALEUVROWUP2_LINEAR_16_SSE41 + +SBUH2LANY(ScaleUVRowUp2_Linear_16_Any_SSE41, + ScaleUVRowUp2_Linear_16_SSE41, + ScaleUVRowUp2_Linear_16_C, + 3, + uint16_t) + +#endif + +#ifdef HAS_SCALEUVROWUP2_LINEAR_16_AVX2 + +SBUH2LANY(ScaleUVRowUp2_Linear_16_Any_AVX2, + ScaleUVRowUp2_Linear_16_AVX2, + ScaleUVRowUp2_Linear_16_C, + 7, + uint16_t) + +#endif + +#undef SBUH2LANY + +// Scale bi-planar plane up 2 times using bilinear filter. +// This function produces 2 rows at a time. +#define SBU2BLANY(NAME, SIMD, C, MASK, PTYPE) \ + void NAME(const PTYPE* src_ptr, ptrdiff_t src_stride, PTYPE* dst_ptr, \ + ptrdiff_t dst_stride, int dst_width) { \ + int work_width = (dst_width - 1) & ~1; \ + int r = work_width & MASK; \ + int n = work_width & ~MASK; \ + const PTYPE* sa = src_ptr; \ + const PTYPE* sb = src_ptr + src_stride; \ + PTYPE* da = dst_ptr; \ + PTYPE* db = dst_ptr + dst_stride; \ + da[0] = (3 * sa[0] + sb[0] + 2) >> 2; \ + db[0] = (sa[0] + 3 * sb[0] + 2) >> 2; \ + da[1] = (3 * sa[1] + sb[1] + 2) >> 2; \ + db[1] = (sa[1] + 3 * sb[1] + 2) >> 2; \ + if (work_width > 0) { \ + if (n != 0) { \ + SIMD(sa, sb - sa, da + 2, db - da, n); \ + } \ + C(sa + n, sb - sa, da + 2 * n + 2, db - da, r); \ + } \ + da[2 * dst_width - 2] = (3 * sa[((dst_width + 1) & ~1) - 2] + \ + sb[((dst_width + 1) & ~1) - 2] + 2) >> \ + 2; \ + db[2 * dst_width - 2] = (sa[((dst_width + 1) & ~1) - 2] + \ + 3 * sb[((dst_width + 1) & ~1) - 2] + 2) >> \ + 2; \ + da[2 * dst_width - 1] = (3 * sa[((dst_width + 1) & ~1) - 1] + \ + sb[((dst_width + 1) & ~1) - 1] + 2) >> \ + 2; \ + db[2 * dst_width - 1] = (sa[((dst_width + 1) & ~1) - 1] + \ + 3 * sb[((dst_width + 1) & ~1) - 1] + 2) >> \ + 2; \ + } + +SBU2BLANY(ScaleUVRowUp2_Bilinear_Any_C, + ScaleUVRowUp2_Bilinear_C, + ScaleUVRowUp2_Bilinear_C, + 0, + uint8_t) + +SBU2BLANY(ScaleUVRowUp2_Bilinear_16_Any_C, + ScaleUVRowUp2_Bilinear_16_C, + ScaleUVRowUp2_Bilinear_16_C, + 0, + uint16_t) + +#ifdef HAS_SCALEUVROWUP2_BILINEAR_SSSE3 + +SBU2BLANY(ScaleUVRowUp2_Bilinear_Any_SSSE3, + ScaleUVRowUp2_Bilinear_SSSE3, + ScaleUVRowUp2_Bilinear_C, + 7, + uint8_t) + +#endif + +#ifdef HAS_SCALEUVROWUP2_BILINEAR_AVX2 + +SBU2BLANY(ScaleUVRowUp2_Bilinear_Any_AVX2, + ScaleUVRowUp2_Bilinear_AVX2, + ScaleUVRowUp2_Bilinear_C, + 15, + uint8_t) + +#endif + +#ifdef HAS_SCALEUVROWUP2_BILINEAR_16_SSE41 + +SBU2BLANY(ScaleUVRowUp2_Bilinear_16_Any_SSE41, + ScaleUVRowUp2_Bilinear_16_SSE41, + ScaleUVRowUp2_Bilinear_16_C, + 7, + uint16_t) + +#endif + +#ifdef HAS_SCALEUVROWUP2_BILINEAR_16_AVX2 + +SBU2BLANY(ScaleUVRowUp2_Bilinear_16_Any_AVX2, + ScaleUVRowUp2_Bilinear_16_AVX2, + ScaleUVRowUp2_Bilinear_16_C, + 7, + uint16_t) + +#endif + +#undef SBU2BLANY diff --git a/pkg/encoder/yuv/libyuv/scale_common.c b/pkg/encoder/yuv/libyuv/scale_common.c new file mode 100644 index 00000000..17eedd99 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/scale_common.c @@ -0,0 +1,930 @@ +/* + * Copyright 2013 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "scale.h" + +#include + +#include "cpu_id.h" +#include "row.h" +#include "scale_row.h" + +#define STATIC_CAST(type, expr) (type)(expr) + +// TODO(fbarchard): make clamp255 preserve negative values. +static __inline int32_t clamp255(int32_t v) { + return (-(v >= 255) | v) & 255; +} + +// Use scale to convert lsb formats to msb, depending how many bits there are: +// 32768 = 9 bits +// 16384 = 10 bits +// 4096 = 12 bits +// 256 = 16 bits +// TODO(fbarchard): change scale to bits +#define C16TO8(v, scale) clamp255(((v) * (scale)) >> 16) + +static __inline int Abs(int v) { + return v >= 0 ? v : -v; +} + +// CPU agnostic row functions +void ScaleRowDown2_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width) { + int x; + (void) src_stride; + for (x = 0; x < dst_width - 1; x += 2) { + dst[0] = src_ptr[1]; + dst[1] = src_ptr[3]; + dst += 2; + src_ptr += 4; + } + if (dst_width & 1) { + dst[0] = src_ptr[1]; + } +} + +void ScaleRowDown2Linear_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width) { + const uint8_t *s = src_ptr; + int x; + (void) src_stride; + for (x = 0; x < dst_width - 1; x += 2) { + dst[0] = (s[0] + s[1] + 1) >> 1; + dst[1] = (s[2] + s[3] + 1) >> 1; + dst += 2; + s += 4; + } + if (dst_width & 1) { + dst[0] = (s[0] + s[1] + 1) >> 1; + } +} + +void ScaleRowDown2Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width) { + const uint8_t *s = src_ptr; + const uint8_t *t = src_ptr + src_stride; + int x; + for (x = 0; x < dst_width - 1; x += 2) { + dst[0] = (s[0] + s[1] + t[0] + t[1] + 2) >> 2; + dst[1] = (s[2] + s[3] + t[2] + t[3] + 2) >> 2; + dst += 2; + s += 4; + t += 4; + } + if (dst_width & 1) { + dst[0] = (s[0] + s[1] + t[0] + t[1] + 2) >> 2; + } +} + +void ScaleRowDown2Box_Odd_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width) { + const uint8_t *s = src_ptr; + const uint8_t *t = src_ptr + src_stride; + int x; + dst_width -= 1; + for (x = 0; x < dst_width - 1; x += 2) { + dst[0] = (s[0] + s[1] + t[0] + t[1] + 2) >> 2; + dst[1] = (s[2] + s[3] + t[2] + t[3] + 2) >> 2; + dst += 2; + s += 4; + t += 4; + } + if (dst_width & 1) { + dst[0] = (s[0] + s[1] + t[0] + t[1] + 2) >> 2; + dst += 1; + s += 2; + t += 2; + } + dst[0] = (s[0] + t[0] + 1) >> 1; +} + +void ScaleRowDown4_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width) { + int x; + (void) src_stride; + for (x = 0; x < dst_width - 1; x += 2) { + dst[0] = src_ptr[2]; + dst[1] = src_ptr[6]; + dst += 2; + src_ptr += 8; + } + if (dst_width & 1) { + dst[0] = src_ptr[2]; + } +} + +void ScaleRowDown4Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width) { + intptr_t stride = src_stride; + int x; + for (x = 0; x < dst_width - 1; x += 2) { + dst[0] = (src_ptr[0] + src_ptr[1] + src_ptr[2] + src_ptr[3] + + src_ptr[stride + 0] + src_ptr[stride + 1] + src_ptr[stride + 2] + + src_ptr[stride + 3] + src_ptr[stride * 2 + 0] + + src_ptr[stride * 2 + 1] + src_ptr[stride * 2 + 2] + + src_ptr[stride * 2 + 3] + src_ptr[stride * 3 + 0] + + src_ptr[stride * 3 + 1] + src_ptr[stride * 3 + 2] + + src_ptr[stride * 3 + 3] + 8) >> + 4; + dst[1] = (src_ptr[4] + src_ptr[5] + src_ptr[6] + src_ptr[7] + + src_ptr[stride + 4] + src_ptr[stride + 5] + src_ptr[stride + 6] + + src_ptr[stride + 7] + src_ptr[stride * 2 + 4] + + src_ptr[stride * 2 + 5] + src_ptr[stride * 2 + 6] + + src_ptr[stride * 2 + 7] + src_ptr[stride * 3 + 4] + + src_ptr[stride * 3 + 5] + src_ptr[stride * 3 + 6] + + src_ptr[stride * 3 + 7] + 8) >> + 4; + dst += 2; + src_ptr += 8; + } + if (dst_width & 1) { + dst[0] = (src_ptr[0] + src_ptr[1] + src_ptr[2] + src_ptr[3] + + src_ptr[stride + 0] + src_ptr[stride + 1] + src_ptr[stride + 2] + + src_ptr[stride + 3] + src_ptr[stride * 2 + 0] + + src_ptr[stride * 2 + 1] + src_ptr[stride * 2 + 2] + + src_ptr[stride * 2 + 3] + src_ptr[stride * 3 + 0] + + src_ptr[stride * 3 + 1] + src_ptr[stride * 3 + 2] + + src_ptr[stride * 3 + 3] + 8) >> + 4; + } +} + +void ScaleRowDown34_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width) { + int x; + (void) src_stride; + assert((dst_width % 3 == 0) && (dst_width > 0)); + for (x = 0; x < dst_width; x += 3) { + dst[0] = src_ptr[0]; + dst[1] = src_ptr[1]; + dst[2] = src_ptr[3]; + dst += 3; + src_ptr += 4; + } +} + +// Filter rows 0 and 1 together, 3 : 1 +void ScaleRowDown34_0_Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *d, + int dst_width) { + const uint8_t *s = src_ptr; + const uint8_t *t = src_ptr + src_stride; + int x; + assert((dst_width % 3 == 0) && (dst_width > 0)); + for (x = 0; x < dst_width; x += 3) { + uint8_t a0 = (s[0] * 3 + s[1] * 1 + 2) >> 2; + uint8_t a1 = (s[1] * 1 + s[2] * 1 + 1) >> 1; + uint8_t a2 = (s[2] * 1 + s[3] * 3 + 2) >> 2; + uint8_t b0 = (t[0] * 3 + t[1] * 1 + 2) >> 2; + uint8_t b1 = (t[1] * 1 + t[2] * 1 + 1) >> 1; + uint8_t b2 = (t[2] * 1 + t[3] * 3 + 2) >> 2; + d[0] = (a0 * 3 + b0 + 2) >> 2; + d[1] = (a1 * 3 + b1 + 2) >> 2; + d[2] = (a2 * 3 + b2 + 2) >> 2; + d += 3; + s += 4; + t += 4; + } +} + +// Filter rows 1 and 2 together, 1 : 1 +void ScaleRowDown34_1_Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *d, + int dst_width) { + const uint8_t *s = src_ptr; + const uint8_t *t = src_ptr + src_stride; + int x; + assert((dst_width % 3 == 0) && (dst_width > 0)); + for (x = 0; x < dst_width; x += 3) { + uint8_t a0 = (s[0] * 3 + s[1] * 1 + 2) >> 2; + uint8_t a1 = (s[1] * 1 + s[2] * 1 + 1) >> 1; + uint8_t a2 = (s[2] * 1 + s[3] * 3 + 2) >> 2; + uint8_t b0 = (t[0] * 3 + t[1] * 1 + 2) >> 2; + uint8_t b1 = (t[1] * 1 + t[2] * 1 + 1) >> 1; + uint8_t b2 = (t[2] * 1 + t[3] * 3 + 2) >> 2; + d[0] = (a0 + b0 + 1) >> 1; + d[1] = (a1 + b1 + 1) >> 1; + d[2] = (a2 + b2 + 1) >> 1; + d += 3; + s += 4; + t += 4; + } +} + +// Sample position: (O is src sample position, X is dst sample position) +// +// v dst_ptr at here v stop at here +// X O X X O X X O X X O X X O X +// ^ src_ptr at here +void ScaleRowUp2_Linear_C(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width) { + int src_width = dst_width >> 1; + int x; + assert((dst_width % 2 == 0) && (dst_width >= 0)); + for (x = 0; x < src_width; ++x) { + dst_ptr[2 * x + 0] = (src_ptr[x + 0] * 3 + src_ptr[x + 1] * 1 + 2) >> 2; + dst_ptr[2 * x + 1] = (src_ptr[x + 0] * 1 + src_ptr[x + 1] * 3 + 2) >> 2; + } +} + +// Sample position: (O is src sample position, X is dst sample position) +// +// src_ptr at here +// X v X X X X X X X X X +// O O O O O +// X X X X X X X X X X +// ^ dst_ptr at here ^ stop at here +// X X X X X X X X X X +// O O O O O +// X X X X X X X X X X +void ScaleRowUp2_Bilinear_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + const uint8_t *s = src_ptr; + const uint8_t *t = src_ptr + src_stride; + uint8_t *d = dst_ptr; + uint8_t *e = dst_ptr + dst_stride; + int src_width = dst_width >> 1; + int x; + assert((dst_width % 2 == 0) && (dst_width >= 0)); + for (x = 0; x < src_width; ++x) { + d[2 * x + 0] = + (s[x + 0] * 9 + s[x + 1] * 3 + t[x + 0] * 3 + t[x + 1] * 1 + 8) >> 4; + d[2 * x + 1] = + (s[x + 0] * 3 + s[x + 1] * 9 + t[x + 0] * 1 + t[x + 1] * 3 + 8) >> 4; + e[2 * x + 0] = + (s[x + 0] * 3 + s[x + 1] * 1 + t[x + 0] * 9 + t[x + 1] * 3 + 8) >> 4; + e[2 * x + 1] = + (s[x + 0] * 1 + s[x + 1] * 3 + t[x + 0] * 3 + t[x + 1] * 9 + 8) >> 4; + } +} + +// Only suitable for at most 14 bit range. +void ScaleRowUp2_Linear_16_C(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width) { + int src_width = dst_width >> 1; + int x; + assert((dst_width % 2 == 0) && (dst_width >= 0)); + for (x = 0; x < src_width; ++x) { + dst_ptr[2 * x + 0] = (src_ptr[x + 0] * 3 + src_ptr[x + 1] * 1 + 2) >> 2; + dst_ptr[2 * x + 1] = (src_ptr[x + 0] * 1 + src_ptr[x + 1] * 3 + 2) >> 2; + } +} + +// Only suitable for at most 12bit range. +void ScaleRowUp2_Bilinear_16_C(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + const uint16_t *s = src_ptr; + const uint16_t *t = src_ptr + src_stride; + uint16_t *d = dst_ptr; + uint16_t *e = dst_ptr + dst_stride; + int src_width = dst_width >> 1; + int x; + assert((dst_width % 2 == 0) && (dst_width >= 0)); + for (x = 0; x < src_width; ++x) { + d[2 * x + 0] = + (s[x + 0] * 9 + s[x + 1] * 3 + t[x + 0] * 3 + t[x + 1] * 1 + 8) >> 4; + d[2 * x + 1] = + (s[x + 0] * 3 + s[x + 1] * 9 + t[x + 0] * 1 + t[x + 1] * 3 + 8) >> 4; + e[2 * x + 0] = + (s[x + 0] * 3 + s[x + 1] * 1 + t[x + 0] * 9 + t[x + 1] * 3 + 8) >> 4; + e[2 * x + 1] = + (s[x + 0] * 1 + s[x + 1] * 3 + t[x + 0] * 3 + t[x + 1] * 9 + 8) >> 4; + } +} + +// (1-f)a + fb can be replaced with a + f(b-a) +#if defined(__arm__) || defined(__aarch64__) +#define BLENDER(a, b, f) \ + (uint8_t)((int)(a) + ((((int)((f)) * ((int)(b) - (int)(a))) + 0x8000) >> 16)) +#else +// Intel uses 7 bit math with rounding. +#define BLENDER(a, b, f) \ + (uint8_t)((int)(a) + (((int)((f) >> 9) * ((int)(b) - (int)(a)) + 0x40) >> 7)) +#endif + +void ScaleFilterCols_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx) { + int j; + for (j = 0; j < dst_width - 1; j += 2) { + int xi = x >> 16; + int a = src_ptr[xi]; + int b = src_ptr[xi + 1]; + dst_ptr[0] = BLENDER(a, b, x & 0xffff); + x += dx; + xi = x >> 16; + a = src_ptr[xi]; + b = src_ptr[xi + 1]; + dst_ptr[1] = BLENDER(a, b, x & 0xffff); + x += dx; + dst_ptr += 2; + } + if (dst_width & 1) { + int xi = x >> 16; + int a = src_ptr[xi]; + int b = src_ptr[xi + 1]; + dst_ptr[0] = BLENDER(a, b, x & 0xffff); + } +} + +void ScaleFilterCols64_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x32, + int dx) { + int64_t x = (int64_t) (x32); + int j; + for (j = 0; j < dst_width - 1; j += 2) { + int64_t xi = x >> 16; + int a = src_ptr[xi]; + int b = src_ptr[xi + 1]; + dst_ptr[0] = BLENDER(a, b, x & 0xffff); + x += dx; + xi = x >> 16; + a = src_ptr[xi]; + b = src_ptr[xi + 1]; + dst_ptr[1] = BLENDER(a, b, x & 0xffff); + x += dx; + dst_ptr += 2; + } + if (dst_width & 1) { + int64_t xi = x >> 16; + int a = src_ptr[xi]; + int b = src_ptr[xi + 1]; + dst_ptr[0] = BLENDER(a, b, x & 0xffff); + } +} + +#undef BLENDER + +// Same as 8 bit arm blender but return is cast to uint16_t +#define BLENDER(a, b, f) \ + (uint16_t)( \ + (int)(a) + \ + (int)((((int64_t)((f)) * ((int64_t)(b) - (int)(a))) + 0x8000) >> 16)) +#undef BLENDER + +void ScaleRowDown38_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width) { + int x; + (void) src_stride; + assert(dst_width % 3 == 0); + for (x = 0; x < dst_width; x += 3) { + dst[0] = src_ptr[0]; + dst[1] = src_ptr[3]; + dst[2] = src_ptr[6]; + dst += 3; + src_ptr += 8; + } +} + +// 8x3 -> 3x1 +void ScaleRowDown38_3_Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + intptr_t stride = src_stride; + int i; + assert((dst_width % 3 == 0) && (dst_width > 0)); + for (i = 0; i < dst_width; i += 3) { + dst_ptr[0] = + (src_ptr[0] + src_ptr[1] + src_ptr[2] + src_ptr[stride + 0] + + src_ptr[stride + 1] + src_ptr[stride + 2] + src_ptr[stride * 2 + 0] + + src_ptr[stride * 2 + 1] + src_ptr[stride * 2 + 2]) * + (65536 / 9) >> + 16; + dst_ptr[1] = + (src_ptr[3] + src_ptr[4] + src_ptr[5] + src_ptr[stride + 3] + + src_ptr[stride + 4] + src_ptr[stride + 5] + src_ptr[stride * 2 + 3] + + src_ptr[stride * 2 + 4] + src_ptr[stride * 2 + 5]) * + (65536 / 9) >> + 16; + dst_ptr[2] = + (src_ptr[6] + src_ptr[7] + src_ptr[stride + 6] + src_ptr[stride + 7] + + src_ptr[stride * 2 + 6] + src_ptr[stride * 2 + 7]) * + (65536 / 6) >> + 16; + src_ptr += 8; + dst_ptr += 3; + } +} + +// 8x2 -> 3x1 +void ScaleRowDown38_2_Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + intptr_t stride = src_stride; + int i; + assert((dst_width % 3 == 0) && (dst_width > 0)); + for (i = 0; i < dst_width; i += 3) { + dst_ptr[0] = (src_ptr[0] + src_ptr[1] + src_ptr[2] + src_ptr[stride + 0] + + src_ptr[stride + 1] + src_ptr[stride + 2]) * + (65536 / 6) >> + 16; + dst_ptr[1] = (src_ptr[3] + src_ptr[4] + src_ptr[5] + src_ptr[stride + 3] + + src_ptr[stride + 4] + src_ptr[stride + 5]) * + (65536 / 6) >> + 16; + dst_ptr[2] = + (src_ptr[6] + src_ptr[7] + src_ptr[stride + 6] + src_ptr[stride + 7]) * + (65536 / 4) >> + 16; + src_ptr += 8; + dst_ptr += 3; + } +} + +void ScaleAddRow_C(const uint8_t *src_ptr, uint16_t *dst_ptr, int src_width) { + int x; + assert(src_width > 0); + for (x = 0; x < src_width - 1; x += 2) { + dst_ptr[0] += src_ptr[0]; + dst_ptr[1] += src_ptr[1]; + src_ptr += 2; + dst_ptr += 2; + } + if (src_width & 1) { + dst_ptr[0] += src_ptr[0]; + } +} + +// UV scale row functions +// same as ARGB but 2 channels + +void ScaleUVRowDown2_C(const uint8_t *src_uv, + ptrdiff_t src_stride, + uint8_t *dst_uv, + int dst_width) { + int x; + (void) src_stride; + for (x = 0; x < dst_width; ++x) { + dst_uv[0] = src_uv[2]; // Store the 2nd UV + dst_uv[1] = src_uv[3]; + src_uv += 4; + dst_uv += 2; + } +} + +void ScaleUVRowDown2Linear_C(const uint8_t *src_uv, + ptrdiff_t src_stride, + uint8_t *dst_uv, + int dst_width) { + int x; + (void) src_stride; + for (x = 0; x < dst_width; ++x) { + dst_uv[0] = (src_uv[0] + src_uv[2] + 1) >> 1; + dst_uv[1] = (src_uv[1] + src_uv[3] + 1) >> 1; + src_uv += 4; + dst_uv += 2; + } +} + +void ScaleUVRowDown2Box_C(const uint8_t *src_uv, + ptrdiff_t src_stride, + uint8_t *dst_uv, + int dst_width) { + int x; + for (x = 0; x < dst_width; ++x) { + dst_uv[0] = (src_uv[0] + src_uv[2] + src_uv[src_stride] + + src_uv[src_stride + 2] + 2) >> + 2; + dst_uv[1] = (src_uv[1] + src_uv[3] + src_uv[src_stride + 1] + + src_uv[src_stride + 3] + 2) >> + 2; + src_uv += 4; + dst_uv += 2; + } +} + +void ScaleUVRowDownEven_C(const uint8_t *src_uv, + ptrdiff_t src_stride, + int src_stepx, + uint8_t *dst_uv, + int dst_width) { + const uint16_t *src = (const uint16_t *) (src_uv); + uint16_t *dst = (uint16_t *) (dst_uv); + (void) src_stride; + int x; + for (x = 0; x < dst_width - 1; x += 2) { + dst[0] = src[0]; + dst[1] = src[src_stepx]; + src += src_stepx * 2; + dst += 2; + } + if (dst_width & 1) { + dst[0] = src[0]; + } +} + +// Scales a single row of pixels using point sampling. +void ScaleCols_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx) { + int j; + for (j = 0; j < dst_width - 1; j += 2) { + dst_ptr[0] = src_ptr[x >> 16]; + x += dx; + dst_ptr[1] = src_ptr[x >> 16]; + x += dx; + dst_ptr += 2; + } + if (dst_width & 1) { + dst_ptr[0] = src_ptr[x >> 16]; + } +} + +// Scales a single row of pixels up by 2x using point sampling. +void ScaleColsUp2_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx) { + int j; + (void) x; + (void) dx; + for (j = 0; j < dst_width - 1; j += 2) { + dst_ptr[1] = dst_ptr[0] = src_ptr[0]; + src_ptr += 1; + dst_ptr += 2; + } + if (dst_width & 1) { + dst_ptr[0] = src_ptr[0]; + } +} + +void ScaleUVRowUp2_Linear_C(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width) { + int src_width = dst_width >> 1; + int x; + assert((dst_width % 2 == 0) && (dst_width >= 0)); + for (x = 0; x < src_width; ++x) { + dst_ptr[4 * x + 0] = + (src_ptr[2 * x + 0] * 3 + src_ptr[2 * x + 2] * 1 + 2) >> 2; + dst_ptr[4 * x + 1] = + (src_ptr[2 * x + 1] * 3 + src_ptr[2 * x + 3] * 1 + 2) >> 2; + dst_ptr[4 * x + 2] = + (src_ptr[2 * x + 0] * 1 + src_ptr[2 * x + 2] * 3 + 2) >> 2; + dst_ptr[4 * x + 3] = + (src_ptr[2 * x + 1] * 1 + src_ptr[2 * x + 3] * 3 + 2) >> 2; + } +} + +void ScaleUVRowUp2_Bilinear_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + const uint8_t *s = src_ptr; + const uint8_t *t = src_ptr + src_stride; + uint8_t *d = dst_ptr; + uint8_t *e = dst_ptr + dst_stride; + int src_width = dst_width >> 1; + int x; + assert((dst_width % 2 == 0) && (dst_width >= 0)); + for (x = 0; x < src_width; ++x) { + d[4 * x + 0] = (s[2 * x + 0] * 9 + s[2 * x + 2] * 3 + t[2 * x + 0] * 3 + + t[2 * x + 2] * 1 + 8) >> + 4; + d[4 * x + 1] = (s[2 * x + 1] * 9 + s[2 * x + 3] * 3 + t[2 * x + 1] * 3 + + t[2 * x + 3] * 1 + 8) >> + 4; + d[4 * x + 2] = (s[2 * x + 0] * 3 + s[2 * x + 2] * 9 + t[2 * x + 0] * 1 + + t[2 * x + 2] * 3 + 8) >> + 4; + d[4 * x + 3] = (s[2 * x + 1] * 3 + s[2 * x + 3] * 9 + t[2 * x + 1] * 1 + + t[2 * x + 3] * 3 + 8) >> + 4; + e[4 * x + 0] = (s[2 * x + 0] * 3 + s[2 * x + 2] * 1 + t[2 * x + 0] * 9 + + t[2 * x + 2] * 3 + 8) >> + 4; + e[4 * x + 1] = (s[2 * x + 1] * 3 + s[2 * x + 3] * 1 + t[2 * x + 1] * 9 + + t[2 * x + 3] * 3 + 8) >> + 4; + e[4 * x + 2] = (s[2 * x + 0] * 1 + s[2 * x + 2] * 3 + t[2 * x + 0] * 3 + + t[2 * x + 2] * 9 + 8) >> + 4; + e[4 * x + 3] = (s[2 * x + 1] * 1 + s[2 * x + 3] * 3 + t[2 * x + 1] * 3 + + t[2 * x + 3] * 9 + 8) >> + 4; + } +} + +void ScaleUVRowUp2_Linear_16_C(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width) { + int src_width = dst_width >> 1; + int x; + assert((dst_width % 2 == 0) && (dst_width >= 0)); + for (x = 0; x < src_width; ++x) { + dst_ptr[4 * x + 0] = + (src_ptr[2 * x + 0] * 3 + src_ptr[2 * x + 2] * 1 + 2) >> 2; + dst_ptr[4 * x + 1] = + (src_ptr[2 * x + 1] * 3 + src_ptr[2 * x + 3] * 1 + 2) >> 2; + dst_ptr[4 * x + 2] = + (src_ptr[2 * x + 0] * 1 + src_ptr[2 * x + 2] * 3 + 2) >> 2; + dst_ptr[4 * x + 3] = + (src_ptr[2 * x + 1] * 1 + src_ptr[2 * x + 3] * 3 + 2) >> 2; + } +} + +void ScaleUVRowUp2_Bilinear_16_C(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + const uint16_t *s = src_ptr; + const uint16_t *t = src_ptr + src_stride; + uint16_t *d = dst_ptr; + uint16_t *e = dst_ptr + dst_stride; + int src_width = dst_width >> 1; + int x; + assert((dst_width % 2 == 0) && (dst_width >= 0)); + for (x = 0; x < src_width; ++x) { + d[4 * x + 0] = (s[2 * x + 0] * 9 + s[2 * x + 2] * 3 + t[2 * x + 0] * 3 + + t[2 * x + 2] * 1 + 8) >> + 4; + d[4 * x + 1] = (s[2 * x + 1] * 9 + s[2 * x + 3] * 3 + t[2 * x + 1] * 3 + + t[2 * x + 3] * 1 + 8) >> + 4; + d[4 * x + 2] = (s[2 * x + 0] * 3 + s[2 * x + 2] * 9 + t[2 * x + 0] * 1 + + t[2 * x + 2] * 3 + 8) >> + 4; + d[4 * x + 3] = (s[2 * x + 1] * 3 + s[2 * x + 3] * 9 + t[2 * x + 1] * 1 + + t[2 * x + 3] * 3 + 8) >> + 4; + e[4 * x + 0] = (s[2 * x + 0] * 3 + s[2 * x + 2] * 1 + t[2 * x + 0] * 9 + + t[2 * x + 2] * 3 + 8) >> + 4; + e[4 * x + 1] = (s[2 * x + 1] * 3 + s[2 * x + 3] * 1 + t[2 * x + 1] * 9 + + t[2 * x + 3] * 3 + 8) >> + 4; + e[4 * x + 2] = (s[2 * x + 0] * 1 + s[2 * x + 2] * 3 + t[2 * x + 0] * 3 + + t[2 * x + 2] * 9 + 8) >> + 4; + e[4 * x + 3] = (s[2 * x + 1] * 1 + s[2 * x + 3] * 3 + t[2 * x + 1] * 3 + + t[2 * x + 3] * 9 + 8) >> + 4; + } +} + +// TODO(fbarchard): Replace 0x7f ^ f with 128-f. bug=607. +// Mimics SSSE3 blender +#define BLENDER1(a, b, f) ((a) * (0x7f ^ f) + (b)*f) >> 7 +#define BLENDERC(a, b, f, s) \ + (uint16_t)(BLENDER1(((a) >> s) & 255, ((b) >> s) & 255, f) << s) +#define BLENDER(a, b, f) BLENDERC(a, b, f, 8) | BLENDERC(a, b, f, 0) + +void ScaleUVFilterCols_C(uint8_t *dst_uv, + const uint8_t *src_uv, + int dst_width, + int x, + int dx) { + const uint16_t *src = (const uint16_t *) (src_uv); + uint16_t *dst = (uint16_t *) (dst_uv); + int j; + for (j = 0; j < dst_width - 1; j += 2) { + int xi = x >> 16; + int xf = (x >> 9) & 0x7f; + uint16_t a = src[xi]; + uint16_t b = src[xi + 1]; + dst[0] = BLENDER(a, b, xf); + x += dx; + xi = x >> 16; + xf = (x >> 9) & 0x7f; + a = src[xi]; + b = src[xi + 1]; + dst[1] = BLENDER(a, b, xf); + x += dx; + dst += 2; + } + if (dst_width & 1) { + int xi = x >> 16; + int xf = (x >> 9) & 0x7f; + uint16_t a = src[xi]; + uint16_t b = src[xi + 1]; + dst[0] = BLENDER(a, b, xf); + } +} + +#undef BLENDER1 +#undef BLENDERC +#undef BLENDER + +// Scale plane vertically with bilinear interpolation. +void ScalePlaneVertical(int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_argb, + uint8_t *dst_argb, + int x, + int y, + int dy, + int bpp, // bytes per pixel. 4 for ARGB. + enum FilterMode filtering) { + // TODO(fbarchard): Allow higher bpp. + int dst_width_bytes = dst_width * bpp; + void (*InterpolateRow)(uint8_t *dst_argb, const uint8_t *src_argb, + ptrdiff_t src_stride, int dst_width, + int source_y_fraction) = InterpolateRow_C; + const int max_y = (src_height > 1) ? ((src_height - 1) << 16) - 1 : 0; + int j; + assert(bpp >= 1 && bpp <= 4); + assert(src_height != 0); + assert(dst_width > 0); + assert(dst_height > 0); + src_argb += (x >> 16) * bpp; +#if defined(HAS_INTERPOLATEROW_SSSE3) + if (TestCpuFlag(kCpuHasSSSE3)) { + InterpolateRow = InterpolateRow_Any_SSSE3; + if (IS_ALIGNED(dst_width_bytes, 16)) { + InterpolateRow = InterpolateRow_SSSE3; + } + } +#endif +#if defined(HAS_INTERPOLATEROW_AVX2) + if (TestCpuFlag(kCpuHasAVX2)) { + InterpolateRow = InterpolateRow_Any_AVX2; + if (IS_ALIGNED(dst_width_bytes, 32)) { + InterpolateRow = InterpolateRow_AVX2; + } + } +#endif + + + for (j = 0; j < dst_height; ++j) { + int yi; + int yf; + if (y > max_y) { + y = max_y; + } + yi = y >> 16; + yf = filtering ? ((y >> 8) & 255) : 0; + InterpolateRow(dst_argb, src_argb + yi * src_stride, src_stride, + dst_width_bytes, yf); + dst_argb += dst_stride; + y += dy; + } +} + +// Simplify the filtering based on scale factors. +enum FilterMode ScaleFilterReduce(int src_width, + int src_height, + int dst_width, + int dst_height, + enum FilterMode filtering) { + if (src_width < 0) { + src_width = -src_width; + } + if (src_height < 0) { + src_height = -src_height; + } + if (filtering == kFilterBox) { + // If scaling either axis to 0.5 or larger, switch from Box to Bilinear. + if (dst_width * 2 >= src_width || dst_height * 2 >= src_height) { + filtering = kFilterBilinear; + } + } + if (filtering == kFilterBilinear) { + if (src_height == 1) { + filtering = kFilterLinear; + } + // TODO(fbarchard): Detect any odd scale factor and reduce to Linear. + if (dst_height == src_height || dst_height * 3 == src_height) { + filtering = kFilterLinear; + } + // TODO(fbarchard): Remove 1 pixel wide filter restriction, which is to + // avoid reading 2 pixels horizontally that causes memory exception. + if (src_width == 1) { + filtering = kFilterNone; + } + } + if (filtering == kFilterLinear) { + if (src_width == 1) { + filtering = kFilterNone; + } + // TODO(fbarchard): Detect any odd scale factor and reduce to None. + if (dst_width == src_width || dst_width * 3 == src_width) { + filtering = kFilterNone; + } + } + return filtering; +} + +#define CENTERSTART(dx, s) (dx < 0) ? -((-dx >> 1) + s) : ((dx >> 1) + s) + +// Compute slope values for stepping. +void ScaleSlope(int src_width, + int src_height, + int dst_width, + int dst_height, + enum FilterMode filtering, + int *x, + int *y, + int *dx, + int *dy) { + assert(x != NULL); + assert(y != NULL); + assert(dx != NULL); + assert(dy != NULL); + assert(src_width != 0); + assert(src_height != 0); + assert(dst_width > 0); + assert(dst_height > 0); + // Check for 1 pixel and avoid FixedDiv overflow. + if (dst_width == 1 && src_width >= 32768) { + dst_width = src_width; + } + if (dst_height == 1 && src_height >= 32768) { + dst_height = src_height; + } + if (filtering == kFilterBox) { + // Scale step for point sampling duplicates all pixels equally. + *dx = FixedDiv(Abs(src_width), dst_width); + *dy = FixedDiv(src_height, dst_height); + *x = 0; + *y = 0; + } else if (filtering == kFilterBilinear) { + // Scale step for bilinear sampling renders last pixel once for upsample. + if (dst_width <= Abs(src_width)) { + *dx = FixedDiv(Abs(src_width), dst_width); + *x = CENTERSTART(*dx, -32768); // Subtract 0.5 (32768) to center filter. + } else if (src_width > 1 && dst_width > 1) { + *dx = FixedDiv1(Abs(src_width), dst_width); + *x = 0; + } + if (dst_height <= src_height) { + *dy = FixedDiv(src_height, dst_height); + *y = CENTERSTART(*dy, -32768); // Subtract 0.5 (32768) to center filter. + } else if (src_height > 1 && dst_height > 1) { + *dy = FixedDiv1(src_height, dst_height); + *y = 0; + } + } else if (filtering == kFilterLinear) { + // Scale step for bilinear sampling renders last pixel once for upsample. + if (dst_width <= Abs(src_width)) { + *dx = FixedDiv(Abs(src_width), dst_width); + *x = CENTERSTART(*dx, -32768); // Subtract 0.5 (32768) to center filter. + } else if (src_width > 1 && dst_width > 1) { + *dx = FixedDiv1(Abs(src_width), dst_width); + *x = 0; + } + *dy = FixedDiv(src_height, dst_height); + *y = *dy >> 1; + } else { + // Scale step for point sampling duplicates all pixels equally. + *dx = FixedDiv(Abs(src_width), dst_width); + *dy = FixedDiv(src_height, dst_height); + *x = CENTERSTART(*dx, 0); + *y = CENTERSTART(*dy, 0); + } + // Negative src_width means horizontally mirror. + if (src_width < 0) { + *x += (dst_width - 1) * *dx; + *dx = -*dx; + // src_width = -src_width; // Caller must do this. + } +} + +#undef CENTERSTART diff --git a/pkg/encoder/yuv/libyuv/scale_gcc.c b/pkg/encoder/yuv/libyuv/scale_gcc.c new file mode 100644 index 00000000..716d6cfd --- /dev/null +++ b/pkg/encoder/yuv/libyuv/scale_gcc.c @@ -0,0 +1,2651 @@ +/* + * Copyright 2013 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "row.h" +#include "scale_row.h" + +// This module is for GCC x86 and x64. +#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) + +// Offsets for source bytes 0 to 9 +static const uvec8 kShuf0 = {0, 1, 3, 4, 5, 7, 8, 9, + 128, 128, 128, 128, 128, 128, 128, 128}; + +// Offsets for source bytes 11 to 20 with 8 subtracted = 3 to 12. +static const uvec8 kShuf1 = {3, 4, 5, 7, 8, 9, 11, 12, + 128, 128, 128, 128, 128, 128, 128, 128}; + +// Offsets for source bytes 21 to 31 with 16 subtracted = 5 to 31. +static const uvec8 kShuf2 = {5, 7, 8, 9, 11, 12, 13, 15, + 128, 128, 128, 128, 128, 128, 128, 128}; + +// Offsets for source bytes 0 to 10 +static const uvec8 kShuf01 = {0, 1, 1, 2, 2, 3, 4, 5, 5, 6, 6, 7, 8, 9, 9, 10}; + +// Offsets for source bytes 10 to 21 with 8 subtracted = 3 to 13. +static const uvec8 kShuf11 = {2, 3, 4, 5, 5, 6, 6, 7, + 8, 9, 9, 10, 10, 11, 12, 13}; + +// Offsets for source bytes 21 to 31 with 16 subtracted = 5 to 31. +static const uvec8 kShuf21 = {5, 6, 6, 7, 8, 9, 9, 10, + 10, 11, 12, 13, 13, 14, 14, 15}; + +// Coefficients for source bytes 0 to 10 +static const uvec8 kMadd01 = {3, 1, 2, 2, 1, 3, 3, 1, 2, 2, 1, 3, 3, 1, 2, 2}; + +// Coefficients for source bytes 10 to 21 +static const uvec8 kMadd11 = {1, 3, 3, 1, 2, 2, 1, 3, 3, 1, 2, 2, 1, 3, 3, 1}; + +// Coefficients for source bytes 21 to 31 +static const uvec8 kMadd21 = {2, 2, 1, 3, 3, 1, 2, 2, 1, 3, 3, 1, 2, 2, 1, 3}; + +// Coefficients for source bytes 21 to 31 +static const vec16 kRound34 = {2, 2, 2, 2, 2, 2, 2, 2}; + +static const uvec8 kShuf38a = {0, 3, 6, 8, 11, 14, 128, 128, + 128, 128, 128, 128, 128, 128, 128, 128}; + +static const uvec8 kShuf38b = {128, 128, 128, 128, 128, 128, 0, 3, + 6, 8, 11, 14, 128, 128, 128, 128}; + +// Arrange words 0,3,6 into 0,1,2 +static const uvec8 kShufAc = {0, 1, 6, 7, 12, 13, 128, 128, + 128, 128, 128, 128, 128, 128, 128, 128}; + +// Arrange words 0,3,6 into 3,4,5 +static const uvec8 kShufAc3 = {128, 128, 128, 128, 128, 128, 0, 1, + 6, 7, 12, 13, 128, 128, 128, 128}; + +// Scaling values for boxes of 3x3 and 2x3 +static const uvec16 kScaleAc33 = {65536 / 9, 65536 / 9, 65536 / 6, 65536 / 9, + 65536 / 9, 65536 / 6, 0, 0}; + +// Arrange first value for pixels 0,1,2,3,4,5 +static const uvec8 kShufAb0 = {0, 128, 3, 128, 6, 128, 8, 128, + 11, 128, 14, 128, 128, 128, 128, 128}; + +// Arrange second value for pixels 0,1,2,3,4,5 +static const uvec8 kShufAb1 = {1, 128, 4, 128, 7, 128, 9, 128, + 12, 128, 15, 128, 128, 128, 128, 128}; + +// Arrange third value for pixels 0,1,2,3,4,5 +static const uvec8 kShufAb2 = {2, 128, 5, 128, 128, 128, 10, 128, + 13, 128, 128, 128, 128, 128, 128, 128}; + +// Scaling values for boxes of 3x2 and 2x2 +static const uvec16 kScaleAb2 = {65536 / 3, 65536 / 3, 65536 / 2, 65536 / 3, + 65536 / 3, 65536 / 2, 0, 0}; + +// GCC versions of row functions are verbatim conversions from Visual C. +// Generated using gcc disassembly on Visual C object file: +// objdump -D yuvscaler.obj >yuvscaler.txt + +void ScaleRowDown2_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + (void) src_stride; + asm volatile( + // 16 pixel loop. + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "lea 0x20(%0),%0 \n" + "psrlw $0x8,%%xmm0 \n" + "psrlw $0x8,%%xmm1 \n" + "packuswb %%xmm1,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + ::"memory", + "cc", "xmm0", "xmm1"); +} + +void ScaleRowDown2Linear_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + (void) src_stride; + asm volatile( + "pcmpeqb %%xmm4,%%xmm4 \n" + "psrlw $0xf,%%xmm4 \n" + "packuswb %%xmm4,%%xmm4 \n" + "pxor %%xmm5,%%xmm5 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "lea 0x20(%0),%0 \n" + "pmaddubsw %%xmm4,%%xmm0 \n" + "pmaddubsw %%xmm4,%%xmm1 \n" + "pavgw %%xmm5,%%xmm0 \n" + "pavgw %%xmm5,%%xmm1 \n" + "packuswb %%xmm1,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + ::"memory", + "cc", "xmm0", "xmm1", "xmm4", "xmm5"); +} + +void ScaleRowDown2Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "pcmpeqb %%xmm4,%%xmm4 \n" + "psrlw $0xf,%%xmm4 \n" + "packuswb %%xmm4,%%xmm4 \n" + "pxor %%xmm5,%%xmm5 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "movdqu 0x00(%0,%3,1),%%xmm2 \n" + "movdqu 0x10(%0,%3,1),%%xmm3 \n" + "lea 0x20(%0),%0 \n" + "pmaddubsw %%xmm4,%%xmm0 \n" + "pmaddubsw %%xmm4,%%xmm1 \n" + "pmaddubsw %%xmm4,%%xmm2 \n" + "pmaddubsw %%xmm4,%%xmm3 \n" + "paddw %%xmm2,%%xmm0 \n" + "paddw %%xmm3,%%xmm1 \n" + "psrlw $0x1,%%xmm0 \n" + "psrlw $0x1,%%xmm1 \n" + "pavgw %%xmm5,%%xmm0 \n" + "pavgw %%xmm5,%%xmm1 \n" + "packuswb %%xmm1,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm5"); +} + +#ifdef HAS_SCALEROWDOWN2_AVX2 + +void ScaleRowDown2_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + (void) src_stride; + asm volatile(LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" + "vmovdqu 0x20(%0),%%ymm1 \n" + "lea 0x40(%0),%0 \n" + "vpsrlw $0x8,%%ymm0,%%ymm0 \n" + "vpsrlw $0x8,%%ymm1,%%ymm1 \n" + "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + ::"memory", + "cc", "xmm0", "xmm1"); +} + +void ScaleRowDown2Linear_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + (void) src_stride; + asm volatile( + "vpcmpeqb %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrlw $0xf,%%ymm4,%%ymm4 \n" + "vpackuswb %%ymm4,%%ymm4,%%ymm4 \n" + "vpxor %%ymm5,%%ymm5,%%ymm5 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" + "vmovdqu 0x20(%0),%%ymm1 \n" + "lea 0x40(%0),%0 \n" + "vpmaddubsw %%ymm4,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm4,%%ymm1,%%ymm1 \n" + "vpavgw %%ymm5,%%ymm0,%%ymm0 \n" + "vpavgw %%ymm5,%%ymm1,%%ymm1 \n" + "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + ::"memory", + "cc", "xmm0", "xmm1", "xmm4", "xmm5"); +} + +void ScaleRowDown2Box_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "vpcmpeqb %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrlw $0xf,%%ymm4,%%ymm4 \n" + "vpackuswb %%ymm4,%%ymm4,%%ymm4 \n" + "vpxor %%ymm5,%%ymm5,%%ymm5 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" + "vmovdqu 0x20(%0),%%ymm1 \n" + "vmovdqu 0x00(%0,%3,1),%%ymm2 \n" + "vmovdqu 0x20(%0,%3,1),%%ymm3 \n" + "lea 0x40(%0),%0 \n" + "vpmaddubsw %%ymm4,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm4,%%ymm1,%%ymm1 \n" + "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" + "vpmaddubsw %%ymm4,%%ymm3,%%ymm3 \n" + "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" + "vpaddw %%ymm3,%%ymm1,%%ymm1 \n" + "vpsrlw $0x1,%%ymm0,%%ymm0 \n" + "vpsrlw $0x1,%%ymm1,%%ymm1 \n" + "vpavgw %%ymm5,%%ymm0,%%ymm0 \n" + "vpavgw %%ymm5,%%ymm1,%%ymm1 \n" + "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm5"); +} + +#endif // HAS_SCALEROWDOWN2_AVX2 + +void ScaleRowDown4_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + (void) src_stride; + asm volatile( + "pcmpeqb %%xmm5,%%xmm5 \n" + "psrld $0x18,%%xmm5 \n" + "pslld $0x10,%%xmm5 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "lea 0x20(%0),%0 \n" + "pand %%xmm5,%%xmm0 \n" + "pand %%xmm5,%%xmm1 \n" + "packuswb %%xmm1,%%xmm0 \n" + "psrlw $0x8,%%xmm0 \n" + "packuswb %%xmm0,%%xmm0 \n" + "movq %%xmm0,(%1) \n" + "lea 0x8(%1),%1 \n" + "sub $0x8,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + ::"memory", + "cc", "xmm0", "xmm1", "xmm5"); +} + +void ScaleRowDown4Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + intptr_t stridex3; + asm volatile( + "pcmpeqb %%xmm4,%%xmm4 \n" + "psrlw $0xf,%%xmm4 \n" + "movdqa %%xmm4,%%xmm5 \n" + "packuswb %%xmm4,%%xmm4 \n" + "psllw $0x3,%%xmm5 \n" + "lea 0x00(%4,%4,2),%3 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "movdqu 0x00(%0,%4,1),%%xmm2 \n" + "movdqu 0x10(%0,%4,1),%%xmm3 \n" + "pmaddubsw %%xmm4,%%xmm0 \n" + "pmaddubsw %%xmm4,%%xmm1 \n" + "pmaddubsw %%xmm4,%%xmm2 \n" + "pmaddubsw %%xmm4,%%xmm3 \n" + "paddw %%xmm2,%%xmm0 \n" + "paddw %%xmm3,%%xmm1 \n" + "movdqu 0x00(%0,%4,2),%%xmm2 \n" + "movdqu 0x10(%0,%4,2),%%xmm3 \n" + "pmaddubsw %%xmm4,%%xmm2 \n" + "pmaddubsw %%xmm4,%%xmm3 \n" + "paddw %%xmm2,%%xmm0 \n" + "paddw %%xmm3,%%xmm1 \n" + "movdqu 0x00(%0,%3,1),%%xmm2 \n" + "movdqu 0x10(%0,%3,1),%%xmm3 \n" + "lea 0x20(%0),%0 \n" + "pmaddubsw %%xmm4,%%xmm2 \n" + "pmaddubsw %%xmm4,%%xmm3 \n" + "paddw %%xmm2,%%xmm0 \n" + "paddw %%xmm3,%%xmm1 \n" + "phaddw %%xmm1,%%xmm0 \n" + "paddw %%xmm5,%%xmm0 \n" + "psrlw $0x4,%%xmm0 \n" + "packuswb %%xmm0,%%xmm0 \n" + "movq %%xmm0,(%1) \n" + "lea 0x8(%1),%1 \n" + "sub $0x8,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width), // %2 + "=&r"(stridex3) // %3 + : "r"((intptr_t) (src_stride)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#ifdef HAS_SCALEROWDOWN4_AVX2 + +void ScaleRowDown4_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + (void) src_stride; + asm volatile( + "vpcmpeqb %%ymm5,%%ymm5,%%ymm5 \n" + "vpsrld $0x18,%%ymm5,%%ymm5 \n" + "vpslld $0x10,%%ymm5,%%ymm5 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" + "vmovdqu 0x20(%0),%%ymm1 \n" + "lea 0x40(%0),%0 \n" + "vpand %%ymm5,%%ymm0,%%ymm0 \n" + "vpand %%ymm5,%%ymm1,%%ymm1 \n" + "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vpsrlw $0x8,%%ymm0,%%ymm0 \n" + "vpackuswb %%ymm0,%%ymm0,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vmovdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + ::"memory", + "cc", "xmm0", "xmm1", "xmm5"); +} + +void ScaleRowDown4Box_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "vpcmpeqb %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrlw $0xf,%%ymm4,%%ymm4 \n" + "vpsllw $0x3,%%ymm4,%%ymm5 \n" + "vpackuswb %%ymm4,%%ymm4,%%ymm4 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" + "vmovdqu 0x20(%0),%%ymm1 \n" + "vmovdqu 0x00(%0,%3,1),%%ymm2 \n" + "vmovdqu 0x20(%0,%3,1),%%ymm3 \n" + "vpmaddubsw %%ymm4,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm4,%%ymm1,%%ymm1 \n" + "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" + "vpmaddubsw %%ymm4,%%ymm3,%%ymm3 \n" + "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" + "vpaddw %%ymm3,%%ymm1,%%ymm1 \n" + "vmovdqu 0x00(%0,%3,2),%%ymm2 \n" + "vmovdqu 0x20(%0,%3,2),%%ymm3 \n" + "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" + "vpmaddubsw %%ymm4,%%ymm3,%%ymm3 \n" + "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" + "vpaddw %%ymm3,%%ymm1,%%ymm1 \n" + "vmovdqu 0x00(%0,%4,1),%%ymm2 \n" + "vmovdqu 0x20(%0,%4,1),%%ymm3 \n" + "lea 0x40(%0),%0 \n" + "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" + "vpmaddubsw %%ymm4,%%ymm3,%%ymm3 \n" + "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" + "vpaddw %%ymm3,%%ymm1,%%ymm1 \n" + "vphaddw %%ymm1,%%ymm0,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vpaddw %%ymm5,%%ymm0,%%ymm0 \n" + "vpsrlw $0x4,%%ymm0,%%ymm0 \n" + "vpackuswb %%ymm0,%%ymm0,%%ymm0 \n" + "vpermq $0xd8,%%ymm0,%%ymm0 \n" + "vmovdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (src_stride * 3)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif // HAS_SCALEROWDOWN4_AVX2 + +void ScaleRowDown34_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + (void) src_stride; + asm volatile( + "movdqa %0,%%xmm3 \n" + "movdqa %1,%%xmm4 \n" + "movdqa %2,%%xmm5 \n" + : + : "m"(kShuf0), // %0 + "m"(kShuf1), // %1 + "m"(kShuf2) // %2 + ); + asm volatile(LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x10(%0),%%xmm2 \n" + "lea 0x20(%0),%0 \n" + "movdqa %%xmm2,%%xmm1 \n" + "palignr $0x8,%%xmm0,%%xmm1 \n" + "pshufb %%xmm3,%%xmm0 \n" + "pshufb %%xmm4,%%xmm1 \n" + "pshufb %%xmm5,%%xmm2 \n" + "movq %%xmm0,(%1) \n" + "movq %%xmm1,0x8(%1) \n" + "movq %%xmm2,0x10(%1) \n" + "lea 0x18(%1),%1 \n" + "sub $0x18,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + ::"memory", + "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +void ScaleRowDown34_1_Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "movdqa %0,%%xmm2 \n" // kShuf01 + "movdqa %1,%%xmm3 \n" // kShuf11 + "movdqa %2,%%xmm4 \n" // kShuf21 + : + : "m"(kShuf01), // %0 + "m"(kShuf11), // %1 + "m"(kShuf21) // %2 + ); + asm volatile( + "movdqa %0,%%xmm5 \n" // kMadd01 + "movdqa %1,%%xmm0 \n" // kMadd11 + "movdqa %2,%%xmm1 \n" // kRound34 + : + : "m"(kMadd01), // %0 + "m"(kMadd11), // %1 + "m"(kRound34) // %2 + ); + asm volatile(LABELALIGN + "1: \n" + "movdqu (%0),%%xmm6 \n" + "movdqu 0x00(%0,%3,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + "pshufb %%xmm2,%%xmm6 \n" + "pmaddubsw %%xmm5,%%xmm6 \n" + "paddsw %%xmm1,%%xmm6 \n" + "psrlw $0x2,%%xmm6 \n" + "packuswb %%xmm6,%%xmm6 \n" + "movq %%xmm6,(%1) \n" + "movdqu 0x8(%0),%%xmm6 \n" + "movdqu 0x8(%0,%3,1),%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + "pshufb %%xmm3,%%xmm6 \n" + "pmaddubsw %%xmm0,%%xmm6 \n" + "paddsw %%xmm1,%%xmm6 \n" + "psrlw $0x2,%%xmm6 \n" + "packuswb %%xmm6,%%xmm6 \n" + "movq %%xmm6,0x8(%1) \n" + "movdqu 0x10(%0),%%xmm6 \n" + "movdqu 0x10(%0,%3,1),%%xmm7 \n" + "lea 0x20(%0),%0 \n" + "pavgb %%xmm7,%%xmm6 \n" + "pshufb %%xmm4,%%xmm6 \n" + "pmaddubsw %4,%%xmm6 \n" + "paddsw %%xmm1,%%xmm6 \n" + "psrlw $0x2,%%xmm6 \n" + "packuswb %%xmm6,%%xmm6 \n" + "movq %%xmm6,0x10(%1) \n" + "lea 0x18(%1),%1 \n" + "sub $0x18,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "m"(kMadd21) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", + "xmm6", "xmm7"); +} + +void ScaleRowDown34_0_Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "movdqa %0,%%xmm2 \n" // kShuf01 + "movdqa %1,%%xmm3 \n" // kShuf11 + "movdqa %2,%%xmm4 \n" // kShuf21 + : + : "m"(kShuf01), // %0 + "m"(kShuf11), // %1 + "m"(kShuf21) // %2 + ); + asm volatile( + "movdqa %0,%%xmm5 \n" // kMadd01 + "movdqa %1,%%xmm0 \n" // kMadd11 + "movdqa %2,%%xmm1 \n" // kRound34 + : + : "m"(kMadd01), // %0 + "m"(kMadd11), // %1 + "m"(kRound34) // %2 + ); + + asm volatile(LABELALIGN + "1: \n" + "movdqu (%0),%%xmm6 \n" + "movdqu 0x00(%0,%3,1),%%xmm7 \n" + "pavgb %%xmm6,%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + "pshufb %%xmm2,%%xmm6 \n" + "pmaddubsw %%xmm5,%%xmm6 \n" + "paddsw %%xmm1,%%xmm6 \n" + "psrlw $0x2,%%xmm6 \n" + "packuswb %%xmm6,%%xmm6 \n" + "movq %%xmm6,(%1) \n" + "movdqu 0x8(%0),%%xmm6 \n" + "movdqu 0x8(%0,%3,1),%%xmm7 \n" + "pavgb %%xmm6,%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + "pshufb %%xmm3,%%xmm6 \n" + "pmaddubsw %%xmm0,%%xmm6 \n" + "paddsw %%xmm1,%%xmm6 \n" + "psrlw $0x2,%%xmm6 \n" + "packuswb %%xmm6,%%xmm6 \n" + "movq %%xmm6,0x8(%1) \n" + "movdqu 0x10(%0),%%xmm6 \n" + "movdqu 0x10(%0,%3,1),%%xmm7 \n" + "lea 0x20(%0),%0 \n" + "pavgb %%xmm6,%%xmm7 \n" + "pavgb %%xmm7,%%xmm6 \n" + "pshufb %%xmm4,%%xmm6 \n" + "pmaddubsw %4,%%xmm6 \n" + "paddsw %%xmm1,%%xmm6 \n" + "psrlw $0x2,%%xmm6 \n" + "packuswb %%xmm6,%%xmm6 \n" + "movq %%xmm6,0x10(%1) \n" + "lea 0x18(%1),%1 \n" + "sub $0x18,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "m"(kMadd21) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", + "xmm6", "xmm7"); +} + +void ScaleRowDown38_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + (void) src_stride; + asm volatile( + "movdqa %3,%%xmm4 \n" + "movdqa %4,%%xmm5 \n" + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x10(%0),%%xmm1 \n" + "lea 0x20(%0),%0 \n" + "pshufb %%xmm4,%%xmm0 \n" + "pshufb %%xmm5,%%xmm1 \n" + "paddusb %%xmm1,%%xmm0 \n" + "movq %%xmm0,(%1) \n" + "movhlps %%xmm0,%%xmm1 \n" + "movd %%xmm1,0x8(%1) \n" + "lea 0xc(%1),%1 \n" + "sub $0xc,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "m"(kShuf38a), // %3 + "m"(kShuf38b) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm4", "xmm5"); +} + +void ScaleRowDown38_2_Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "movdqa %0,%%xmm2 \n" + "movdqa %1,%%xmm3 \n" + "movdqa %2,%%xmm4 \n" + "movdqa %3,%%xmm5 \n" + : + : "m"(kShufAb0), // %0 + "m"(kShufAb1), // %1 + "m"(kShufAb2), // %2 + "m"(kScaleAb2) // %3 + ); + asm volatile(LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x00(%0,%3,1),%%xmm1 \n" + "lea 0x10(%0),%0 \n" + "pavgb %%xmm1,%%xmm0 \n" + "movdqa %%xmm0,%%xmm1 \n" + "pshufb %%xmm2,%%xmm1 \n" + "movdqa %%xmm0,%%xmm6 \n" + "pshufb %%xmm3,%%xmm6 \n" + "paddusw %%xmm6,%%xmm1 \n" + "pshufb %%xmm4,%%xmm0 \n" + "paddusw %%xmm0,%%xmm1 \n" + "pmulhuw %%xmm5,%%xmm1 \n" + "packuswb %%xmm1,%%xmm1 \n" + "movd %%xmm1,(%1) \n" + "psrlq $0x10,%%xmm1 \n" + "movd %%xmm1,0x2(%1) \n" + "lea 0x6(%1),%1 \n" + "sub $0x6,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", + "xmm6"); +} + +void ScaleRowDown38_3_Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "movdqa %0,%%xmm2 \n" + "movdqa %1,%%xmm3 \n" + "movdqa %2,%%xmm4 \n" + "pxor %%xmm5,%%xmm5 \n" + : + : "m"(kShufAc), // %0 + "m"(kShufAc3), // %1 + "m"(kScaleAc33) // %2 + ); + asm volatile(LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" + "movdqu 0x00(%0,%3,1),%%xmm6 \n" + "movhlps %%xmm0,%%xmm1 \n" + "movhlps %%xmm6,%%xmm7 \n" + "punpcklbw %%xmm5,%%xmm0 \n" + "punpcklbw %%xmm5,%%xmm1 \n" + "punpcklbw %%xmm5,%%xmm6 \n" + "punpcklbw %%xmm5,%%xmm7 \n" + "paddusw %%xmm6,%%xmm0 \n" + "paddusw %%xmm7,%%xmm1 \n" + "movdqu 0x00(%0,%3,2),%%xmm6 \n" + "lea 0x10(%0),%0 \n" + "movhlps %%xmm6,%%xmm7 \n" + "punpcklbw %%xmm5,%%xmm6 \n" + "punpcklbw %%xmm5,%%xmm7 \n" + "paddusw %%xmm6,%%xmm0 \n" + "paddusw %%xmm7,%%xmm1 \n" + "movdqa %%xmm0,%%xmm6 \n" + "psrldq $0x2,%%xmm0 \n" + "paddusw %%xmm0,%%xmm6 \n" + "psrldq $0x2,%%xmm0 \n" + "paddusw %%xmm0,%%xmm6 \n" + "pshufb %%xmm2,%%xmm6 \n" + "movdqa %%xmm1,%%xmm7 \n" + "psrldq $0x2,%%xmm1 \n" + "paddusw %%xmm1,%%xmm7 \n" + "psrldq $0x2,%%xmm1 \n" + "paddusw %%xmm1,%%xmm7 \n" + "pshufb %%xmm3,%%xmm7 \n" + "paddusw %%xmm7,%%xmm6 \n" + "pmulhuw %%xmm4,%%xmm6 \n" + "packuswb %%xmm6,%%xmm6 \n" + "movd %%xmm6,(%1) \n" + "psrlq $0x10,%%xmm6 \n" + "movd %%xmm6,0x2(%1) \n" + "lea 0x6(%1),%1 \n" + "sub $0x6,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", + "xmm6", "xmm7"); +} + +static const uvec8 kLinearShuffleFar = {2, 3, 0, 1, 6, 7, 4, 5, + 10, 11, 8, 9, 14, 15, 12, 13}; + +static const uvec8 kLinearMadd31 = {3, 1, 1, 3, 3, 1, 1, 3, + 3, 1, 1, 3, 3, 1, 1, 3}; + +#ifdef HAS_SCALEROWUP2_LINEAR_SSE2 + +void ScaleRowUp2_Linear_SSE2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "pxor %%xmm0,%%xmm0 \n" // 0 + "pcmpeqw %%xmm6,%%xmm6 \n" + "psrlw $15,%%xmm6 \n" + "psllw $1,%%xmm6 \n" // all 2 + + LABELALIGN + "1: \n" + "movq (%0),%%xmm1 \n" // 01234567 + "movq 1(%0),%%xmm2 \n" // 12345678 + "movdqa %%xmm1,%%xmm3 \n" + "punpcklbw %%xmm2,%%xmm3 \n" // 0112233445566778 + "punpcklbw %%xmm1,%%xmm1 \n" // 0011223344556677 + "punpcklbw %%xmm2,%%xmm2 \n" // 1122334455667788 + "movdqa %%xmm1,%%xmm4 \n" + "punpcklbw %%xmm0,%%xmm4 \n" // 00112233 (16) + "movdqa %%xmm2,%%xmm5 \n" + "punpcklbw %%xmm0,%%xmm5 \n" // 11223344 (16) + "paddw %%xmm5,%%xmm4 \n" + "movdqa %%xmm3,%%xmm5 \n" + "paddw %%xmm6,%%xmm4 \n" + "punpcklbw %%xmm0,%%xmm5 \n" // 01122334 (16) + "paddw %%xmm5,%%xmm5 \n" + "paddw %%xmm4,%%xmm5 \n" // 3*near+far+2 (lo) + "psrlw $2,%%xmm5 \n" // 3/4*near+1/4*far (lo) + + "punpckhbw %%xmm0,%%xmm1 \n" // 44556677 (16) + "punpckhbw %%xmm0,%%xmm2 \n" // 55667788 (16) + "paddw %%xmm2,%%xmm1 \n" + "punpckhbw %%xmm0,%%xmm3 \n" // 45566778 (16) + "paddw %%xmm6,%%xmm1 \n" + "paddw %%xmm3,%%xmm3 \n" + "paddw %%xmm3,%%xmm1 \n" // 3*near+far+2 (hi) + "psrlw $2,%%xmm1 \n" // 3/4*near+1/4*far (hi) + + "packuswb %%xmm1,%%xmm5 \n" + "movdqu %%xmm5,(%1) \n" + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 8 sample to 16 sample + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_SSE2 + +void ScaleRowUp2_Bilinear_SSE2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + LABELALIGN + "1: \n" + "pxor %%xmm0,%%xmm0 \n" // 0 + // above line + "movq (%0),%%xmm1 \n" // 01234567 + "movq 1(%0),%%xmm2 \n" // 12345678 + "movdqa %%xmm1,%%xmm3 \n" + "punpcklbw %%xmm2,%%xmm3 \n" // 0112233445566778 + "punpcklbw %%xmm1,%%xmm1 \n" // 0011223344556677 + "punpcklbw %%xmm2,%%xmm2 \n" // 1122334455667788 + + "movdqa %%xmm1,%%xmm4 \n" + "punpcklbw %%xmm0,%%xmm4 \n" // 00112233 (16) + "movdqa %%xmm2,%%xmm5 \n" + "punpcklbw %%xmm0,%%xmm5 \n" // 11223344 (16) + "paddw %%xmm5,%%xmm4 \n" // near+far + "movdqa %%xmm3,%%xmm5 \n" + "punpcklbw %%xmm0,%%xmm5 \n" // 01122334 (16) + "paddw %%xmm5,%%xmm5 \n" // 2*near + "paddw %%xmm5,%%xmm4 \n" // 3*near+far (1, lo) + + "punpckhbw %%xmm0,%%xmm1 \n" // 44556677 (16) + "punpckhbw %%xmm0,%%xmm2 \n" // 55667788 (16) + "paddw %%xmm2,%%xmm1 \n" + "punpckhbw %%xmm0,%%xmm3 \n" // 45566778 (16) + "paddw %%xmm3,%%xmm3 \n" // 2*near + "paddw %%xmm3,%%xmm1 \n" // 3*near+far (1, hi) + + // below line + "movq (%0,%3),%%xmm6 \n" // 01234567 + "movq 1(%0,%3),%%xmm2 \n" // 12345678 + "movdqa %%xmm6,%%xmm3 \n" + "punpcklbw %%xmm2,%%xmm3 \n" // 0112233445566778 + "punpcklbw %%xmm6,%%xmm6 \n" // 0011223344556677 + "punpcklbw %%xmm2,%%xmm2 \n" // 1122334455667788 + + "movdqa %%xmm6,%%xmm5 \n" + "punpcklbw %%xmm0,%%xmm5 \n" // 00112233 (16) + "movdqa %%xmm2,%%xmm7 \n" + "punpcklbw %%xmm0,%%xmm7 \n" // 11223344 (16) + "paddw %%xmm7,%%xmm5 \n" // near+far + "movdqa %%xmm3,%%xmm7 \n" + "punpcklbw %%xmm0,%%xmm7 \n" // 01122334 (16) + "paddw %%xmm7,%%xmm7 \n" // 2*near + "paddw %%xmm7,%%xmm5 \n" // 3*near+far (2, lo) + + "punpckhbw %%xmm0,%%xmm6 \n" // 44556677 (16) + "punpckhbw %%xmm0,%%xmm2 \n" // 55667788 (16) + "paddw %%xmm6,%%xmm2 \n" // near+far + "punpckhbw %%xmm0,%%xmm3 \n" // 45566778 (16) + "paddw %%xmm3,%%xmm3 \n" // 2*near + "paddw %%xmm3,%%xmm2 \n" // 3*near+far (2, hi) + + // xmm4 xmm1 + // xmm5 xmm2 + "pcmpeqw %%xmm0,%%xmm0 \n" + "psrlw $15,%%xmm0 \n" + "psllw $3,%%xmm0 \n" // all 8 + + "movdqa %%xmm4,%%xmm3 \n" + "movdqa %%xmm5,%%xmm6 \n" + "paddw %%xmm3,%%xmm3 \n" // 6*near+2*far (1, lo) + "paddw %%xmm0,%%xmm6 \n" // 3*near+far+8 (2, lo) + "paddw %%xmm4,%%xmm3 \n" // 9*near+3*far (1, lo) + "paddw %%xmm6,%%xmm3 \n" // 9 3 3 1 + 8 (1, lo) + "psrlw $4,%%xmm3 \n" // ^ div by 16 + + "movdqa %%xmm1,%%xmm7 \n" + "movdqa %%xmm2,%%xmm6 \n" + "paddw %%xmm7,%%xmm7 \n" // 6*near+2*far (1, hi) + "paddw %%xmm0,%%xmm6 \n" // 3*near+far+8 (2, hi) + "paddw %%xmm1,%%xmm7 \n" // 9*near+3*far (1, hi) + "paddw %%xmm6,%%xmm7 \n" // 9 3 3 1 + 8 (1, hi) + "psrlw $4,%%xmm7 \n" // ^ div by 16 + + "packuswb %%xmm7,%%xmm3 \n" + "movdqu %%xmm3,(%1) \n" // save above line + + "movdqa %%xmm5,%%xmm3 \n" + "paddw %%xmm0,%%xmm4 \n" // 3*near+far+8 (1, lo) + "paddw %%xmm3,%%xmm3 \n" // 6*near+2*far (2, lo) + "paddw %%xmm3,%%xmm5 \n" // 9*near+3*far (2, lo) + "paddw %%xmm4,%%xmm5 \n" // 9 3 3 1 + 8 (lo) + "psrlw $4,%%xmm5 \n" // ^ div by 16 + + "movdqa %%xmm2,%%xmm3 \n" + "paddw %%xmm0,%%xmm1 \n" // 3*near+far+8 (1, hi) + "paddw %%xmm3,%%xmm3 \n" // 6*near+2*far (2, hi) + "paddw %%xmm3,%%xmm2 \n" // 9*near+3*far (2, hi) + "paddw %%xmm1,%%xmm2 \n" // 9 3 3 1 + 8 (hi) + "psrlw $4,%%xmm2 \n" // ^ div by 16 + + "packuswb %%xmm2,%%xmm5 \n" + "movdqu %%xmm5,(%1,%4) \n" // save below line + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 8 sample to 16 sample + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_12_SSSE3 + +void ScaleRowUp2_Linear_12_SSSE3(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width) { + asm volatile( + "movdqa %3,%%xmm5 \n" + "pcmpeqw %%xmm4,%%xmm4 \n" + "psrlw $15,%%xmm4 \n" + "psllw $1,%%xmm4 \n" // all 2 + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" // 01234567 (16) + "movdqu 2(%0),%%xmm1 \n" // 12345678 (16) + + "movdqa %%xmm0,%%xmm2 \n" + "punpckhwd %%xmm1,%%xmm2 \n" // 45566778 (16) + "punpcklwd %%xmm1,%%xmm0 \n" // 01122334 (16) + + "movdqa %%xmm2,%%xmm3 \n" + "movdqa %%xmm0,%%xmm1 \n" + "pshufb %%xmm5,%%xmm3 \n" // 54657687 (far) + "pshufb %%xmm5,%%xmm1 \n" // 10213243 (far) + + "paddw %%xmm4,%%xmm1 \n" // far+2 + "paddw %%xmm4,%%xmm3 \n" // far+2 + "paddw %%xmm0,%%xmm1 \n" // near+far+2 + "paddw %%xmm2,%%xmm3 \n" // near+far+2 + "paddw %%xmm0,%%xmm0 \n" // 2*near + "paddw %%xmm2,%%xmm2 \n" // 2*near + "paddw %%xmm1,%%xmm0 \n" // 3*near+far+2 (lo) + "paddw %%xmm3,%%xmm2 \n" // 3*near+far+2 (hi) + + "psrlw $2,%%xmm0 \n" // 3/4*near+1/4*far + "psrlw $2,%%xmm2 \n" // 3/4*near+1/4*far + "movdqu %%xmm0,(%1) \n" + "movdqu %%xmm2,16(%1) \n" + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 8 sample to 16 sample + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "m"(kLinearShuffleFar) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_12_SSSE3 + +void ScaleRowUp2_Bilinear_12_SSSE3(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "pcmpeqw %%xmm7,%%xmm7 \n" + "psrlw $15,%%xmm7 \n" + "psllw $3,%%xmm7 \n" // all 8 + "movdqa %5,%%xmm6 \n" + + LABELALIGN + "1: \n" + // above line + "movdqu (%0),%%xmm0 \n" // 01234567 (16) + "movdqu 2(%0),%%xmm1 \n" // 12345678 (16) + "movdqa %%xmm0,%%xmm2 \n" + "punpckhwd %%xmm1,%%xmm2 \n" // 45566778 (16) + "punpcklwd %%xmm1,%%xmm0 \n" // 01122334 (16) + "movdqa %%xmm2,%%xmm3 \n" + "movdqa %%xmm0,%%xmm1 \n" + "pshufb %%xmm6,%%xmm3 \n" // 54657687 (far) + "pshufb %%xmm6,%%xmm1 \n" // 10213243 (far) + "paddw %%xmm0,%%xmm1 \n" // near+far + "paddw %%xmm2,%%xmm3 \n" // near+far + "paddw %%xmm0,%%xmm0 \n" // 2*near + "paddw %%xmm2,%%xmm2 \n" // 2*near + "paddw %%xmm1,%%xmm0 \n" // 3*near+far (1, lo) + "paddw %%xmm3,%%xmm2 \n" // 3*near+far (1, hi) + + // below line + "movdqu (%0,%3,2),%%xmm1 \n" // 01234567 (16) + "movdqu 2(%0,%3,2),%%xmm4 \n" // 12345678 (16) + "movdqa %%xmm1,%%xmm3 \n" + "punpckhwd %%xmm4,%%xmm3 \n" // 45566778 (16) + "punpcklwd %%xmm4,%%xmm1 \n" // 01122334 (16) + "movdqa %%xmm3,%%xmm5 \n" + "movdqa %%xmm1,%%xmm4 \n" + "pshufb %%xmm6,%%xmm5 \n" // 54657687 (far) + "pshufb %%xmm6,%%xmm4 \n" // 10213243 (far) + "paddw %%xmm1,%%xmm4 \n" // near+far + "paddw %%xmm3,%%xmm5 \n" // near+far + "paddw %%xmm1,%%xmm1 \n" // 2*near + "paddw %%xmm3,%%xmm3 \n" // 2*near + "paddw %%xmm4,%%xmm1 \n" // 3*near+far (2, lo) + "paddw %%xmm5,%%xmm3 \n" // 3*near+far (2, hi) + + // xmm0 xmm2 + // xmm1 xmm3 + + "movdqa %%xmm0,%%xmm4 \n" + "movdqa %%xmm1,%%xmm5 \n" + "paddw %%xmm4,%%xmm4 \n" // 6*near+2*far (1, lo) + "paddw %%xmm7,%%xmm5 \n" // 3*near+far+8 (2, lo) + "paddw %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) + "paddw %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) + "psrlw $4,%%xmm4 \n" // ^ div by 16 + "movdqu %%xmm4,(%1) \n" + + "movdqa %%xmm2,%%xmm4 \n" + "movdqa %%xmm3,%%xmm5 \n" + "paddw %%xmm4,%%xmm4 \n" // 6*near+2*far (1, hi) + "paddw %%xmm7,%%xmm5 \n" // 3*near+far+8 (2, hi) + "paddw %%xmm2,%%xmm4 \n" // 9*near+3*far (1, hi) + "paddw %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, hi) + "psrlw $4,%%xmm4 \n" // ^ div by 16 + "movdqu %%xmm4,0x10(%1) \n" + + "movdqa %%xmm1,%%xmm4 \n" + "paddw %%xmm7,%%xmm0 \n" // 3*near+far+8 (1, lo) + "paddw %%xmm4,%%xmm4 \n" // 6*near+2*far (2, lo) + "paddw %%xmm4,%%xmm1 \n" // 9*near+3*far (2, lo) + "paddw %%xmm0,%%xmm1 \n" // 9 3 3 1 + 8 (2, lo) + "psrlw $4,%%xmm1 \n" // ^ div by 16 + "movdqu %%xmm1,(%1,%4,2) \n" + + "movdqa %%xmm3,%%xmm4 \n" + "paddw %%xmm7,%%xmm2 \n" // 3*near+far+8 (1, hi) + "paddw %%xmm4,%%xmm4 \n" // 6*near+2*far (2, hi) + "paddw %%xmm4,%%xmm3 \n" // 9*near+3*far (2, hi) + "paddw %%xmm2,%%xmm3 \n" // 9 3 3 1 + 8 (2, hi) + "psrlw $4,%%xmm3 \n" // ^ div by 16 + "movdqu %%xmm3,0x10(%1,%4,2) \n" + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 8 sample to 16 sample + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)), // %4 + "m"(kLinearShuffleFar) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_16_SSE2 + +void ScaleRowUp2_Linear_16_SSE2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width) { + asm volatile( + "pxor %%xmm5,%%xmm5 \n" + "pcmpeqd %%xmm4,%%xmm4 \n" + "psrld $31,%%xmm4 \n" + "pslld $1,%%xmm4 \n" // all 2 + + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" // 0123 (16b) + "movq 2(%0),%%xmm1 \n" // 1234 (16b) + + "punpcklwd %%xmm5,%%xmm0 \n" // 0123 (32b) + "punpcklwd %%xmm5,%%xmm1 \n" // 1234 (32b) + + "movdqa %%xmm0,%%xmm2 \n" + "movdqa %%xmm1,%%xmm3 \n" + + "pshufd $0b10110001,%%xmm2,%%xmm2 \n" // 1032 (even, far) + "pshufd $0b10110001,%%xmm3,%%xmm3 \n" // 2143 (odd, far) + + "paddd %%xmm4,%%xmm2 \n" // far+2 (lo) + "paddd %%xmm4,%%xmm3 \n" // far+2 (hi) + "paddd %%xmm0,%%xmm2 \n" // near+far+2 (lo) + "paddd %%xmm1,%%xmm3 \n" // near+far+2 (hi) + "paddd %%xmm0,%%xmm0 \n" // 2*near (lo) + "paddd %%xmm1,%%xmm1 \n" // 2*near (hi) + "paddd %%xmm2,%%xmm0 \n" // 3*near+far+2 (lo) + "paddd %%xmm3,%%xmm1 \n" // 3*near+far+2 (hi) + + "psrld $2,%%xmm0 \n" // 3/4*near+1/4*far (lo) + "psrld $2,%%xmm1 \n" // 3/4*near+1/4*far (hi) + "packssdw %%xmm1,%%xmm0 \n" + "pshufd $0b11011000,%%xmm0,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 4 pixel to 8 pixel + "sub $0x8,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_16_SSE2 + +void ScaleRowUp2_Bilinear_16_SSE2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "pxor %%xmm7,%%xmm7 \n" + "pcmpeqd %%xmm6,%%xmm6 \n" + "psrld $31,%%xmm6 \n" + "pslld $3,%%xmm6 \n" // all 8 + + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" // 0011 (16b, 1u1v) + "movq 4(%0),%%xmm1 \n" // 1122 (16b, 1u1v) + "punpcklwd %%xmm7,%%xmm0 \n" // 0011 (near) (32b, 1u1v) + "punpcklwd %%xmm7,%%xmm1 \n" // 1122 (near) (32b, 1u1v) + "movdqa %%xmm0,%%xmm2 \n" + "movdqa %%xmm1,%%xmm3 \n" + "pshufd $0b01001110,%%xmm2,%%xmm2 \n" // 1100 (far) (1, lo) + "pshufd $0b01001110,%%xmm3,%%xmm3 \n" // 2211 (far) (1, hi) + "paddd %%xmm0,%%xmm2 \n" // near+far (1, lo) + "paddd %%xmm1,%%xmm3 \n" // near+far (1, hi) + "paddd %%xmm0,%%xmm0 \n" // 2*near (1, lo) + "paddd %%xmm1,%%xmm1 \n" // 2*near (1, hi) + "paddd %%xmm2,%%xmm0 \n" // 3*near+far (1, lo) + "paddd %%xmm3,%%xmm1 \n" // 3*near+far (1, hi) + + "movq (%0),%%xmm0 \n" // 0123 (16b) + "movq 2(%0),%%xmm1 \n" // 1234 (16b) + "punpcklwd %%xmm7,%%xmm0 \n" // 0123 (32b) + "punpcklwd %%xmm7,%%xmm1 \n" // 1234 (32b) + "movdqa %%xmm0,%%xmm2 \n" + "movdqa %%xmm1,%%xmm3 \n" + "pshufd $0b10110001,%%xmm2,%%xmm2 \n" // 1032 (even, far) + "pshufd $0b10110001,%%xmm3,%%xmm3 \n" // 2143 (odd, far) + "paddd %%xmm0,%%xmm2 \n" // near+far (lo) + "paddd %%xmm1,%%xmm3 \n" // near+far (hi) + "paddd %%xmm0,%%xmm0 \n" // 2*near (lo) + "paddd %%xmm1,%%xmm1 \n" // 2*near (hi) + "paddd %%xmm2,%%xmm0 \n" // 3*near+far (1, lo) + "paddd %%xmm3,%%xmm1 \n" // 3*near+far (1, hi) + + "movq (%0,%3,2),%%xmm2 \n" + "movq 2(%0,%3,2),%%xmm3 \n" + "punpcklwd %%xmm7,%%xmm2 \n" // 0123 (32b) + "punpcklwd %%xmm7,%%xmm3 \n" // 1234 (32b) + "movdqa %%xmm2,%%xmm4 \n" + "movdqa %%xmm3,%%xmm5 \n" + "pshufd $0b10110001,%%xmm4,%%xmm4 \n" // 1032 (even, far) + "pshufd $0b10110001,%%xmm5,%%xmm5 \n" // 2143 (odd, far) + "paddd %%xmm2,%%xmm4 \n" // near+far (lo) + "paddd %%xmm3,%%xmm5 \n" // near+far (hi) + "paddd %%xmm2,%%xmm2 \n" // 2*near (lo) + "paddd %%xmm3,%%xmm3 \n" // 2*near (hi) + "paddd %%xmm4,%%xmm2 \n" // 3*near+far (2, lo) + "paddd %%xmm5,%%xmm3 \n" // 3*near+far (2, hi) + + "movdqa %%xmm0,%%xmm4 \n" + "movdqa %%xmm2,%%xmm5 \n" + "paddd %%xmm0,%%xmm4 \n" // 6*near+2*far (1, lo) + "paddd %%xmm6,%%xmm5 \n" // 3*near+far+8 (2, lo) + "paddd %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) + "paddd %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) + "psrld $4,%%xmm4 \n" // ^ div by 16 (1, lo) + + "movdqa %%xmm2,%%xmm5 \n" + "paddd %%xmm2,%%xmm5 \n" // 6*near+2*far (2, lo) + "paddd %%xmm6,%%xmm0 \n" // 3*near+far+8 (1, lo) + "paddd %%xmm2,%%xmm5 \n" // 9*near+3*far (2, lo) + "paddd %%xmm0,%%xmm5 \n" // 9 3 3 1 + 8 (2, lo) + "psrld $4,%%xmm5 \n" // ^ div by 16 (2, lo) + + "movdqa %%xmm1,%%xmm0 \n" + "movdqa %%xmm3,%%xmm2 \n" + "paddd %%xmm1,%%xmm0 \n" // 6*near+2*far (1, hi) + "paddd %%xmm6,%%xmm2 \n" // 3*near+far+8 (2, hi) + "paddd %%xmm1,%%xmm0 \n" // 9*near+3*far (1, hi) + "paddd %%xmm2,%%xmm0 \n" // 9 3 3 1 + 8 (1, hi) + "psrld $4,%%xmm0 \n" // ^ div by 16 (1, hi) + + "movdqa %%xmm3,%%xmm2 \n" + "paddd %%xmm3,%%xmm2 \n" // 6*near+2*far (2, hi) + "paddd %%xmm6,%%xmm1 \n" // 3*near+far+8 (1, hi) + "paddd %%xmm3,%%xmm2 \n" // 9*near+3*far (2, hi) + "paddd %%xmm1,%%xmm2 \n" // 9 3 3 1 + 8 (2, hi) + "psrld $4,%%xmm2 \n" // ^ div by 16 (2, hi) + + "packssdw %%xmm0,%%xmm4 \n" + "pshufd $0b11011000,%%xmm4,%%xmm4 \n" + "movdqu %%xmm4,(%1) \n" // store above + "packssdw %%xmm2,%%xmm5 \n" + "pshufd $0b11011000,%%xmm5,%%xmm5 \n" + "movdqu %%xmm5,(%1,%4,2) \n" // store below + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 4 pixel to 8 pixel + "sub $0x8,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_SSSE3 + +void ScaleRowUp2_Linear_SSSE3(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "pcmpeqw %%xmm4,%%xmm4 \n" + "psrlw $15,%%xmm4 \n" + "psllw $1,%%xmm4 \n" // all 2 + "movdqa %3,%%xmm3 \n" + + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" // 01234567 + "movq 1(%0),%%xmm1 \n" // 12345678 + "punpcklwd %%xmm0,%%xmm0 \n" // 0101232345456767 + "punpcklwd %%xmm1,%%xmm1 \n" // 1212343456567878 + "movdqa %%xmm0,%%xmm2 \n" + "punpckhdq %%xmm1,%%xmm2 \n" // 4545565667677878 + "punpckldq %%xmm1,%%xmm0 \n" // 0101121223233434 + "pmaddubsw %%xmm3,%%xmm2 \n" // 3*near+far (hi) + "pmaddubsw %%xmm3,%%xmm0 \n" // 3*near+far (lo) + "paddw %%xmm4,%%xmm0 \n" // 3*near+far+2 (lo) + "paddw %%xmm4,%%xmm2 \n" // 3*near+far+2 (hi) + "psrlw $2,%%xmm0 \n" // 3/4*near+1/4*far (lo) + "psrlw $2,%%xmm2 \n" // 3/4*near+1/4*far (hi) + "packuswb %%xmm2,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 8 sample to 16 sample + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "m"(kLinearMadd31) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_SSSE3 + +void ScaleRowUp2_Bilinear_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "pcmpeqw %%xmm6,%%xmm6 \n" + "psrlw $15,%%xmm6 \n" + "psllw $3,%%xmm6 \n" // all 8 + "movdqa %5,%%xmm7 \n" + + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" // 01234567 + "movq 1(%0),%%xmm1 \n" // 12345678 + "punpcklwd %%xmm0,%%xmm0 \n" // 0101232345456767 + "punpcklwd %%xmm1,%%xmm1 \n" // 1212343456567878 + "movdqa %%xmm0,%%xmm2 \n" + "punpckhdq %%xmm1,%%xmm2 \n" // 4545565667677878 + "punpckldq %%xmm1,%%xmm0 \n" // 0101121223233434 + "pmaddubsw %%xmm7,%%xmm2 \n" // 3*near+far (1, hi) + "pmaddubsw %%xmm7,%%xmm0 \n" // 3*near+far (1, lo) + + "movq (%0,%3),%%xmm1 \n" + "movq 1(%0,%3),%%xmm4 \n" + "punpcklwd %%xmm1,%%xmm1 \n" + "punpcklwd %%xmm4,%%xmm4 \n" + "movdqa %%xmm1,%%xmm3 \n" + "punpckhdq %%xmm4,%%xmm3 \n" + "punpckldq %%xmm4,%%xmm1 \n" + "pmaddubsw %%xmm7,%%xmm3 \n" // 3*near+far (2, hi) + "pmaddubsw %%xmm7,%%xmm1 \n" // 3*near+far (2, lo) + + // xmm0 xmm2 + // xmm1 xmm3 + + "movdqa %%xmm0,%%xmm4 \n" + "movdqa %%xmm1,%%xmm5 \n" + "paddw %%xmm0,%%xmm4 \n" // 6*near+2*far (1, lo) + "paddw %%xmm6,%%xmm5 \n" // 3*near+far+8 (2, lo) + "paddw %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) + "paddw %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) + "psrlw $4,%%xmm4 \n" // ^ div by 16 (1, lo) + + "movdqa %%xmm1,%%xmm5 \n" + "paddw %%xmm1,%%xmm5 \n" // 6*near+2*far (2, lo) + "paddw %%xmm6,%%xmm0 \n" // 3*near+far+8 (1, lo) + "paddw %%xmm1,%%xmm5 \n" // 9*near+3*far (2, lo) + "paddw %%xmm0,%%xmm5 \n" // 9 3 3 1 + 8 (2, lo) + "psrlw $4,%%xmm5 \n" // ^ div by 16 (2, lo) + + "movdqa %%xmm2,%%xmm0 \n" + "movdqa %%xmm3,%%xmm1 \n" + "paddw %%xmm2,%%xmm0 \n" // 6*near+2*far (1, hi) + "paddw %%xmm6,%%xmm1 \n" // 3*near+far+8 (2, hi) + "paddw %%xmm2,%%xmm0 \n" // 9*near+3*far (1, hi) + "paddw %%xmm1,%%xmm0 \n" // 9 3 3 1 + 8 (1, hi) + "psrlw $4,%%xmm0 \n" // ^ div by 16 (1, hi) + + "movdqa %%xmm3,%%xmm1 \n" + "paddw %%xmm3,%%xmm1 \n" // 6*near+2*far (2, hi) + "paddw %%xmm6,%%xmm2 \n" // 3*near+far+8 (1, hi) + "paddw %%xmm3,%%xmm1 \n" // 9*near+3*far (2, hi) + "paddw %%xmm2,%%xmm1 \n" // 9 3 3 1 + 8 (2, hi) + "psrlw $4,%%xmm1 \n" // ^ div by 16 (2, hi) + + "packuswb %%xmm0,%%xmm4 \n" + "movdqu %%xmm4,(%1) \n" // store above + "packuswb %%xmm1,%%xmm5 \n" + "movdqu %%xmm5,(%1,%4) \n" // store below + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 8 sample to 16 sample + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)), // %4 + "m"(kLinearMadd31) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_AVX2 + +void ScaleRowUp2_Linear_AVX2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "vpcmpeqw %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrlw $15,%%ymm4,%%ymm4 \n" + "vpsllw $1,%%ymm4,%%ymm4 \n" // all 2 + "vbroadcastf128 %3,%%ymm3 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%xmm0 \n" // 0123456789ABCDEF + "vmovdqu 1(%0),%%xmm1 \n" // 123456789ABCDEF0 + "vpermq $0b11011000,%%ymm0,%%ymm0 \n" + "vpermq $0b11011000,%%ymm1,%%ymm1 \n" + "vpunpcklwd %%ymm0,%%ymm0,%%ymm0 \n" + "vpunpcklwd %%ymm1,%%ymm1,%%ymm1 \n" + "vpunpckhdq %%ymm1,%%ymm0,%%ymm2 \n" + "vpunpckldq %%ymm1,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm3,%%ymm2,%%ymm1 \n" // 3*near+far (hi) + "vpmaddubsw %%ymm3,%%ymm0,%%ymm0 \n" // 3*near+far (lo) + "vpaddw %%ymm4,%%ymm0,%%ymm0 \n" // 3*near+far+2 (lo) + "vpaddw %%ymm4,%%ymm1,%%ymm1 \n" // 3*near+far+2 (hi) + "vpsrlw $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far (lo) + "vpsrlw $2,%%ymm1,%%ymm1 \n" // 3/4*near+1/4*far (hi) + "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 16 sample to 32 sample + "sub $0x20,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "m"(kLinearMadd31) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_AVX2 + +void ScaleRowUp2_Bilinear_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "vpcmpeqw %%ymm6,%%ymm6,%%ymm6 \n" + "vpsrlw $15,%%ymm6,%%ymm6 \n" + "vpsllw $3,%%ymm6,%%ymm6 \n" // all 8 + "vbroadcastf128 %5,%%ymm7 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%xmm0 \n" // 0123456789ABCDEF + "vmovdqu 1(%0),%%xmm1 \n" // 123456789ABCDEF0 + "vpermq $0b11011000,%%ymm0,%%ymm0 \n" + "vpermq $0b11011000,%%ymm1,%%ymm1 \n" + "vpunpcklwd %%ymm0,%%ymm0,%%ymm0 \n" + "vpunpcklwd %%ymm1,%%ymm1,%%ymm1 \n" + "vpunpckhdq %%ymm1,%%ymm0,%%ymm2 \n" + "vpunpckldq %%ymm1,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm7,%%ymm2,%%ymm1 \n" // 3*near+far (1, hi) + "vpmaddubsw %%ymm7,%%ymm0,%%ymm0 \n" // 3*near+far (1, lo) + + "vmovdqu (%0,%3),%%xmm2 \n" // 0123456789ABCDEF + "vmovdqu 1(%0,%3),%%xmm3 \n" // 123456789ABCDEF0 + "vpermq $0b11011000,%%ymm2,%%ymm2 \n" + "vpermq $0b11011000,%%ymm3,%%ymm3 \n" + "vpunpcklwd %%ymm2,%%ymm2,%%ymm2 \n" + "vpunpcklwd %%ymm3,%%ymm3,%%ymm3 \n" + "vpunpckhdq %%ymm3,%%ymm2,%%ymm4 \n" + "vpunpckldq %%ymm3,%%ymm2,%%ymm2 \n" + "vpmaddubsw %%ymm7,%%ymm4,%%ymm3 \n" // 3*near+far (2, hi) + "vpmaddubsw %%ymm7,%%ymm2,%%ymm2 \n" // 3*near+far (2, lo) + + // ymm0 ymm1 + // ymm2 ymm3 + + "vpaddw %%ymm0,%%ymm0,%%ymm4 \n" // 6*near+2*far (1, lo) + "vpaddw %%ymm6,%%ymm2,%%ymm5 \n" // 3*near+far+8 (2, lo) + "vpaddw %%ymm4,%%ymm0,%%ymm4 \n" // 9*near+3*far (1, lo) + "vpaddw %%ymm4,%%ymm5,%%ymm4 \n" // 9 3 3 1 + 8 (1, lo) + "vpsrlw $4,%%ymm4,%%ymm4 \n" // ^ div by 16 (1, lo) + + "vpaddw %%ymm2,%%ymm2,%%ymm5 \n" // 6*near+2*far (2, lo) + "vpaddw %%ymm6,%%ymm0,%%ymm0 \n" // 3*near+far+8 (1, lo) + "vpaddw %%ymm5,%%ymm2,%%ymm5 \n" // 9*near+3*far (2, lo) + "vpaddw %%ymm5,%%ymm0,%%ymm5 \n" // 9 3 3 1 + 8 (2, lo) + "vpsrlw $4,%%ymm5,%%ymm5 \n" // ^ div by 16 (2, lo) + + "vpaddw %%ymm1,%%ymm1,%%ymm0 \n" // 6*near+2*far (1, hi) + "vpaddw %%ymm6,%%ymm3,%%ymm2 \n" // 3*near+far+8 (2, hi) + "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 9*near+3*far (1, hi) + "vpaddw %%ymm0,%%ymm2,%%ymm0 \n" // 9 3 3 1 + 8 (1, hi) + "vpsrlw $4,%%ymm0,%%ymm0 \n" // ^ div by 16 (1, hi) + + "vpaddw %%ymm3,%%ymm3,%%ymm2 \n" // 6*near+2*far (2, hi) + "vpaddw %%ymm6,%%ymm1,%%ymm1 \n" // 3*near+far+8 (1, hi) + "vpaddw %%ymm2,%%ymm3,%%ymm2 \n" // 9*near+3*far (2, hi) + "vpaddw %%ymm2,%%ymm1,%%ymm2 \n" // 9 3 3 1 + 8 (2, hi) + "vpsrlw $4,%%ymm2,%%ymm2 \n" // ^ div by 16 (2, hi) + + "vpackuswb %%ymm0,%%ymm4,%%ymm4 \n" + "vmovdqu %%ymm4,(%1) \n" // store above + "vpackuswb %%ymm2,%%ymm5,%%ymm5 \n" + "vmovdqu %%ymm5,(%1,%4) \n" // store below + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 16 sample to 32 sample + "sub $0x20,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)), // %4 + "m"(kLinearMadd31) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_12_AVX2 + +void ScaleRowUp2_Linear_12_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width) { + asm volatile( + "vbroadcastf128 %3,%%ymm5 \n" + "vpcmpeqw %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrlw $15,%%ymm4,%%ymm4 \n" + "vpsllw $1,%%ymm4,%%ymm4 \n" // all 2 + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" // 0123456789ABCDEF (16b) + "vmovdqu 2(%0),%%ymm1 \n" // 123456789ABCDEF0 (16b) + + "vpermq $0b11011000,%%ymm0,%%ymm0 \n" // 012389AB4567CDEF + "vpermq $0b11011000,%%ymm1,%%ymm1 \n" // 12349ABC5678DEF0 + + "vpunpckhwd %%ymm1,%%ymm0,%%ymm2 \n" // 899AABBCCDDEEFF0 (near) + "vpunpcklwd %%ymm1,%%ymm0,%%ymm0 \n" // 0112233445566778 (near) + "vpshufb %%ymm5,%%ymm2,%%ymm3 \n" // 98A9BACBDCEDFE0F (far) + "vpshufb %%ymm5,%%ymm0,%%ymm1 \n" // 1021324354657687 (far) + + "vpaddw %%ymm4,%%ymm1,%%ymm1 \n" // far+2 + "vpaddw %%ymm4,%%ymm3,%%ymm3 \n" // far+2 + "vpaddw %%ymm0,%%ymm1,%%ymm1 \n" // near+far+2 + "vpaddw %%ymm2,%%ymm3,%%ymm3 \n" // near+far+2 + "vpaddw %%ymm0,%%ymm0,%%ymm0 \n" // 2*near + "vpaddw %%ymm2,%%ymm2,%%ymm2 \n" // 2*near + "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 3*near+far+2 + "vpaddw %%ymm2,%%ymm3,%%ymm2 \n" // 3*near+far+2 + + "vpsrlw $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far + "vpsrlw $2,%%ymm2,%%ymm2 \n" // 3/4*near+1/4*far + "vmovdqu %%ymm0,(%1) \n" + "vmovdqu %%ymm2,32(%1) \n" + + "lea 0x20(%0),%0 \n" + "lea 0x40(%1),%1 \n" // 16 sample to 32 sample + "sub $0x20,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "m"(kLinearShuffleFar) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_12_AVX2 + +void ScaleRowUp2_Bilinear_12_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "vbroadcastf128 %5,%%ymm5 \n" + "vpcmpeqw %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrlw $15,%%ymm4,%%ymm4 \n" + "vpsllw $3,%%ymm4,%%ymm4 \n" // all 8 + + LABELALIGN + "1: \n" + + "vmovdqu (%0),%%xmm0 \n" // 01234567 (16b) + "vmovdqu 2(%0),%%xmm1 \n" // 12345678 (16b) + "vpermq $0b11011000,%%ymm0,%%ymm0 \n" // 0123000045670000 + "vpermq $0b11011000,%%ymm1,%%ymm1 \n" // 1234000056780000 + "vpunpcklwd %%ymm1,%%ymm0,%%ymm0 \n" // 0112233445566778 (near) + "vpshufb %%ymm5,%%ymm0,%%ymm1 \n" // 1021324354657687 (far) + "vpaddw %%ymm0,%%ymm1,%%ymm1 \n" // near+far + "vpaddw %%ymm0,%%ymm0,%%ymm0 \n" // 2*near + "vpaddw %%ymm0,%%ymm1,%%ymm2 \n" // 3*near+far (1) + + "vmovdqu (%0,%3,2),%%xmm0 \n" // 01234567 (16b) + "vmovdqu 2(%0,%3,2),%%xmm1 \n" // 12345678 (16b) + "vpermq $0b11011000,%%ymm0,%%ymm0 \n" // 0123000045670000 + "vpermq $0b11011000,%%ymm1,%%ymm1 \n" // 1234000056780000 + "vpunpcklwd %%ymm1,%%ymm0,%%ymm0 \n" // 0112233445566778 (near) + "vpshufb %%ymm5,%%ymm0,%%ymm1 \n" // 1021324354657687 (far) + "vpaddw %%ymm0,%%ymm1,%%ymm1 \n" // near+far + "vpaddw %%ymm0,%%ymm0,%%ymm0 \n" // 2*near + "vpaddw %%ymm0,%%ymm1,%%ymm3 \n" // 3*near+far (2) + + "vpaddw %%ymm2,%%ymm2,%%ymm0 \n" // 6*near+2*far (1) + "vpaddw %%ymm4,%%ymm3,%%ymm1 \n" // 3*near+far+8 (2) + "vpaddw %%ymm0,%%ymm2,%%ymm0 \n" // 9*near+3*far (1) + "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 9 3 3 1 + 8 (1) + "vpsrlw $4,%%ymm0,%%ymm0 \n" // ^ div by 16 + "vmovdqu %%ymm0,(%1) \n" // store above + + "vpaddw %%ymm3,%%ymm3,%%ymm0 \n" // 6*near+2*far (2) + "vpaddw %%ymm4,%%ymm2,%%ymm1 \n" // 3*near+far+8 (1) + "vpaddw %%ymm0,%%ymm3,%%ymm0 \n" // 9*near+3*far (2) + "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 9 3 3 1 + 8 (2) + "vpsrlw $4,%%ymm0,%%ymm0 \n" // ^ div by 16 + "vmovdqu %%ymm0,(%1,%4,2) \n" // store below + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 8 sample to 16 sample + "sub $0x10,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)), // %4 + "m"(kLinearShuffleFar) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_LINEAR_16_AVX2 + +void ScaleRowUp2_Linear_16_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width) { + asm volatile( + "vpcmpeqd %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrld $31,%%ymm4,%%ymm4 \n" + "vpslld $1,%%ymm4,%%ymm4 \n" // all 2 + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%xmm0 \n" // 01234567 (16b, 1u1v) + "vmovdqu 2(%0),%%xmm1 \n" // 12345678 (16b, 1u1v) + + "vpmovzxwd %%xmm0,%%ymm0 \n" // 01234567 (32b, 1u1v) + "vpmovzxwd %%xmm1,%%ymm1 \n" // 12345678 (32b, 1u1v) + + "vpshufd $0b10110001,%%ymm0,%%ymm2 \n" // 10325476 (lo, far) + "vpshufd $0b10110001,%%ymm1,%%ymm3 \n" // 21436587 (hi, far) + + "vpaddd %%ymm4,%%ymm2,%%ymm2 \n" // far+2 (lo) + "vpaddd %%ymm4,%%ymm3,%%ymm3 \n" // far+2 (hi) + "vpaddd %%ymm0,%%ymm2,%%ymm2 \n" // near+far+2 (lo) + "vpaddd %%ymm1,%%ymm3,%%ymm3 \n" // near+far+2 (hi) + "vpaddd %%ymm0,%%ymm0,%%ymm0 \n" // 2*near (lo) + "vpaddd %%ymm1,%%ymm1,%%ymm1 \n" // 2*near (hi) + "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 3*near+far+2 (lo) + "vpaddd %%ymm1,%%ymm3,%%ymm1 \n" // 3*near+far+2 (hi) + + "vpsrld $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far (lo) + "vpsrld $2,%%ymm1,%%ymm1 \n" // 3/4*near+1/4*far (hi) + "vpackusdw %%ymm1,%%ymm0,%%ymm0 \n" + "vpshufd $0b11011000,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 8 pixel to 16 pixel + "sub $0x10,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); +} + +#endif + +#ifdef HAS_SCALEROWUP2_BILINEAR_16_AVX2 + +void ScaleRowUp2_Bilinear_16_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "vpcmpeqd %%ymm6,%%ymm6,%%ymm6 \n" + "vpsrld $31,%%ymm6,%%ymm6 \n" + "vpslld $3,%%ymm6,%%ymm6 \n" // all 8 + + LABELALIGN + "1: \n" + + "vmovdqu (%0),%%xmm0 \n" // 01234567 (16b, 1u1v) + "vmovdqu 2(%0),%%xmm1 \n" // 12345678 (16b, 1u1v) + "vpmovzxwd %%xmm0,%%ymm0 \n" // 01234567 (32b, 1u1v) + "vpmovzxwd %%xmm1,%%ymm1 \n" // 12345678 (32b, 1u1v) + "vpshufd $0b10110001,%%ymm0,%%ymm2 \n" // 10325476 (lo, far) + "vpshufd $0b10110001,%%ymm1,%%ymm3 \n" // 21436587 (hi, far) + "vpaddd %%ymm0,%%ymm2,%%ymm2 \n" // near+far (lo) + "vpaddd %%ymm1,%%ymm3,%%ymm3 \n" // near+far (hi) + "vpaddd %%ymm0,%%ymm0,%%ymm0 \n" // 2*near (lo) + "vpaddd %%ymm1,%%ymm1,%%ymm1 \n" // 2*near (hi) + "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 3*near+far (1, lo) + "vpaddd %%ymm1,%%ymm3,%%ymm1 \n" // 3*near+far (1, hi) + + "vmovdqu (%0,%3,2),%%xmm2 \n" // 01234567 (16b, 1u1v) + "vmovdqu 2(%0,%3,2),%%xmm3 \n" // 12345678 (16b, 1u1v) + "vpmovzxwd %%xmm2,%%ymm2 \n" // 01234567 (32b, 1u1v) + "vpmovzxwd %%xmm3,%%ymm3 \n" // 12345678 (32b, 1u1v) + "vpshufd $0b10110001,%%ymm2,%%ymm4 \n" // 10325476 (lo, far) + "vpshufd $0b10110001,%%ymm3,%%ymm5 \n" // 21436587 (hi, far) + "vpaddd %%ymm2,%%ymm4,%%ymm4 \n" // near+far (lo) + "vpaddd %%ymm3,%%ymm5,%%ymm5 \n" // near+far (hi) + "vpaddd %%ymm2,%%ymm2,%%ymm2 \n" // 2*near (lo) + "vpaddd %%ymm3,%%ymm3,%%ymm3 \n" // 2*near (hi) + "vpaddd %%ymm2,%%ymm4,%%ymm2 \n" // 3*near+far (2, lo) + "vpaddd %%ymm3,%%ymm5,%%ymm3 \n" // 3*near+far (2, hi) + + "vpaddd %%ymm0,%%ymm0,%%ymm4 \n" // 6*near+2*far (1, lo) + "vpaddd %%ymm6,%%ymm2,%%ymm5 \n" // 3*near+far+8 (2, lo) + "vpaddd %%ymm4,%%ymm0,%%ymm4 \n" // 9*near+3*far (1, lo) + "vpaddd %%ymm4,%%ymm5,%%ymm4 \n" // 9 3 3 1 + 8 (1, lo) + "vpsrld $4,%%ymm4,%%ymm4 \n" // ^ div by 16 (1, lo) + + "vpaddd %%ymm2,%%ymm2,%%ymm5 \n" // 6*near+2*far (2, lo) + "vpaddd %%ymm6,%%ymm0,%%ymm0 \n" // 3*near+far+8 (1, lo) + "vpaddd %%ymm5,%%ymm2,%%ymm5 \n" // 9*near+3*far (2, lo) + "vpaddd %%ymm5,%%ymm0,%%ymm5 \n" // 9 3 3 1 + 8 (2, lo) + "vpsrld $4,%%ymm5,%%ymm5 \n" // ^ div by 16 (2, lo) + + "vpaddd %%ymm1,%%ymm1,%%ymm0 \n" // 6*near+2*far (1, hi) + "vpaddd %%ymm6,%%ymm3,%%ymm2 \n" // 3*near+far+8 (2, hi) + "vpaddd %%ymm0,%%ymm1,%%ymm0 \n" // 9*near+3*far (1, hi) + "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 9 3 3 1 + 8 (1, hi) + "vpsrld $4,%%ymm0,%%ymm0 \n" // ^ div by 16 (1, hi) + + "vpaddd %%ymm3,%%ymm3,%%ymm2 \n" // 6*near+2*far (2, hi) + "vpaddd %%ymm6,%%ymm1,%%ymm1 \n" // 3*near+far+8 (1, hi) + "vpaddd %%ymm2,%%ymm3,%%ymm2 \n" // 9*near+3*far (2, hi) + "vpaddd %%ymm2,%%ymm1,%%ymm2 \n" // 9 3 3 1 + 8 (2, hi) + "vpsrld $4,%%ymm2,%%ymm2 \n" // ^ div by 16 (2, hi) + + "vpackusdw %%ymm0,%%ymm4,%%ymm4 \n" + "vpshufd $0b11011000,%%ymm4,%%ymm4 \n" + "vmovdqu %%ymm4,(%1) \n" // store above + "vpackusdw %%ymm2,%%ymm5,%%ymm5 \n" + "vpshufd $0b11011000,%%ymm5,%%ymm5 \n" + "vmovdqu %%ymm5,(%1,%4,2) \n" // store below + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 8 pixel to 16 pixel + "sub $0x10,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6"); +} + +#endif + +// Reads 16xN bytes and produces 16 shorts at a time. +void ScaleAddRow_SSE2(const uint8_t *src_ptr, + uint16_t *dst_ptr, + int src_width) { + asm volatile("pxor %%xmm5,%%xmm5 \n" + + // 16 pixel loop. + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm3 \n" + "lea 0x10(%0),%0 \n" // src_ptr += 16 + "movdqu (%1),%%xmm0 \n" + "movdqu 0x10(%1),%%xmm1 \n" + "movdqa %%xmm3,%%xmm2 \n" + "punpcklbw %%xmm5,%%xmm2 \n" + "punpckhbw %%xmm5,%%xmm3 \n" + "paddusw %%xmm2,%%xmm0 \n" + "paddusw %%xmm3,%%xmm1 \n" + "movdqu %%xmm0,(%1) \n" + "movdqu %%xmm1,0x10(%1) \n" + "lea 0x20(%1),%1 \n" + "sub $0x10,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(src_width) // %2 + : + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm5"); +} + +#ifdef HAS_SCALEADDROW_AVX2 + +// Reads 32 bytes and accumulates to 32 shorts at a time. +void ScaleAddRow_AVX2(const uint8_t *src_ptr, + uint16_t *dst_ptr, + int src_width) { + asm volatile("vpxor %%ymm5,%%ymm5,%%ymm5 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm3 \n" + "lea 0x20(%0),%0 \n" // src_ptr += 32 + "vpermq $0xd8,%%ymm3,%%ymm3 \n" + "vpunpcklbw %%ymm5,%%ymm3,%%ymm2 \n" + "vpunpckhbw %%ymm5,%%ymm3,%%ymm3 \n" + "vpaddusw (%1),%%ymm2,%%ymm0 \n" + "vpaddusw 0x20(%1),%%ymm3,%%ymm1 \n" + "vmovdqu %%ymm0,(%1) \n" + "vmovdqu %%ymm1,0x20(%1) \n" + "lea 0x40(%1),%1 \n" + "sub $0x20,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(src_width) // %2 + : + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm5"); +} + +#endif // HAS_SCALEADDROW_AVX2 + +// Constant for making pixels signed to avoid pmaddubsw +// saturation. +static const uvec8 kFsub80 = {0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, + 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80}; + +// Constant for making pixels unsigned and adding .5 for rounding. +static const uvec16 kFadd40 = {0x4040, 0x4040, 0x4040, 0x4040, + 0x4040, 0x4040, 0x4040, 0x4040}; + +// Bilinear column filtering. SSSE3 version. +void ScaleFilterCols_SSSE3(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx) { + intptr_t x0, x1, temp_pixel; + asm volatile( + "movd %6,%%xmm2 \n" + "movd %7,%%xmm3 \n" + "movl $0x04040000,%k2 \n" + "movd %k2,%%xmm5 \n" + "pcmpeqb %%xmm6,%%xmm6 \n" + "psrlw $0x9,%%xmm6 \n" // 0x007f007f + "pcmpeqb %%xmm7,%%xmm7 \n" + "psrlw $15,%%xmm7 \n" // 0x00010001 + + "pextrw $0x1,%%xmm2,%k3 \n" + "subl $0x2,%5 \n" + "jl 29f \n" + "movdqa %%xmm2,%%xmm0 \n" + "paddd %%xmm3,%%xmm0 \n" + "punpckldq %%xmm0,%%xmm2 \n" + "punpckldq %%xmm3,%%xmm3 \n" + "paddd %%xmm3,%%xmm3 \n" + "pextrw $0x3,%%xmm2,%k4 \n" + + LABELALIGN + "2: \n" + "movdqa %%xmm2,%%xmm1 \n" + "paddd %%xmm3,%%xmm2 \n" + "movzwl 0x00(%1,%3,1),%k2 \n" + "movd %k2,%%xmm0 \n" + "psrlw $0x9,%%xmm1 \n" + "movzwl 0x00(%1,%4,1),%k2 \n" + "movd %k2,%%xmm4 \n" + "pshufb %%xmm5,%%xmm1 \n" + "punpcklwd %%xmm4,%%xmm0 \n" + "psubb %8,%%xmm0 \n" // make pixels signed. + "pxor %%xmm6,%%xmm1 \n" // 128 - f = (f ^ 127 ) + + // 1 + "paddusb %%xmm7,%%xmm1 \n" + "pmaddubsw %%xmm0,%%xmm1 \n" + "pextrw $0x1,%%xmm2,%k3 \n" + "pextrw $0x3,%%xmm2,%k4 \n" + "paddw %9,%%xmm1 \n" // make pixels unsigned. + "psrlw $0x7,%%xmm1 \n" + "packuswb %%xmm1,%%xmm1 \n" + "movd %%xmm1,%k2 \n" + "mov %w2,(%0) \n" + "lea 0x2(%0),%0 \n" + "subl $0x2,%5 \n" + "jge 2b \n" + + LABELALIGN + "29: \n" + "addl $0x1,%5 \n" + "jl 99f \n" + "movzwl 0x00(%1,%3,1),%k2 \n" + "movd %k2,%%xmm0 \n" + "psrlw $0x9,%%xmm2 \n" + "pshufb %%xmm5,%%xmm2 \n" + "psubb %8,%%xmm0 \n" // make pixels signed. + "pxor %%xmm6,%%xmm2 \n" + "paddusb %%xmm7,%%xmm2 \n" + "pmaddubsw %%xmm0,%%xmm2 \n" + "paddw %9,%%xmm2 \n" // make pixels unsigned. + "psrlw $0x7,%%xmm2 \n" + "packuswb %%xmm2,%%xmm2 \n" + "movd %%xmm2,%k2 \n" + "mov %b2,(%0) \n" + "99: \n" + : "+r"(dst_ptr), // %0 + "+r"(src_ptr), // %1 + "=&a"(temp_pixel), // %2 + "=&r"(x0), // %3 + "=&r"(x1), // %4 +#if defined(__x86_64__) + "+rm"(dst_width) // %5 +#else + "+m"(dst_width) // %5 +#endif + : "rm"(x), // %6 + "rm"(dx), // %7 +#if defined(__x86_64__) + "x"(kFsub80), // %8 + "x"(kFadd40) // %9 +#else + "m"(kFsub80), // %8 + "m"(kFadd40) // %9 +#endif + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +// Reads 4 pixels, duplicates them and writes 8 pixels. +// Alignment requirement: src_argb 16 byte aligned, dst_argb 16 byte aligned. +void ScaleColsUp2_SSE2(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx) { + (void) x; + (void) dx; + asm volatile(LABELALIGN + "1: \n" + "movdqu (%1),%%xmm0 \n" + "lea 0x10(%1),%1 \n" + "movdqa %%xmm0,%%xmm1 \n" + "punpcklbw %%xmm0,%%xmm0 \n" + "punpckhbw %%xmm1,%%xmm1 \n" + "movdqu %%xmm0,(%0) \n" + "movdqu %%xmm1,0x10(%0) \n" + "lea 0x20(%0),%0 \n" + "sub $0x20,%2 \n" + "jg 1b \n" + + : "+r"(dst_ptr), // %0 + "+r"(src_ptr), // %1 + "+r"(dst_width) // %2 + ::"memory", + "cc", "xmm0", "xmm1"); +} + +// Divide num by div and return as 16.16 fixed point result. +int FixedDiv_X86(int num, int div) { + asm volatile( + "cdq \n" + "shld $0x10,%%eax,%%edx \n" + "shl $0x10,%%eax \n" + "idiv %1 \n" + "mov %0, %%eax \n" + : "+a"(num) // %0 + : "c"(div) // %1 + : "memory", "cc", "edx"); + return num; +} + +// Divide num - 1 by div - 1 and return as 16.16 fixed point result. +int FixedDiv1_X86(int num, int div) { + asm volatile( + "cdq \n" + "shld $0x10,%%eax,%%edx \n" + "shl $0x10,%%eax \n" + "sub $0x10001,%%eax \n" + "sbb $0x0,%%edx \n" + "sub $0x1,%1 \n" + "idiv %1 \n" + "mov %0, %%eax \n" + : "+a"(num) // %0 + : "c"(div) // %1 + : "memory", "cc", "edx"); + return num; +} + +#if defined(HAS_SCALEUVROWDOWN2BOX_SSSE3) || \ + defined(HAS_SCALEUVROWDOWN2BOX_AVX2) + +// Shuffle table for splitting UV into upper and lower part of register. +static const uvec8 kShuffleSplitUV = {0u, 2u, 4u, 6u, 8u, 10u, 12u, 14u, + 1u, 3u, 5u, 7u, 9u, 11u, 13u, 15u}; +static const uvec8 kShuffleMergeUV = {0u, 8u, 2u, 10u, 4u, 12u, + 6u, 14u, 0x80, 0x80, 0x80, 0x80, + 0x80, 0x80, 0x80, 0x80}; +#endif + +#ifdef HAS_SCALEUVROWDOWN2BOX_SSSE3 + +void ScaleUVRowDown2Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "pcmpeqb %%xmm4,%%xmm4 \n" // 01010101 + "psrlw $0xf,%%xmm4 \n" + "packuswb %%xmm4,%%xmm4 \n" + "pxor %%xmm5, %%xmm5 \n" // zero + "movdqa %4,%%xmm1 \n" // split shuffler + "movdqa %5,%%xmm3 \n" // merge shuffler + + LABELALIGN + "1: \n" + "movdqu (%0),%%xmm0 \n" // 8 UV row 0 + "movdqu 0x00(%0,%3,1),%%xmm2 \n" // 8 UV row 1 + "lea 0x10(%0),%0 \n" + "pshufb %%xmm1,%%xmm0 \n" // uuuuvvvv + "pshufb %%xmm1,%%xmm2 \n" + "pmaddubsw %%xmm4,%%xmm0 \n" // horizontal add + "pmaddubsw %%xmm4,%%xmm2 \n" + "paddw %%xmm2,%%xmm0 \n" // vertical add + "psrlw $0x1,%%xmm0 \n" // round + "pavgw %%xmm5,%%xmm0 \n" + "pshufb %%xmm3,%%xmm0 \n" // merge uv + "movq %%xmm0,(%1) \n" + "lea 0x8(%1),%1 \n" // 4 UV + "sub $0x4,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "m"(kShuffleSplitUV), // %4 + "m"(kShuffleMergeUV) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif // HAS_SCALEUVROWDOWN2BOX_SSSE3 + +#ifdef HAS_SCALEUVROWDOWN2BOX_AVX2 + +void ScaleUVRowDown2Box_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "vpcmpeqb %%ymm4,%%ymm4,%%ymm4 \n" // 01010101 + "vpsrlw $0xf,%%ymm4,%%ymm4 \n" + "vpackuswb %%ymm4,%%ymm4,%%ymm4 \n" + "vpxor %%ymm5,%%ymm5,%%ymm5 \n" // zero + "vbroadcastf128 %4,%%ymm1 \n" // split shuffler + "vbroadcastf128 %5,%%ymm3 \n" // merge shuffler + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%ymm0 \n" // 16 UV row 0 + "vmovdqu 0x00(%0,%3,1),%%ymm2 \n" // 16 UV row 1 + "lea 0x20(%0),%0 \n" + "vpshufb %%ymm1,%%ymm0,%%ymm0 \n" // uuuuvvvv + "vpshufb %%ymm1,%%ymm2,%%ymm2 \n" + "vpmaddubsw %%ymm4,%%ymm0,%%ymm0 \n" // horizontal add + "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" + "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" // vertical add + "vpsrlw $0x1,%%ymm0,%%ymm0 \n" // round + "vpavgw %%ymm5,%%ymm0,%%ymm0 \n" + "vpshufb %%ymm3,%%ymm0,%%ymm0 \n" // merge uv + "vpermq $0xd8,%%ymm0,%%ymm0 \n" // combine qwords + "vmovdqu %%xmm0,(%1) \n" + "lea 0x10(%1),%1 \n" // 8 UV + "sub $0x8,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "m"(kShuffleSplitUV), // %4 + "m"(kShuffleMergeUV) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif // HAS_SCALEUVROWDOWN2BOX_AVX2 + +static const uvec8 kUVLinearMadd31 = {3, 1, 3, 1, 1, 3, 1, 3, + 3, 1, 3, 1, 1, 3, 1, 3}; + +#ifdef HAS_SCALEUVROWUP2_LINEAR_SSSE3 + +void ScaleUVRowUp2_Linear_SSSE3(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "pcmpeqw %%xmm4,%%xmm4 \n" + "psrlw $15,%%xmm4 \n" + "psllw $1,%%xmm4 \n" // all 2 + "movdqa %3,%%xmm3 \n" + + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" // 00112233 (1u1v) + "movq 2(%0),%%xmm1 \n" // 11223344 (1u1v) + "punpcklbw %%xmm1,%%xmm0 \n" // 0101121223233434 (2u2v) + "movdqa %%xmm0,%%xmm2 \n" + "punpckhdq %%xmm0,%%xmm2 \n" // 2323232334343434 (2u2v) + "punpckldq %%xmm0,%%xmm0 \n" // 0101010112121212 (2u2v) + "pmaddubsw %%xmm3,%%xmm2 \n" // 3*near+far (1u1v16, hi) + "pmaddubsw %%xmm3,%%xmm0 \n" // 3*near+far (1u1v16, lo) + "paddw %%xmm4,%%xmm0 \n" // 3*near+far+2 (lo) + "paddw %%xmm4,%%xmm2 \n" // 3*near+far+2 (hi) + "psrlw $2,%%xmm0 \n" // 3/4*near+1/4*far (lo) + "psrlw $2,%%xmm2 \n" // 3/4*near+1/4*far (hi) + "packuswb %%xmm2,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 4 uv to 8 uv + "sub $0x8,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "m"(kUVLinearMadd31) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6"); +} + +#endif + +#ifdef HAS_SCALEUVROWUP2_BILINEAR_SSSE3 + +void ScaleUVRowUp2_Bilinear_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "pcmpeqw %%xmm6,%%xmm6 \n" + "psrlw $15,%%xmm6 \n" + "psllw $3,%%xmm6 \n" // all 8 + "movdqa %5,%%xmm7 \n" + + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" // 00112233 (1u1v) + "movq 2(%0),%%xmm1 \n" // 11223344 (1u1v) + "punpcklbw %%xmm1,%%xmm0 \n" // 0101121223233434 (2u2v) + "movdqa %%xmm0,%%xmm2 \n" + "punpckhdq %%xmm0,%%xmm2 \n" // 2323232334343434 (2u2v) + "punpckldq %%xmm0,%%xmm0 \n" // 0101010112121212 (2u2v) + "pmaddubsw %%xmm7,%%xmm2 \n" // 3*near+far (1u1v16, hi) + "pmaddubsw %%xmm7,%%xmm0 \n" // 3*near+far (1u1v16, lo) + + "movq (%0,%3),%%xmm1 \n" + "movq 2(%0,%3),%%xmm4 \n" + "punpcklbw %%xmm4,%%xmm1 \n" + "movdqa %%xmm1,%%xmm3 \n" + "punpckhdq %%xmm1,%%xmm3 \n" + "punpckldq %%xmm1,%%xmm1 \n" + "pmaddubsw %%xmm7,%%xmm3 \n" // 3*near+far (2, hi) + "pmaddubsw %%xmm7,%%xmm1 \n" // 3*near+far (2, lo) + + // xmm0 xmm2 + // xmm1 xmm3 + + "movdqa %%xmm0,%%xmm4 \n" + "movdqa %%xmm1,%%xmm5 \n" + "paddw %%xmm0,%%xmm4 \n" // 6*near+2*far (1, lo) + "paddw %%xmm6,%%xmm5 \n" // 3*near+far+8 (2, lo) + "paddw %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) + "paddw %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) + "psrlw $4,%%xmm4 \n" // ^ div by 16 (1, lo) + + "movdqa %%xmm1,%%xmm5 \n" + "paddw %%xmm1,%%xmm5 \n" // 6*near+2*far (2, lo) + "paddw %%xmm6,%%xmm0 \n" // 3*near+far+8 (1, lo) + "paddw %%xmm1,%%xmm5 \n" // 9*near+3*far (2, lo) + "paddw %%xmm0,%%xmm5 \n" // 9 3 3 1 + 8 (2, lo) + "psrlw $4,%%xmm5 \n" // ^ div by 16 (2, lo) + + "movdqa %%xmm2,%%xmm0 \n" + "movdqa %%xmm3,%%xmm1 \n" + "paddw %%xmm2,%%xmm0 \n" // 6*near+2*far (1, hi) + "paddw %%xmm6,%%xmm1 \n" // 3*near+far+8 (2, hi) + "paddw %%xmm2,%%xmm0 \n" // 9*near+3*far (1, hi) + "paddw %%xmm1,%%xmm0 \n" // 9 3 3 1 + 8 (1, hi) + "psrlw $4,%%xmm0 \n" // ^ div by 16 (1, hi) + + "movdqa %%xmm3,%%xmm1 \n" + "paddw %%xmm3,%%xmm1 \n" // 6*near+2*far (2, hi) + "paddw %%xmm6,%%xmm2 \n" // 3*near+far+8 (1, hi) + "paddw %%xmm3,%%xmm1 \n" // 9*near+3*far (2, hi) + "paddw %%xmm2,%%xmm1 \n" // 9 3 3 1 + 8 (2, hi) + "psrlw $4,%%xmm1 \n" // ^ div by 16 (2, hi) + + "packuswb %%xmm0,%%xmm4 \n" + "movdqu %%xmm4,(%1) \n" // store above + "packuswb %%xmm1,%%xmm5 \n" + "movdqu %%xmm5,(%1,%4) \n" // store below + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 4 uv to 8 uv + "sub $0x8,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)), // %4 + "m"(kUVLinearMadd31) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif + +#ifdef HAS_SCALEUVROWUP2_LINEAR_AVX2 + +void ScaleUVRowUp2_Linear_AVX2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width) { + asm volatile( + "vpcmpeqw %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrlw $15,%%ymm4,%%ymm4 \n" + "vpsllw $1,%%ymm4,%%ymm4 \n" // all 2 + "vbroadcastf128 %3,%%ymm3 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%xmm0 \n" + "vmovdqu 2(%0),%%xmm1 \n" + "vpermq $0b11011000,%%ymm0,%%ymm0 \n" + "vpermq $0b11011000,%%ymm1,%%ymm1 \n" + "vpunpcklbw %%ymm1,%%ymm0,%%ymm0 \n" + "vpunpckhdq %%ymm0,%%ymm0,%%ymm2 \n" + "vpunpckldq %%ymm0,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm3,%%ymm2,%%ymm1 \n" // 3*near+far (hi) + "vpmaddubsw %%ymm3,%%ymm0,%%ymm0 \n" // 3*near+far (lo) + "vpaddw %%ymm4,%%ymm0,%%ymm0 \n" // 3*near+far+2 (lo) + "vpaddw %%ymm4,%%ymm1,%%ymm1 \n" // 3*near+far+2 (hi) + "vpsrlw $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far (lo) + "vpsrlw $2,%%ymm1,%%ymm1 \n" // 3/4*near+1/4*far (hi) + "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 8 uv to 16 uv + "sub $0x10,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "m"(kUVLinearMadd31) // %3 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); +} + +#endif + +#ifdef HAS_SCALEUVROWUP2_BILINEAR_AVX2 + +void ScaleUVRowUp2_Bilinear_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "vpcmpeqw %%ymm6,%%ymm6,%%ymm6 \n" + "vpsrlw $15,%%ymm6,%%ymm6 \n" + "vpsllw $3,%%ymm6,%%ymm6 \n" // all 8 + "vbroadcastf128 %5,%%ymm7 \n" + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%xmm0 \n" + "vmovdqu 2(%0),%%xmm1 \n" + "vpermq $0b11011000,%%ymm0,%%ymm0 \n" + "vpermq $0b11011000,%%ymm1,%%ymm1 \n" + "vpunpcklbw %%ymm1,%%ymm0,%%ymm0 \n" + "vpunpckhdq %%ymm0,%%ymm0,%%ymm2 \n" + "vpunpckldq %%ymm0,%%ymm0,%%ymm0 \n" + "vpmaddubsw %%ymm7,%%ymm2,%%ymm1 \n" // 3*near+far (1, hi) + "vpmaddubsw %%ymm7,%%ymm0,%%ymm0 \n" // 3*near+far (1, lo) + + "vmovdqu (%0,%3),%%xmm2 \n" // 0123456789ABCDEF + "vmovdqu 2(%0,%3),%%xmm3 \n" // 123456789ABCDEF0 + "vpermq $0b11011000,%%ymm2,%%ymm2 \n" + "vpermq $0b11011000,%%ymm3,%%ymm3 \n" + "vpunpcklbw %%ymm3,%%ymm2,%%ymm2 \n" + "vpunpckhdq %%ymm2,%%ymm2,%%ymm4 \n" + "vpunpckldq %%ymm2,%%ymm2,%%ymm2 \n" + "vpmaddubsw %%ymm7,%%ymm4,%%ymm3 \n" // 3*near+far (2, hi) + "vpmaddubsw %%ymm7,%%ymm2,%%ymm2 \n" // 3*near+far (2, lo) + + // ymm0 ymm1 + // ymm2 ymm3 + + "vpaddw %%ymm0,%%ymm0,%%ymm4 \n" // 6*near+2*far (1, lo) + "vpaddw %%ymm6,%%ymm2,%%ymm5 \n" // 3*near+far+8 (2, lo) + "vpaddw %%ymm4,%%ymm0,%%ymm4 \n" // 9*near+3*far (1, lo) + "vpaddw %%ymm4,%%ymm5,%%ymm4 \n" // 9 3 3 1 + 8 (1, lo) + "vpsrlw $4,%%ymm4,%%ymm4 \n" // ^ div by 16 (1, lo) + + "vpaddw %%ymm2,%%ymm2,%%ymm5 \n" // 6*near+2*far (2, lo) + "vpaddw %%ymm6,%%ymm0,%%ymm0 \n" // 3*near+far+8 (1, lo) + "vpaddw %%ymm5,%%ymm2,%%ymm5 \n" // 9*near+3*far (2, lo) + "vpaddw %%ymm5,%%ymm0,%%ymm5 \n" // 9 3 3 1 + 8 (2, lo) + "vpsrlw $4,%%ymm5,%%ymm5 \n" // ^ div by 16 (2, lo) + + "vpaddw %%ymm1,%%ymm1,%%ymm0 \n" // 6*near+2*far (1, hi) + "vpaddw %%ymm6,%%ymm3,%%ymm2 \n" // 3*near+far+8 (2, hi) + "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 9*near+3*far (1, hi) + "vpaddw %%ymm0,%%ymm2,%%ymm0 \n" // 9 3 3 1 + 8 (1, hi) + "vpsrlw $4,%%ymm0,%%ymm0 \n" // ^ div by 16 (1, hi) + + "vpaddw %%ymm3,%%ymm3,%%ymm2 \n" // 6*near+2*far (2, hi) + "vpaddw %%ymm6,%%ymm1,%%ymm1 \n" // 3*near+far+8 (1, hi) + "vpaddw %%ymm2,%%ymm3,%%ymm2 \n" // 9*near+3*far (2, hi) + "vpaddw %%ymm2,%%ymm1,%%ymm2 \n" // 9 3 3 1 + 8 (2, hi) + "vpsrlw $4,%%ymm2,%%ymm2 \n" // ^ div by 16 (2, hi) + + "vpackuswb %%ymm0,%%ymm4,%%ymm4 \n" + "vmovdqu %%ymm4,(%1) \n" // store above + "vpackuswb %%ymm2,%%ymm5,%%ymm5 \n" + "vmovdqu %%ymm5,(%1,%4) \n" // store below + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 8 uv to 16 uv + "sub $0x10,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)), // %4 + "m"(kUVLinearMadd31) // %5 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif + +#ifdef HAS_SCALEUVROWUP2_LINEAR_16_SSE41 + +void ScaleUVRowUp2_Linear_16_SSE41(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width) { + asm volatile( + "pxor %%xmm5,%%xmm5 \n" + "pcmpeqd %%xmm4,%%xmm4 \n" + "psrld $31,%%xmm4 \n" + "pslld $1,%%xmm4 \n" // all 2 + + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" // 0011 (16b, 1u1v) + "movq 4(%0),%%xmm1 \n" // 1122 (16b, 1u1v) + + "punpcklwd %%xmm5,%%xmm0 \n" // 0011 (32b, 1u1v) + "punpcklwd %%xmm5,%%xmm1 \n" // 1122 (32b, 1u1v) + + "movdqa %%xmm0,%%xmm2 \n" + "movdqa %%xmm1,%%xmm3 \n" + + "pshufd $0b01001110,%%xmm2,%%xmm2 \n" // 1100 (lo, far) + "pshufd $0b01001110,%%xmm3,%%xmm3 \n" // 2211 (hi, far) + + "paddd %%xmm4,%%xmm2 \n" // far+2 (lo) + "paddd %%xmm4,%%xmm3 \n" // far+2 (hi) + "paddd %%xmm0,%%xmm2 \n" // near+far+2 (lo) + "paddd %%xmm1,%%xmm3 \n" // near+far+2 (hi) + "paddd %%xmm0,%%xmm0 \n" // 2*near (lo) + "paddd %%xmm1,%%xmm1 \n" // 2*near (hi) + "paddd %%xmm2,%%xmm0 \n" // 3*near+far+2 (lo) + "paddd %%xmm3,%%xmm1 \n" // 3*near+far+2 (hi) + + "psrld $2,%%xmm0 \n" // 3/4*near+1/4*far (lo) + "psrld $2,%%xmm1 \n" // 3/4*near+1/4*far (hi) + "packusdw %%xmm1,%%xmm0 \n" + "movdqu %%xmm0,(%1) \n" + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 2 uv to 4 uv + "sub $0x4,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); +} + +#endif + +#ifdef HAS_SCALEUVROWUP2_BILINEAR_16_SSE41 + +void ScaleUVRowUp2_Bilinear_16_SSE41(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "pxor %%xmm7,%%xmm7 \n" + "pcmpeqd %%xmm6,%%xmm6 \n" + "psrld $31,%%xmm6 \n" + "pslld $3,%%xmm6 \n" // all 8 + + LABELALIGN + "1: \n" + "movq (%0),%%xmm0 \n" // 0011 (16b, 1u1v) + "movq 4(%0),%%xmm1 \n" // 1122 (16b, 1u1v) + "punpcklwd %%xmm7,%%xmm0 \n" // 0011 (near) (32b, 1u1v) + "punpcklwd %%xmm7,%%xmm1 \n" // 1122 (near) (32b, 1u1v) + "movdqa %%xmm0,%%xmm2 \n" + "movdqa %%xmm1,%%xmm3 \n" + "pshufd $0b01001110,%%xmm2,%%xmm2 \n" // 1100 (far) (1, lo) + "pshufd $0b01001110,%%xmm3,%%xmm3 \n" // 2211 (far) (1, hi) + "paddd %%xmm0,%%xmm2 \n" // near+far (1, lo) + "paddd %%xmm1,%%xmm3 \n" // near+far (1, hi) + "paddd %%xmm0,%%xmm0 \n" // 2*near (1, lo) + "paddd %%xmm1,%%xmm1 \n" // 2*near (1, hi) + "paddd %%xmm2,%%xmm0 \n" // 3*near+far (1, lo) + "paddd %%xmm3,%%xmm1 \n" // 3*near+far (1, hi) + + "movq (%0,%3,2),%%xmm2 \n" + "movq 4(%0,%3,2),%%xmm3 \n" + "punpcklwd %%xmm7,%%xmm2 \n" + "punpcklwd %%xmm7,%%xmm3 \n" + "movdqa %%xmm2,%%xmm4 \n" + "movdqa %%xmm3,%%xmm5 \n" + "pshufd $0b01001110,%%xmm4,%%xmm4 \n" // 1100 (far) (2, lo) + "pshufd $0b01001110,%%xmm5,%%xmm5 \n" // 2211 (far) (2, hi) + "paddd %%xmm2,%%xmm4 \n" // near+far (2, lo) + "paddd %%xmm3,%%xmm5 \n" // near+far (2, hi) + "paddd %%xmm2,%%xmm2 \n" // 2*near (2, lo) + "paddd %%xmm3,%%xmm3 \n" // 2*near (2, hi) + "paddd %%xmm4,%%xmm2 \n" // 3*near+far (2, lo) + "paddd %%xmm5,%%xmm3 \n" // 3*near+far (2, hi) + + "movdqa %%xmm0,%%xmm4 \n" + "movdqa %%xmm2,%%xmm5 \n" + "paddd %%xmm0,%%xmm4 \n" // 6*near+2*far (1, lo) + "paddd %%xmm6,%%xmm5 \n" // 3*near+far+8 (2, lo) + "paddd %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) + "paddd %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) + "psrld $4,%%xmm4 \n" // ^ div by 16 (1, lo) + + "movdqa %%xmm2,%%xmm5 \n" + "paddd %%xmm2,%%xmm5 \n" // 6*near+2*far (2, lo) + "paddd %%xmm6,%%xmm0 \n" // 3*near+far+8 (1, lo) + "paddd %%xmm2,%%xmm5 \n" // 9*near+3*far (2, lo) + "paddd %%xmm0,%%xmm5 \n" // 9 3 3 1 + 8 (2, lo) + "psrld $4,%%xmm5 \n" // ^ div by 16 (2, lo) + + "movdqa %%xmm1,%%xmm0 \n" + "movdqa %%xmm3,%%xmm2 \n" + "paddd %%xmm1,%%xmm0 \n" // 6*near+2*far (1, hi) + "paddd %%xmm6,%%xmm2 \n" // 3*near+far+8 (2, hi) + "paddd %%xmm1,%%xmm0 \n" // 9*near+3*far (1, hi) + "paddd %%xmm2,%%xmm0 \n" // 9 3 3 1 + 8 (1, hi) + "psrld $4,%%xmm0 \n" // ^ div by 16 (1, hi) + + "movdqa %%xmm3,%%xmm2 \n" + "paddd %%xmm3,%%xmm2 \n" // 6*near+2*far (2, hi) + "paddd %%xmm6,%%xmm1 \n" // 3*near+far+8 (1, hi) + "paddd %%xmm3,%%xmm2 \n" // 9*near+3*far (2, hi) + "paddd %%xmm1,%%xmm2 \n" // 9 3 3 1 + 8 (2, hi) + "psrld $4,%%xmm2 \n" // ^ div by 16 (2, hi) + + "packusdw %%xmm0,%%xmm4 \n" + "movdqu %%xmm4,(%1) \n" // store above + "packusdw %%xmm2,%%xmm5 \n" + "movdqu %%xmm5,(%1,%4,2) \n" // store below + + "lea 0x8(%0),%0 \n" + "lea 0x10(%1),%1 \n" // 2 uv to 4 uv + "sub $0x4,%2 \n" + "jg 1b \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", + "xmm7"); +} + +#endif + +#ifdef HAS_SCALEUVROWUP2_LINEAR_16_AVX2 + +void ScaleUVRowUp2_Linear_16_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width) { + asm volatile( + "vpcmpeqd %%ymm4,%%ymm4,%%ymm4 \n" + "vpsrld $31,%%ymm4,%%ymm4 \n" + "vpslld $1,%%ymm4,%%ymm4 \n" // all 2 + + LABELALIGN + "1: \n" + "vmovdqu (%0),%%xmm0 \n" // 00112233 (16b, 1u1v) + "vmovdqu 4(%0),%%xmm1 \n" // 11223344 (16b, 1u1v) + + "vpmovzxwd %%xmm0,%%ymm0 \n" // 01234567 (32b, 1u1v) + "vpmovzxwd %%xmm1,%%ymm1 \n" // 12345678 (32b, 1u1v) + + "vpshufd $0b01001110,%%ymm0,%%ymm2 \n" // 11003322 (lo, far) + "vpshufd $0b01001110,%%ymm1,%%ymm3 \n" // 22114433 (hi, far) + + "vpaddd %%ymm4,%%ymm2,%%ymm2 \n" // far+2 (lo) + "vpaddd %%ymm4,%%ymm3,%%ymm3 \n" // far+2 (hi) + "vpaddd %%ymm0,%%ymm2,%%ymm2 \n" // near+far+2 (lo) + "vpaddd %%ymm1,%%ymm3,%%ymm3 \n" // near+far+2 (hi) + "vpaddd %%ymm0,%%ymm0,%%ymm0 \n" // 2*near (lo) + "vpaddd %%ymm1,%%ymm1,%%ymm1 \n" // 2*near (hi) + "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 3*near+far+2 (lo) + "vpaddd %%ymm1,%%ymm3,%%ymm1 \n" // 3*near+far+2 (hi) + + "vpsrld $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far (lo) + "vpsrld $2,%%ymm1,%%ymm1 \n" // 3/4*near+1/4*far (hi) + "vpackusdw %%ymm1,%%ymm0,%%ymm0 \n" + "vmovdqu %%ymm0,(%1) \n" + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 4 uv to 8 uv + "sub $0x8,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); +} + +#endif + +#ifdef HAS_SCALEUVROWUP2_BILINEAR_16_AVX2 + +void ScaleUVRowUp2_Bilinear_16_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width) { + asm volatile( + "vpcmpeqd %%ymm6,%%ymm6,%%ymm6 \n" + "vpsrld $31,%%ymm6,%%ymm6 \n" + "vpslld $3,%%ymm6,%%ymm6 \n" // all 8 + + LABELALIGN + "1: \n" + + "vmovdqu (%0),%%xmm0 \n" // 00112233 (16b, 1u1v) + "vmovdqu 4(%0),%%xmm1 \n" // 11223344 (16b, 1u1v) + "vpmovzxwd %%xmm0,%%ymm0 \n" // 01234567 (32b, 1u1v) + "vpmovzxwd %%xmm1,%%ymm1 \n" // 12345678 (32b, 1u1v) + "vpshufd $0b01001110,%%ymm0,%%ymm2 \n" // 11003322 (lo, far) + "vpshufd $0b01001110,%%ymm1,%%ymm3 \n" // 22114433 (hi, far) + "vpaddd %%ymm0,%%ymm2,%%ymm2 \n" // near+far (lo) + "vpaddd %%ymm1,%%ymm3,%%ymm3 \n" // near+far (hi) + "vpaddd %%ymm0,%%ymm0,%%ymm0 \n" // 2*near (lo) + "vpaddd %%ymm1,%%ymm1,%%ymm1 \n" // 2*near (hi) + "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 3*near+far (lo) + "vpaddd %%ymm1,%%ymm3,%%ymm1 \n" // 3*near+far (hi) + + "vmovdqu (%0,%3,2),%%xmm2 \n" // 00112233 (16b, 1u1v) + "vmovdqu 4(%0,%3,2),%%xmm3 \n" // 11223344 (16b, 1u1v) + "vpmovzxwd %%xmm2,%%ymm2 \n" // 01234567 (32b, 1u1v) + "vpmovzxwd %%xmm3,%%ymm3 \n" // 12345678 (32b, 1u1v) + "vpshufd $0b01001110,%%ymm2,%%ymm4 \n" // 11003322 (lo, far) + "vpshufd $0b01001110,%%ymm3,%%ymm5 \n" // 22114433 (hi, far) + "vpaddd %%ymm2,%%ymm4,%%ymm4 \n" // near+far (lo) + "vpaddd %%ymm3,%%ymm5,%%ymm5 \n" // near+far (hi) + "vpaddd %%ymm2,%%ymm2,%%ymm2 \n" // 2*near (lo) + "vpaddd %%ymm3,%%ymm3,%%ymm3 \n" // 2*near (hi) + "vpaddd %%ymm2,%%ymm4,%%ymm2 \n" // 3*near+far (lo) + "vpaddd %%ymm3,%%ymm5,%%ymm3 \n" // 3*near+far (hi) + + "vpaddd %%ymm0,%%ymm0,%%ymm4 \n" // 6*near+2*far (1, lo) + "vpaddd %%ymm6,%%ymm2,%%ymm5 \n" // 3*near+far+8 (2, lo) + "vpaddd %%ymm4,%%ymm0,%%ymm4 \n" // 9*near+3*far (1, lo) + "vpaddd %%ymm4,%%ymm5,%%ymm4 \n" // 9 3 3 1 + 8 (1, lo) + "vpsrld $4,%%ymm4,%%ymm4 \n" // ^ div by 16 (1, lo) + + "vpaddd %%ymm2,%%ymm2,%%ymm5 \n" // 6*near+2*far (2, lo) + "vpaddd %%ymm6,%%ymm0,%%ymm0 \n" // 3*near+far+8 (1, lo) + "vpaddd %%ymm5,%%ymm2,%%ymm5 \n" // 9*near+3*far (2, lo) + "vpaddd %%ymm5,%%ymm0,%%ymm5 \n" // 9 3 3 1 + 8 (2, lo) + "vpsrld $4,%%ymm5,%%ymm5 \n" // ^ div by 16 (2, lo) + + "vpaddd %%ymm1,%%ymm1,%%ymm0 \n" // 6*near+2*far (1, hi) + "vpaddd %%ymm6,%%ymm3,%%ymm2 \n" // 3*near+far+8 (2, hi) + "vpaddd %%ymm0,%%ymm1,%%ymm0 \n" // 9*near+3*far (1, hi) + "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 9 3 3 1 + 8 (1, hi) + "vpsrld $4,%%ymm0,%%ymm0 \n" // ^ div by 16 (1, hi) + + "vpaddd %%ymm3,%%ymm3,%%ymm2 \n" // 6*near+2*far (2, hi) + "vpaddd %%ymm6,%%ymm1,%%ymm1 \n" // 3*near+far+8 (1, hi) + "vpaddd %%ymm2,%%ymm3,%%ymm2 \n" // 9*near+3*far (2, hi) + "vpaddd %%ymm2,%%ymm1,%%ymm2 \n" // 9 3 3 1 + 8 (2, hi) + "vpsrld $4,%%ymm2,%%ymm2 \n" // ^ div by 16 (2, hi) + + "vpackusdw %%ymm0,%%ymm4,%%ymm4 \n" + "vmovdqu %%ymm4,(%1) \n" // store above + "vpackusdw %%ymm2,%%ymm5,%%ymm5 \n" + "vmovdqu %%ymm5,(%1,%4,2) \n" // store below + + "lea 0x10(%0),%0 \n" + "lea 0x20(%1),%1 \n" // 4 uv to 8 uv + "sub $0x8,%2 \n" + "jg 1b \n" + "vzeroupper \n" + : "+r"(src_ptr), // %0 + "+r"(dst_ptr), // %1 + "+r"(dst_width) // %2 + : "r"((intptr_t) (src_stride)), // %3 + "r"((intptr_t) (dst_stride)) // %4 + : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6"); +} + +#endif + +#endif // defined(__x86_64__) || defined(__i386__) diff --git a/pkg/encoder/yuv/libyuv/scale_row.h b/pkg/encoder/yuv/libyuv/scale_row.h new file mode 100644 index 00000000..16389cdc --- /dev/null +++ b/pkg/encoder/yuv/libyuv/scale_row.h @@ -0,0 +1,768 @@ +/* + * Copyright 2013 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_SCALE_ROW_H_ +#define INCLUDE_LIBYUV_SCALE_ROW_H_ + +#include "basic_types.h" +#include "scale.h" + +#if defined(__pnacl__) || defined(__CLR_VER) || \ + (defined(__native_client__) && defined(__x86_64__)) || \ + (defined(__i386__) && !defined(__SSE__) && !defined(__clang__)) +#define LIBYUV_DISABLE_X86 +#endif +#if defined(__native_client__) +#define LIBYUV_DISABLE_NEON +#endif +// MemorySanitizer does not support assembly code yet. http://crbug.com/344505 +#if defined(__has_feature) +#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_NEON) +#define LIBYUV_DISABLE_NEON +#endif +#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_X86) +#define LIBYUV_DISABLE_X86 +#endif +#endif +// GCC >= 4.7.0 required for AVX2. +#if defined(__GNUC__) && (defined(__x86_64__) || defined(__i386__)) +#if (__GNUC__ > 4) || (__GNUC__ == 4 && (__GNUC_MINOR__ >= 7)) +#define GCC_HAS_AVX2 1 +#endif // GNUC >= 4.7 +#endif // __GNUC__ + +// The following are available on all x86 platforms: +#if !defined(LIBYUV_DISABLE_X86) && \ + (defined(_M_IX86) || defined(__x86_64__) || defined(__i386__)) +#define HAS_FIXEDDIV1_X86 +#define HAS_FIXEDDIV_X86 +#define HAS_SCALEADDROW_SSE2 +#define HAS_SCALECOLSUP2_SSE2 +#define HAS_SCALEFILTERCOLS_SSSE3 +#define HAS_SCALEROWDOWN2_SSSE3 +#define HAS_SCALEROWDOWN34_SSSE3 +#define HAS_SCALEROWDOWN38_SSSE3 +#define HAS_SCALEROWDOWN4_SSSE3 +#endif + +// The following are available for gcc/clang x86 platforms: +// TODO(fbarchard): Port to Visual C +#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) +#define HAS_SCALEUVROWDOWN2BOX_SSSE3 +#define HAS_SCALEROWUP2_LINEAR_SSE2 +#define HAS_SCALEROWUP2_LINEAR_SSSE3 +#define HAS_SCALEROWUP2_BILINEAR_SSE2 +#define HAS_SCALEROWUP2_BILINEAR_SSSE3 +#define HAS_SCALEROWUP2_LINEAR_12_SSSE3 +#define HAS_SCALEROWUP2_BILINEAR_12_SSSE3 +#define HAS_SCALEROWUP2_LINEAR_16_SSE2 +#define HAS_SCALEROWUP2_BILINEAR_16_SSE2 +#define HAS_SCALEUVROWUP2_LINEAR_SSSE3 +#define HAS_SCALEUVROWUP2_BILINEAR_SSSE3 +#define HAS_SCALEUVROWUP2_LINEAR_16_SSE41 +#define HAS_SCALEUVROWUP2_BILINEAR_16_SSE41 +#endif + +// The following are available for gcc/clang x86 platforms, but +// require clang 3.4 or gcc 4.7. +// TODO(fbarchard): Port to Visual C +#if !defined(LIBYUV_DISABLE_X86) && \ + (defined(__x86_64__) || defined(__i386__)) && \ + (defined(CLANG_HAS_AVX2) || defined(GCC_HAS_AVX2)) +#define HAS_SCALEUVROWDOWN2BOX_AVX2 +#define HAS_SCALEROWUP2_LINEAR_AVX2 +#define HAS_SCALEROWUP2_BILINEAR_AVX2 +#define HAS_SCALEROWUP2_LINEAR_12_AVX2 +#define HAS_SCALEROWUP2_BILINEAR_12_AVX2 +#define HAS_SCALEROWUP2_LINEAR_16_AVX2 +#define HAS_SCALEROWUP2_BILINEAR_16_AVX2 +#define HAS_SCALEUVROWUP2_LINEAR_AVX2 +#define HAS_SCALEUVROWUP2_BILINEAR_AVX2 +#define HAS_SCALEUVROWUP2_LINEAR_16_AVX2 +#define HAS_SCALEUVROWUP2_BILINEAR_16_AVX2 +#endif + +// The following are available on all x86 platforms, but +// require VS2012, clang 3.4 or gcc 4.7. +// The code supports NaCL but requires a new compiler and validator. +#if !defined(LIBYUV_DISABLE_X86) && \ + (defined(VISUALC_HAS_AVX2) || defined(CLANG_HAS_AVX2) || \ + defined(GCC_HAS_AVX2)) +#define HAS_SCALEADDROW_AVX2 +#define HAS_SCALEROWDOWN2_AVX2 +#define HAS_SCALEROWDOWN4_AVX2 +#endif + +// Scale ARGB vertically with bilinear interpolation. +void ScalePlaneVertical(int src_height, + int dst_width, + int dst_height, + int src_stride, + int dst_stride, + const uint8_t *src_argb, + uint8_t *dst_argb, + int x, + int y, + int dy, + int bpp, + enum FilterMode filtering); + +// Simplify the filtering based on scale factors. +enum FilterMode ScaleFilterReduce(int src_width, + int src_height, + int dst_width, + int dst_height, + enum FilterMode filtering); + +// Divide num by div and return as 16.16 fixed point result. +int FixedDiv_X86(int num, int div); + +int FixedDiv1_X86(int num, int div); + +#ifdef HAS_FIXEDDIV_X86 +#define FixedDiv FixedDiv_X86 +#define FixedDiv1 FixedDiv1_X86 +#endif + +// Compute slope values for stepping. +void ScaleSlope(int src_width, + int src_height, + int dst_width, + int dst_height, + enum FilterMode filtering, + int *x, + int *y, + int *dx, + int *dy); + +void ScaleRowDown2_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width); + +void ScaleRowDown2Linear_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width); + +void ScaleRowDown2Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width); + +void ScaleRowDown2Box_Odd_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width); + +void ScaleRowDown4_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width); + +void ScaleRowDown4Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width); + +void ScaleRowDown34_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width); + +void ScaleRowDown34_0_Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *d, + int dst_width); + +void ScaleRowDown34_1_Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *d, + int dst_width); + +void ScaleRowUp2_Linear_C(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_16_C(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_16_C(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_Any_C(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_Any_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_16_Any_C(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_16_Any_C(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleCols_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx); + +void ScaleColsUp2_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int, + int); + +void ScaleFilterCols_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx); + +void ScaleFilterCols64_C(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x32, + int dx); + +void ScaleRowDown38_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst, + int dst_width); + +void ScaleRowDown38_3_Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown38_2_Box_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleAddRow_C(const uint8_t *src_ptr, uint16_t *dst_ptr, int src_width); + +void ScaleUVRowDown2_C(const uint8_t *src_uv, + ptrdiff_t src_stride, + uint8_t *dst_uv, + int dst_width); + +void ScaleUVRowDown2Linear_C(const uint8_t *src_uv, + ptrdiff_t src_stride, + uint8_t *dst_uv, + int dst_width); + +void ScaleUVRowDown2Box_C(const uint8_t *src_uv, + ptrdiff_t src_stride, + uint8_t *dst_uv, + int dst_width); + +void ScaleUVRowDownEven_C(const uint8_t *src_uv, + ptrdiff_t src_stride, + int src_stepx, + uint8_t *dst_uv, + int dst_width); + +void ScaleUVRowUp2_Linear_C(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_Any_C(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_Any_C(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_16_C(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_16_C(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_16_Any_C(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_16_Any_C(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +// Specialized scalers for x86. +void ScaleRowDown2_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Linear_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Linear_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Box_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown4_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown4Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown4_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown4Box_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown34_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown34_1_Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown34_0_Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown38_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown38_3_Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown38_2_Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Linear_SSE2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_SSE2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_12_SSSE3(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_12_SSSE3(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_16_SSE2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_16_SSE2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_SSSE3(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_AVX2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_12_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_12_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_16_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_16_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_Any_SSE2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_Any_SSE2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_12_Any_SSSE3(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_12_Any_SSSE3(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_16_Any_SSE2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_16_Any_SSE2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_Any_SSSE3(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_Any_AVX2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_Any_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_12_Any_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_12_Any_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowUp2_Linear_16_Any_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleRowUp2_Bilinear_16_Any_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleRowDown2_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Linear_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Box_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Box_Odd_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2_Any_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Linear_Any_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Box_Any_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown2Box_Odd_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown4_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown4Box_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown4_Any_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown4Box_Any_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown34_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown34_1_Box_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown34_0_Box_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown38_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown38_3_Box_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleRowDown38_2_Box_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleAddRow_SSE2(const uint8_t *src_ptr, uint16_t *dst_ptr, int src_width); + +void ScaleAddRow_AVX2(const uint8_t *src_ptr, uint16_t *dst_ptr, int src_width); + +void ScaleAddRow_Any_SSE2(const uint8_t *src_ptr, + uint16_t *dst_ptr, + int src_width); + +void ScaleAddRow_Any_AVX2(const uint8_t *src_ptr, + uint16_t *dst_ptr, + int src_width); + +void ScaleFilterCols_SSSE3(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx); + +void ScaleColsUp2_SSE2(uint8_t *dst_ptr, + const uint8_t *src_ptr, + int dst_width, + int x, + int dx); + +// UV Row functions +void ScaleUVRowDown2Box_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_uv, + int dst_width); + +void ScaleUVRowDown2Box_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_uv, + int dst_width); + +void ScaleUVRowDown2Box_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleUVRowDown2Box_Any_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Linear_SSSE3(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_Any_SSSE3(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_Any_SSSE3(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_AVX2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_Any_AVX2(const uint8_t *src_ptr, + uint8_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_Any_AVX2(const uint8_t *src_ptr, + ptrdiff_t src_stride, + uint8_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_16_SSE41(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_16_SSE41(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_16_Any_SSE41(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_16_Any_SSE41(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_16_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_16_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +void ScaleUVRowUp2_Linear_16_Any_AVX2(const uint16_t *src_ptr, + uint16_t *dst_ptr, + int dst_width); + +void ScaleUVRowUp2_Bilinear_16_Any_AVX2(const uint16_t *src_ptr, + ptrdiff_t src_stride, + uint16_t *dst_ptr, + ptrdiff_t dst_stride, + int dst_width); + +#endif // INCLUDE_LIBYUV_SCALE_ROW_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/version.h b/pkg/encoder/yuv/libyuv/version.h new file mode 100644 index 00000000..d45ef09d --- /dev/null +++ b/pkg/encoder/yuv/libyuv/version.h @@ -0,0 +1,16 @@ +/* + * Copyright 2012 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef INCLUDE_LIBYUV_VERSION_H_ +#define INCLUDE_LIBYUV_VERSION_H_ + +#define LIBYUV_VERSION 1875 + +#endif // INCLUDE_LIBYUV_VERSION_H_ diff --git a/pkg/encoder/yuv/libyuv/video_common.c b/pkg/encoder/yuv/libyuv/video_common.c new file mode 100644 index 00000000..e492402e --- /dev/null +++ b/pkg/encoder/yuv/libyuv/video_common.c @@ -0,0 +1,50 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#include "video_common.h" + +struct FourCCAliasEntry { + uint32_t alias; + uint32_t canonical; +}; + +#define NUM_ALIASES 18 +static const struct FourCCAliasEntry kFourCCAliases[NUM_ALIASES] = { + {FOURCC_IYUV, FOURCC_I420}, + {FOURCC_YU12, FOURCC_I420}, + {FOURCC_YU16, FOURCC_I422}, + {FOURCC_YU24, FOURCC_I444}, + {FOURCC_YUYV, FOURCC_YUY2}, + {FOURCC_YUVS, FOURCC_YUY2}, // kCMPixelFormat_422YpCbCr8_yuvs + {FOURCC_HDYC, FOURCC_UYVY}, + {FOURCC_2VUY, FOURCC_UYVY}, // kCMPixelFormat_422YpCbCr8 + {FOURCC_JPEG, FOURCC_MJPG}, // Note: JPEG has DHT while MJPG does not. + {FOURCC_DMB1, FOURCC_MJPG}, + {FOURCC_BA81, FOURCC_BGGR}, // deprecated. + {FOURCC_RGB3, FOURCC_RAW}, + {FOURCC_BGR3, FOURCC_24BG}, + {FOURCC_CM32, FOURCC_BGRA}, // kCMPixelFormat_32ARGB + {FOURCC_CM24, FOURCC_RAW}, // kCMPixelFormat_24RGB + {FOURCC_L555, FOURCC_RGBO}, // kCMPixelFormat_16LE555 + {FOURCC_L565, FOURCC_RGBP}, // kCMPixelFormat_16LE565 + {FOURCC_5551, FOURCC_RGBO}, // kCMPixelFormat_16LE5551 +}; + +LIBYUV_API +uint32_t CanonicalFourCC(uint32_t fourcc) { + int i; + for (i = 0; i < NUM_ALIASES; ++i) { + if (kFourCCAliases[i].alias == fourcc) { + return kFourCCAliases[i].canonical; + } + } + // Not an alias, so return it as-is. + return fourcc; +} diff --git a/pkg/encoder/yuv/libyuv/video_common.h b/pkg/encoder/yuv/libyuv/video_common.h new file mode 100644 index 00000000..e2aacf44 --- /dev/null +++ b/pkg/encoder/yuv/libyuv/video_common.h @@ -0,0 +1,212 @@ +/* + * Copyright 2011 The LibYuv Project Authors. All rights reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +// Common definitions for video, including fourcc and VideoFormat. + +#ifndef INCLUDE_LIBYUV_VIDEO_COMMON_H_ +#define INCLUDE_LIBYUV_VIDEO_COMMON_H_ + +#include "basic_types.h" + +////////////////////////////////////////////////////////////////////////////// +// Definition of FourCC codes +////////////////////////////////////////////////////////////////////////////// + +// Convert four characters to a FourCC code. +// Needs to be a macro otherwise the OS X compiler complains when the kFormat* +// constants are used in a switch. +#ifdef __cplusplus +#define FOURCC(a, b, c, d) \ + ((static_cast(a)) | (static_cast(b) << 8) | \ + (static_cast(c) << 16) | /* NOLINT */ \ + (static_cast(d) << 24)) /* NOLINT */ +#else +#define FOURCC(a, b, c, d) \ + (((uint32_t)(a)) | ((uint32_t)(b) << 8) | /* NOLINT */ \ + ((uint32_t)(c) << 16) | ((uint32_t)(d) << 24)) /* NOLINT */ +#endif + +// Some pages discussing FourCC codes: +// http://www.fourcc.org/yuv.php +// http://v4l2spec.bytesex.org/spec/book1.htm +// http://developer.apple.com/quicktime/icefloe/dispatch020.html +// http://msdn.microsoft.com/library/windows/desktop/dd206750.aspx#nv12 +// http://people.xiph.org/~xiphmont/containers/nut/nut4cc.txt + +// FourCC codes grouped according to implementation efficiency. +// Primary formats should convert in 1 efficient step. +// Secondary formats are converted in 2 steps. +// Auxilliary formats call primary converters. +enum FourCC { + // 10 Primary YUV formats: 5 planar, 2 biplanar, 2 packed. + FOURCC_I420 = FOURCC('I', '4', '2', '0'), + FOURCC_I422 = FOURCC('I', '4', '2', '2'), + FOURCC_I444 = FOURCC('I', '4', '4', '4'), + FOURCC_I400 = FOURCC('I', '4', '0', '0'), + FOURCC_NV21 = FOURCC('N', 'V', '2', '1'), + FOURCC_NV12 = FOURCC('N', 'V', '1', '2'), + FOURCC_YUY2 = FOURCC('Y', 'U', 'Y', '2'), + FOURCC_UYVY = FOURCC('U', 'Y', 'V', 'Y'), + FOURCC_I010 = FOURCC('I', '0', '1', '0'), // bt.601 10 bit 420 + FOURCC_I210 = FOURCC('I', '2', '1', '0'), // bt.601 10 bit 422 + + // 1 Secondary YUV format: row biplanar. deprecated. + FOURCC_M420 = FOURCC('M', '4', '2', '0'), + + // 13 Primary RGB formats: 4 32 bpp, 2 24 bpp, 3 16 bpp, 1 10 bpc 2 64 bpp + FOURCC_ARGB = FOURCC('A', 'R', 'G', 'B'), + FOURCC_BGRA = FOURCC('B', 'G', 'R', 'A'), + FOURCC_ABGR = FOURCC('A', 'B', 'G', 'R'), + FOURCC_AR30 = FOURCC('A', 'R', '3', '0'), // 10 bit per channel. 2101010. + FOURCC_AB30 = FOURCC('A', 'B', '3', '0'), // ABGR version of 10 bit + FOURCC_AR64 = FOURCC('A', 'R', '6', '4'), // 16 bit per channel. + FOURCC_AB64 = FOURCC('A', 'B', '6', '4'), // ABGR version of 16 bit + FOURCC_24BG = FOURCC('2', '4', 'B', 'G'), + FOURCC_RAW = FOURCC('r', 'a', 'w', ' '), + FOURCC_RGBA = FOURCC('R', 'G', 'B', 'A'), + FOURCC_RGBP = FOURCC('R', 'G', 'B', 'P'), // rgb565 LE. + FOURCC_RGBO = FOURCC('R', 'G', 'B', 'O'), // argb1555 LE. + FOURCC_R444 = FOURCC('R', '4', '4', '4'), // argb4444 LE. + + // 1 Primary Compressed YUV format. + FOURCC_MJPG = FOURCC('M', 'J', 'P', 'G'), + + // 14 Auxiliary YUV variations: 3 with U and V planes are swapped, 1 Alias. + FOURCC_YV12 = FOURCC('Y', 'V', '1', '2'), + FOURCC_YV16 = FOURCC('Y', 'V', '1', '6'), + FOURCC_YV24 = FOURCC('Y', 'V', '2', '4'), + FOURCC_YU12 = FOURCC('Y', 'U', '1', '2'), // Linux version of I420. + FOURCC_J420 = + FOURCC('J', '4', '2', '0'), // jpeg (bt.601 full), unofficial fourcc + FOURCC_J422 = + FOURCC('J', '4', '2', '2'), // jpeg (bt.601 full), unofficial fourcc + FOURCC_J444 = + FOURCC('J', '4', '4', '4'), // jpeg (bt.601 full), unofficial fourcc + FOURCC_J400 = + FOURCC('J', '4', '0', '0'), // jpeg (bt.601 full), unofficial fourcc + FOURCC_F420 = FOURCC('F', '4', '2', '0'), // bt.709 full, unofficial fourcc + FOURCC_F422 = FOURCC('F', '4', '2', '2'), // bt.709 full, unofficial fourcc + FOURCC_F444 = FOURCC('F', '4', '4', '4'), // bt.709 full, unofficial fourcc + FOURCC_H420 = FOURCC('H', '4', '2', '0'), // bt.709, unofficial fourcc + FOURCC_H422 = FOURCC('H', '4', '2', '2'), // bt.709, unofficial fourcc + FOURCC_H444 = FOURCC('H', '4', '4', '4'), // bt.709, unofficial fourcc + FOURCC_U420 = FOURCC('U', '4', '2', '0'), // bt.2020, unofficial fourcc + FOURCC_U422 = FOURCC('U', '4', '2', '2'), // bt.2020, unofficial fourcc + FOURCC_U444 = FOURCC('U', '4', '4', '4'), // bt.2020, unofficial fourcc + FOURCC_F010 = FOURCC('F', '0', '1', '0'), // bt.709 full range 10 bit 420 + FOURCC_H010 = FOURCC('H', '0', '1', '0'), // bt.709 10 bit 420 + FOURCC_U010 = FOURCC('U', '0', '1', '0'), // bt.2020 10 bit 420 + FOURCC_F210 = FOURCC('F', '2', '1', '0'), // bt.709 full range 10 bit 422 + FOURCC_H210 = FOURCC('H', '2', '1', '0'), // bt.709 10 bit 422 + FOURCC_U210 = FOURCC('U', '2', '1', '0'), // bt.2020 10 bit 422 + FOURCC_P010 = FOURCC('P', '0', '1', '0'), + FOURCC_P210 = FOURCC('P', '2', '1', '0'), + + // 14 Auxiliary aliases. CanonicalFourCC() maps these to canonical fourcc. + FOURCC_IYUV = FOURCC('I', 'Y', 'U', 'V'), // Alias for I420. + FOURCC_YU16 = FOURCC('Y', 'U', '1', '6'), // Alias for I422. + FOURCC_YU24 = FOURCC('Y', 'U', '2', '4'), // Alias for I444. + FOURCC_YUYV = FOURCC('Y', 'U', 'Y', 'V'), // Alias for YUY2. + FOURCC_YUVS = FOURCC('y', 'u', 'v', 's'), // Alias for YUY2 on Mac. + FOURCC_HDYC = FOURCC('H', 'D', 'Y', 'C'), // Alias for UYVY. + FOURCC_2VUY = FOURCC('2', 'v', 'u', 'y'), // Alias for UYVY on Mac. + FOURCC_JPEG = FOURCC('J', 'P', 'E', 'G'), // Alias for MJPG. + FOURCC_DMB1 = FOURCC('d', 'm', 'b', '1'), // Alias for MJPG on Mac. + FOURCC_BA81 = FOURCC('B', 'A', '8', '1'), // Alias for BGGR. + FOURCC_RGB3 = FOURCC('R', 'G', 'B', '3'), // Alias for RAW. + FOURCC_BGR3 = FOURCC('B', 'G', 'R', '3'), // Alias for 24BG. + FOURCC_CM32 = FOURCC(0, 0, 0, 32), // Alias for BGRA kCMPixelFormat_32ARGB + FOURCC_CM24 = FOURCC(0, 0, 0, 24), // Alias for RAW kCMPixelFormat_24RGB + FOURCC_L555 = FOURCC('L', '5', '5', '5'), // Alias for RGBO. + FOURCC_L565 = FOURCC('L', '5', '6', '5'), // Alias for RGBP. + FOURCC_5551 = FOURCC('5', '5', '5', '1'), // Alias for RGBO. + + // deprecated formats. Not supported, but defined for backward compatibility. + FOURCC_I411 = FOURCC('I', '4', '1', '1'), + FOURCC_Q420 = FOURCC('Q', '4', '2', '0'), + FOURCC_RGGB = FOURCC('R', 'G', 'G', 'B'), + FOURCC_BGGR = FOURCC('B', 'G', 'G', 'R'), + FOURCC_GRBG = FOURCC('G', 'R', 'B', 'G'), + FOURCC_GBRG = FOURCC('G', 'B', 'R', 'G'), + FOURCC_H264 = FOURCC('H', '2', '6', '4'), + + // Match any fourcc. + FOURCC_ANY = -1, +}; + +enum FourCCBpp { + // Canonical fourcc codes used in our code. + FOURCC_BPP_I420 = 12, + FOURCC_BPP_I422 = 16, + FOURCC_BPP_I444 = 24, + FOURCC_BPP_I411 = 12, + FOURCC_BPP_I400 = 8, + FOURCC_BPP_NV21 = 12, + FOURCC_BPP_NV12 = 12, + FOURCC_BPP_YUY2 = 16, + FOURCC_BPP_UYVY = 16, + FOURCC_BPP_M420 = 12, // deprecated + FOURCC_BPP_Q420 = 12, + FOURCC_BPP_ARGB = 32, + FOURCC_BPP_BGRA = 32, + FOURCC_BPP_ABGR = 32, + FOURCC_BPP_RGBA = 32, + FOURCC_BPP_AR30 = 32, + FOURCC_BPP_AB30 = 32, + FOURCC_BPP_AR64 = 64, + FOURCC_BPP_AB64 = 64, + FOURCC_BPP_24BG = 24, + FOURCC_BPP_RAW = 24, + FOURCC_BPP_RGBP = 16, + FOURCC_BPP_RGBO = 16, + FOURCC_BPP_R444 = 16, + FOURCC_BPP_RGGB = 8, + FOURCC_BPP_BGGR = 8, + FOURCC_BPP_GRBG = 8, + FOURCC_BPP_GBRG = 8, + FOURCC_BPP_YV12 = 12, + FOURCC_BPP_YV16 = 16, + FOURCC_BPP_YV24 = 24, + FOURCC_BPP_YU12 = 12, + FOURCC_BPP_J420 = 12, + FOURCC_BPP_J400 = 8, + FOURCC_BPP_H420 = 12, + FOURCC_BPP_H422 = 16, + FOURCC_BPP_I010 = 15, + FOURCC_BPP_I210 = 20, + FOURCC_BPP_H010 = 15, + FOURCC_BPP_H210 = 20, + FOURCC_BPP_P010 = 15, + FOURCC_BPP_P210 = 20, + FOURCC_BPP_MJPG = 0, // 0 means unknown. + FOURCC_BPP_H264 = 0, + FOURCC_BPP_IYUV = 12, + FOURCC_BPP_YU16 = 16, + FOURCC_BPP_YU24 = 24, + FOURCC_BPP_YUYV = 16, + FOURCC_BPP_YUVS = 16, + FOURCC_BPP_HDYC = 16, + FOURCC_BPP_2VUY = 16, + FOURCC_BPP_JPEG = 1, + FOURCC_BPP_DMB1 = 1, + FOURCC_BPP_BA81 = 8, + FOURCC_BPP_RGB3 = 24, + FOURCC_BPP_BGR3 = 24, + FOURCC_BPP_CM32 = 32, + FOURCC_BPP_CM24 = 24, + + // Match any fourcc. + FOURCC_BPP_ANY = 0, // 0 means unknown. +}; + +// Converts fourcc aliases into canonical ones. +LIBYUV_API uint32_t CanonicalFourCC(uint32_t fourcc); + +#endif // INCLUDE_LIBYUV_VIDEO_COMMON_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/yuv.c b/pkg/encoder/yuv/yuv.c deleted file mode 100644 index c4d918dc..00000000 --- a/pkg/encoder/yuv/yuv.c +++ /dev/null @@ -1,130 +0,0 @@ -#include "yuv.h" - -#define Y601_STUDIO 1 - -// BT.601 STUDIO - -#ifdef Y601_STUDIO -// 66*R+129*G+25*B -static __inline int Y(uint8_t *__restrict rgb) { - int R = *rgb; - int G = *(rgb+1); - int B = *(rgb+2); - return (66*R+129*G+25*B+128)>>8; -} - -// 112*B-38*R-74G -static __inline int U(uint8_t *__restrict rgb) { - int R = *rgb; - int G = *(rgb+1); - int B = *(rgb+2); - return (-38*R-74*G+112*B+128) >> 8; -} - -// 112*R-94*G-18*B -static __inline int V(uint8_t *__restrict rgb) { - int R = 56**(rgb); - int G = 47**(rgb+1); - int B = *(rgb+2); - return (R-G-(B+(B<<3))+64) >> 7; -} - -static const int Y_MIN = 16; - -#else - -// BT.601 FULL - -// 77*R+150*G+29*B -static __inline int Y(uint8_t *rgb) { - int R = 77**(rgb); - int G = 150**(rgb+1); - int B = 29**(rgb+2); - return (R+G+B+128) >> 8; -} - -// 127*B-43*R-84*G -static __inline int U(uint8_t *rgb) { - int R = 43**(rgb); - int G = 84**(rgb+1); - int B = 127**(rgb+2); - return (-R-G+B+128) >> 8; -} - -// 127*R-106*G-21*B -static __inline int V(uint8_t *rgb) { - int R = 127**rgb; - int G = -106**(rgb+1); - int B = -21**(rgb+2); - return (G+B+R+128) >> 8; -} - -static const int Y_MIN = 0; -#endif - -static __inline void _y(uint8_t *__restrict p, uint8_t *__restrict y, int size) { - do { - *y++ = Y(p) + Y_MIN; - p += 4; - } while (--size); -} - -// It will take an average color from the 2x2 pixel group for chroma values. -// X X X X -// O O -// X X X X -static __inline void _4uv(uint8_t * __restrict p, uint8_t * __restrict u, uint8_t * __restrict v, const int w, const int h) { - uint8_t *p2, *p3, *p4; - const int row = w << 2; - const int next = 4; - - int x = w, y = h, sumU = 0, sumV = 0; - while (y > 0) { - while (x > 0) { - // xx.. - // .... - p2 = p+next; - sumU = U(p) + U(p2); - sumV = V(p) + V(p2); - // .... - // xx.. - p3 = p+row; - p4 = p3+next; - sumU += U(p3) + U(p4); - sumV += V(p3) + V(p4); - *u++ = 128 + (sumU >> 2); - *v++ = 128 + (sumV >> 2); - // ..x. - p += 8; - x -= 2; - } - p += row; - y -= 2; - x = w; - } -} - -// Converts RGBA image to YUV (I420) with BT.601 studio color range. -void rgbaToYuv(void *__restrict destination, void *__restrict source, const int w, const int h) { - const int image_size = w * h; - uint8_t *src = source; - uint8_t *dst_y = destination; - uint8_t *dst_u = destination + image_size; - uint8_t *dst_v = destination + image_size + image_size / 4; - _y(src, dst_y, image_size); - src = source; - _4uv(source, dst_u, dst_v, w, h); -} - -void luma(void *__restrict destination, void *__restrict source, const int pos, const int w, const int h) { - uint8_t *rgba = source + 4 * pos; - uint8_t *dst = destination + pos; - _y(rgba, dst, w*h); -} - -void chroma(void *__restrict dst, void *__restrict source, const int pos, const int deu, const int dev, const int w, const int h) { - uint8_t *src = source + 4 * pos; - uint8_t *dst_u = dst + deu + pos / 4; - uint8_t *dst_v = dst + dev + pos / 4; - _4uv(src, dst_u, dst_v, w, h); -} diff --git a/pkg/encoder/yuv/yuv.go b/pkg/encoder/yuv/yuv.go index 19a33318..82f59ea7 100644 --- a/pkg/encoder/yuv/yuv.go +++ b/pkg/encoder/yuv/yuv.go @@ -3,123 +3,80 @@ package yuv import ( "image" "sync" - "unsafe" + + "github.com/giongto35/cloud-game/v3/pkg/encoder/yuv/libyuv" ) -/* -#cgo CFLAGS: -Wall -#include "yuv.h" -*/ -import "C" - -type ImgProcessor interface { - Process(rgba *image.RGBA) []byte - Put(*[]byte) +type Conv struct { + w, h int + sw, sh int + scale float64 + pool sync.Pool } -type Options struct { - Threads int +type RawFrame struct { + Data []byte + Stride int + W, H int } -type processor struct { - w, h int +type PixFmt uint32 - // cache - ww C.int - pool sync.Pool +const FourccRgbp = libyuv.FourccRgbp +const FourccArgb = libyuv.FourccArgb +const FourccAbgr = libyuv.FourccAbgr + +func NewYuvConv(w, h int, scale float64) Conv { + if scale < 1 { + scale = 1 + } + sw, sh := round(w, scale), round(h, scale) + bufSize := int(float64(sw) * float64(sh) * 1.5) + return Conv{ + w: w, h: h, sw: sw, sh: sh, scale: scale, + pool: sync.Pool{New: func() any { b := make([]byte, bufSize); return &b }}, + } } -type threadedProcessor struct { - *processor - - // threading - threads int - chunk int - - // cache - chromaU C.int - chromaV C.int - wg sync.WaitGroup -} - -// NewYuvImgProcessor creates new YUV image converter from RGBA. -func NewYuvImgProcessor(w, h int, opts *Options) ImgProcessor { - bufSize := int(float32(w*h) * 1.5) - - processor := processor{ - w: w, - h: h, - ww: C.int(w), - pool: sync.Pool{New: func() any { - b := make([]byte, bufSize) - return &b - }}, +// Process converts an image to YUV I420 format inside the internal buffer. +func (c *Conv) Process(frame RawFrame, rot uint, pf PixFmt) []byte { + dx, dy := c.w, c.h // dest + cx, cy := c.w, c.h // crop + if rot == 90 || rot == 270 { + cx, cy = cy, cx } - if opts != nil && opts.Threads > 0 { - // chunks the image evenly - chunk := h / opts.Threads - if chunk%2 != 0 { - chunk-- - } - - return &threadedProcessor{ - chromaU: C.int(w * h), - chromaV: C.int(w*h + w*h/4), - chunk: chunk, - processor: &processor, - threads: opts.Threads, - wg: sync.WaitGroup{}, - } + stride := frame.Stride >> 2 + if pf == PixFmt(libyuv.FourccRgbp) { + stride = frame.Stride >> 1 } - return &processor -} -// Process converts RGBA colorspace into YUV I420 format inside the internal buffer. -// Non-threaded version. -func (yuv *processor) Process(rgba *image.RGBA) []byte { - buf := *yuv.pool.Get().(*[]byte) - C.rgbaToYuv(unsafe.Pointer(&buf[0]), unsafe.Pointer(&rgba.Pix[0]), yuv.ww, C.int(yuv.h)) + buf := *c.pool.Get().(*[]byte) + libyuv.Y420(frame.Data, buf, frame.W, frame.H, stride, dx, dy, rot, uint32(pf), cx, cy) + + if c.scale > 1 { + dstBuf := *c.pool.Get().(*[]byte) + libyuv.Y420Scale(buf, dstBuf, dx, dy, c.sw, c.sh) + c.pool.Put(&buf) + return dstBuf + } return buf } -func (yuv *processor) Put(x *[]byte) { yuv.pool.Put(x) } +func (c *Conv) Put(x *[]byte) { c.pool.Put(x) } +func (c *Conv) Version() string { return libyuv.Version() } +func round(x int, scale float64) int { return (int(float64(x)*scale) + 1) & ^1 } -// Process converts RGBA colorspace into YUV I420 format inside the internal buffer. -// Threaded version. -// -// We divide the input image into chunks by the number of available CPUs. -// Each chunk should contain 2, 4, 6, etc. rows of the image. -// -// 8x4 CPU (2) -// x x x x x x x x | Coroutine 1 -// x x x x x x x x | Coroutine 1 -// x x x x x x x x | Coroutine 2 -// x x x x x x x x | Coroutine 2 -func (yuv *threadedProcessor) Process(rgba *image.RGBA) []byte { - src := unsafe.Pointer(&rgba.Pix[0]) - buf := *yuv.pool.Get().(*[]byte) - dst := unsafe.Pointer(&buf[0]) - yuv.wg.Add(yuv.threads << 1) - chunk := yuv.w * yuv.chunk - for i := 0; i < yuv.threads; i++ { - pos, hh := C.int(i*chunk), C.int(yuv.chunk) - if i == yuv.threads-1 { - hh = C.int(yuv.h - i*yuv.chunk) - } - go yuv.chroma_(src, dst, pos, hh) - go yuv.luma_(src, dst, pos, hh) - } - yuv.wg.Wait() - return buf -} +func ToYCbCr(bytes []byte, w, h int) *image.YCbCr { + cw, ch := (w+1)/2, (h+1)/2 -func (yuv *threadedProcessor) luma_(src unsafe.Pointer, dst unsafe.Pointer, pos C.int, hh C.int) { - C.luma(dst, src, pos, yuv.ww, hh) - yuv.wg.Done() -} + i0 := w*h + 0*cw*ch + i1 := w*h + 1*cw*ch + i2 := w*h + 2*cw*ch -func (yuv *threadedProcessor) chroma_(src unsafe.Pointer, dst unsafe.Pointer, pos C.int, hh C.int) { - C.chroma(dst, src, pos, yuv.chromaU, yuv.chromaV, yuv.ww, hh) - yuv.wg.Done() + yuv := image.NewYCbCr(image.Rect(0, 0, w, h), image.YCbCrSubsampleRatio420) + yuv.Y = bytes[:i0:i0] + yuv.Cb = bytes[i0:i1:i1] + yuv.Cr = bytes[i1:i2:i2] + return yuv } diff --git a/pkg/encoder/yuv/yuv.h b/pkg/encoder/yuv/yuv.h deleted file mode 100644 index 6b39ec52..00000000 --- a/pkg/encoder/yuv/yuv.h +++ /dev/null @@ -1,18 +0,0 @@ -#ifndef YUV_H__ -#define YUV_H__ - -#include - -// Converts RGBA image to YUV (I420) with BT.601 studio color range. -void rgbaToYuv(void *destination, void *source, int width, int height); - -// Converts RGBA image chunk to YUV (I420) chroma with BT.601 studio color range. -// pos contains a shift value for chunks. -// deu, dev contains constant shifts for U, V planes in the resulting array. -// chroma (0, 1) selects chroma estimation algorithm. -void chroma(void *destination, void *source, int pos, int deu, int dev, int width, int height); - -// Converts RGBA image chunk to YUV (I420) luma with BT.601 studio color range. -void luma(void *destination, void *source, int pos, int width, int height); - -#endif diff --git a/pkg/encoder/yuv/yuv_test.go b/pkg/encoder/yuv/yuv_test.go index fbf53efe..6b67c29f 100644 --- a/pkg/encoder/yuv/yuv_test.go +++ b/pkg/encoder/yuv/yuv_test.go @@ -1,213 +1,188 @@ package yuv import ( + "archive/zip" "fmt" "image" "image/color" "image/png" + "io" "math" "math/rand" "os" - "reflect" - "runtime" + "path/filepath" "testing" - "time" + + "github.com/giongto35/cloud-game/v3/pkg/encoder/yuv/libyuv" + _ "github.com/giongto35/cloud-game/v3/test" ) -func TestYuv(t *testing.T) { - size1, size2 := 32, 32 - for i := 1; i < 100; i++ { - img := generateImage(size1, size2, randomColor()) - pc := NewYuvImgProcessor(size1, size2, new(Options)) - pct := NewYuvImgProcessor(size1, size2, &Options{Threads: runtime.NumCPU()}) - - a := pc.Process(img) - b := pct.Process(img) - - if !reflect.DeepEqual(a, b) { - t.Fatalf("couldn't convert %v, \n %v \n %v", img.Pix, a, b) - } - } -} - func TestYuvPredefined(t *testing.T) { im := []uint8{101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255} should := []byte{ - 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 52, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, - 142, 142, 142, 142, 126, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 126, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 126, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 126, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 126, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 126, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 126, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 126, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, - 94, 94, 94, 94, 94, 94, 94, 94, 94, 106, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 106, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 106, - 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 106, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 106, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 106, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 106, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 106, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, - 47, 47, 47, 47, 47, 47, 47, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 52, 142, 142, 142, 142, 142, 142, 142, + 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, + 110, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, + 110, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, + 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 110, 94, 94, 94, + 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, + 94, 94, 94, 94, 110, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, + 94, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, + 110, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, + 110, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, + 110, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, + 110, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, + 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, 110, 94, 94, 94, + 94, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 94, 110, 94, 94, 94, + 94, 94, 94, 94, 110, 94, 94, 94, 110, 94, 94, 94, 94, 94, 94, 94, 76, 47, 47, 47, + 47, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 76, + 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 76, 47, + 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, + 47, 47, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, + 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 76, + 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, + 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, + 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, + 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, + 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, + 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, 47, 47, 47, + 47, 76, 47, 47, 47, 47, 47, 47, 47, 76, 47, 47, 47, 76, 47, 47, 47, 47, 47, 47, 47, } - pc := NewYuvImgProcessor(32, 32, new(Options)) - pct := NewYuvImgProcessor(32, 32, &Options{Threads: runtime.NumCPU()}) + pc := NewYuvConv(32, 32, 1) + frame := RawFrame{Data: im, Stride: 32, W: 32, H: 32} + a := pc.Process(frame, 0, PixFmt(libyuv.FourccAbgr)) - img := image.NewRGBA(image.Rect(0, 0, 32, 32)) - img.Pix = im - - a := pc.Process(img) - b := pct.Process(img) - - if len(a) != len(b) || len(a) != len(should) || len(b) != len(should) { - t.Fatalf("diffrent size a: %v, b: %v, o: %v", len(a), len(b), len(should)) + if len(a) != len(should) { + t.Fatalf("diffrent size a: %v, o: %v", len(a), len(should)) } for i := 0; i < len(a); i++ { - if a[i] != b[i] || a[i] != should[i] || b[i] != should[i] { - t.Fatalf("diff in %vth, %v != %v != %v \n%v\n%v", i, a[i], b[i], should[i], im, should) + if a[i] != should[i] { + t.Fatalf("diff in %vth, %v != %v \n%v\n%v", i, a[i], should[i], im, should) } } } -func generateImage(w, h int, color color.RGBA) *image.RGBA { - img := image.NewRGBA(image.Rect(0, 0, w, h)) - for x := 0; x < w; x++ { - for y := 0; y < h; y++ { - img.Set(x, y, color) - } +func TestYuvScale(t *testing.T) { + name := "001_alsa_ABGR_256_240_1024.raw" + path := filepath.Join("./test/testdata/raw/", name) + + data, err := ReadZip(path + ".zip") + if err != nil { + t.Error(err) } - return img + + pf, w, h, stride := PixFmt(libyuv.FourccArgb), 256, 240, 1024 + scale := 2 + + conv := NewYuvConv(w, h, float64(scale)) + frame := RawFrame{Data: data, Stride: stride, W: w, H: h} + out := conv.Process(frame, 0, pf) + + d := float64(len(out)) / float64(len(data)) + if d != 1.5 { + t.Errorf("Scaled not by factor %v, %v", scale, d) + } + + // save as RGBA + //sw, sh := w*scale, h*scale + //yuv := ToYCbCr(out, sw, sh) + //if f, err := os.Create(filepath.Join("./", name+".png")); err == nil { + // if err = png.Encode(f, yuv); err != nil { + // t.Logf("Couldn't encode the image, %v", err) + // } + // _ = f.Close() + //} } -func randomColor() color.RGBA { - rnd := rand.New(rand.NewSource(time.Now().Unix())) - return color.RGBA{ - R: uint8(rnd.Intn(255)), - G: uint8(rnd.Intn(255)), - B: uint8(rnd.Intn(255)), - A: 255, - } -} - -func BenchmarkYUV(b *testing.B) { - cpu := runtime.NumCPU() +func BenchmarkYuv(b *testing.B) { tests := []struct { - cpu int - w int - h int + w int + h int }{ - {cpu: cpu * 0, w: 1920, h: 1080}, - {cpu: cpu * 2, w: 1920, h: 1080}, - {cpu: cpu * 4, w: 1920, h: 1080}, - {cpu: cpu * 0, w: 320, h: 240}, - {cpu: cpu * 2, w: 320, h: 240}, - {cpu: cpu * 4, w: 320, h: 240}, + {w: 1920, h: 1080}, + {w: 320, h: 240}, } - for _, bn := range tests { - b.Run(fmt.Sprintf("%d-%vx%v", bn.cpu, bn.w, bn.h), func(b *testing.B) { - _processYUV(bn.w, bn.h, bn.cpu, b) + r1 := rand.New(rand.NewSource(int64(1))).Float32() + + for _, test := range tests { + w, h := test.w, test.h + frame := genFrame(w, h, r1) + b.Run(fmt.Sprintf("%vx%v YUV", w, h), func(b *testing.B) { + pc := NewYuvConv(w, h, 1) + for i := 0; i < b.N; i++ { + pc.Process(frame, 0, PixFmt(libyuv.FourccAbgr)) + b.SetBytes(int64(len(frame.Data))) + } + b.ReportAllocs() }) } } -func BenchmarkYUVReference(b *testing.B) { _processYUV(1920, 1080, 0, b) } - -func _processYUV(w, h, cpu int, b *testing.B) { - b.StopTimer() - - r1 := rand.New(rand.NewSource(int64(1))).Float32() - r2 := rand.New(rand.NewSource(int64(2))).Float32() - - pc := NewYuvImgProcessor(w, h, &Options{Threads: cpu}) - - image1 := genTestImage(w, h, r1) - image2 := genTestImage(w, h, r2) - - for i := 0; i < b.N; i++ { - im := image1 - if i%2 == 0 { - im = image2 - } - b.StartTimer() - pc.Process(im) - b.StopTimer() - b.SetBytes(int64(len(im.Pix))) - } - b.ReportAllocs() -} - -func genTestImage(w, h int, seed float32) *image.RGBA { +func genFrame(w, h int, seed float32) RawFrame { img := image.NewRGBA(image.Rectangle{Max: image.Point{X: w, Y: h}}) for x := 0; x < w; x++ { for y := 0; y < h; y++ { @@ -215,7 +190,12 @@ func genTestImage(w, h int, seed float32) *image.RGBA { img.Set(x, y, col) } } - return img + return RawFrame{ + Data: img.Pix, + Stride: img.Stride, + W: img.Bounds().Dx(), + H: img.Bounds().Dy(), + } } func TestGen24bitFull(t *testing.T) { @@ -282,3 +262,19 @@ func hsb2rgb(hue, s, bri float64) (r, g, b int) { } return } + +func ReadZip(path string) ([]byte, error) { + zf, err := zip.OpenReader(path) + if err != nil { + return nil, err + } + defer func() { _ = zf.Close() }() + + f, err := zf.File[0].Open() + if err != nil { + return nil, err + } + defer func() { _ = f.Close() }() + + return io.ReadAll(f) +} diff --git a/pkg/worker/caged/app/app.go b/pkg/worker/caged/app/app.go index 82fff885..a1917b4d 100644 --- a/pkg/worker/caged/app/app.go +++ b/pkg/worker/caged/app/app.go @@ -1,7 +1,5 @@ package app -import "image" - type App interface { AudioSampleRate() int Init() error @@ -20,6 +18,12 @@ type Audio struct { } type Video struct { - Frame image.RGBA + Frame RawFrame Duration int32 } + +type RawFrame struct { + Data []byte + Stride int + W, H int +} diff --git a/pkg/worker/caged/libretro/caged.go b/pkg/worker/caged/libretro/caged.go index 57ea82d8..de0ba038 100644 --- a/pkg/worker/caged/libretro/caged.go +++ b/pkg/worker/caged/libretro/caged.go @@ -50,8 +50,7 @@ func (c *Caged) Load(game games.GameMetadata, path string) error { return err } w, h := c.ViewportCalc() - c.SetViewport(w, h, c.conf.Emulator.Scale) - + c.SetViewport(w, h) return nil } @@ -75,8 +74,11 @@ func (c *Caged) EnableCloudStorage(uid string, storage cloud.Storage) { } } +func (c *Caged) PixFormat() uint32 { return c.Emulator.PixFormat() } +func (c *Caged) Rotation() uint { return c.Emulator.Rotation() } func (c *Caged) AudioSampleRate() int { return c.Emulator.AudioSampleRate() } func (c *Caged) ViewportSize() (int, int) { return c.Emulator.ViewportSize() } +func (c *Caged) Scale() float64 { return c.Emulator.Scale() } func (c *Caged) SendControl(port int, data []byte) { c.base.Input(port, data) } func (c *Caged) Start() { go c.Emulator.Start() } func (c *Caged) SetSaveOnClose(v bool) { c.base.SaveOnClose = v } diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index bf7651b4..63d32320 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -14,7 +14,6 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/image" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/nanoarch" ) @@ -25,12 +24,14 @@ type Emulator interface { LoadGame(path string) error FPS() int Flipped() bool + Rotation() uint + PixFormat() uint32 AudioSampleRate() int IsPortrait() bool // Start is called after LoadGame Start() // SetViewport sets viewport size - SetViewport(width int, height int, scale int) + SetViewport(width int, height int) // ViewportCalc calculates the viewport size with the aspect ratio and scale ViewportCalc() (nw int, nh int) ViewportSize() (w, h int) @@ -48,10 +49,11 @@ type Emulator interface { ToggleMultitap() // Input passes input to the emulator Input(player int, data []byte) + // Scale returns set video scale factor + Scale() float64 } type Frontend struct { - canvas *image.Canvas conf config.Emulator done chan struct{} input InputState @@ -60,6 +62,7 @@ type Frontend struct { onAudio func(app.Audio) onVideo func(app.Video) storage Storage + scale float64 th int // draw threads vw, vh int // out frame size @@ -151,6 +154,12 @@ func (f *Frontend) LoadCore(emu string) { UsesLibCo: conf.UsesLibCo, } f.mu.Lock() + scale := 1.0 + if conf.Scale > 1 { + scale = conf.Scale + f.log.Debug().Msgf("Scale: x%v", scale) + } + f.scale = scale f.nano.CoreLoad(meta) f.mu.Unlock() } @@ -169,30 +178,27 @@ func (f *Frontend) handleAudio(audio unsafe.Pointer, samples int) { } func (f *Frontend) handleVideo(data []byte, delta int32, fi nanoarch.FrameInfo) { - pixFmt := f.nano.Video.PixFmt - bpp := int(f.nano.Video.BPP) - drawn := f.canvas.Draw(pixFmt, f.nano.Rot, int(fi.W), int(fi.H), int(fi.Packed), bpp, data, f.th) - + // !to merge both pools fr, _ := videoPool.Get().(*app.Video) if fr == nil { fr = new(app.Video) } - fr.Frame = drawn.Unwrap() + fr.Frame.Data = data + fr.Frame.W = int(fi.W) + fr.Frame.H = int(fi.H) + fr.Frame.Stride = int(fi.Stride) fr.Duration = delta f.onVideo(*fr) - f.canvas.Put(drawn) videoPool.Put(fr) } func (f *Frontend) Shutdown() { - f.log.Debug().Msgf("run loop cleanup") f.mu.Lock() f.nano.Shutdown() - f.canvas.Clear() f.SetAudioCb(noAudio) f.SetVideoCb(noVideo) f.mu.Unlock() - f.log.Debug().Msgf("run loop finished") + f.log.Debug().Msgf("frontend closed") } func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { @@ -240,6 +246,8 @@ func (f *Frontend) Start() { } } +func (f *Frontend) PixFormat() uint32 { return f.nano.Video.PixFmt.C } +func (f *Frontend) Rotation() uint { return f.nano.Rot } func (f *Frontend) Flipped() bool { return f.nano.IsGL() } func (f *Frontend) FrameSize() (int, int) { return f.nano.GeometryBase() } func (f *Frontend) FPS() int { return f.nano.VideoFramerate() } @@ -250,21 +258,15 @@ func (f *Frontend) AudioSampleRate() int { return f.nano.AudioSampleRat func (f *Frontend) Input(player int, data []byte) { f.input.setInput(player, data) } func (f *Frontend) LoadGame(path string) error { return f.nano.LoadGame(path) } func (f *Frontend) RestoreGameState() error { return f.Load() } +func (f *Frontend) Scale() float64 { return f.scale } func (f *Frontend) IsPortrait() bool { return f.nano.IsPortrait() } func (f *Frontend) SaveGameState() error { return f.Save() } -func (f *Frontend) Scale(factor int) { w, h := f.ViewportSize(); f.SetViewport(w, h, factor) } func (f *Frontend) SetAudioCb(cb func(app.Audio)) { f.onAudio = cb } func (f *Frontend) SetSessionId(name string) { f.storage.SetMainSaveName(name) } func (f *Frontend) SetVideoCb(ff func(app.Video)) { f.onVideo = ff } -func (f *Frontend) SetViewport(width int, height int, scale int) { +func (f *Frontend) SetViewport(width int, height int) { f.mu.Lock() f.vw, f.vh = width, height - mw, mh := f.nano.GeometryMax() - size := mw * scale * mh * scale - f.canvas = image.NewCanvas(width, height, size) - if f.DisableCanvasPool { - f.canvas.SetEnabled(false) - } f.mu.Unlock() } @@ -292,14 +294,9 @@ func (f *Frontend) ViewportCalc() (nw int, nh int) { nw, nh = w, h } - if f.conf.Scale > 1 { - nw, nh = nw*f.conf.Scale, nh*f.conf.Scale - f.log.Debug().Msgf("Viewport size scaled: %dx%d", nw, nh) - } - if f.IsPortrait() { nw, nh = nh, nw - f.log.Debug().Msgf("Viewport was flipped") + f.log.Debug().Msgf("Set portrait mode") } f.log.Info().Msgf("Viewport final size: %dx%d", nw, nh) diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index afedbd53..60a08dee 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -7,18 +7,27 @@ import ( "log" "math/rand" "os" - "path" "path/filepath" "sync" "testing" - "unsafe" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/manager" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/nanoarch" + "github.com/giongto35/cloud-game/v3/pkg/worker/thread" + + _ "github.com/giongto35/cloud-game/v3/test" ) +type TestFrontend struct { + *Frontend + + corePath string + gamePath string +} + type testRun struct { room string system string @@ -26,46 +35,48 @@ type testRun struct { emulationTicks int } -// EmulatorMock contains Frontend mocking data. -type EmulatorMock struct { - *Frontend - - // Libretro compiled lib core name - core string - // shared core paths (can't be changed) - paths EmulatorPaths +type game struct { + rom string + system string } -// EmulatorPaths defines various emulator file paths. -type EmulatorPaths struct { - assets string - cores string - games string - save string +var ( + alwa = game{system: "nes", rom: "Alwa's Awakening (Demo).nes"} + sushi = game{system: "gba", rom: "Sushi The Cat.gba"} + angua = game{system: "gba", rom: "anguna.gba"} +) + +// TestMain runs all tests in the main thread in macOS. +func TestMain(m *testing.M) { + thread.Wrap(func() { os.Exit(m.Run()) }) } -// GetEmulatorMock returns a properly stubbed emulator instance. +// EmulatorMock returns a properly stubbed emulator instance. // Due to extensive use of globals -- one mock instance is allowed per a test run. // Don't forget to init one image channel consumer, it will lock-out otherwise. // Make sure you call Shutdown(). -func GetEmulatorMock(room string, system string) *EmulatorMock { - rootPath := getRootPath() - +func EmulatorMock(room string, system string) *TestFrontend { var conf config.WorkerConfig if _, err := config.LoadConfig(&conf, ""); err != nil { panic(err) } - meta := conf.Emulator.GetLibretroCoreConfig(system) - - nano := nanoarch.NewNano(cleanPath(conf.Emulator.LocalPath)) + conf.Emulator.Libretro.Cores.Repo.ExtLock = expand("tests", ".cr", "cloud-game.lock") + conf.Emulator.LocalPath = expand("tests", conf.Emulator.LocalPath) + conf.Emulator.Storage = expand("tests", "storage") l := logger.Default() l2 := l.Extend(l.Level(logger.ErrorLevel).With()) + + if err := manager.CheckCores(conf.Emulator, l); err != nil { + panic(err) + } + + nano := nanoarch.NewNano(conf.Emulator.LocalPath) nano.SetLogger(l2) // an emu - emu := &EmulatorMock{ + emu := &TestFrontend{ Frontend: &Frontend{ conf: conf.Emulator, storage: &StateStorage{ @@ -78,27 +89,19 @@ func GetEmulatorMock(room string, system string) *EmulatorMock { log: l2, SaveOnClose: false, }, - - core: path.Base(meta.Lib), - - paths: EmulatorPaths{ - assets: cleanPath(rootPath), - cores: cleanPath(rootPath + "assets/cores/"), - games: cleanPath(rootPath + "assets/games/"), - }, + corePath: expand(conf.Emulator.GetLibretroCoreConfig(system).Lib), + gamePath: expand(conf.Worker.Library.BasePath), } emu.linkNano(nano) - emu.paths.save = cleanPath(emu.HashPath()) - return emu } -// GetDefaultFrontend returns initialized emulator mock with default params. +// DefaultFrontend returns initialized emulator mock with default params. // Spawns audio/image channels consumers. // Don't forget to close emulator mock with Shutdown(). -func GetDefaultFrontend(room string, system string, rom string) *EmulatorMock { - mock := GetEmulatorMock(room, system) +func DefaultFrontend(room string, system string, rom string) *TestFrontend { + mock := EmulatorMock(room, system) mock.loadRom(rom) mock.SetVideoCb(func(app.Video) {}) mock.SetAudioCb(func(app.Audio) {}) @@ -107,25 +110,30 @@ func GetDefaultFrontend(room string, system string, rom string) *EmulatorMock { // loadRom loads a ROM into the emulator. // The rom will be loaded from emulators' games path. -func (emu *EmulatorMock) loadRom(game string) { - fmt.Printf("%v %v\n", emu.paths.cores, emu.core) - emu.nano.CoreLoad(nanoarch.Metadata{LibPath: emu.paths.cores + emu.core}) - err := emu.nano.LoadGame(emu.paths.games + game) +func (emu *TestFrontend) loadRom(game string) { + emu.nano.CoreLoad(nanoarch.Metadata{LibPath: emu.corePath}) + + gamePath := expand(emu.gamePath, game) + + conf := emu.conf.GetLibretroCoreConfig(gamePath) + scale := 1.0 + if conf.Scale > 1 { + scale = conf.Scale + } + emu.scale = scale + + err := emu.nano.LoadGame(gamePath) if err != nil { log.Fatal(err) } w, h := emu.FrameSize() - if emu.conf.Scale == 0 { - emu.conf.Scale = 1 - } - emu.SetViewport(w, h, emu.conf.Scale) + emu.SetViewport(w, h) } // Shutdown closes the emulator and cleans its resources. -func (emu *EmulatorMock) Shutdown() { +func (emu *TestFrontend) Shutdown() { _ = os.Remove(emu.HashPath()) _ = os.Remove(emu.SRAMPath()) - emu.Frontend.Close() emu.Frontend.Shutdown() } @@ -133,97 +141,56 @@ func (emu *EmulatorMock) Shutdown() { // dumpState returns the current emulator state and // the latest saved state for its session. // Locks the emulator. -func (emu *EmulatorMock) dumpState() (string, string) { +func (emu *TestFrontend) dumpState() (string, string) { emu.mu.Lock() - bytes, _ := os.ReadFile(emu.paths.save) - persistedStateHash := getHash(bytes) + bytes, _ := os.ReadFile(emu.HashPath()) + lastStateHash := hash(bytes) emu.mu.Unlock() - stateHash := emu.getStateHash() - fmt.Printf("mem: %v, dat: %v\n", stateHash, persistedStateHash) - return stateHash, persistedStateHash -} - -// getStateHash returns the current emulator state hash. -// Locks the emulator. -func (emu *EmulatorMock) getStateHash() string { emu.mu.Lock() state, _ := nanoarch.SaveState() emu.mu.Unlock() + stateHash := hash(state) - return getHash(state) + fmt.Printf("mem: %v, dat: %v\n", stateHash, lastStateHash) + return stateHash, lastStateHash } -// getRootPath returns absolute path to the root directory. -func getRootPath() string { - p, _ := filepath.Abs("../../../../") - return p + string(filepath.Separator) -} - -// getHash returns MD5 hash. -func getHash(bytes []byte) string { return fmt.Sprintf("%x", md5.Sum(bytes)) } - -// cleanPath returns a proper file path for current OS. -func cleanPath(path string) string { return filepath.FromSlash(path) } - -// benchmarkEmulator is a generic function for -// measuring emulator performance for one emulation frame. -func benchmarkEmulator(system string, rom string, b *testing.B) { - b.StopTimer() +func BenchmarkEmulators(b *testing.B) { log.SetOutput(io.Discard) os.Stdout, _ = os.Open(os.DevNull) - s := GetDefaultFrontend("bench_"+system+"_performance", system, rom) - - b.StartTimer() - for i := 0; i < b.N; i++ { - s.nano.Run() + benchmarks := []struct { + name string + system string + rom string + }{ + {name: "GBA Sushi", system: sushi.system, rom: sushi.rom}, + {name: "NES Alwa", system: alwa.system, rom: alwa.rom}, } - s.Shutdown() -} -func BenchmarkEmulatorGba(b *testing.B) { - benchmarkEmulator("gba", "Sushi The Cat.gba", b) -} - -func BenchmarkEmulatorNes(b *testing.B) { - benchmarkEmulator("nes", "Alwa's Awakening (Demo).nes", b) -} - -func TestSwap(t *testing.T) { - data := []byte{1, 254, 255, 32} - pixel := *(*uint32)(unsafe.Pointer(&data[0])) - // 0 1 2 3 - // 2 1 0 3 - ll := ((pixel >> 16) & 0xff) | (pixel & 0xff00) | ((pixel << 16) & 0xff0000) | 0xff000000 - - rez := []byte{0, 0, 0, 0} - *(*uint32)(unsafe.Pointer(&rez[0])) = ll - - log.Printf("%v\n%v", data, rez) + for _, bench := range benchmarks { + b.Run(bench.name, func(b *testing.B) { + s := DefaultFrontend("bench_"+bench.system+"_performance", bench.system, bench.rom) + for i := 0; i < b.N; i++ { + s.nano.Run() + } + s.Shutdown() + }) + } } // Tests a successful emulator state save. func TestSave(t *testing.T) { tests := []testRun{ - { - room: "test_save_ok_00", - system: "gba", - rom: "Sushi The Cat.gba", - emulationTicks: 100, - }, - { - room: "test_save_ok_01", - system: "gba", - rom: "anguna.gba", - emulationTicks: 10, - }, + {room: "test_save_ok_00", system: sushi.system, rom: sushi.rom, emulationTicks: 100}, + {room: "test_save_ok_01", system: angua.system, rom: angua.rom, emulationTicks: 10}, } for _, test := range tests { t.Logf("Testing [%v] save with [%v]\n", test.system, test.rom) - front := GetDefaultFrontend(test.room, test.system, test.rom) + front := DefaultFrontend(test.room, test.system, test.rom) for test.emulationTicks > 0 { front.Tick() @@ -255,30 +222,15 @@ func TestSave(t *testing.T) { // Compare states (a) and (b), should be =. func TestLoad(t *testing.T) { tests := []testRun{ - { - room: "test_load_00", - system: "nes", - rom: "Alwa's Awakening (Demo).nes", - emulationTicks: 100, - }, - { - room: "test_load_01", - system: "gba", - rom: "Sushi The Cat.gba", - emulationTicks: 1000, - }, - { - room: "test_load_02", - system: "gba", - rom: "anguna.gba", - emulationTicks: 100, - }, + {room: "test_load_00", system: alwa.system, rom: alwa.rom, emulationTicks: 100}, + {room: "test_load_01", system: sushi.system, rom: sushi.rom, emulationTicks: 1000}, + {room: "test_load_02", system: angua.system, rom: angua.rom, emulationTicks: 100}, } for _, test := range tests { t.Logf("Testing [%v] load with [%v]\n", test.system, test.rom) - mock := GetDefaultFrontend(test.room, test.system, test.rom) + mock := DefaultFrontend(test.room, test.system, test.rom) fmt.Printf("[%-14v] ", "initial") mock.dumpState() @@ -317,26 +269,15 @@ func TestLoad(t *testing.T) { func TestStateConcurrency(t *testing.T) { tests := []struct { - run testRun - // determine random + run testRun seed int }{ { - run: testRun{ - room: "test_concurrency_00", - system: "gba", - rom: "Sushi The Cat.gba", - emulationTicks: 120, - }, + run: testRun{room: "test_concurrency_00", system: sushi.system, rom: sushi.rom, emulationTicks: 120}, seed: 42, }, { - run: testRun{ - room: "test_concurrency_01", - system: "gba", - rom: "anguna.gba", - emulationTicks: 300, - }, + run: testRun{room: "test_concurrency_01", system: angua.system, rom: angua.rom, emulationTicks: 300}, seed: 42 + 42, }, } @@ -344,7 +285,7 @@ func TestStateConcurrency(t *testing.T) { for _, test := range tests { t.Logf("Testing [%v] concurrency with [%v]\n", test.run.system, test.run.rom) - mock := GetEmulatorMock(test.run.room, test.run.system) + mock := EmulatorMock(test.run.room, test.run.system) ops := &sync.WaitGroup{} // quantum lock @@ -352,14 +293,14 @@ func TestStateConcurrency(t *testing.T) { mock.loadRom(test.run.rom) mock.SetVideoCb(func(v app.Video) { - if len(v.Frame.Pix) == 0 { + if len(v.Frame.Data) == 0 { t.Errorf("It seems that rom video frame was empty, which is strange!") } }) mock.SetAudioCb(func(app.Audio) {}) t.Logf("Random seed is [%v]\n", test.seed) - t.Logf("Save path is [%v]\n", mock.paths.save) + t.Logf("Save path is [%v]\n", mock.HashPath()) _ = mock.Save() @@ -404,36 +345,28 @@ func TestStateConcurrency(t *testing.T) { } } -// lucky returns random boolean. -func lucky() bool { return rand.Intn(2) == 1 } - func TestConcurrentInput(t *testing.T) { - players := NewGameSessionInput() - - events := 1000 var wg sync.WaitGroup + state := NewGameSessionInput() + events := 1000 + wg.Add(2 * events) - wg.Add(events * 2) - - go func() { - for i := 0; i < events; i++ { - player := rand.Intn(maxPort) - go func() { - players.setInput(player, []byte{0, 1}) - wg.Done() - }() - } - }() - - go func() { - for i := 0; i < events; i++ { - player := rand.Intn(maxPort) - go func() { - players.isKeyPressed(uint(player), 100) - wg.Done() - }() - } - }() - + for i := 0; i < events; i++ { + player := rand.Intn(maxPort) + go func() { state.setInput(player, []byte{0, 1}); wg.Done() }() + go func() { state.isKeyPressed(uint(player), 100); wg.Done() }() + } wg.Wait() } + +// expand joins a list of file path elements. +func expand(p ...string) string { + ph, _ := filepath.Abs(filepath.FromSlash(filepath.Join(p...))) + return ph +} + +// hash returns MD5 hash. +func hash(bytes []byte) string { return fmt.Sprintf("%x", md5.Sum(bytes)) } + +// lucky returns random boolean. +func lucky() bool { return rand.Intn(2) == 1 } diff --git a/pkg/worker/caged/libretro/image/canvas.c b/pkg/worker/caged/libretro/image/canvas.c deleted file mode 100644 index 03753014..00000000 --- a/pkg/worker/caged/libretro/image/canvas.c +++ /dev/null @@ -1,88 +0,0 @@ -#include "canvas.h" - -__inline xy rotate(int t, int x, int y, int w, int h) { - xy p = {x, y}; - switch (t) { - // 90° CCW or 270° CW - case A90: - p.x = y; - p.y = w - 1 - x; - break; - // 180° CCW - case A180: - p.x = w - 1 - x; - p.y = h - 1 - y; - break; - // 270° CCW or 90° CW - case A270: - p.x = h - 1 - y; - p.y = x; - break; - // flip Y - case F180: - //p.x = x; - p.y = h - 1 - y; - break; - } - return p; -} - -__inline uint32_t _565(uint32_t x) { - return ((x >> 8 & 0xf8) | ((x >> 3 & 0xfc) << 8) | ((x << 3 & 0xfc) << 16)); // | 0xff000000 -} - -__inline uint32_t _8888rev(uint32_t px) { - return (((px >> 16) & 0xff) | (px & 0xff00) | ((px << 16) & 0xff0000)); // | 0xff000000 -} - -void RGBA(int pix, uint32_t *__restrict dst, const void *__restrict source, int y, int h, int w, int hh, int dw, int pad, int rot) { - int x; - xy rxy; - const uint16_t *src16; - const uint32_t *src32; - - switch (pix) { - //case BIT_SHORT5551: - // break; - case BIT_INT_8888REV: - src32 = (const uint32_t *)source; - int pad32 = pad >> 2; - if (rot == NO_ROT) { - for (; y < h; ++y) { - for (x = 0; x < w; ++x) { - *dst++ = _8888rev(*src32++); - } - src32 += pad32; - } - } else { - for (; y < h; ++y) { - for (x = 0; x < w; ++x) { - rxy = rotate(rot, x, y, w, hh); - dst[rxy.x+rxy.y*dw] = _8888rev(*src32++); - } - src32 += pad32; - } - } - break; - case BIT_SHORT565: - src16 = (const uint16_t *)source; - int pad16 = pad >> 1; - if (rot == NO_ROT) { - for (; y < h; ++y) { - for (x = 0; x < w; ++x) { - *dst++ = _565(*src16++); - } - src16 += pad16; - } - } else { - for (; y < h; ++y) { - for (x = 0; x < w; ++x) { - rxy = rotate(rot, x, y, w, hh); - dst[rxy.x+rxy.y*dw] = _565(*src16++); - } - src16 += pad16; - } - } - break; - } -} diff --git a/pkg/worker/caged/libretro/image/canvas.go b/pkg/worker/caged/libretro/image/canvas.go deleted file mode 100644 index 31d9750b..00000000 --- a/pkg/worker/caged/libretro/image/canvas.go +++ /dev/null @@ -1,159 +0,0 @@ -package image - -import ( - "image" - "sync" - "unsafe" - - "golang.org/x/image/draw" -) - -/* -#cgo CFLAGS: -Wall -#include "canvas.h" -*/ -import "C" - -// Canvas is a stateful drawing surface, i.e. image.RGBA -type Canvas struct { - enabled bool - w, h int - vertical bool - pool sync.Pool - wg sync.WaitGroup -} - -type Frame struct{ image.RGBA } - -func (f *Frame) Unwrap() image.RGBA { return f.RGBA } -func (f *Frame) Opaque() bool { return true } -func (f *Frame) Copy() Frame { - return Frame{image.RGBA{Pix: append([]uint8{}, f.Pix...), Stride: f.Stride, Rect: f.Rect}} -} - -const ( - BitFormatShort5551 = iota // BIT_FORMAT_SHORT_5_5_5_1 has 5 bits R, 5 bits G, 5 bits B, 1 bit alpha - BitFormatInt8888Rev // BIT_FORMAT_INT_8_8_8_8_REV has 8 bits R, 8 bits G, 8 bits B, 8 bit alpha - BitFormatShort565 // BIT_FORMAT_SHORT_5_6_5 has 5 bits R, 6 bits G, 5 bits -) - -const ( - ScaleNot = iota // skips image interpolation - ScaleNearestNeighbour // nearest neighbour interpolation - ScaleBilinear // bilinear interpolation -) - -func Resize(scaleType int, src *image.RGBA, out *image.RGBA) { - // !to do set it once instead switching on each iteration - switch scaleType { - case ScaleBilinear: - draw.ApproxBiLinear.Scale(out, out.Bounds(), src, src.Bounds(), draw.Src, nil) - case ScaleNot: - fallthrough - case ScaleNearestNeighbour: - fallthrough - default: - draw.NearestNeighbor.Scale(out, out.Bounds(), src, src.Bounds(), draw.Src, nil) - } -} - -type Rotation uint - -const ( - A90 Rotation = iota + 1 - A180 - A270 - F180 // F180 is flipped Y -) - -func NewCanvas(w, h, size int) *Canvas { - return &Canvas{ - enabled: true, - w: w, - h: h, - vertical: h > w, // input is inverted - pool: sync.Pool{New: func() any { - i := Frame{image.RGBA{ - Pix: make([]uint8, size<<2), - Rect: image.Rectangle{Max: image.Point{X: w, Y: h}}, - }} - return &i - }}, - } -} - -func (c *Canvas) Get(w, h int) *Frame { - i := c.pool.Get().(*Frame) - if c.vertical { - w, h = h, w - } - i.Stride = w << 2 - i.Pix = i.Pix[:i.Stride*h] - i.Rect.Max.X = w - i.Rect.Max.Y = h - return i -} - -func (c *Canvas) Put(i *Frame) { - if c.enabled { - c.pool.Put(i) - } -} -func (c *Canvas) Clear() { c.wg = sync.WaitGroup{} } -func (c *Canvas) SetEnabled(enabled bool) { c.enabled = enabled } - -func (c *Canvas) Draw(encoding uint32, rot Rotation, w, h, packedW, bpp int, data []byte, th int) *Frame { - dst := c.Get(w, h) - if th == 0 { - frame(encoding, dst, data, 0, h, w, h, packedW, bpp, rot) - } else { - hn := h / th - c.wg.Add(th) - for i := 0; i < th; i++ { - xx := hn * i - go func() { - frame(encoding, dst, data, xx, hn, w, h, packedW, bpp, rot) - c.wg.Done() - }() - } - c.wg.Wait() - } - - // rescale - if dst.Rect.Dx() != c.w || dst.Rect.Dy() != c.h { - ww := c.w - hh := c.h - // w, h supposedly have been swapped before - if c.vertical { - ww, hh = c.h, c.w - } - out := c.Get(ww, hh) - Resize(ScaleNearestNeighbour, &dst.RGBA, &out.RGBA) - c.Put(dst) - return out - } - - return dst -} - -func frame(encoding uint32, dst *Frame, data []byte, yy int, hn int, w int, h int, pwb int, bpp int, rot Rotation) { - sPtr := unsafe.Pointer(&data[yy*pwb]) - // some cores can zero-right-pad rows to the packed width value - pad := pwb - w*bpp - if pad < 0 { - pad = 0 - } - ds := 0 - if rot == 0 { - ds = yy * dst.Stride - } - dPtr := (*C.uint32_t)(unsafe.Pointer(&dst.Pix[ds])) - C.RGBA(C.int(encoding), dPtr, sPtr, C.int(yy), C.int(yy+hn), C.int(w), C.int(h), C.int(dst.Stride>>2), C.int(pad), C.int(rot)) -} - -func _8888rev(px uint32) uint32 { return uint32(C._8888rev(C.uint32_t(px))) } - -func rotate(t int, x int, y int, w int, h int) (int, int) { - var rot C.xy = C.rotate(C.int(t), C.int(x), C.int(y), C.int(w), C.int(h)) - return int(rot.x), int(rot.y) -} diff --git a/pkg/worker/caged/libretro/image/canvas.h b/pkg/worker/caged/libretro/image/canvas.h deleted file mode 100644 index 5ee04a86..00000000 --- a/pkg/worker/caged/libretro/image/canvas.h +++ /dev/null @@ -1,27 +0,0 @@ -#ifndef CANVAS_H__ -#define CANVAS_H__ - -#include - -#define BIT_SHORT5551 0 -#define BIT_INT_8888REV 1 -#define BIT_SHORT565 2 - -#define NO_ROT 0 -#define A90 1 -#define A180 2 -#define A270 3 -#define F180 4 - -typedef struct XY { - int x, y; -} xy; - -xy rotate(int t, int x, int y, int w, int h); - -void RGBA(int pix, uint32_t *dst, const void *source, int y, int h, int w, int hh, int dw, int pad, int rot); - -uint32_t _565(uint32_t x); -uint32_t _8888rev(uint32_t px); - -#endif diff --git a/pkg/worker/caged/libretro/image/canvas_test.go b/pkg/worker/caged/libretro/image/canvas_test.go deleted file mode 100644 index b1def658..00000000 --- a/pkg/worker/caged/libretro/image/canvas_test.go +++ /dev/null @@ -1,340 +0,0 @@ -package image - -import ( - "bytes" - "fmt" - "testing" -) - -func BenchmarkDraw(b *testing.B) { - w1, h1 := 256, 240 - w2, h2 := 640, 480 - - type args struct { - encoding uint32 - rot Rotation - scaleType int - w int - h int - packedW int - bpp int - data []byte - dw int - dh int - th int - } - tests := []struct { - name string - args args - }{ - { - name: "565_0th", - args: args{ - encoding: BitFormatShort565, scaleType: ScaleNearestNeighbour, - w: w1, h: h1, packedW: w1, bpp: 2, data: make([]uint8, w1*h1*2), dw: w1, dh: h1, th: 0, - }, - }, - { - name: "565_0th_90", - args: args{ - encoding: BitFormatShort565, rot: A90, scaleType: ScaleNearestNeighbour, - w: h1, h: w1, packedW: h1, bpp: 2, data: make([]uint8, w1*h1*2), dw: w1, dh: h1, th: 0, - }, - }, - { - name: "565_0th", - args: args{ - encoding: BitFormatShort565, scaleType: ScaleNearestNeighbour, - w: w2, h: h2, packedW: w1, bpp: 2, data: make([]uint8, w2*h2*2), dw: w2, dh: h2, th: 0, - }, - }, - { - name: "565_4th", - args: args{ - encoding: BitFormatShort565, scaleType: ScaleNearestNeighbour, - w: w1, h: h1, packedW: w1, bpp: 2, data: make([]uint8, w1*h1*2), dw: w1, dh: h1, th: 4, - }, - }, - { - name: "565_4th", - args: args{ - encoding: BitFormatShort565, scaleType: ScaleNearestNeighbour, - w: w2, h: h2, packedW: w2, bpp: 2, data: make([]uint8, w2*h2*2), dw: w2, dh: h2, th: 4, - }, - }, - { - name: "8888 - 0th", - args: args{ - encoding: BitFormatInt8888Rev, scaleType: ScaleNearestNeighbour, - w: w1, h: h1, packedW: w1, bpp: 4, data: make([]uint8, w1*h1*4), dw: w1, dh: h1, th: 0, - }, - }, - { - name: "8888 - 4th", - args: args{ - encoding: BitFormatInt8888Rev, scaleType: ScaleNearestNeighbour, - w: w1, h: h1, packedW: w1, bpp: 4, data: make([]uint8, w1*h1*4), dw: w1, dh: h1, th: 4, - }, - }, - } - - for _, bn := range tests { - c := NewCanvas(bn.args.dw, bn.args.dh, bn.args.dw*bn.args.dh) - img := c.Get(bn.args.dw, bn.args.dh) - c.Put(img) - img2 := c.Get(bn.args.dw, bn.args.dh) - c.Put(img2) - b.ResetTimer() - b.Run(fmt.Sprintf("%vx%v_%v", bn.args.w, bn.args.h, bn.name), func(b *testing.B) { - for i := 0; i < b.N; i++ { - p := c.Draw(bn.args.encoding, bn.args.rot, bn.args.w, bn.args.h, bn.args.packedW, bn.args.bpp, bn.args.data, bn.args.th) - c.Put(p) - } - b.ReportAllocs() - }) - } -} - -func Test_ix8888(t *testing.T) { - type args struct { - dst *uint32 - px uint32 - expect uint32 - } - tests := []struct { - name string - args args - }{ - { - name: "", - args: args{ - dst: new(uint32), - px: 0x11223344, - expect: 0x00443322, - }, - }, - } - for _, tt := range tests { - t.Run(tt.name, func(t *testing.T) { - *tt.args.dst = _8888rev(tt.args.px) - if *tt.args.dst != tt.args.expect { - t.Errorf("nope, %x %x", *tt.args.dst, tt.args.expect) - } - }) - } -} - -type dimensions struct { - w int - h int -} - -func TestRotate(t *testing.T) { - tests := []struct { - // packed bytes from a 2D matrix - input []byte - // original matrix's width - w int - // original matrix's height - h int - // rotation algorithm - rotateHow []Rotation - expected [][]byte - }{ - { - // a cross - []byte{ - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - 3, 3, []Rotation{0, A90, A180, A270}, - [][]byte{ - { - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - { - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - { - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - { - 0, 1, 0, - 1, 1, 1, - 0, 1, 0, - }, - }, - }, - { - []byte{ - 1, 2, - 3, 4, - 5, 6, - 7, 8, - }, - 2, 4, []Rotation{0, A90, A180, A270}, - [][]byte{ - { - 1, 2, - 3, 4, - 5, 6, - 7, 8, - }, - { - 2, 4, 6, 8, - 1, 3, 5, 7, - }, - { - 8, 7, - 6, 5, - 4, 3, - 2, 1, - }, - { - 7, 5, 3, 1, - 8, 6, 4, 2, - }, - }, - }, - { - // a square - []byte{ - 1, 0, 0, 0, 0, 0, 0, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 0, 0, 0, 0, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 0, 0, 0, 0, 0, 0, 1, - }, - 8, 6, []Rotation{0, A90, A180, A270}, - [][]byte{ - { - // L // R - 1, 0, 0, 0, 0, 0, 0, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 0, 0, 0, 0, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 0, 0, 0, 0, 0, 0, 1, - }, - { - 0, 0, 0, 0, 0, 1, - 0, 1, 1, 1, 1, 0, - 0, 1, 1, 0, 1, 0, - 0, 1, 1, 0, 1, 0, - 0, 1, 1, 0, 1, 0, - 0, 1, 1, 0, 1, 0, - 0, 1, 1, 1, 1, 0, - 1, 0, 0, 0, 0, 0, - }, - - { - 1, 0, 0, 0, 0, 0, 0, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 0, 0, 0, 0, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 1, 1, 1, 1, 1, 1, 0, - 0, 0, 0, 0, 0, 0, 0, 1, - }, - { - 0, 0, 0, 0, 0, 1, - 0, 1, 1, 1, 1, 0, - 0, 1, 0, 1, 1, 0, - 0, 1, 0, 1, 1, 0, - 0, 1, 0, 1, 1, 0, - 0, 1, 0, 1, 1, 0, - 0, 1, 1, 1, 1, 0, - 1, 0, 0, 0, 0, 0, - }, - }, - }, - } - - for _, test := range tests { - for i, rot := range test.rotateHow { - if output := exampleRotate(test.input, test.w, test.h, rot); !bytes.Equal(output, test.expected[i]) { - t.Errorf( - "Test fail for angle %v with %v that should be \n%v but it's \n%v", - rot, test.input, test.expected[i], output) - } - } - } -} - -func TestBoundsAfterRotation(t *testing.T) { - tests := []struct { - dim []dimensions - rotateHow []Rotation - }{ - { - // a combinatorics lib would be nice instead - []dimensions{ - // square - {w: 100, h: 100}, - // even w/h - {w: 100, h: 50}, - // even h/w - {w: 50, h: 100}, - // odd even w/h - {w: 77, h: 32}, - // even odd h/w - {w: 32, h: 77}, - // just odd - {w: 13, h: 19}, - }, - []Rotation{0, A90, A180, A270}, - }, - } - - for _, test := range tests { - for _, rot := range test.rotateHow { - for _, dim := range test.dim { - - for y := 0; y < dim.h; y++ { - for x := 0; x < dim.w; x++ { - - xx, yy := rotate(int(rot), x, y, dim.w, dim.h) - - if rot == A90 || rot == A270 { // is even - yy, xx = xx, yy - } - - if xx < 0 || xx > dim.w { - t.Errorf("Rot %v, coordinate x should be in range [0; %v]: %v", rot, dim.w-1, xx) - } - - if yy < 0 || yy > dim.h { - t.Errorf("Rot %v, coordinate y should be in range [0; %v]: %v", rot, dim.h-1, yy) - } - } - } - } - } - } -} - -// exampleRotate is an example of rotation usage. -// -// [1 2 3 4 5 6 7 8 9] -// [7 4 1 8 5 2 9 6 3] -func exampleRotate(data []uint8, w int, h int, rot Rotation) []uint8 { - dest := make([]uint8, len(data)) - for y := 0; y < h; y++ { - for x := 0; x < w; x++ { - nx, ny := rotate(int(rot), x, y, w, h) - stride := w - if rot == A90 || rot == A270 { // is even - stride = h - } - dest[nx+ny*stride] = data[x+y*w] - } - } - return dest -} diff --git a/pkg/worker/caged/libretro/manager/http.go b/pkg/worker/caged/libretro/manager/http.go index 8609314e..1f2dbc88 100644 --- a/pkg/worker/caged/libretro/manager/http.go +++ b/pkg/worker/caged/libretro/manager/http.go @@ -2,6 +2,7 @@ package manager import ( "os" + "path/filepath" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" @@ -31,6 +32,15 @@ func NewRemoteHttpManager(conf config.LibretroConfig, log *logger.Logger) Manage } log.Debug().Msgf("Using .lock file: %v", fileLock) + if err := os.MkdirAll(filepath.Dir(fileLock), 0770); err != nil { + log.Error().Err(err).Msgf("couldn't create lock") + } else { + f, err := os.Create(fileLock) + if err != nil { + log.Error().Err(err).Msgf("couldn't create lock") + } + _ = f.Close() + } ar, err := arch.Guess() if err != nil { log.Error().Err(err).Msg("couldn't get Libretro core file extension") @@ -73,8 +83,16 @@ func CheckCores(conf config.Emulator, log *logger.Logger) error { func (m *Manager) Sync() error { // IPC lock if multiple worker processes on the same machine - m.fmu.Lock() - defer m.fmu.Unlock() + err := m.fmu.Lock() + if err != nil { + m.log.Error().Err(err).Msg("file lock fail") + } + defer func() { + err := m.fmu.Unlock() + if err != nil { + m.log.Error().Err(err).Msg("file unlock fail") + } + }() installed, err := m.GetInstalled(m.arch.LibExt) if err != nil { diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 841ae8c4..b601aade 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -12,7 +12,6 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/graphics" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/image" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" "github.com/giongto35/cloud-game/v3/pkg/worker/thread" ) @@ -33,6 +32,12 @@ const KeyReleased = 0 const MaxPort int = 4 +var ( + RGBA5551 = PixFmt{C: 0, BPP: 2} // BIT_FORMAT_SHORT_5_5_5_1 has 5 bits R, 5 bits G, 5 bits B, 1 bit alpha + RGBA8888Rev = PixFmt{C: 1, BPP: 4} // BIT_FORMAT_INT_8_8_8_8_REV has 8 bits R, 8 bits G, 8 bits B, 8 bit alpha + RGB565 = PixFmt{C: 2, BPP: 2} // BIT_FORMAT_SHORT_5_6_5 has 5 bits R, 6 bits G, 5 bits +) + type Nanoarch struct { Handlers LastFrameTime int64 @@ -44,7 +49,7 @@ type Nanoarch struct { } options *map[string]string reserved chan struct{} // limits concurrent use - Rot image.Rotation + Rot uint serializeSize C.size_t stopped atomic.Bool sysAvInfo C.struct_retro_system_av_info @@ -58,9 +63,8 @@ type Nanoarch struct { enabled bool autoCtx bool } - BPP uint hw *C.struct_retro_hw_render_callback - PixFmt uint32 + PixFmt PixFmt } vfr bool sdlCtx *graphics.SDL @@ -78,7 +82,7 @@ type Handlers struct { type FrameInfo struct { W uint H uint - Packed uint + Stride uint } type Metadata struct { @@ -92,6 +96,24 @@ type Metadata struct { Hacks []string } +type PixFmt struct { + C uint32 + BPP uint +} + +func (p PixFmt) String() string { + switch p.C { + case 0: + return "RGBA5551/2" + case 1: + return "RGBA8888Rev/4" + case 2: + return "RGB565/2" + default: + return fmt.Sprintf("Unknown (%v/%v)", p.C, p.BPP) + } +} + // Nan0 is a global link for C callbacks to Go var Nan0 = Nanoarch{ reserved: make(chan struct{}, 1), // this thing forbids concurrent use of the emulator @@ -118,7 +140,7 @@ func NewNano(localPath string) *Nanoarch { func (n *Nanoarch) AudioSampleRate() int { return int(n.sysAvInfo.timing.sample_rate) } func (n *Nanoarch) VideoFramerate() int { return int(n.sysAvInfo.timing.fps) } -func (n *Nanoarch) IsPortrait() bool { return n.Rot == image.A90 || n.Rot == image.A270 } +func (n *Nanoarch) IsPortrait() bool { return n.Rot == 90 || n.Rot == 270 } func (n *Nanoarch) GeometryBase() (int, int) { return int(n.sysAvInfo.geometry.base_width), int(n.sysAvInfo.geometry.base_height) } @@ -252,7 +274,7 @@ func (n *Nanoarch) LoadGame(path string) error { if n.Video.gl.enabled { //setRotation(image.F180) // flip Y coordinates of OpenGL - bufS := uint(n.sysAvInfo.geometry.max_width*n.sysAvInfo.geometry.max_height) * n.Video.BPP + bufS := uint(n.sysAvInfo.geometry.max_width*n.sysAvInfo.geometry.max_height) * n.Video.PixFmt.BPP graphics.SetBuffer(int(bufS)) n.log.Info().Msgf("Set buffer: %v", byteCountBinary(int64(bufS))) if n.LibCo { @@ -357,34 +379,33 @@ func (n *Nanoarch) IsStopped() bool { return n.stopped.Load() } func videoSetPixelFormat(format uint32) (C.bool, error) { switch format { case C.RETRO_PIXEL_FORMAT_0RGB1555: - Nan0.Video.PixFmt = image.BitFormatShort5551 + Nan0.Video.PixFmt = RGBA5551 if err := graphics.SetPixelFormat(graphics.UnsignedShort5551); err != nil { return false, fmt.Errorf("unknown pixel format %v", Nan0.Video.PixFmt) } - Nan0.Video.BPP = 2 // format is not implemented return false, fmt.Errorf("unsupported pixel type %v converter", format) case C.RETRO_PIXEL_FORMAT_XRGB8888: - Nan0.Video.PixFmt = image.BitFormatInt8888Rev + Nan0.Video.PixFmt = RGBA8888Rev if err := graphics.SetPixelFormat(graphics.UnsignedInt8888Rev); err != nil { return false, fmt.Errorf("unknown pixel format %v", Nan0.Video.PixFmt) } - Nan0.Video.BPP = 4 case C.RETRO_PIXEL_FORMAT_RGB565: - Nan0.Video.PixFmt = image.BitFormatShort565 + Nan0.Video.PixFmt = RGB565 if err := graphics.SetPixelFormat(graphics.UnsignedShort565); err != nil { return false, fmt.Errorf("unknown pixel format %v", Nan0.Video.PixFmt) } - Nan0.Video.BPP = 2 default: return false, fmt.Errorf("unknown pixel type %v", format) } + Nan0.log.Info().Msgf("Pixel format: %v", Nan0.Video.PixFmt) + return true, nil } -func setRotation(rotation image.Rotation) { - Nan0.Rot = rotation - Nan0.log.Debug().Msgf("Image rotated %v°", map[uint]uint{0: 0, 1: 90, 2: 180, 3: 270}[uint(rotation)]) +func setRotation(rot uint) { + Nan0.Rot = rot + Nan0.log.Debug().Msgf("Image rotated %v°", rot) } func printOpenGLDriverInfo() { @@ -557,7 +578,7 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { // calculate real frame width in pixels from packed data (realWidth >= width) // some cores or games output zero pitch, i.e. N64 Mupen if packed == 0 { - packed = width * Nan0.Video.BPP + packed = width * Nan0.Video.PixFmt.BPP } // calculate space for the video frame bytes := packed * height @@ -575,7 +596,7 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { // also we have an option of xN output frame magnification // so, it may be rescaled - Nan0.Handlers.OnVideo(data_, int32(dt), FrameInfo{W: width, H: height, Packed: packed}) + Nan0.Handlers.OnVideo(data_, int32(dt), FrameInfo{W: width, H: height, Stride: packed}) } //export coreInputPoll @@ -665,8 +686,16 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { } switch cmd { + case C.RETRO_ENVIRONMENT_SET_SYSTEM_AV_INFO: + av := *(*C.struct_retro_system_av_info)(data) + Nan0.log.Info().Msgf(">>> SET SYS AV INFO: %v", av) + return true + case C.RETRO_ENVIRONMENT_SET_GEOMETRY: + geom := *(*C.struct_retro_game_geometry)(data) + Nan0.log.Info().Msgf(">>> GEOMETRY: %v", geom) + return true case C.RETRO_ENVIRONMENT_SET_ROTATION: - setRotation(image.Rotation(*(*uint)(data) % 4)) + setRotation((*(*uint)(data) % 4) * 90) return true case C.RETRO_ENVIRONMENT_GET_CAN_DUPE: *(*C.bool)(data) = C.bool(true) diff --git a/pkg/worker/caged/libretro/recording.go b/pkg/worker/caged/libretro/recording.go index 7c128aea..cc4cdcdd 100644 --- a/pkg/worker/caged/libretro/recording.go +++ b/pkg/worker/caged/libretro/recording.go @@ -1,7 +1,6 @@ package libretro import ( - "image" "time" "github.com/giongto35/cloud-game/v3/pkg/config" @@ -15,23 +14,29 @@ type RecordingFrontend struct { rec *recorder.Recording } -// !to fix opaque image save - -type opaque struct{ image.RGBA } - -func (o *opaque) Opaque() bool { return true } - func WithRecording(fe Emulator, rec bool, user string, game string, conf config.Recording, log *logger.Logger) *RecordingFrontend { + + pix := "" + switch fe.PixFormat() { + case 0: + pix = "rgb1555" + case 1: + pix = "brga" + case 2: + pix = "rgb565" + } + rr := &RecordingFrontend{Emulator: fe, rec: recorder.NewRecording( recorder.Meta{UserName: user}, log, recorder.Options{ - Dir: conf.Folder, - Game: game, - ImageCompressionLevel: conf.CompressLevel, - Name: conf.Name, - Zip: conf.Zip, - Vsync: true, + Dir: conf.Folder, + Game: game, + Name: conf.Name, + Zip: conf.Zip, + Vsync: true, + Flip: fe.Flipped(), + Pix: pix, })} rr.ToggleRecording(rec, user) return rr @@ -52,7 +57,7 @@ func (r *RecordingFrontend) SetAudioCb(fn func(app.Audio)) { func (r *RecordingFrontend) SetVideoCb(fn func(app.Video)) { r.Emulator.SetVideoCb(func(v app.Video) { if r.IsRecording() { - r.rec.WriteVideo(recorder.Video{Image: &opaque{v.Frame}, Duration: time.Duration(v.Duration)}) + r.rec.WriteVideo(recorder.Video{Frame: recorder.Frame(v.Frame), Duration: time.Duration(v.Duration)}) } fn(v) }) diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index ebce6062..2a791c1b 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -121,6 +121,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke m.AudioSrcHz = app.AudioSampleRate() m.AudioFrame = w.conf.Encoder.Audio.Frame m.VideoW, m.VideoH = app.ViewportSize() + m.VideoScale = app.Scale() r.SetMedia(m) diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 5f53324a..5b33404e 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -103,11 +103,11 @@ func (s samples) stretch(size int) []int16 { } type WebrtcMediaPipe struct { + a *opus.Encoder + v *encoder.Video onAudio func([]byte) - opus *opus.Encoder audioBuf buffer log *logger.Logger - enc *encoder.VideoEncoder aConf config.Audio vConf config.Video @@ -115,6 +115,7 @@ type WebrtcMediaPipe struct { AudioSrcHz int AudioFrame int VideoW, VideoH int + VideoScale float64 } func NewWebRtcMediaPipe(ac config.Audio, vc config.Video, log *logger.Logger) *WebrtcMediaPipe { @@ -126,8 +127,8 @@ func (wmp *WebrtcMediaPipe) SetAudioCb(cb func([]byte, int32)) { wmp.onAudio = func(bytes []byte) { cb(bytes, fr) } } func (wmp *WebrtcMediaPipe) Destroy() { - if wmp.enc != nil { - wmp.enc.Stop() + if wmp.v != nil { + wmp.v.Stop() } } func (wmp *WebrtcMediaPipe) PushAudio(audio []int16) { wmp.audioBuf.write(audio, wmp.encodeAudio) } @@ -136,7 +137,7 @@ func (wmp *WebrtcMediaPipe) Init() error { if err := wmp.initAudio(wmp.AudioSrcHz, wmp.AudioFrame); err != nil { return err } - if err := wmp.initVideo(wmp.VideoW, wmp.VideoH, wmp.vConf); err != nil { + if err := wmp.initVideo(wmp.VideoW, wmp.VideoH, wmp.VideoScale, wmp.vConf); err != nil { return err } return nil @@ -148,7 +149,7 @@ func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSize int) error { return fmt.Errorf("opus fail: %w", err) } wmp.log.Debug().Msgf("Opus: %v", au.GetInfo()) - wmp.opus = au + wmp.a = au buf := newBuffer(frame(srcHz, frameSize)) dstHz, _ := au.SampleRate() if srcHz != dstHz { @@ -160,7 +161,7 @@ func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSize int) error { } func (wmp *WebrtcMediaPipe) encodeAudio(pcm samples) { - data, err := wmp.opus.Encode(pcm) + data, err := wmp.a.Encode(pcm) audioPool.Put((*[]int16)(&pcm)) if err != nil { wmp.log.Error().Err(err).Msgf("opus encode fail") @@ -169,25 +170,36 @@ func (wmp *WebrtcMediaPipe) encodeAudio(pcm samples) { wmp.onAudio(data) } -func (wmp *WebrtcMediaPipe) initVideo(w, h int, conf config.Video) error { +func (wmp *WebrtcMediaPipe) initVideo(w, h int, scale float64, conf config.Video) error { var enc encoder.Encoder var err error + + sw, sh := round(w, scale), round(h, scale) + + wmp.log.Debug().Msgf("Scale: %vx%v -> %vx%v", w, h, sw, sh) + wmp.log.Info().Msgf("Video codec: %v", conf.Codec) if conf.Codec == string(encoder.H264) { wmp.log.Debug().Msgf("x264: build v%v", h264.LibVersion()) opts := h264.Options(conf.H264) - enc, err = h264.NewEncoder(w, h, &opts) + enc, err = h264.NewEncoder(sw, sh, &opts) } else { opts := vpx.Options(conf.Vpx) - enc, err = vpx.NewEncoder(w, h, &opts) + enc, err = vpx.NewEncoder(sw, sh, &opts) } if err != nil { return fmt.Errorf("couldn't create a video encoder: %w", err) } - wmp.enc = encoder.NewVideoEncoder(enc, w, h, conf.Concurrency, wmp.log) + wmp.v = encoder.NewVideoEncoder(enc, w, h, scale, wmp.log) + wmp.log.Debug().Msgf("%v", wmp.v.Info()) return nil } -func (wmp *WebrtcMediaPipe) ProcessVideo(v app.Video) []byte { return wmp.enc.Encode(&v.Frame) } +func round(x int, scale float64) int { return (int(float64(x)*scale) + 1) & ^1 } -func (wmp *WebrtcMediaPipe) SetVideoFlip(b bool) { wmp.enc.SetFlip(b) } +func (wmp *WebrtcMediaPipe) ProcessVideo(v app.Video) []byte { + return wmp.v.Encode(encoder.InFrame(v.Frame)) +} +func (wmp *WebrtcMediaPipe) SetPixFmt(f uint32) { wmp.v.SetPixFormat(f) } +func (wmp *WebrtcMediaPipe) SetVideoFlip(b bool) { wmp.v.SetFlip(b) } +func (wmp *WebrtcMediaPipe) SetRot(r uint) { wmp.v.SetRot(r) } diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 612be7a2..e99522ef 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -46,7 +46,7 @@ func run(w, h int, cod encoder.VideoCodec, count int, a *image.RGBA, b *image.RG } logger.SetGlobalLevel(logger.Disabled) - ve := encoder.NewVideoEncoder(enc, w, h, 8, l) + ve := encoder.NewVideoEncoder(enc, w, h, 1, l) defer ve.Stop() if a == nil { @@ -61,7 +61,12 @@ func run(w, h int, cod encoder.VideoCodec, count int, a *image.RGBA, b *image.RG if i%2 == 0 { im = b } - out := ve.Encode(im) + out := ve.Encode(encoder.InFrame{ + Data: im.Pix, + Stride: im.Stride, + W: im.Bounds().Dx(), + H: im.Bounds().Dy(), + }) if out == nil { backend.Fatalf("encoder closed abnormally") } diff --git a/pkg/worker/recorder/ffmpegmux.go b/pkg/worker/recorder/ffmpegmux.go index 4869ef71..37c9df6a 100644 --- a/pkg/worker/recorder/ffmpegmux.go +++ b/pkg/worker/recorder/ffmpegmux.go @@ -15,6 +15,8 @@ const demuxFile = "input.txt" // ffmpeg concat demuxer, see: https://ffmpeg.org/ffmpeg-formats.html#concat // example: // +// !to change +// // ffmpeg -f concat -i input.txt \ // -ac 2 -channel_layout stereo -i audio.wav \ // -b:a 192K -crf 23 -vf fps=30 -pix_fmt yuv420p \ @@ -25,9 +27,17 @@ func createFfmpegMuxFile(dir string, fPattern string, frameTimes []time.Duration return err } defer func() { er = demux.Close() }() - _, err = demux.WriteString( - fmt.Sprintf("ffconcat version 1.0\n# v: 1\n# date: %v\n# game: %v\n# fps: %v\n# freq (hz): %v\n\n", - time.Now().Format("20060102"), opts.Game, opts.Fps, opts.Frequency)) + + b := strings.Builder{} + + b.WriteString("ffconcat version 1.0\n") + b.WriteString(meta("v", "1")) + b.WriteString(meta("date", time.Now().Format("20060102"))) + b.WriteString(meta("game", opts.Game)) + b.WriteString(meta("fps", opts.Fps)) + b.WriteString(meta("freq", opts.Frequency)) + b.WriteString(meta("pix", opts.Pix)) + _, err = demux.WriteString(fmt.Sprintf("%s\n", b.String())) if err != nil { return err } @@ -51,7 +61,9 @@ func createFfmpegMuxFile(dir string, fPattern string, frameTimes []time.Duration } i++ } - inf := fmt.Sprintf("file %v\nduration %f\n", name, dur) + w, h, s := ExtractFileInfo(file.Name()) + inf := fmt.Sprintf("file %v\nduration %f\n%s%s%s", name, dur, + metaf("width", w), metaf("height", h), metaf("stride", s)) if _, err := demux.WriteString(inf); err != nil { er = err } @@ -61,3 +73,11 @@ func createFfmpegMuxFile(dir string, fPattern string, frameTimes []time.Duration } return er } + +// meta adds stream_meta key value line. +func meta(key string, value any) string { return fmt.Sprintf("stream_meta %s '%v'\n", key, value) } + +// metaf adds file_packet_meta key value line. +func metaf(key string, value any) string { + return fmt.Sprintf("file_packet_meta %s '%v'\n", key, value) +} diff --git a/pkg/worker/recorder/options.go b/pkg/worker/recorder/options.go index 9707e171..fe4ca7ce 100644 --- a/pkg/worker/recorder/options.go +++ b/pkg/worker/recorder/options.go @@ -1,14 +1,18 @@ package recorder type Options struct { - Dir string - Fps float64 - Frequency int - Game string - ImageCompressionLevel int - Name string - Zip bool - Vsync bool + Dir string + Fps float64 + W int + H int + Stride int + Flip bool + Frequency int + Pix string + Game string + Name string + Zip bool + Vsync bool } type Meta struct { diff --git a/pkg/worker/recorder/pngstream.go b/pkg/worker/recorder/pngstream.go deleted file mode 100644 index 1cb0cf88..00000000 --- a/pkg/worker/recorder/pngstream.go +++ /dev/null @@ -1,72 +0,0 @@ -package recorder - -import ( - "bytes" - "fmt" - "image" - "image/png" - "log" - "os" - "path/filepath" - "sync" - "sync/atomic" -) - -type pngStream struct { - dir string - e *png.Encoder - id uint32 - wg sync.WaitGroup -} - -const videoFile = "f%07d.png" - -type pool struct{ sync.Pool } - -func pngBuf() *pool { return &pool{sync.Pool{New: func() any { return &png.EncoderBuffer{} }}} } -func (p *pool) Get() *png.EncoderBuffer { return p.Pool.Get().(*png.EncoderBuffer) } -func (p *pool) Put(b *png.EncoderBuffer) { p.Pool.Put(b) } - -func newPngStream(dir string, opts Options) (*pngStream, error) { - return &pngStream{ - dir: dir, - e: &png.Encoder{ - CompressionLevel: png.CompressionLevel(opts.ImageCompressionLevel), - BufferPool: pngBuf(), - }, - }, nil -} - -func (p *pngStream) Close() error { - atomic.StoreUint32(&p.id, 0) - p.wg.Wait() - return nil -} - -func (p *pngStream) Write(data Video) { - fileName := fmt.Sprintf(videoFile, atomic.AddUint32(&p.id, 1)) - p.wg.Add(1) - go p.saveImage(fileName, data.Image) -} - -func (p *pngStream) saveImage(fileName string, img image.Image) { - var buf bytes.Buffer - x, y := (img).Bounds().Dx(), (img).Bounds().Dy() - buf.Grow(x * y * 4) - - if err := p.e.Encode(&buf, img); err != nil { - log.Printf("p err: %v", err) - } else { - file, err := os.Create(filepath.Join(p.dir, fileName)) - if err != nil { - log.Printf("c err: %v", err) - } - if _, err = file.Write(buf.Bytes()); err != nil { - log.Printf("f err: %v", err) - } - if err = file.Close(); err != nil { - log.Printf("fc err: %v", err) - } - } - p.wg.Done() -} diff --git a/pkg/worker/recorder/rawstream.go b/pkg/worker/recorder/rawstream.go new file mode 100644 index 00000000..26b8875c --- /dev/null +++ b/pkg/worker/recorder/rawstream.go @@ -0,0 +1,66 @@ +package recorder + +import ( + "fmt" + "log" + "os" + "path/filepath" + "strings" + "sync" + "sync/atomic" +) + +type rawStream struct { + dir string + id uint32 + wg sync.WaitGroup +} + +const videoFile = "f%07d__%dx%d__%d.raw" + +func newRawStream(dir string) (*rawStream, error) { + return &rawStream{dir: dir}, nil +} + +func (p *rawStream) Close() error { + atomic.StoreUint32(&p.id, 0) + p.wg.Wait() + return nil +} + +func (p *rawStream) Write(data Video) { + i := atomic.AddUint32(&p.id, 1) + fileName := fmt.Sprintf(videoFile, i, data.Frame.W, data.Frame.H, data.Frame.Stride) + p.wg.Add(1) + go p.saveFrame(fileName, data.Frame) +} + +func (p *rawStream) saveFrame(fileName string, frame Frame) { + file, err := os.Create(filepath.Join(p.dir, fileName)) + if err != nil { + log.Printf("c err: %v", err) + } + if _, err = file.Write(frame.Data); err != nil { + log.Printf("f err: %v", err) + } + + if err = file.Close(); err != nil { + log.Printf("fc err: %v", err) + } + p.wg.Done() +} + +func ExtractFileInfo(name string) (w, h, st string) { + s1 := strings.Split(name, "__") + if len(s1) > 1 { + s12 := strings.Split(s1[1], "x") + if len(s12) > 1 { + w, h = s12[0], s12[1] + } + s21 := strings.TrimSuffix(s1[2], filepath.Ext(s1[2])) + if s21 != "" { + st = s21 + } + } + return +} diff --git a/pkg/worker/recorder/recorder.go b/pkg/worker/recorder/recorder.go index 24edc4c8..4c3d1207 100644 --- a/pkg/worker/recorder/recorder.go +++ b/pkg/worker/recorder/recorder.go @@ -1,7 +1,6 @@ package recorder import ( - "image" "io" "math/rand" "os" @@ -60,9 +59,14 @@ type ( Duration time.Duration } Video struct { - Image image.Image + Frame Frame Duration time.Duration } + Frame struct { + Data []byte + Stride int + W, H int + } ) // NewRecording creates new media recorder for the emulator. @@ -96,7 +100,7 @@ func (r *Recording) Start() { r.log.Fatal().Err(err) } r.audio = audio - video, err := newPngStream(path, r.opts) + video, err := newRawStream(path) if err != nil { r.log.Fatal().Err(err) } diff --git a/pkg/worker/recorder/recorder_test.go b/pkg/worker/recorder/recorder_test.go index e4441749..8d2fa998 100644 --- a/pkg/worker/recorder/recorder_test.go +++ b/pkg/worker/recorder/recorder_test.go @@ -30,13 +30,12 @@ func TestName(t *testing.T) { Meta{UserName: "test"}, logger.Default(), Options{ - Dir: dir, - Fps: 60, - Frequency: 10, - Game: fmt.Sprintf("test_game_%v", rand.Int()), - ImageCompressionLevel: 0, - Name: "test", - Zip: false, + Dir: dir, + Fps: 60, + Frequency: 10, + Game: fmt.Sprintf("test_game_%v", rand.Int()), + Name: "test", + Zip: false, }) recorder.Set(true, "test_user") @@ -45,11 +44,11 @@ func TestName(t *testing.T) { var imgWg, audioWg sync.WaitGroup imgWg.Add(iterations) audioWg.Add(iterations) - img := generateImage(100, 100) + frame := genFrame(100, 100) for i := 0; i < 222; i++ { go func() { - recorder.WriteVideo(Video{Image: img, Duration: 16 * time.Millisecond}) + recorder.WriteVideo(Video{Frame: frame, Duration: 16 * time.Millisecond}) imgWg.Done() }() go func() { @@ -66,17 +65,14 @@ func TestName(t *testing.T) { } func BenchmarkNewRecording100x100(b *testing.B) { - benchmarkRecorder(100, 100, 0, b) + benchmarkRecorder(100, 100, b) } -func BenchmarkNewRecording320x240_compressed(b *testing.B) { - benchmarkRecorder(320, 240, 0, b) -} -func BenchmarkNewRecording320x240_nocompress(b *testing.B) { - benchmarkRecorder(320, 240, -1, b) +func BenchmarkNewRecording320x240(b *testing.B) { + benchmarkRecorder(320, 240, b) } -func benchmarkRecorder(w, h int, comp int, b *testing.B) { +func benchmarkRecorder(w, h int, b *testing.B) { b.StopTimer() dir, err := os.MkdirTemp("", "rec_bench_") @@ -89,8 +85,8 @@ func benchmarkRecorder(w, h int, comp int, b *testing.B) { } }() - image1 := generateImage(w, h) - image2 := generateImage(w, h) + frame1 := genFrame(w, h) + frame2 := genFrame(w, h) var bytes int64 = 0 @@ -103,25 +99,24 @@ func benchmarkRecorder(w, h int, comp int, b *testing.B) { Meta{UserName: "test"}, logger.Default(), Options{ - Dir: dir, - Fps: 60, - Frequency: 10, - Game: fmt.Sprintf("test_game_%v", rand.Int()), - ImageCompressionLevel: comp, - Name: "", - Zip: false, + Dir: dir, + Fps: 60, + Frequency: 10, + Game: fmt.Sprintf("test_game_%v", rand.Int()), + Name: "", + Zip: false, }) recorder.Set(true, "test_user") samples := []int16{0, 0, 0, 0, 0, 1, 11, 11, 11, 1} for i := 0; i < b.N; i++ { - im := image1 + f := frame1 if i%2 == 0 { - im = image2 + f = frame2 } go func() { - recorder.WriteVideo(Video{Image: im, Duration: 16 * time.Millisecond}) - atomic.AddInt64(&bytes, int64(len(im.(*image.RGBA).Pix))) + recorder.WriteVideo(Video{Frame: f, Duration: 16 * time.Millisecond}) + atomic.AddInt64(&bytes, int64(len(f.Data))) ticks.Done() }() go func() { @@ -137,14 +132,19 @@ func benchmarkRecorder(w, h int, comp int, b *testing.B) { } } -func generateImage(w, h int) image.Image { +func genFrame(w, h int) Frame { img := image.NewRGBA(image.Rect(0, 0, w, h)) for x := 0; x < w; x++ { for y := 0; y < h; y++ { img.Set(x, y, randomColor()) } } - return img + return Frame{ + Data: img.Pix, + Stride: img.Stride, + W: img.Bounds().Dx(), + H: img.Bounds().Dy(), + } } var rnd = rand.New(rand.NewSource(time.Now().Unix())) diff --git a/pkg/worker/room/room_test.go b/pkg/worker/room/room_test.go index 36bd25d4..ed67e48c 100644 --- a/pkg/worker/room/room_test.go +++ b/pkg/worker/room/room_test.go @@ -19,16 +19,20 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/com" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/encoder" + "github.com/giongto35/cloud-game/v3/pkg/encoder/color/bgra" + "github.com/giongto35/cloud-game/v3/pkg/encoder/color/rgb565" + "github.com/giongto35/cloud-game/v3/pkg/encoder/color/rgba" "github.com/giongto35/cloud-game/v3/pkg/games" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/caged" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" - canvas "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/image" "github.com/giongto35/cloud-game/v3/pkg/worker/media" "github.com/giongto35/cloud-game/v3/pkg/worker/thread" "golang.org/x/image/font" "golang.org/x/image/font/basicfont" "golang.org/x/image/math/fixed" + + _ "github.com/giongto35/cloud-game/v3/test" ) var ( @@ -58,13 +62,15 @@ func (r testRoom) Close() { time.Sleep(2 * time.Second) // hack: wait room destruction (atm impossible to tell) } -func (r testRoom) WaitFrames(n int) canvas.Frame { - var frame canvas.Frame +func (r testRoom) WaitFrame(n int) app.RawFrame { var wg sync.WaitGroup - wg.Add(n) + wg.Add(1) + target := app.RawFrame{} WithEmulator(r.app).SetVideoCb(func(v app.Video) { - if n > 0 { - frame = (&canvas.Frame{RGBA: v.Frame}).Copy() + if n == 1 { + target = v.Frame + target.Data = make([]byte, len(v.Frame.Data)) + copy(target.Data, v.Frame.Data) wg.Done() } n-- @@ -73,7 +79,7 @@ func (r testRoom) WaitFrames(n int) canvas.Frame { r.StartApp() } wg.Wait() - return frame + return target } type testParams struct { @@ -81,11 +87,11 @@ type testParams struct { game games.GameMetadata codecs []codec frames int + color int } // Store absolute path to test games var testTempDir = filepath.Join(os.TempDir(), "cloud-game-core-tests") -var root = "" // games var ( @@ -94,12 +100,6 @@ var ( fd = games.GameMetadata{Name: "Florian Demo", Type: "n64", Path: "Sample Demo by Florian (PD).z64", System: "n64"} ) -func init() { - runtime.LockOSThread() - p, _ := filepath.Abs("../../../") - root = p + string(filepath.Separator) -} - func TestMain(m *testing.M) { flag.BoolVar(&renderFrames, "renderFrames", false, "Render frames for eye testing purposes") flag.StringVar(&outputPath, "outputPath", "./", "Output path for generated files") @@ -115,40 +115,51 @@ func TestRoom(t *testing.T) { for _, test := range tests { room := room(conf{codec: test.codecs[0], game: test.game}) - room.WaitFrames(test.frames) + room.WaitFrame(test.frames) room.Close() } } func TestAll(t *testing.T) { tests := []testParams{ - {game: sushi, frames: 150}, - {game: alwas, frames: 50}, - {game: fd, frames: 50, system: "main-thread"}, + {game: sushi, frames: 150, color: 2}, + {game: alwas, frames: 50, color: 1}, + {game: fd, frames: 50, system: "gl", color: 1}, } crc32q := crc32.MakeTable(0xD5828281) for _, test := range tests { + var frame app.RawFrame room := room(conf{game: test.game, codec: encoder.VP8, autoGlContext: autoGlContext, autoAppStart: false}) - var frame canvas.Frame - if test.system == "main-thread" { - thread.Main(func() { - frame = room.WaitFrames(test.frames) - room.Close() - }) - } else { - frame = room.WaitFrames(test.frames) - room.Close() - } + flip := test.system == "gl" + thread.Main(func() { frame = room.WaitFrame(test.frames) }) + room.Close() + if renderFrames { - tag := fmt.Sprintf("%v-%v-0x%08x", runtime.GOOS, test.game.Type, crc32.Checksum(frame.Pix, crc32q)) - dumpCanvas(&frame, tag, fmt.Sprintf("%v [%v]", tag, test.frames), outputPath) + rect := image.Rect(0, 0, frame.W, frame.H) + var src image.Image + if test.color == 1 { + src1 := bgra.NewBGRA(rect) + src1.Pix = frame.Data + src1.Stride = frame.Stride + src = src1 + } else { + if test.color == 2 { + src1 := rgb565.NewRGB565(rect) + src1.Pix = frame.Data + src1.Stride = frame.Stride + src = src1 + } + } + dst := rgba.ToRGBA(src, flip) + tag := fmt.Sprintf("%v-%v-0x%08x", runtime.GOOS, test.game.Type, crc32.Checksum(frame.Data, crc32q)) + dumpCanvas(dst, tag, fmt.Sprintf("%v [%v]", tag, test.frames), outputPath) } } } -func dumpCanvas(frame *canvas.Frame, name string, caption string, path string) { +func dumpCanvas(frame *image.RGBA, name string, caption string, path string) { // slap 'em caption if caption != "" { draw.Draw(frame, image.Rect(8, 8, 8+len(caption)*7+3, 24), &image.Uniform{C: color.RGBA{}}, image.Point{}, draw.Src) @@ -187,16 +198,17 @@ func room(cfg conf) testRoom { panic(err) } - conf.Worker.Library.BasePath = filepath.FromSlash(root + "/assets/games") + conf.Emulator.Libretro.Cores.Repo.ExtLock = expand("tests", ".cr", "cloud-game.lock") + conf.Emulator.LocalPath = expand("tests", conf.Emulator.LocalPath) + conf.Emulator.Storage = expand("tests", "storage") + + conf.Encoder.Video.Codec = string(cfg.codec) - fixEmulators(&conf, cfg.autoGlContext) l := logger.NewConsole(conf.Worker.Debug, "w", false) if cfg.noLog { logger.SetGlobalLevel(logger.Disabled) } - conf.Encoder.Video.Codec = string(cfg.codec) - id := cfg.roomName if id == "" { id = games.GenerateRoomID(cfg.game.Name) @@ -218,6 +230,7 @@ func room(cfg conf) testRoom { m.AudioSrcHz = emu.AudioSampleRate() m.AudioFrame = conf.Encoder.Audio.Frame m.VideoW, m.VideoH = emu.ViewportSize() + m.VideoScale = emu.Scale() if err := m.Init(); err != nil { l.Fatal().Err(err).Msgf("no init") } @@ -230,22 +243,6 @@ func room(cfg conf) testRoom { return testRoom{Room: room, started: cfg.autoAppStart} } -// fixEmulators makes absolute game paths in global GameList and passes GL context config. -// hack: emulator paths should be absolute and visible to the tests. -func fixEmulators(config *config.WorkerConfig, autoGlContext bool) { - config.Emulator.Libretro.Cores.Paths.Libs = - filepath.FromSlash(root + config.Emulator.Libretro.Cores.Paths.Libs) - config.Emulator.LocalPath = filepath.FromSlash(filepath.Join(root, "tests", config.Emulator.LocalPath)) - config.Emulator.Storage = filepath.FromSlash(filepath.Join(root, "tests", "storage")) - - for k, conf := range config.Emulator.Libretro.Cores.List { - if conf.IsGlAllowed && autoGlContext { - conf.AutoGlContext = true - } - config.Emulator.Libretro.Cores.List[k] = conf - } -} - // Measures emulation performance of various // emulators and encoding options. func BenchmarkRoom(b *testing.B) { @@ -263,7 +260,7 @@ func BenchmarkRoom(b *testing.B) { b.StopTimer() room := room(conf{game: bench.game, codec: cod, noLog: true}) b.StartTimer() - room.WaitFrames(bench.frames) + room.WaitFrame(bench.frames) b.StopTimer() room.Room.Close() } @@ -299,3 +296,9 @@ func TestRouter(t *testing.T) { router.SetRoom(nil) router.Close() } + +// expand joins a list of file path elements. +func expand(p ...string) string { + ph, _ := filepath.Abs(filepath.FromSlash(filepath.Join(p...))) + return ph +} diff --git a/pkg/worker/thread/mainthread_darwin_test.go b/pkg/worker/thread/mainthread_darwin_test.go index bab4a92c..15ce9328 100644 --- a/pkg/worker/thread/mainthread_darwin_test.go +++ b/pkg/worker/thread/mainthread_darwin_test.go @@ -1,16 +1,14 @@ package thread -import "testing" +import ( + "os" + "testing" +) -func init() { - runtime.LockOSThread() +func TestMain(m *testing.M) { + Wrap(func() { os.Exit(m.Run()) }) } func TestMainThread(t *testing.T) { - value := 0 - fn := func() { value = 1 } - Main(fn) - if value != 1 { - t.Errorf("wrong value %v", value) - } + _ = 10 } diff --git a/test/test.go b/test/test.go new file mode 100644 index 00000000..b80b425a --- /dev/null +++ b/test/test.go @@ -0,0 +1,17 @@ +package test + +import ( + "os" + "path" + "runtime" +) + +// runs tests from the root dir when imported + +func init() { + _, filename, _, _ := runtime.Caller(0) + dir := path.Join(path.Dir(filename), "..") + if err := os.Chdir(dir); err != nil { + panic(err) + } +} diff --git a/test/testdata/raw/000_name_fourcc_width_height_stride b/test/testdata/raw/000_name_fourcc_width_height_stride new file mode 100644 index 00000000..e69de29b diff --git a/test/testdata/raw/001_alsa_ABGR_256_240_1024.raw.zip b/test/testdata/raw/001_alsa_ABGR_256_240_1024.raw.zip new file mode 100644 index 0000000000000000000000000000000000000000..a85e7d7bf96eb111c7ba530a210bd2b8a4a034c1 GIT binary patch literal 3748 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 Date: Mon, 16 Oct 2023 00:02:16 +0300 Subject: [PATCH 108/361] Use static libyuv for macs --- .github/workflows/build.yml | 2 +- Makefile | 2 +- README.md | 2 +- pkg/encoder/yuv/libyuv/LICENSE | 29 - pkg/encoder/yuv/libyuv/basic_types.h | 29 - pkg/encoder/yuv/libyuv/convert.c | 336 --- pkg/encoder/yuv/libyuv/convert.h | 113 - pkg/encoder/yuv/libyuv/convert_argb.h | 24 - pkg/encoder/yuv/libyuv/convert_to_i420.c | 116 - pkg/encoder/yuv/libyuv/cpu_id.c | 204 -- pkg/encoder/yuv/libyuv/cpu_id.h | 106 - pkg/encoder/yuv/libyuv/libyuv.go | 49 +- pkg/encoder/yuv/libyuv/libyuv2.go | 89 - pkg/encoder/yuv/libyuv/libyuv_darwin_arm64.a | Bin 0 -> 486312 bytes pkg/encoder/yuv/libyuv/libyuv_darwin_x86_64.a | Bin 0 -> 669112 bytes pkg/encoder/yuv/libyuv/planar_functions.c | 68 - pkg/encoder/yuv/libyuv/planar_functions.h | 46 - pkg/encoder/yuv/libyuv/rotate.c | 217 -- pkg/encoder/yuv/libyuv/rotate.h | 79 - pkg/encoder/yuv/libyuv/rotate_any.c | 54 - pkg/encoder/yuv/libyuv/rotate_common.c | 77 - pkg/encoder/yuv/libyuv/rotate_gcc.c | 370 --- pkg/encoder/yuv/libyuv/rotate_row.h | 106 - pkg/encoder/yuv/libyuv/row.h | 426 --- pkg/encoder/yuv/libyuv/row_any.c | 206 -- pkg/encoder/yuv/libyuv/row_common.c | 887 ------ pkg/encoder/yuv/libyuv/row_gcc.c | 1090 ------- pkg/encoder/yuv/libyuv/scale.c | 946 ------ pkg/encoder/yuv/libyuv/scale.h | 53 - pkg/encoder/yuv/libyuv/scale_any.c | 632 ---- pkg/encoder/yuv/libyuv/scale_common.c | 930 ------ pkg/encoder/yuv/libyuv/scale_gcc.c | 2651 ----------------- pkg/encoder/yuv/libyuv/scale_row.h | 768 ----- pkg/encoder/yuv/libyuv/version.h | 16 - pkg/encoder/yuv/libyuv/video_common.c | 50 - pkg/encoder/yuv/libyuv/video_common.h | 212 -- pkg/encoder/yuv/yuv_test.go | 3 + 37 files changed, 45 insertions(+), 10943 deletions(-) delete mode 100644 pkg/encoder/yuv/libyuv/LICENSE delete mode 100644 pkg/encoder/yuv/libyuv/basic_types.h delete mode 100644 pkg/encoder/yuv/libyuv/convert.c delete mode 100644 pkg/encoder/yuv/libyuv/convert.h delete mode 100644 pkg/encoder/yuv/libyuv/convert_argb.h delete mode 100644 pkg/encoder/yuv/libyuv/convert_to_i420.c delete mode 100644 pkg/encoder/yuv/libyuv/cpu_id.c delete mode 100644 pkg/encoder/yuv/libyuv/cpu_id.h delete mode 100644 pkg/encoder/yuv/libyuv/libyuv2.go create mode 100644 pkg/encoder/yuv/libyuv/libyuv_darwin_arm64.a create mode 100644 pkg/encoder/yuv/libyuv/libyuv_darwin_x86_64.a delete mode 100644 pkg/encoder/yuv/libyuv/planar_functions.c delete mode 100644 pkg/encoder/yuv/libyuv/planar_functions.h delete mode 100644 pkg/encoder/yuv/libyuv/rotate.c delete mode 100644 pkg/encoder/yuv/libyuv/rotate.h delete mode 100644 pkg/encoder/yuv/libyuv/rotate_any.c delete mode 100644 pkg/encoder/yuv/libyuv/rotate_common.c delete mode 100644 pkg/encoder/yuv/libyuv/rotate_gcc.c delete mode 100644 pkg/encoder/yuv/libyuv/rotate_row.h delete mode 100644 pkg/encoder/yuv/libyuv/row.h delete mode 100644 pkg/encoder/yuv/libyuv/row_any.c delete mode 100644 pkg/encoder/yuv/libyuv/row_common.c delete mode 100644 pkg/encoder/yuv/libyuv/row_gcc.c delete mode 100644 pkg/encoder/yuv/libyuv/scale.c delete mode 100644 pkg/encoder/yuv/libyuv/scale.h delete mode 100644 pkg/encoder/yuv/libyuv/scale_any.c delete mode 100644 pkg/encoder/yuv/libyuv/scale_common.c delete mode 100644 pkg/encoder/yuv/libyuv/scale_gcc.c delete mode 100644 pkg/encoder/yuv/libyuv/scale_row.h delete mode 100644 pkg/encoder/yuv/libyuv/version.h delete mode 100644 pkg/encoder/yuv/libyuv/video_common.c delete mode 100644 pkg/encoder/yuv/libyuv/video_common.h diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index ccae921f..4da180c5 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -38,7 +38,7 @@ jobs: - name: Get MacOS dev libraries and tools if: matrix.os == 'macos-latest' run: | - brew install pkg-config libvpx x264 opus sdl2 + brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo - name: Get Windows dev libraries and tools if: matrix.os == 'windows-latest' diff --git a/Makefile b/Makefile index f0afe6ad..748aa595 100644 --- a/Makefile +++ b/Makefile @@ -38,7 +38,7 @@ test: go test -v ./pkg/... verify-cores: - go test -run TestAll ./pkg/worker/room -v -renderFrames $(GL_CTX) -outputPath "../../../_rendered" + go test -run TestAll ./pkg/worker/room -v -renderFrames $(GL_CTX) -outputPath "./_rendered" dev.build: compile build diff --git a/README.md b/README.md index b3f181c3..d1d837ad 100644 --- a/README.md +++ b/README.md @@ -64,7 +64,7 @@ a better sense of performance. apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev # MacOS -brew install pkg-config libvpx x264 opus sdl2 +brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo # Windows (MSYS2) pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,x264-git,SDL2,libyuv} diff --git a/pkg/encoder/yuv/libyuv/LICENSE b/pkg/encoder/yuv/libyuv/LICENSE deleted file mode 100644 index c911747a..00000000 --- a/pkg/encoder/yuv/libyuv/LICENSE +++ /dev/null @@ -1,29 +0,0 @@ -Copyright 2011 The LibYuv Project Authors. All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are -met: - - * Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - * Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in - the documentation and/or other materials provided with the - distribution. - - * Neither the name of Google nor the names of its contributors may - be used to endorse or promote products derived from this software - without specific prior written permission. - -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/pkg/encoder/yuv/libyuv/basic_types.h b/pkg/encoder/yuv/libyuv/basic_types.h deleted file mode 100644 index 9c66a132..00000000 --- a/pkg/encoder/yuv/libyuv/basic_types.h +++ /dev/null @@ -1,29 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_BASIC_TYPES_H_ -#define INCLUDE_LIBYUV_BASIC_TYPES_H_ - -#include // For size_t and NULL - -#if !defined(INT_TYPES_DEFINED) && !defined(GG_LONGLONG) -#define INT_TYPES_DEFINED - -#include // for uintptr_t and C99 types - -#endif // INT_TYPES_DEFINED - -#if !defined(LIBYUV_API) -#define LIBYUV_API -#endif // LIBYUV_API - -#define LIBYUV_BOOL int - -#endif // INCLUDE_LIBYUV_BASIC_TYPES_H_ diff --git a/pkg/encoder/yuv/libyuv/convert.c b/pkg/encoder/yuv/libyuv/convert.c deleted file mode 100644 index c59da3b1..00000000 --- a/pkg/encoder/yuv/libyuv/convert.c +++ /dev/null @@ -1,336 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "convert.h" - -#include "basic_types.h" -#include "cpu_id.h" -#include "planar_functions.h" -#include "row.h" - -// Subsample amount uses a shift. -// v is value -// a is amount to add to round up -// s is shift to subsample down -#define SUBSAMPLE(v, a, s) (v < 0) ? (-((-v + a) >> s)) : ((v + a) >> s) - -static __inline int Abs(int v) { - return v >= 0 ? v : -v; -} - -// Copy I420 with optional flipping. -// TODO(fbarchard): Use Scale plane which supports mirroring, but ensure -// is does row coalescing. -LIBYUV_API -int I420Copy(const uint8_t *src_y, - int src_stride_y, - const uint8_t *src_u, - int src_stride_u, - const uint8_t *src_v, - int src_stride_v, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height) { - int halfwidth = (width + 1) >> 1; - int halfheight = (height + 1) >> 1; - if ((!src_y && dst_y) || !src_u || !src_v || !dst_u || !dst_v || width <= 0 || - height == 0) { - return -1; - } - // Negative height means invert the image. - if (height < 0) { - height = -height; - halfheight = (height + 1) >> 1; - src_y = src_y + (height - 1) * src_stride_y; - src_u = src_u + (halfheight - 1) * src_stride_u; - src_v = src_v + (halfheight - 1) * src_stride_v; - src_stride_y = -src_stride_y; - src_stride_u = -src_stride_u; - src_stride_v = -src_stride_v; - } - - if (dst_y) { - CopyPlane(src_y, src_stride_y, dst_y, dst_stride_y, width, height); - } - // Copy UV planes. - CopyPlane(src_u, src_stride_u, dst_u, dst_stride_u, halfwidth, halfheight); - CopyPlane(src_v, src_stride_v, dst_v, dst_stride_v, halfwidth, halfheight); - return 0; -} - -// Convert ARGB to I420. -LIBYUV_API -int ARGBToI420(const uint8_t *src_argb, - int src_stride_argb, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height) { - int y; - void (*ARGBToUVRow)(const uint8_t *src_argb0, int src_stride_argb, - uint8_t *dst_u, uint8_t *dst_v, int width) = - ARGBToUVRow_C; - void (*ARGBToYRow)(const uint8_t *src_argb, uint8_t *dst_y, int width) = - ARGBToYRow_C; - if (!src_argb || !dst_y || !dst_u || !dst_v || width <= 0 || height == 0) { - return -1; - } - // Negative height means invert the image. - if (height < 0) { - height = -height; - src_argb = src_argb + (height - 1) * src_stride_argb; - src_stride_argb = -src_stride_argb; - } -#if defined(HAS_ARGBTOYROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - ARGBToYRow = ARGBToYRow_Any_SSSE3; - if (IS_ALIGNED(width, 16)) { - ARGBToYRow = ARGBToYRow_SSSE3; - } - } -#endif -#if defined(HAS_ARGBTOUVROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - ARGBToUVRow = ARGBToUVRow_Any_SSSE3; - if (IS_ALIGNED(width, 16)) { - ARGBToUVRow = ARGBToUVRow_SSSE3; - } - } -#endif -#if defined(HAS_ARGBTOYROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ARGBToYRow = ARGBToYRow_Any_AVX2; - if (IS_ALIGNED(width, 32)) { - ARGBToYRow = ARGBToYRow_AVX2; - } - } -#endif -#if defined(HAS_ARGBTOUVROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ARGBToUVRow = ARGBToUVRow_Any_AVX2; - if (IS_ALIGNED(width, 32)) { - ARGBToUVRow = ARGBToUVRow_AVX2; - } - } -#endif - - for (y = 0; y < height - 1; y += 2) { - ARGBToUVRow(src_argb, src_stride_argb, dst_u, dst_v, width); - ARGBToYRow(src_argb, dst_y, width); - ARGBToYRow(src_argb + src_stride_argb, dst_y + dst_stride_y, width); - src_argb += src_stride_argb * 2; - dst_y += dst_stride_y * 2; - dst_u += dst_stride_u; - dst_v += dst_stride_v; - } - if (height & 1) { - ARGBToUVRow(src_argb, 0, dst_u, dst_v, width); - ARGBToYRow(src_argb, dst_y, width); - } - return 0; -} - -// Convert ABGR to I420. -LIBYUV_API -int ABGRToI420(const uint8_t *src_abgr, - int src_stride_abgr, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height) { - int y; - void (*ABGRToUVRow)(const uint8_t *src_abgr0, int src_stride_abgr, - uint8_t *dst_u, uint8_t *dst_v, int width) = - ABGRToUVRow_C; - void (*ABGRToYRow)(const uint8_t *src_abgr, uint8_t *dst_y, int width) = - ABGRToYRow_C; - if (!src_abgr || !dst_y || !dst_u || !dst_v || width <= 0 || height == 0) { - return -1; - } - // Negative height means invert the image. - if (height < 0) { - height = -height; - src_abgr = src_abgr + (height - 1) * src_stride_abgr; - src_stride_abgr = -src_stride_abgr; - } -#if defined(HAS_ABGRTOYROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - ABGRToYRow = ABGRToYRow_Any_SSSE3; - if (IS_ALIGNED(width, 16)) { - ABGRToYRow = ABGRToYRow_SSSE3; - } - } -#endif -#if defined(HAS_ABGRTOUVROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - ABGRToUVRow = ABGRToUVRow_Any_SSSE3; - if (IS_ALIGNED(width, 16)) { - ABGRToUVRow = ABGRToUVRow_SSSE3; - } - } -#endif -#if defined(HAS_ABGRTOYROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ABGRToYRow = ABGRToYRow_Any_AVX2; - if (IS_ALIGNED(width, 32)) { - ABGRToYRow = ABGRToYRow_AVX2; - } - } -#endif -#if defined(HAS_ABGRTOUVROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ABGRToUVRow = ABGRToUVRow_Any_AVX2; - if (IS_ALIGNED(width, 32)) { - ABGRToUVRow = ABGRToUVRow_AVX2; - } - } -#endif - - for (y = 0; y < height - 1; y += 2) { - ABGRToUVRow(src_abgr, src_stride_abgr, dst_u, dst_v, width); - ABGRToYRow(src_abgr, dst_y, width); - ABGRToYRow(src_abgr + src_stride_abgr, dst_y + dst_stride_y, width); - src_abgr += src_stride_abgr * 2; - dst_y += dst_stride_y * 2; - dst_u += dst_stride_u; - dst_v += dst_stride_v; - } - if (height & 1) { - ABGRToUVRow(src_abgr, 0, dst_u, dst_v, width); - ABGRToYRow(src_abgr, dst_y, width); - } - return 0; -} - -// Convert RGB565 to I420. -LIBYUV_API -int RGB565ToI420(const uint8_t *src_rgb565, - int src_stride_rgb565, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height) { - int y; - void (*RGB565ToARGBRow)(const uint8_t *src_rgb, uint8_t *dst_argb, - int width) = RGB565ToARGBRow_C; - void (*ARGBToUVRow)(const uint8_t *src_argb0, int src_stride_argb, - uint8_t *dst_u, uint8_t *dst_v, int width) = - ARGBToUVRow_C; - void (*ARGBToYRow)(const uint8_t *src_argb, uint8_t *dst_y, int width) = - ARGBToYRow_C; - if (!src_rgb565 || !dst_y || !dst_u || !dst_v || width <= 0 || height == 0) { - return -1; - } - // Negative height means invert the image. - if (height < 0) { - height = -height; - src_rgb565 = src_rgb565 + (height - 1) * src_stride_rgb565; - src_stride_rgb565 = -src_stride_rgb565; - } - -#if defined(HAS_RGB565TOARGBROW_SSE2) - if (TestCpuFlag(kCpuHasSSE2)) { - RGB565ToARGBRow = RGB565ToARGBRow_Any_SSE2; - if (IS_ALIGNED(width, 8)) { - RGB565ToARGBRow = RGB565ToARGBRow_SSE2; - } - } -#endif -#if defined(HAS_RGB565TOARGBROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - RGB565ToARGBRow = RGB565ToARGBRow_Any_AVX2; - if (IS_ALIGNED(width, 16)) { - RGB565ToARGBRow = RGB565ToARGBRow_AVX2; - } - } -#endif -#if defined(HAS_ARGBTOYROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - ARGBToYRow = ARGBToYRow_Any_SSSE3; - if (IS_ALIGNED(width, 16)) { - ARGBToYRow = ARGBToYRow_SSSE3; - } - } -#endif -#if defined(HAS_ARGBTOUVROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - ARGBToUVRow = ARGBToUVRow_Any_SSSE3; - if (IS_ALIGNED(width, 16)) { - ARGBToUVRow = ARGBToUVRow_SSSE3; - } - } -#endif -#if defined(HAS_ARGBTOYROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ARGBToYRow = ARGBToYRow_Any_AVX2; - if (IS_ALIGNED(width, 32)) { - ARGBToYRow = ARGBToYRow_AVX2; - } - } -#endif -#if defined(HAS_ARGBTOUVROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ARGBToUVRow = ARGBToUVRow_Any_AVX2; - if (IS_ALIGNED(width, 32)) { - ARGBToUVRow = ARGBToUVRow_AVX2; - } - } -#endif - { -#if !(defined(HAS_RGB565TOYROW_NEON)) - // Allocate 2 rows of ARGB. - const int row_size = (width * 4 + 31) & ~31; - align_buffer_64(row, row_size * 2); -#endif - for (y = 0; y < height - 1; y += 2) { -#if (defined(HAS_RGB565TOYROW_NEON)) -#else - RGB565ToARGBRow(src_rgb565, row, width); - RGB565ToARGBRow(src_rgb565 + src_stride_rgb565, row + row_size, width); - ARGBToUVRow(row, row_size, dst_u, dst_v, width); - ARGBToYRow(row, dst_y, width); - ARGBToYRow(row + row_size, dst_y + dst_stride_y, width); -#endif - src_rgb565 += src_stride_rgb565 * 2; - dst_y += dst_stride_y * 2; - dst_u += dst_stride_u; - dst_v += dst_stride_v; - } - if (height & 1) { -#if (defined(HAS_RGB565TOYROW_NEON)) -#else - RGB565ToARGBRow(src_rgb565, row, width); - ARGBToUVRow(row, 0, dst_u, dst_v, width); - ARGBToYRow(row, dst_y, width); -#endif - } -#if !(defined(HAS_RGB565TOYROW_NEON)) - free_aligned_buffer_64(row); -#endif - } - return 0; -} diff --git a/pkg/encoder/yuv/libyuv/convert.h b/pkg/encoder/yuv/libyuv/convert.h deleted file mode 100644 index 9a81c509..00000000 --- a/pkg/encoder/yuv/libyuv/convert.h +++ /dev/null @@ -1,113 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_CONVERT_H_ -#define INCLUDE_LIBYUV_CONVERT_H_ - -#include "rotate.h" // For enum RotationMode. - -// Copy I420 to I420. -#define I420ToI420 I420Copy -LIBYUV_API -int I420Copy(const uint8_t *src_y, - int src_stride_y, - const uint8_t *src_u, - int src_stride_u, - const uint8_t *src_v, - int src_stride_v, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height); - -// ARGB little endian (bgra in memory) to I420. -LIBYUV_API -int ARGBToI420(const uint8_t *src_argb, - int src_stride_argb, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height); - -// ABGR little endian (rgba in memory) to I420. -LIBYUV_API -int ABGRToI420(const uint8_t *src_abgr, - int src_stride_abgr, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height); - -// RGB16 (RGBP fourcc) little endian to I420. -LIBYUV_API -int RGB565ToI420(const uint8_t *src_rgb565, - int src_stride_rgb565, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height); - -// Convert camera sample to I420 with cropping, rotation and vertical flip. -// "src_size" is needed to parse MJPG. -// "dst_stride_y" number of bytes in a row of the dst_y plane. -// Normally this would be the same as dst_width, with recommended alignment -// to 16 bytes for better efficiency. -// If rotation of 90 or 270 is used, stride is affected. The caller should -// allocate the I420 buffer according to rotation. -// "dst_stride_u" number of bytes in a row of the dst_u plane. -// Normally this would be the same as (dst_width + 1) / 2, with -// recommended alignment to 16 bytes for better efficiency. -// If rotation of 90 or 270 is used, stride is affected. -// "crop_x" and "crop_y" are starting position for cropping. -// To center, crop_x = (src_width - dst_width) / 2 -// crop_y = (src_height - dst_height) / 2 -// "src_width" / "src_height" is size of src_frame in pixels. -// "src_height" can be negative indicating a vertically flipped image source. -// "crop_width" / "crop_height" is the size to crop the src to. -// Must be less than or equal to src_width/src_height -// Cropping parameters are pre-rotation. -// "rotation" can be 0, 90, 180 or 270. -// "fourcc" is a fourcc. ie 'I420', 'YUY2' -// Returns 0 for successful; -1 for invalid parameter. Non-zero for failure. -LIBYUV_API -int ConvertToI420(const uint8_t *sample, - size_t sample_size, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int crop_x, - int crop_y, - int src_width, - int src_height, - int crop_width, - int crop_height, - enum RotationMode rotation, - uint32_t fourcc); - -#endif // INCLUDE_LIBYUV_CONVERT_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/convert_argb.h b/pkg/encoder/yuv/libyuv/convert_argb.h deleted file mode 100644 index ac8e9716..00000000 --- a/pkg/encoder/yuv/libyuv/convert_argb.h +++ /dev/null @@ -1,24 +0,0 @@ -/* - * Copyright 2012 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_CONVERT_ARGB_H_ -#define INCLUDE_LIBYUV_CONVERT_ARGB_H_ - -#include "basic_types.h" - -// Conversion matrix for YVU to BGR -LIBYUV_API extern const struct YuvConstants kYvuI601Constants; // BT.601 -LIBYUV_API extern const struct YuvConstants kYvuJPEGConstants; // BT.601 full -LIBYUV_API extern const struct YuvConstants kYvuH709Constants; // BT.709 -LIBYUV_API extern const struct YuvConstants kYvuF709Constants; // BT.709 full -LIBYUV_API extern const struct YuvConstants kYvu2020Constants; // BT.2020 -LIBYUV_API extern const struct YuvConstants kYvuV2020Constants; // BT.2020 full - -#endif // INCLUDE_LIBYUV_CONVERT_ARGB_H_ diff --git a/pkg/encoder/yuv/libyuv/convert_to_i420.c b/pkg/encoder/yuv/libyuv/convert_to_i420.c deleted file mode 100644 index 84802142..00000000 --- a/pkg/encoder/yuv/libyuv/convert_to_i420.c +++ /dev/null @@ -1,116 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include - -#include "convert.h" -#include "video_common.h" - -// Convert camera sample to I420 with cropping, rotation and vertical flip. -// src_width is used for source stride computation -// src_height is used to compute location of planes, and indicate inversion -// sample_size is measured in bytes and is the size of the frame. -// With MJPEG it is the compressed size of the frame. -LIBYUV_API -int ConvertToI420(const uint8_t *sample, - size_t sample_size, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int crop_x, - int crop_y, - int src_width, - int src_height, - int crop_width, - int crop_height, - enum RotationMode rotation, - uint32_t fourcc) { - uint32_t format = CanonicalFourCC(fourcc); - const uint8_t *src; - // TODO(nisse): Why allow crop_height < 0? - const int abs_crop_height = (crop_height < 0) ? -crop_height : crop_height; - int r = 0; - LIBYUV_BOOL need_buf = - (rotation && format != FOURCC_I420 && format != FOURCC_NV12 && - format != FOURCC_NV21 && format != FOURCC_YV12) || - dst_y == sample; - uint8_t *tmp_y = dst_y; - uint8_t *tmp_u = dst_u; - uint8_t *tmp_v = dst_v; - int tmp_y_stride = dst_stride_y; - int tmp_u_stride = dst_stride_u; - int tmp_v_stride = dst_stride_v; - uint8_t *rotate_buffer = NULL; - const int inv_crop_height = - (src_height < 0) ? -abs_crop_height : abs_crop_height; - - if (!dst_y || !dst_u || !dst_v || !sample || src_width <= 0 || - crop_width <= 0 || src_height == 0 || crop_height == 0) { - return -1; - } - - // One pass rotation is available for some formats. For the rest, convert - // to I420 (with optional vertical flipping) into a temporary I420 buffer, - // and then rotate the I420 to the final destination buffer. - // For in-place conversion, if destination dst_y is same as source sample, - // also enable temporary buffer. - if (need_buf) { - int y_size = crop_width * abs_crop_height; - int uv_size = ((crop_width + 1) / 2) * ((abs_crop_height + 1) / 2); - rotate_buffer = (uint8_t *) malloc(y_size + uv_size * 2); /* NOLINT */ - if (!rotate_buffer) { - return 1; // Out of memory runtime error. - } - dst_y = rotate_buffer; - dst_u = dst_y + y_size; - dst_v = dst_u + uv_size; - dst_stride_y = crop_width; - dst_stride_u = dst_stride_v = ((crop_width + 1) / 2); - } - - switch (format) { - // Single plane formats - case FOURCC_RGBP: - src = sample + (src_width * crop_y + crop_x) * 2; - r = RGB565ToI420(src, src_width * 2, dst_y, dst_stride_y, dst_u, - dst_stride_u, dst_v, dst_stride_v, crop_width, - inv_crop_height); - break; - case FOURCC_ARGB: - src = sample + (src_width * crop_y + crop_x) * 4; - r = ARGBToI420(src, src_width * 4, dst_y, dst_stride_y, dst_u, - dst_stride_u, dst_v, dst_stride_v, crop_width, - inv_crop_height); - break; - case FOURCC_ABGR: - src = sample + (src_width * crop_y + crop_x) * 4; - r = ABGRToI420(src, src_width * 4, dst_y, dst_stride_y, dst_u, - dst_stride_u, dst_v, dst_stride_v, crop_width, - inv_crop_height); - break; - default: - r = -1; // unknown fourcc - return failure code. - } - - if (need_buf) { - if (!r) { - r = I420Rotate(dst_y, dst_stride_y, dst_u, dst_stride_u, dst_v, - dst_stride_v, tmp_y, tmp_y_stride, tmp_u, tmp_u_stride, - tmp_v, tmp_v_stride, crop_width, abs_crop_height, - rotation); - } - free(rotate_buffer); - } - - return r; -} diff --git a/pkg/encoder/yuv/libyuv/cpu_id.c b/pkg/encoder/yuv/libyuv/cpu_id.c deleted file mode 100644 index 166057de..00000000 --- a/pkg/encoder/yuv/libyuv/cpu_id.c +++ /dev/null @@ -1,204 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "cpu_id.h" - -#if !defined(__pnacl__) && !defined(__CLR_VER) && \ - !defined(__native_client__) && (defined(_M_IX86) || defined(_M_X64)) && \ - defined(_MSC_FULL_VER) && (_MSC_FULL_VER >= 160040219) -#include // For _xgetbv() -#endif - -// For ArmCpuCaps() but unittested on all platforms -#include // For fopen() -#include - -// For functions that use the stack and have runtime checks for overflow, -// use SAFEBUFFERS to avoid additional check. -#define SAFEBUFFERS - -// cpu_info_ variable for SIMD instruction sets detected. -LIBYUV_API int cpu_info_ = 0; - -// Low level cpuid for X86. -#if (defined(_M_IX86) || defined(_M_X64) || defined(__i386__) || \ - defined(__x86_64__)) && \ - !defined(__pnacl__) && !defined(__CLR_VER) -LIBYUV_API -void CpuId(int info_eax, int info_ecx, int *cpu_info) { -#if defined(_MSC_VER) - // GCC version uses inline x86 assembly. -#else // defined(_MSC_VER) - int info_ebx, info_edx; - asm volatile( -#if defined(__i386__) && defined(__PIC__) - // Preserve ebx for fpic 32 bit. - "mov %%ebx, %%edi \n" - "cpuid \n" - "xchg %%edi, %%ebx \n" - : "=D"(info_ebx), -#else - "cpuid \n" - : "=b"(info_ebx), -#endif // defined( __i386__) && defined(__PIC__) - "+a"(info_eax), "+c"(info_ecx), "=d"(info_edx)); - cpu_info[0] = info_eax; - cpu_info[1] = info_ebx; - cpu_info[2] = info_ecx; - cpu_info[3] = info_edx; -#endif // defined(_MSC_VER) -} - -#else // (defined(_M_IX86) || defined(_M_X64) ... -LIBYUV_API -void CpuId(int eax, int ecx, int* cpu_info) { - (void)eax; - (void)ecx; - cpu_info[0] = cpu_info[1] = cpu_info[2] = cpu_info[3] = 0; -} -#endif - -// For VS2010 and earlier emit can be used: -// _asm _emit 0x0f _asm _emit 0x01 _asm _emit 0xd0 // For VS2010 and earlier. -// __asm { -// xor ecx, ecx // xcr 0 -// xgetbv -// mov xcr0, eax -// } -// For VS2013 and earlier 32 bit, the _xgetbv(0) optimizer produces bad code. -// https://code.google.com/p/libyuv/issues/detail?id=529 -#if defined(_M_IX86) && defined(_MSC_VER) && (_MSC_VER < 1900) -#pragma optimize("g", off) -#endif -#if (defined(_M_IX86) || defined(_M_X64) || defined(__i386__) || \ - defined(__x86_64__)) && \ - !defined(__pnacl__) && !defined(__CLR_VER) && !defined(__native_client__) - -// X86 CPUs have xgetbv to detect OS saves high parts of ymm registers. -static int GetXCR0() { - int xcr0 = 0; -#if defined(__i386__) || defined(__x86_64__) - asm(".byte 0x0f, 0x01, 0xd0" : "=a"(xcr0) : "c"(0) : "%edx"); -#endif // defined(__i386__) || defined(__x86_64__) - return xcr0; -} - -#else -// xgetbv unavailable to query for OSSave support. Return 0. -#define GetXCR0() 0 -#endif // defined(_M_IX86) || defined(_M_X64) .. -// Return optimization to previous setting. -#if defined(_M_IX86) && defined(_MSC_VER) && (_MSC_VER < 1900) -#pragma optimize("g", on) -#endif - -// Based on libvpx arm_cpudetect.c -// For Arm, but public to allow testing on any CPU -LIBYUV_API SAFEBUFFERS int ArmCpuCaps(const char *cpuinfo_name) { - char cpuinfo_line[512]; - FILE *f = fopen(cpuinfo_name, "re"); - if (!f) { - // Assume Neon if /proc/cpuinfo is unavailable. - // This will occur for Chrome sandbox for Pepper or Render process. - return kCpuHasNEON; - } - memset(cpuinfo_line, 0, sizeof(cpuinfo_line)); - while (fgets(cpuinfo_line, sizeof(cpuinfo_line), f)) { - if (memcmp(cpuinfo_line, "Features", 8) == 0) { - char *p = strstr(cpuinfo_line, " neon"); - if (p && (p[5] == ' ' || p[5] == '\n')) { - fclose(f); - return kCpuHasNEON; - } - // aarch64 uses asimd for Neon. - p = strstr(cpuinfo_line, " asimd"); - if (p) { - fclose(f); - return kCpuHasNEON; - } - } - } - fclose(f); - return 0; -} - -static SAFEBUFFERS int GetCpuFlags(void) { - int cpu_info = 0; -#if !defined(__pnacl__) && !defined(__CLR_VER) && \ - (defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || \ - defined(_M_IX86)) - int cpu_info0[4] = {0, 0, 0, 0}; - int cpu_info1[4] = {0, 0, 0, 0}; - int cpu_info7[4] = {0, 0, 0, 0}; - CpuId(0, 0, cpu_info0); - CpuId(1, 0, cpu_info1); - if (cpu_info0[0] >= 7) { - CpuId(7, 0, cpu_info7); - } - cpu_info = kCpuHasX86 | ((cpu_info1[3] & 0x04000000) ? kCpuHasSSE2 : 0) | - ((cpu_info1[2] & 0x00000200) ? kCpuHasSSSE3 : 0) | - ((cpu_info1[2] & 0x00080000) ? kCpuHasSSE41 : 0) | - ((cpu_info1[2] & 0x00100000) ? kCpuHasSSE42 : 0) | - ((cpu_info7[1] & 0x00000200) ? kCpuHasERMS : 0); - - // AVX requires OS saves YMM registers. - if (((cpu_info1[2] & 0x1c000000) == 0x1c000000) && // AVX and OSXSave - ((GetXCR0() & 6) == 6)) { // Test OS saves YMM registers - cpu_info |= kCpuHasAVX | ((cpu_info7[1] & 0x00000020) ? kCpuHasAVX2 : 0) | - ((cpu_info1[2] & 0x00001000) ? kCpuHasFMA3 : 0) | - ((cpu_info1[2] & 0x20000000) ? kCpuHasF16C : 0); - - // Detect AVX512bw - if ((GetXCR0() & 0xe0) == 0xe0) { - cpu_info |= (cpu_info7[1] & 0x40000000) ? kCpuHasAVX512BW : 0; - cpu_info |= (cpu_info7[1] & 0x80000000) ? kCpuHasAVX512VL : 0; - cpu_info |= (cpu_info7[2] & 0x00000002) ? kCpuHasAVX512VBMI : 0; - cpu_info |= (cpu_info7[2] & 0x00000040) ? kCpuHasAVX512VBMI2 : 0; - cpu_info |= (cpu_info7[2] & 0x00000800) ? kCpuHasAVX512VNNI : 0; - cpu_info |= (cpu_info7[2] & 0x00001000) ? kCpuHasAVX512VBITALG : 0; - cpu_info |= (cpu_info7[2] & 0x00004000) ? kCpuHasAVX512VPOPCNTDQ : 0; - cpu_info |= (cpu_info7[2] & 0x00000100) ? kCpuHasGFNI : 0; - } - } -#endif -#if defined(__arm__) || defined(__aarch64__) - // gcc -mfpu=neon defines __ARM_NEON__ - // __ARM_NEON__ generates code that requires Neon. NaCL also requires Neon. - // For Linux, /proc/cpuinfo can be tested but without that assume Neon. -#if defined(__ARM_NEON__) || defined(__native_client__) || !defined(__linux__) - cpu_info = kCpuHasNEON; - // For aarch64(arm64), /proc/cpuinfo's feature is not complete, e.g. no neon - // flag in it. - // So for aarch64, neon enabling is hard coded here. -#endif -#if defined(__aarch64__) - cpu_info = kCpuHasNEON; -#else - // Linux arm parse text file for neon detect. - cpu_info = ArmCpuCaps("/proc/cpuinfo"); -#endif - cpu_info |= kCpuHasARM; -#endif // __arm__ - cpu_info |= kCpuInitialized; - return cpu_info; -} - -// Note that use of this function is not thread safe. -LIBYUV_API -int MaskCpuFlags(int enable_flags) { - int cpu_info = GetCpuFlags() & enable_flags; - SetCpuFlags(cpu_info); - return cpu_info; -} - -LIBYUV_API -int InitCpuFlags(void) { - return MaskCpuFlags(-1); -} diff --git a/pkg/encoder/yuv/libyuv/cpu_id.h b/pkg/encoder/yuv/libyuv/cpu_id.h deleted file mode 100644 index bf50b9cd..00000000 --- a/pkg/encoder/yuv/libyuv/cpu_id.h +++ /dev/null @@ -1,106 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_CPU_ID_H_ -#define INCLUDE_LIBYUV_CPU_ID_H_ - -#include "basic_types.h" - -// Internal flag to indicate cpuid requires initialization. -static const int kCpuInitialized = 0x1; - -// These flags are only valid on ARM processors. -static const int kCpuHasARM = 0x2; -static const int kCpuHasNEON = 0x4; -// 0x8 reserved for future ARM flag. - -// These flags are only valid on x86 processors. -static const int kCpuHasX86 = 0x10; -static const int kCpuHasSSE2 = 0x20; -static const int kCpuHasSSSE3 = 0x40; -static const int kCpuHasSSE41 = 0x80; -static const int kCpuHasSSE42 = 0x100; // unused at this time. -static const int kCpuHasAVX = 0x200; -static const int kCpuHasAVX2 = 0x400; -static const int kCpuHasERMS = 0x800; -static const int kCpuHasFMA3 = 0x1000; -static const int kCpuHasF16C = 0x2000; -static const int kCpuHasGFNI = 0x4000; -static const int kCpuHasAVX512BW = 0x8000; -static const int kCpuHasAVX512VL = 0x10000; -static const int kCpuHasAVX512VNNI = 0x20000; -static const int kCpuHasAVX512VBMI = 0x40000; -static const int kCpuHasAVX512VBMI2 = 0x80000; -static const int kCpuHasAVX512VBITALG = 0x100000; -static const int kCpuHasAVX512VPOPCNTDQ = 0x200000; - -// Optional init function. TestCpuFlag does an auto-init. -// Returns cpu_info flags. -LIBYUV_API -int InitCpuFlags(void); - -// Detect CPU has SSE2 etc. -// Test_flag parameter should be one of kCpuHas constants above. -// Returns non-zero if instruction set is detected -static __inline int TestCpuFlag(int test_flag) { - LIBYUV_API extern int cpu_info_; -#ifdef __ATOMIC_RELAXED - int cpu_info = __atomic_load_n(&cpu_info_, __ATOMIC_RELAXED); -#else - int cpu_info = cpu_info_; -#endif - return (!cpu_info ? InitCpuFlags() : cpu_info) & test_flag; -} - -// Internal function for parsing /proc/cpuinfo. -LIBYUV_API -int ArmCpuCaps(const char *cpuinfo_name); - -// For testing, allow CPU flags to be disabled. -// ie MaskCpuFlags(~kCpuHasSSSE3) to disable SSSE3. -// MaskCpuFlags(-1) to enable all cpu specific optimizations. -// MaskCpuFlags(1) to disable all cpu specific optimizations. -// MaskCpuFlags(0) to reset state so next call will auto init. -// Returns cpu_info flags. -LIBYUV_API -int MaskCpuFlags(int enable_flags); - -// Sets the CPU flags to |cpu_flags|, bypassing the detection code. |cpu_flags| -// should be a valid combination of the kCpuHas constants above and include -// kCpuInitialized. Use this method when running in a sandboxed process where -// the detection code might fail (as it might access /proc/cpuinfo). In such -// cases the cpu_info can be obtained from a non sandboxed process by calling -// InitCpuFlags() and passed to the sandboxed process (via command line -// parameters, IPC...) which can then call this method to initialize the CPU -// flags. -// Notes: -// - when specifying 0 for |cpu_flags|, the auto initialization is enabled -// again. -// - enabling CPU features that are not supported by the CPU will result in -// undefined behavior. -// TODO(fbarchard): consider writing a helper function that translates from -// other library CPU info to libyuv CPU info and add a .md doc that explains -// CPU detection. -static __inline void SetCpuFlags(int cpu_flags) { - LIBYUV_API extern int cpu_info_; -#ifdef __ATOMIC_RELAXED - __atomic_store_n(&cpu_info_, cpu_flags, __ATOMIC_RELAXED); -#else - cpu_info_ = cpu_flags; -#endif -} - -// Low level cpuid for X86. Returns zeros on other CPUs. -// eax is the info type that you want. -// ecx is typically the cpu number, and should normally be zero. -LIBYUV_API -void CpuId(int info_eax, int info_ecx, int *cpu_info); - -#endif // INCLUDE_LIBYUV_CPU_ID_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/libyuv.go b/pkg/encoder/yuv/libyuv/libyuv.go index 98d4276f..8bde0ad8 100644 --- a/pkg/encoder/yuv/libyuv/libyuv.go +++ b/pkg/encoder/yuv/libyuv/libyuv.go @@ -1,18 +1,43 @@ -//go:build !darwin && !no_libyuv - +// Package libyuv contains the wrapper for: https://chromium.googlesource.com/libyuv/libyuv. +// Libs are downloaded from: https://packages.macports.org/libyuv/. package libyuv -// see: https://chromium.googlesource.com/libyuv/libyuv - /* -#cgo CFLAGS: -Wall -#cgo LDFLAGS: -lyuv +#cgo !darwin LDFLAGS: -lyuv -#include +#cgo darwin CFLAGS: -DINCLUDE_LIBYUV_VERSION_H_ +#cgo darwin LDFLAGS: -L${SRCDIR} -lstdc++ +#cgo darwin,amd64 LDFLAGS: -lyuv_darwin_x86_64 -ljpeg -lstdc++ +#cgo darwin,arm64 LDFLAGS: -lyuv_darwin_arm64 -ljpeg -lstdc++ + +#include // for uintptr_t and C99 types + +#if !defined(LIBYUV_API) +#define LIBYUV_API +#endif // LIBYUV_API + +#ifndef INCLUDE_LIBYUV_VERSION_H_ #include "libyuv/version.h" -#include "libyuv/video_common.h" +#else +#define LIBYUV_VERSION 1874 // darwin static libs version +#endif // INCLUDE_LIBYUV_VERSION_H_ + +#ifdef __cplusplus +namespace libyuv { +extern "C" { +#endif + +#define FOURCC(a, b, c, d) \ + (((uint32_t)(a)) | ((uint32_t)(b) << 8) | ((uint32_t)(c) << 16) | ((uint32_t)(d) << 24)) + +enum FourCC { + FOURCC_I420 = FOURCC('I', '4', '2', '0'), + FOURCC_ARGB = FOURCC('A', 'R', 'G', 'B'), + FOURCC_ABGR = FOURCC('A', 'B', 'G', 'R'), + FOURCC_RGBP = FOURCC('R', 'G', 'B', 'P'), // rgb565 LE. + FOURCC_ANY = -1, +}; -// typedef enum RotationMode { kRotate0 = 0, // No rotation. kRotate90 = 90, // Rotate 90 degrees clockwise. @@ -20,7 +45,6 @@ typedef enum RotationMode { kRotate270 = 270, // Rotate 270 degrees clockwise. } RotationModeEnum; -// LIBYUV_API int ConvertToI420(const uint8_t* sample, size_t sample_size, @@ -65,6 +89,11 @@ int I420Scale(const uint8_t *src_y, int dst_width, int dst_height, enum FilterMode filtering); + +#ifdef __cplusplus +} // extern "C" +} // namespace libyuv +#endif */ import "C" import "fmt" diff --git a/pkg/encoder/yuv/libyuv/libyuv2.go b/pkg/encoder/yuv/libyuv/libyuv2.go deleted file mode 100644 index f4f6a68b..00000000 --- a/pkg/encoder/yuv/libyuv/libyuv2.go +++ /dev/null @@ -1,89 +0,0 @@ -//go:build darwin || no_libyuv - -package libyuv - -/* -#cgo CFLAGS: -Wall - -#include "basic_types.h" -#include "version.h" -#include "video_common.h" -#include "rotate.h" -#include "scale.h" -#include "convert.h" - -*/ -import "C" -import "fmt" - -const FourccRgbp uint32 = C.FOURCC_RGBP -const FourccArgb uint32 = C.FOURCC_ARGB -const FourccAbgr uint32 = C.FOURCC_ABGR - -func Y420(src []byte, dst []byte, _, h, stride int, dw, dh int, rot uint, pix uint32, cx, cy int) { - cw := (dw + 1) / 2 - ch := (dh + 1) / 2 - i0 := dw * dh - i1 := i0 + cw*ch - yStride := dw - cStride := cw - - C.ConvertToI420( - (*C.uchar)(&src[0]), - C.size_t(0), - (*C.uchar)(&dst[0]), - C.int(yStride), - (*C.uchar)(&dst[i0]), - C.int(cStride), - (*C.uchar)(&dst[i1]), - C.int(cStride), - C.int(0), - C.int(0), - C.int(stride), - C.int(h), - C.int(cx), - C.int(cy), - C.enum_RotationMode(rot), - C.uint32_t(pix)) -} - -func Y420Scale(src []byte, dst []byte, w, h int, dw, dh int) { - srcWidthUV, dstWidthUV := (w+1)>>1, (dw+1)>>1 - srcHeightUV, dstHeightUV := (h+1)>>1, (dh+1)>>1 - - srcYPlaneSize, dstYPlaneSize := w*h, dw*dh - srcUVPlaneSize, dstUVPlaneSize := srcWidthUV*srcHeightUV, dstWidthUV*dstHeightUV - - srcStrideY, dstStrideY := w, dw - srcStrideU, dstStrideU := srcWidthUV, dstWidthUV - srcStrideV, dstStrideV := srcWidthUV, dstWidthUV - - srcY := (*C.uchar)(&src[0]) - srcU := (*C.uchar)(&src[srcYPlaneSize]) - srcV := (*C.uchar)(&src[srcYPlaneSize+srcUVPlaneSize]) - - dstY := (*C.uchar)(&dst[0]) - dstU := (*C.uchar)(&dst[dstYPlaneSize]) - dstV := (*C.uchar)(&dst[dstYPlaneSize+dstUVPlaneSize]) - - C.I420Scale( - srcY, - C.int(srcStrideY), - srcU, - C.int(srcStrideU), - srcV, - C.int(srcStrideV), - C.int(w), - C.int(h), - dstY, - C.int(dstStrideY), - dstU, - C.int(dstStrideU), - dstV, - C.int(dstStrideV), - C.int(dw), - C.int(dh), - C.enum_FilterMode(C.kFilterNone)) -} - -func Version() string { return fmt.Sprintf("%v mod", int(C.LIBYUV_VERSION)) } diff --git a/pkg/encoder/yuv/libyuv/libyuv_darwin_arm64.a b/pkg/encoder/yuv/libyuv/libyuv_darwin_arm64.a new file mode 100644 index 0000000000000000000000000000000000000000..f399a41c7b388e33a68b3ababd47a275f6a7c6d1 GIT binary patch literal 486312 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

?oAcRr$*J_4zhM|3Z-{t>-_ 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 literal 0 HcmV?d00001 diff --git a/pkg/encoder/yuv/libyuv/libyuv_darwin_x86_64.a b/pkg/encoder/yuv/libyuv/libyuv_darwin_x86_64.a new file mode 100644 index 0000000000000000000000000000000000000000..63cd5c74a4cd168a60f56ff6892a911cedcc82f4 GIT binary patch literal 669112 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%0DkwMRw!ai=t9j2r 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 _%VHFx_%>r))-(QDmB#bsOY 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 8) { - TransposeWx8(src, src_stride, dst, dst_stride, width); - src += 8 * src_stride; // Go down 8 rows. - dst += 8; // Move over 8 columns. - i -= 8; - } - - if (i > 0) { - TransposeWxH_C(src, src_stride, dst, dst_stride, width, i); - } -} - -LIBYUV_API -void RotatePlane90(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height) { - // Rotate by 90 is a transpose with the source read - // from bottom to top. So set the source pointer to the end - // of the buffer and flip the sign of the source stride. - src += src_stride * (height - 1); - src_stride = -src_stride; - TransposePlane(src, src_stride, dst, dst_stride, width, height); -} - -LIBYUV_API -void RotatePlane270(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height) { - // Rotate by 270 is a transpose with the destination written - // from bottom to top. So set the destination pointer to the end - // of the buffer and flip the sign of the destination stride. - dst += dst_stride * (width - 1); - dst_stride = -dst_stride; - TransposePlane(src, src_stride, dst, dst_stride, width, height); -} - -LIBYUV_API -void RotatePlane180(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height) { - // Swap top and bottom row and mirror the content. Uses a temporary row. - align_buffer_64(row, width); - const uint8_t *src_bot = src + src_stride * (height - 1); - uint8_t *dst_bot = dst + dst_stride * (height - 1); - int half_height = (height + 1) >> 1; - int y; - void (*MirrorRow)(const uint8_t *src, uint8_t *dst, int width) = MirrorRow_C; - void (*CopyRow)(const uint8_t *src, uint8_t *dst, int width) = CopyRow_C; -#if defined(HAS_MIRRORROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - MirrorRow = MirrorRow_Any_SSSE3; - if (IS_ALIGNED(width, 16)) { - MirrorRow = MirrorRow_SSSE3; - } - } -#endif -#if defined(HAS_MIRRORROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - MirrorRow = MirrorRow_Any_AVX2; - if (IS_ALIGNED(width, 32)) { - MirrorRow = MirrorRow_AVX2; - } - } -#endif -#if defined(HAS_COPYROW_SSE2) - if (TestCpuFlag(kCpuHasSSE2)) { - CopyRow = IS_ALIGNED(width, 32) ? CopyRow_SSE2 : CopyRow_Any_SSE2; - } -#endif -#if defined(HAS_COPYROW_AVX) - if (TestCpuFlag(kCpuHasAVX)) { - CopyRow = IS_ALIGNED(width, 64) ? CopyRow_AVX : CopyRow_Any_AVX; - } -#endif -#if defined(HAS_COPYROW_ERMS) - if (TestCpuFlag(kCpuHasERMS)) { - CopyRow = CopyRow_ERMS; - } -#endif -#if defined(HAS_COPYROW_NEON) -#endif - // Odd height will harmlessly mirror the middle row twice. - for (y = 0; y < half_height; ++y) { - CopyRow(src, row, width); // Copy top row into buffer - MirrorRow(src_bot, dst, width); // Mirror bottom row into top row - MirrorRow(row, dst_bot, width); // Mirror buffer into bottom row - src += src_stride; - dst += dst_stride; - src_bot -= src_stride; - dst_bot -= dst_stride; - } - free_aligned_buffer_64(row); -} - -LIBYUV_API -int I420Rotate(const uint8_t *src_y, - int src_stride_y, - const uint8_t *src_u, - int src_stride_u, - const uint8_t *src_v, - int src_stride_v, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height, - enum RotationMode mode) { - int halfwidth = (width + 1) >> 1; - int halfheight = (height + 1) >> 1; - if ((!src_y && dst_y) || !src_u || !src_v || width <= 0 || height == 0 || - !dst_y || !dst_u || !dst_v) { - return -1; - } - - // Negative height means invert the image. - if (height < 0) { - height = -height; - halfheight = (height + 1) >> 1; - src_y = src_y + (height - 1) * src_stride_y; - src_u = src_u + (halfheight - 1) * src_stride_u; - src_v = src_v + (halfheight - 1) * src_stride_v; - src_stride_y = -src_stride_y; - src_stride_u = -src_stride_u; - src_stride_v = -src_stride_v; - } - - switch (mode) { - case kRotate0: - // copy frame - return I420Copy(src_y, src_stride_y, src_u, src_stride_u, src_v, - src_stride_v, dst_y, dst_stride_y, dst_u, dst_stride_u, - dst_v, dst_stride_v, width, height); - case kRotate90: - RotatePlane90(src_y, src_stride_y, dst_y, dst_stride_y, width, height); - RotatePlane90(src_u, src_stride_u, dst_u, dst_stride_u, halfwidth, - halfheight); - RotatePlane90(src_v, src_stride_v, dst_v, dst_stride_v, halfwidth, - halfheight); - return 0; - case kRotate270: - RotatePlane270(src_y, src_stride_y, dst_y, dst_stride_y, width, height); - RotatePlane270(src_u, src_stride_u, dst_u, dst_stride_u, halfwidth, - halfheight); - RotatePlane270(src_v, src_stride_v, dst_v, dst_stride_v, halfwidth, - halfheight); - return 0; - case kRotate180: - RotatePlane180(src_y, src_stride_y, dst_y, dst_stride_y, width, height); - RotatePlane180(src_u, src_stride_u, dst_u, dst_stride_u, halfwidth, - halfheight); - RotatePlane180(src_v, src_stride_v, dst_v, dst_stride_v, halfwidth, - halfheight); - return 0; - default: - break; - } - return -1; -} diff --git a/pkg/encoder/yuv/libyuv/rotate.h b/pkg/encoder/yuv/libyuv/rotate.h deleted file mode 100644 index 59b9ec3c..00000000 --- a/pkg/encoder/yuv/libyuv/rotate.h +++ /dev/null @@ -1,79 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_ROTATE_H_ -#define INCLUDE_LIBYUV_ROTATE_H_ - -#include "basic_types.h" - -// Supported rotation. -typedef enum RotationMode { - kRotate0 = 0, // No rotation. - kRotate90 = 90, // Rotate 90 degrees clockwise. - kRotate180 = 180, // Rotate 180 degrees. - kRotate270 = 270, // Rotate 270 degrees clockwise. -} RotationModeEnum; - -// Rotate I420 frame. -LIBYUV_API -int I420Rotate(const uint8_t *src_y, - int src_stride_y, - const uint8_t *src_u, - int src_stride_u, - const uint8_t *src_v, - int src_stride_v, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int width, - int height, - enum RotationMode mode); - -// Rotate planes by 90, 180, 270. Deprecated. -LIBYUV_API -void RotatePlane90(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height); - -LIBYUV_API -void RotatePlane180(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height); - -LIBYUV_API -void RotatePlane270(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height); - -// The 90 and 270 functions are based on transposes. -// Doing a transpose with reversing the read/write -// order will result in a rotation by +- 90 degrees. -// Deprecated. -LIBYUV_API -void TransposePlane(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height); - -#endif // INCLUDE_LIBYUV_ROTATE_H_ diff --git a/pkg/encoder/yuv/libyuv/rotate_any.c b/pkg/encoder/yuv/libyuv/rotate_any.c deleted file mode 100644 index 9af8c04a..00000000 --- a/pkg/encoder/yuv/libyuv/rotate_any.c +++ /dev/null @@ -1,54 +0,0 @@ -/* - * Copyright 2015 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "rotate_row.h" - -#define TANY(NAMEANY, TPOS_SIMD, MASK) \ - void NAMEANY(const uint8_t* src, int src_stride, uint8_t* dst, \ - int dst_stride, int width) { \ - int r = width & MASK; \ - int n = width - r; \ - if (n > 0) { \ - TPOS_SIMD(src, src_stride, dst, dst_stride, n); \ - } \ - TransposeWx8_C(src + n, src_stride, dst + n * dst_stride, dst_stride, r); \ - } - -#ifdef HAS_TRANSPOSEWX8_SSSE3 - -TANY(TransposeWx8_Any_SSSE3, TransposeWx8_SSSE3, 7) - -#endif -#ifdef HAS_TRANSPOSEWX8_FAST_SSSE3 - -TANY(TransposeWx8_Fast_Any_SSSE3, TransposeWx8_Fast_SSSE3, 15) - -#endif -#undef TANY - -#define TUVANY(NAMEANY, TPOS_SIMD, MASK) \ - void NAMEANY(const uint8_t* src, int src_stride, uint8_t* dst_a, \ - int dst_stride_a, uint8_t* dst_b, int dst_stride_b, \ - int width) { \ - int r = width & MASK; \ - int n = width - r; \ - if (n > 0) { \ - TPOS_SIMD(src, src_stride, dst_a, dst_stride_a, dst_b, dst_stride_b, n); \ - } \ - TransposeUVWx8_C(src + n * 2, src_stride, dst_a + n * dst_stride_a, \ - dst_stride_a, dst_b + n * dst_stride_b, dst_stride_b, r); \ - } - -#ifdef HAS_TRANSPOSEUVWX8_SSE2 - -TUVANY(TransposeUVWx8_Any_SSE2, TransposeUVWx8_SSE2, 7) - -#endif -#undef TUVANY diff --git a/pkg/encoder/yuv/libyuv/rotate_common.c b/pkg/encoder/yuv/libyuv/rotate_common.c deleted file mode 100644 index 20c1481a..00000000 --- a/pkg/encoder/yuv/libyuv/rotate_common.c +++ /dev/null @@ -1,77 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "rotate_row.h" - -void TransposeWx8_C(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width) { - int i; - for (i = 0; i < width; ++i) { - dst[0] = src[0 * src_stride]; - dst[1] = src[1 * src_stride]; - dst[2] = src[2 * src_stride]; - dst[3] = src[3 * src_stride]; - dst[4] = src[4 * src_stride]; - dst[5] = src[5 * src_stride]; - dst[6] = src[6 * src_stride]; - dst[7] = src[7 * src_stride]; - ++src; - dst += dst_stride; - } -} - -void TransposeUVWx8_C(const uint8_t *src, - int src_stride, - uint8_t *dst_a, - int dst_stride_a, - uint8_t *dst_b, - int dst_stride_b, - int width) { - int i; - for (i = 0; i < width; ++i) { - dst_a[0] = src[0 * src_stride + 0]; - dst_b[0] = src[0 * src_stride + 1]; - dst_a[1] = src[1 * src_stride + 0]; - dst_b[1] = src[1 * src_stride + 1]; - dst_a[2] = src[2 * src_stride + 0]; - dst_b[2] = src[2 * src_stride + 1]; - dst_a[3] = src[3 * src_stride + 0]; - dst_b[3] = src[3 * src_stride + 1]; - dst_a[4] = src[4 * src_stride + 0]; - dst_b[4] = src[4 * src_stride + 1]; - dst_a[5] = src[5 * src_stride + 0]; - dst_b[5] = src[5 * src_stride + 1]; - dst_a[6] = src[6 * src_stride + 0]; - dst_b[6] = src[6 * src_stride + 1]; - dst_a[7] = src[7 * src_stride + 0]; - dst_b[7] = src[7 * src_stride + 1]; - src += 2; - dst_a += dst_stride_a; - dst_b += dst_stride_b; - } -} - -void TransposeWxH_C(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height) { - int i; - for (i = 0; i < width; ++i) { - int j; - for (j = 0; j < height; ++j) { - dst[i * dst_stride + j] = src[j * src_stride + i]; - } - } -} diff --git a/pkg/encoder/yuv/libyuv/rotate_gcc.c b/pkg/encoder/yuv/libyuv/rotate_gcc.c deleted file mode 100644 index 54fdafff..00000000 --- a/pkg/encoder/yuv/libyuv/rotate_gcc.c +++ /dev/null @@ -1,370 +0,0 @@ -/* - * Copyright 2015 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "rotate_row.h" -#include "row.h" - -// This module is for GCC x86 and x64. -#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) - -// Transpose 8x8. 32 or 64 bit, but not NaCL for 64 bit. -#if defined(HAS_TRANSPOSEWX8_SSSE3) - -void TransposeWx8_SSSE3(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width) { - asm volatile( - // Read in the data from the source pointer. - // First round of bit swap. - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" - "movq (%0,%3),%%xmm1 \n" - "lea (%0,%3,2),%0 \n" - "punpcklbw %%xmm1,%%xmm0 \n" - "movq (%0),%%xmm2 \n" - "movdqa %%xmm0,%%xmm1 \n" - "palignr $0x8,%%xmm1,%%xmm1 \n" - "movq (%0,%3),%%xmm3 \n" - "lea (%0,%3,2),%0 \n" - "punpcklbw %%xmm3,%%xmm2 \n" - "movdqa %%xmm2,%%xmm3 \n" - "movq (%0),%%xmm4 \n" - "palignr $0x8,%%xmm3,%%xmm3 \n" - "movq (%0,%3),%%xmm5 \n" - "lea (%0,%3,2),%0 \n" - "punpcklbw %%xmm5,%%xmm4 \n" - "movdqa %%xmm4,%%xmm5 \n" - "movq (%0),%%xmm6 \n" - "palignr $0x8,%%xmm5,%%xmm5 \n" - "movq (%0,%3),%%xmm7 \n" - "lea (%0,%3,2),%0 \n" - "punpcklbw %%xmm7,%%xmm6 \n" - "neg %3 \n" - "movdqa %%xmm6,%%xmm7 \n" - "lea 0x8(%0,%3,8),%0 \n" - "palignr $0x8,%%xmm7,%%xmm7 \n" - "neg %3 \n" - // Second round of bit swap. - "punpcklwd %%xmm2,%%xmm0 \n" - "punpcklwd %%xmm3,%%xmm1 \n" - "movdqa %%xmm0,%%xmm2 \n" - "movdqa %%xmm1,%%xmm3 \n" - "palignr $0x8,%%xmm2,%%xmm2 \n" - "palignr $0x8,%%xmm3,%%xmm3 \n" - "punpcklwd %%xmm6,%%xmm4 \n" - "punpcklwd %%xmm7,%%xmm5 \n" - "movdqa %%xmm4,%%xmm6 \n" - "movdqa %%xmm5,%%xmm7 \n" - "palignr $0x8,%%xmm6,%%xmm6 \n" - "palignr $0x8,%%xmm7,%%xmm7 \n" - // Third round of bit swap. - // Write to the destination pointer. - "punpckldq %%xmm4,%%xmm0 \n" - "movq %%xmm0,(%1) \n" - "movdqa %%xmm0,%%xmm4 \n" - "palignr $0x8,%%xmm4,%%xmm4 \n" - "movq %%xmm4,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "punpckldq %%xmm6,%%xmm2 \n" - "movdqa %%xmm2,%%xmm6 \n" - "movq %%xmm2,(%1) \n" - "palignr $0x8,%%xmm6,%%xmm6 \n" - "punpckldq %%xmm5,%%xmm1 \n" - "movq %%xmm6,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "movdqa %%xmm1,%%xmm5 \n" - "movq %%xmm1,(%1) \n" - "palignr $0x8,%%xmm5,%%xmm5 \n" - "movq %%xmm5,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "punpckldq %%xmm7,%%xmm3 \n" - "movq %%xmm3,(%1) \n" - "movdqa %%xmm3,%%xmm7 \n" - "palignr $0x8,%%xmm7,%%xmm7 \n" - "sub $0x8,%2 \n" - "movq %%xmm7,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "jg 1b \n" - : "+r"(src), // %0 - "+r"(dst), // %1 - "+r"(width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif // defined(HAS_TRANSPOSEWX8_SSSE3) - -// Transpose 16x8. 64 bit -#if defined(HAS_TRANSPOSEWX8_FAST_SSSE3) - -void TransposeWx8_Fast_SSSE3(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width) { - asm volatile( - // Read in the data from the source pointer. - // First round of bit swap. - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu (%0,%3),%%xmm1 \n" - "lea (%0,%3,2),%0 \n" - "movdqa %%xmm0,%%xmm8 \n" - "punpcklbw %%xmm1,%%xmm0 \n" - "punpckhbw %%xmm1,%%xmm8 \n" - "movdqu (%0),%%xmm2 \n" - "movdqa %%xmm0,%%xmm1 \n" - "movdqa %%xmm8,%%xmm9 \n" - "palignr $0x8,%%xmm1,%%xmm1 \n" - "palignr $0x8,%%xmm9,%%xmm9 \n" - "movdqu (%0,%3),%%xmm3 \n" - "lea (%0,%3,2),%0 \n" - "movdqa %%xmm2,%%xmm10 \n" - "punpcklbw %%xmm3,%%xmm2 \n" - "punpckhbw %%xmm3,%%xmm10 \n" - "movdqa %%xmm2,%%xmm3 \n" - "movdqa %%xmm10,%%xmm11 \n" - "movdqu (%0),%%xmm4 \n" - "palignr $0x8,%%xmm3,%%xmm3 \n" - "palignr $0x8,%%xmm11,%%xmm11 \n" - "movdqu (%0,%3),%%xmm5 \n" - "lea (%0,%3,2),%0 \n" - "movdqa %%xmm4,%%xmm12 \n" - "punpcklbw %%xmm5,%%xmm4 \n" - "punpckhbw %%xmm5,%%xmm12 \n" - "movdqa %%xmm4,%%xmm5 \n" - "movdqa %%xmm12,%%xmm13 \n" - "movdqu (%0),%%xmm6 \n" - "palignr $0x8,%%xmm5,%%xmm5 \n" - "palignr $0x8,%%xmm13,%%xmm13 \n" - "movdqu (%0,%3),%%xmm7 \n" - "lea (%0,%3,2),%0 \n" - "movdqa %%xmm6,%%xmm14 \n" - "punpcklbw %%xmm7,%%xmm6 \n" - "punpckhbw %%xmm7,%%xmm14 \n" - "neg %3 \n" - "movdqa %%xmm6,%%xmm7 \n" - "movdqa %%xmm14,%%xmm15 \n" - "lea 0x10(%0,%3,8),%0 \n" - "palignr $0x8,%%xmm7,%%xmm7 \n" - "palignr $0x8,%%xmm15,%%xmm15 \n" - "neg %3 \n" - // Second round of bit swap. - "punpcklwd %%xmm2,%%xmm0 \n" - "punpcklwd %%xmm3,%%xmm1 \n" - "movdqa %%xmm0,%%xmm2 \n" - "movdqa %%xmm1,%%xmm3 \n" - "palignr $0x8,%%xmm2,%%xmm2 \n" - "palignr $0x8,%%xmm3,%%xmm3 \n" - "punpcklwd %%xmm6,%%xmm4 \n" - "punpcklwd %%xmm7,%%xmm5 \n" - "movdqa %%xmm4,%%xmm6 \n" - "movdqa %%xmm5,%%xmm7 \n" - "palignr $0x8,%%xmm6,%%xmm6 \n" - "palignr $0x8,%%xmm7,%%xmm7 \n" - "punpcklwd %%xmm10,%%xmm8 \n" - "punpcklwd %%xmm11,%%xmm9 \n" - "movdqa %%xmm8,%%xmm10 \n" - "movdqa %%xmm9,%%xmm11 \n" - "palignr $0x8,%%xmm10,%%xmm10 \n" - "palignr $0x8,%%xmm11,%%xmm11 \n" - "punpcklwd %%xmm14,%%xmm12 \n" - "punpcklwd %%xmm15,%%xmm13 \n" - "movdqa %%xmm12,%%xmm14 \n" - "movdqa %%xmm13,%%xmm15 \n" - "palignr $0x8,%%xmm14,%%xmm14 \n" - "palignr $0x8,%%xmm15,%%xmm15 \n" - // Third round of bit swap. - // Write to the destination pointer. - "punpckldq %%xmm4,%%xmm0 \n" - "movq %%xmm0,(%1) \n" - "movdqa %%xmm0,%%xmm4 \n" - "palignr $0x8,%%xmm4,%%xmm4 \n" - "movq %%xmm4,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "punpckldq %%xmm6,%%xmm2 \n" - "movdqa %%xmm2,%%xmm6 \n" - "movq %%xmm2,(%1) \n" - "palignr $0x8,%%xmm6,%%xmm6 \n" - "punpckldq %%xmm5,%%xmm1 \n" - "movq %%xmm6,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "movdqa %%xmm1,%%xmm5 \n" - "movq %%xmm1,(%1) \n" - "palignr $0x8,%%xmm5,%%xmm5 \n" - "movq %%xmm5,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "punpckldq %%xmm7,%%xmm3 \n" - "movq %%xmm3,(%1) \n" - "movdqa %%xmm3,%%xmm7 \n" - "palignr $0x8,%%xmm7,%%xmm7 \n" - "movq %%xmm7,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "punpckldq %%xmm12,%%xmm8 \n" - "movq %%xmm8,(%1) \n" - "movdqa %%xmm8,%%xmm12 \n" - "palignr $0x8,%%xmm12,%%xmm12 \n" - "movq %%xmm12,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "punpckldq %%xmm14,%%xmm10 \n" - "movdqa %%xmm10,%%xmm14 \n" - "movq %%xmm10,(%1) \n" - "palignr $0x8,%%xmm14,%%xmm14 \n" - "punpckldq %%xmm13,%%xmm9 \n" - "movq %%xmm14,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "movdqa %%xmm9,%%xmm13 \n" - "movq %%xmm9,(%1) \n" - "palignr $0x8,%%xmm13,%%xmm13 \n" - "movq %%xmm13,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "punpckldq %%xmm15,%%xmm11 \n" - "movq %%xmm11,(%1) \n" - "movdqa %%xmm11,%%xmm15 \n" - "palignr $0x8,%%xmm15,%%xmm15 \n" - "sub $0x10,%2 \n" - "movq %%xmm15,(%1,%4) \n" - "lea (%1,%4,2),%1 \n" - "jg 1b \n" - : "+r"(src), // %0 - "+r"(dst), // %1 - "+r"(width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7", "xmm8", "xmm9", "xmm10", "xmm11", "xmm12", "xmm13", "xmm14", - "xmm15"); -} - -#endif // defined(HAS_TRANSPOSEWX8_FAST_SSSE3) - -// Transpose UV 8x8. 64 bit. -#if defined(HAS_TRANSPOSEUVWX8_SSE2) - -void TransposeUVWx8_SSE2(const uint8_t *src, - int src_stride, - uint8_t *dst_a, - int dst_stride_a, - uint8_t *dst_b, - int dst_stride_b, - int width) { - asm volatile( - // Read in the data from the source pointer. - // First round of bit swap. - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu (%0,%4),%%xmm1 \n" - "lea (%0,%4,2),%0 \n" - "movdqa %%xmm0,%%xmm8 \n" - "punpcklbw %%xmm1,%%xmm0 \n" - "punpckhbw %%xmm1,%%xmm8 \n" - "movdqa %%xmm8,%%xmm1 \n" - "movdqu (%0),%%xmm2 \n" - "movdqu (%0,%4),%%xmm3 \n" - "lea (%0,%4,2),%0 \n" - "movdqa %%xmm2,%%xmm8 \n" - "punpcklbw %%xmm3,%%xmm2 \n" - "punpckhbw %%xmm3,%%xmm8 \n" - "movdqa %%xmm8,%%xmm3 \n" - "movdqu (%0),%%xmm4 \n" - "movdqu (%0,%4),%%xmm5 \n" - "lea (%0,%4,2),%0 \n" - "movdqa %%xmm4,%%xmm8 \n" - "punpcklbw %%xmm5,%%xmm4 \n" - "punpckhbw %%xmm5,%%xmm8 \n" - "movdqa %%xmm8,%%xmm5 \n" - "movdqu (%0),%%xmm6 \n" - "movdqu (%0,%4),%%xmm7 \n" - "lea (%0,%4,2),%0 \n" - "movdqa %%xmm6,%%xmm8 \n" - "punpcklbw %%xmm7,%%xmm6 \n" - "neg %4 \n" - "lea 0x10(%0,%4,8),%0 \n" - "punpckhbw %%xmm7,%%xmm8 \n" - "movdqa %%xmm8,%%xmm7 \n" - "neg %4 \n" - // Second round of bit swap. - "movdqa %%xmm0,%%xmm8 \n" - "movdqa %%xmm1,%%xmm9 \n" - "punpckhwd %%xmm2,%%xmm8 \n" - "punpckhwd %%xmm3,%%xmm9 \n" - "punpcklwd %%xmm2,%%xmm0 \n" - "punpcklwd %%xmm3,%%xmm1 \n" - "movdqa %%xmm8,%%xmm2 \n" - "movdqa %%xmm9,%%xmm3 \n" - "movdqa %%xmm4,%%xmm8 \n" - "movdqa %%xmm5,%%xmm9 \n" - "punpckhwd %%xmm6,%%xmm8 \n" - "punpckhwd %%xmm7,%%xmm9 \n" - "punpcklwd %%xmm6,%%xmm4 \n" - "punpcklwd %%xmm7,%%xmm5 \n" - "movdqa %%xmm8,%%xmm6 \n" - "movdqa %%xmm9,%%xmm7 \n" - // Third round of bit swap. - // Write to the destination pointer. - "movdqa %%xmm0,%%xmm8 \n" - "punpckldq %%xmm4,%%xmm0 \n" - "movlpd %%xmm0,(%1) \n" // Write back U channel - "movhpd %%xmm0,(%2) \n" // Write back V channel - "punpckhdq %%xmm4,%%xmm8 \n" - "movlpd %%xmm8,(%1,%5) \n" - "lea (%1,%5,2),%1 \n" - "movhpd %%xmm8,(%2,%6) \n" - "lea (%2,%6,2),%2 \n" - "movdqa %%xmm2,%%xmm8 \n" - "punpckldq %%xmm6,%%xmm2 \n" - "movlpd %%xmm2,(%1) \n" - "movhpd %%xmm2,(%2) \n" - "punpckhdq %%xmm6,%%xmm8 \n" - "movlpd %%xmm8,(%1,%5) \n" - "lea (%1,%5,2),%1 \n" - "movhpd %%xmm8,(%2,%6) \n" - "lea (%2,%6,2),%2 \n" - "movdqa %%xmm1,%%xmm8 \n" - "punpckldq %%xmm5,%%xmm1 \n" - "movlpd %%xmm1,(%1) \n" - "movhpd %%xmm1,(%2) \n" - "punpckhdq %%xmm5,%%xmm8 \n" - "movlpd %%xmm8,(%1,%5) \n" - "lea (%1,%5,2),%1 \n" - "movhpd %%xmm8,(%2,%6) \n" - "lea (%2,%6,2),%2 \n" - "movdqa %%xmm3,%%xmm8 \n" - "punpckldq %%xmm7,%%xmm3 \n" - "movlpd %%xmm3,(%1) \n" - "movhpd %%xmm3,(%2) \n" - "punpckhdq %%xmm7,%%xmm8 \n" - "sub $0x8,%3 \n" - "movlpd %%xmm8,(%1,%5) \n" - "lea (%1,%5,2),%1 \n" - "movhpd %%xmm8,(%2,%6) \n" - "lea (%2,%6,2),%2 \n" - "jg 1b \n" - : "+r"(src), // %0 - "+r"(dst_a), // %1 - "+r"(dst_b), // %2 - "+r"(width) // %3 - : "r"((intptr_t) (src_stride)), // %4 - "r"((intptr_t) (dst_stride_a)), // %5 - "r"((intptr_t) (dst_stride_b)) // %6 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7", "xmm8", "xmm9"); -} - -#endif // defined(HAS_TRANSPOSEUVWX8_SSE2) - -#endif // defined(__x86_64__) || defined(__i386__) diff --git a/pkg/encoder/yuv/libyuv/rotate_row.h b/pkg/encoder/yuv/libyuv/rotate_row.h deleted file mode 100644 index afdae49f..00000000 --- a/pkg/encoder/yuv/libyuv/rotate_row.h +++ /dev/null @@ -1,106 +0,0 @@ -/* - * Copyright 2013 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_ROTATE_ROW_H_ -#define INCLUDE_LIBYUV_ROTATE_ROW_H_ - -#include "basic_types.h" - -#if defined(__pnacl__) || defined(__CLR_VER) || \ - (defined(__native_client__) && defined(__x86_64__)) || \ - (defined(__i386__) && !defined(__SSE__) && !defined(__clang__)) -#define LIBYUV_DISABLE_X86 -#endif -#if defined(__native_client__) -#define LIBYUV_DISABLE_NEON -#endif -// MemorySanitizer does not support assembly code yet. http://crbug.com/344505 -#if defined(__has_feature) -#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_NEON) -#define LIBYUV_DISABLE_NEON -#endif -#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_X86) -#define LIBYUV_DISABLE_X86 -#endif -#endif - -// The following are available for GCC 32 or 64 bit: -#if !defined(LIBYUV_DISABLE_X86) && (defined(__i386__) || defined(__x86_64__)) -#define HAS_TRANSPOSEWX8_SSSE3 -#endif - -// The following are available for 64 bit GCC: -#if !defined(LIBYUV_DISABLE_X86) && defined(__x86_64__) -#define HAS_TRANSPOSEWX8_FAST_SSSE3 -#define HAS_TRANSPOSEUVWX8_SSE2 -#endif - -void TransposeWxH_C(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width, - int height); - -void TransposeWx8_C(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width); - -void TransposeWx8_SSSE3(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width); - -void TransposeWx8_Fast_SSSE3(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width); - -void TransposeWx8_Any_SSSE3(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width); - -void TransposeWx8_Fast_Any_SSSE3(const uint8_t *src, - int src_stride, - uint8_t *dst, - int dst_stride, - int width); - -void TransposeUVWx8_C(const uint8_t *src, - int src_stride, - uint8_t *dst_a, - int dst_stride_a, - uint8_t *dst_b, - int dst_stride_b, - int width); - -void TransposeUVWx8_SSE2(const uint8_t *src, - int src_stride, - uint8_t *dst_a, - int dst_stride_a, - uint8_t *dst_b, - int dst_stride_b, - int width); - -void TransposeUVWx8_Any_SSE2(const uint8_t *src, - int src_stride, - uint8_t *dst_a, - int dst_stride_a, - uint8_t *dst_b, - int dst_stride_b, - int width); - -#endif // INCLUDE_LIBYUV_ROTATE_ROW_H_ diff --git a/pkg/encoder/yuv/libyuv/row.h b/pkg/encoder/yuv/libyuv/row.h deleted file mode 100644 index ca1c0c29..00000000 --- a/pkg/encoder/yuv/libyuv/row.h +++ /dev/null @@ -1,426 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_ROW_H_ -#define INCLUDE_LIBYUV_ROW_H_ - -#include // For NULL -#include // For malloc - -#include "basic_types.h" - -#if defined(__pnacl__) || defined(__CLR_VER) || \ - (defined(__native_client__) && defined(__x86_64__)) || \ - (defined(__i386__) && !defined(__SSE__) && !defined(__clang__)) -#define LIBYUV_DISABLE_X86 -#endif -#if defined(__native_client__) -#define LIBYUV_DISABLE_NEON -#endif -// MemorySanitizer does not support assembly code yet. http://crbug.com/344505 -#if defined(__has_feature) -#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_NEON) -#define LIBYUV_DISABLE_NEON -#endif -#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_X86) -#define LIBYUV_DISABLE_X86 -#endif -#endif - -// GCC >= 4.7.0 required for AVX2. -#if defined(__GNUC__) && (defined(__x86_64__) || defined(__i386__)) -#if (__GNUC__ > 4) || (__GNUC__ == 4 && (__GNUC_MINOR__ >= 7)) -#define GCC_HAS_AVX2 1 -#endif // GNUC >= 4.7 -#endif // __GNUC__ - -// The following are available on all x86 platforms: -#if !defined(LIBYUV_DISABLE_X86) && \ - (defined(_M_IX86) || defined(__x86_64__) || defined(__i386__)) -// Conversions: -#define HAS_ABGRTOYROW_SSSE3 -#define HAS_ARGBTOYROW_SSSE3 -#define HAS_BGRATOYROW_SSSE3 -#define HAS_COPYROW_ERMS -#define HAS_COPYROW_SSE2 -#define HAS_INTERPOLATEROW_SSSE3 -#define HAS_MIRRORROW_SSSE3 -#define HAS_MIRRORSPLITUVROW_SSSE3 -#if !defined(LIBYUV_BIT_EXACT) -#define HAS_ABGRTOUVROW_SSSE3 -#define HAS_ARGBTOUVROW_SSSE3 -#endif - -// Effects: -#define HAS_ARGBGRAYROW_SSSE3 -#define HAS_ARGBMIRRORROW_SSE2 - -#endif - -// The following are available on all x86 platforms, but -// require VS2012, clang 3.4 or gcc 4.7. -#if !defined(LIBYUV_DISABLE_X86) && \ - (defined(VISUALC_HAS_AVX2) || defined(CLANG_HAS_AVX2) || \ - defined(GCC_HAS_AVX2)) -#define HAS_ARGBEXTRACTALPHAROW_AVX2 -#define HAS_ARGBMIRRORROW_AVX2 -#define HAS_ARGBTOYROW_AVX2 -#define HAS_COPYROW_AVX -#define HAS_INTERPOLATEROW_AVX2 -#define HAS_MIRRORROW_AVX2 -#if !defined(LIBYUV_BIT_EXACT) -#define HAS_ARGBTOUVROW_AVX2 -#endif - -#endif - -// The following are available for gcc/clang x86 platforms: -// TODO(fbarchard): Port to Visual C -#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) -#define HAS_MIRRORUVROW_SSSE3 - -#endif - -// The following are available for AVX2 gcc/clang x86 platforms: -// TODO(fbarchard): Port to Visual C -#if !defined(LIBYUV_DISABLE_X86) && \ - (defined(__x86_64__) || defined(__i386__)) && \ - (defined(CLANG_HAS_AVX2) || defined(GCC_HAS_AVX2)) -#define HAS_ABGRTOYROW_AVX2 -#define HAS_MIRRORUVROW_AVX2 -#if !defined(LIBYUV_BIT_EXACT) -#define HAS_ABGRTOUVROW_AVX2 -#endif - -#endif - -#if defined(_MSC_VER) && !defined(__CLR_VER) && !defined(__clang__) - #if defined(VISUALC_HAS_AVX2) -#define SIMD_ALIGNED(var) __declspec(align(32)) var -#else -#define SIMD_ALIGNED(var) __declspec(align(16)) var -#endif -#define LIBYUV_NOINLINE __declspec(noinline) -typedef __declspec(align(16)) int16_t vec16[8]; -typedef __declspec(align(16)) int32_t vec32[4]; -typedef __declspec(align(16)) float vecf32[4]; -typedef __declspec(align(16)) int8_t vec8[16]; -typedef __declspec(align(16)) uint16_t uvec16[8]; -typedef __declspec(align(16)) uint32_t uvec32[4]; -typedef __declspec(align(16)) uint8_t uvec8[16]; -typedef __declspec(align(32)) int16_t lvec16[16]; -typedef __declspec(align(32)) int32_t lvec32[8]; -typedef __declspec(align(32)) int8_t lvec8[32]; -typedef __declspec(align(32)) uint16_t ulvec16[16]; -typedef __declspec(align(32)) uint32_t ulvec32[8]; -typedef __declspec(align(32)) uint8_t ulvec8[32]; -#elif !defined(__pnacl__) && (defined(__GNUC__) || defined(__clang__)) -// Caveat GCC 4.2 to 4.7 have a known issue using vectors with const. -#if defined(CLANG_HAS_AVX2) || defined(GCC_HAS_AVX2) -#define SIMD_ALIGNED(var) var __attribute__((aligned(32))) -#else -#define SIMD_ALIGNED(var) var __attribute__((aligned(16))) -#endif -#define LIBYUV_NOINLINE __attribute__((noinline)) -typedef int16_t __attribute__((vector_size(16))) vec16; -typedef int32_t __attribute__((vector_size(16))) vec32; -typedef float __attribute__((vector_size(16))) vecf32; -typedef int8_t __attribute__((vector_size(16))) vec8; -typedef uint16_t __attribute__((vector_size(16))) uvec16; -typedef uint32_t __attribute__((vector_size(16))) uvec32; -typedef uint8_t __attribute__((vector_size(16))) uvec8; -typedef int16_t __attribute__((vector_size(32))) lvec16; -typedef int32_t __attribute__((vector_size(32))) lvec32; -typedef int8_t __attribute__((vector_size(32))) lvec8; -typedef uint16_t __attribute__((vector_size(32))) ulvec16; -typedef uint32_t __attribute__((vector_size(32))) ulvec32; -typedef uint8_t __attribute__((vector_size(32))) ulvec8; -#else -#define SIMD_ALIGNED(var) var -#define LIBYUV_NOINLINE -typedef int16_t vec16[8]; -typedef int32_t vec32[4]; -typedef float vecf32[4]; -typedef int8_t vec8[16]; -typedef uint16_t uvec16[8]; -typedef uint32_t uvec32[4]; -typedef uint8_t uvec8[16]; -typedef int16_t lvec16[16]; -typedef int32_t lvec32[8]; -typedef int8_t lvec8[32]; -typedef uint16_t ulvec16[16]; -typedef uint32_t ulvec32[8]; -typedef uint8_t ulvec8[32]; -#endif - -#if !defined(__aarch64__) || !defined(__arm__) -// This struct is for Intel color conversion. -struct YuvConstants { - uint8_t kUVToB[32]; - uint8_t kUVToG[32]; - uint8_t kUVToR[32]; - int16_t kYToRgb[16]; - int16_t kYBiasToRgb[16]; -}; -#endif - -#define IS_ALIGNED(p, a) (!((uintptr_t)(p) & ((a)-1))) - -#define align_buffer_64(var, size) \ - void* var##_mem = malloc((size) + 63); /* NOLINT */ \ - uint8_t* var = (uint8_t*)(((intptr_t)var##_mem + 63) & ~63) /* NOLINT */ - -#define free_aligned_buffer_64(var) \ - free(var##_mem); \ - var = NULL - -#if defined(__APPLE__) || defined(__x86_64__) || defined(__llvm__) -#define OMITFP -#else -#define OMITFP __attribute__((optimize("omit-frame-pointer"))) -#endif - -// NaCL macros for GCC x86 and x64. -#if defined(__native_client__) -#define LABELALIGN ".p2align 5\n" -#else -#define LABELALIGN -#endif - -void ARGBToYRow_AVX2(const uint8_t *src_argb, uint8_t *dst_y, int width); - -void ARGBToYRow_Any_AVX2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void ABGRToYRow_AVX2(const uint8_t *src_abgr, uint8_t *dst_y, int width); - -void ABGRToYRow_Any_AVX2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void ARGBToYRow_SSSE3(const uint8_t *src_argb, uint8_t *dst_y, int width); - -void ABGRToYRow_SSSE3(const uint8_t *src_abgr, uint8_t *dst_y, int width); - -void BGRAToYRow_SSSE3(const uint8_t *src_bgra, uint8_t *dst_y, int width); - -void ABGRToYRow_SSSE3(const uint8_t *src_abgr, uint8_t *dst_y, int width); - -void ARGBToYRow_C(const uint8_t *src_rgb, uint8_t *dst_y, int width); - -void ABGRToYRow_C(const uint8_t *src_rgb, uint8_t *dst_y, int width); - -void RGB565ToYRow_C(const uint8_t *src_rgb565, uint8_t *dst_y, int width); - -void ARGBToYRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void BGRAToYRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void ABGRToYRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void ARGBToUVRow_AVX2(const uint8_t *src_argb, - int src_stride_argb, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ABGRToUVRow_AVX2(const uint8_t *src_abgr, - int src_stride_abgr, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ARGBToUVRow_SSSE3(const uint8_t *src_argb, - int src_stride_argb, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void BGRAToUVRow_SSSE3(const uint8_t *src_bgra, - int src_stride_bgra, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ABGRToUVRow_SSSE3(const uint8_t *src_abgr, - int src_stride_abgr, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void RGBAToUVRow_SSSE3(const uint8_t *src_rgba, - int src_stride_rgba, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ARGBToUVRow_Any_AVX2(const uint8_t *src_ptr, - int src_stride, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ABGRToUVRow_Any_AVX2(const uint8_t *src_ptr, - int src_stride, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ARGBToUVRow_Any_SSSE3(const uint8_t *src_ptr, - int src_stride, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void BGRAToUVRow_Any_SSSE3(const uint8_t *src_ptr, - int src_stride, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ABGRToUVRow_Any_SSSE3(const uint8_t *src_ptr, - int src_stride, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void RGBAToUVRow_Any_SSSE3(const uint8_t *src_ptr, - int src_stride, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ARGBToUVRow_C(const uint8_t *src_rgb, - int src_stride_rgb, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ARGBToUVRow_C(const uint8_t *src_rgb, - int src_stride_rgb, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void BGRAToUVRow_C(const uint8_t *src_rgb, - int src_stride_rgb, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void ABGRToUVRow_C(const uint8_t *src_rgb, - int src_stride_rgb, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void RGBAToUVRow_C(const uint8_t *src_rgb, - int src_stride_rgb, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void RGB565ToUVRow_C(const uint8_t *src_rgb565, - int src_stride_rgb565, - uint8_t *dst_u, - uint8_t *dst_v, - int width); - -void MirrorRow_AVX2(const uint8_t *src, uint8_t *dst, int width); - -void MirrorRow_SSSE3(const uint8_t *src, uint8_t *dst, int width); - -void MirrorRow_C(const uint8_t *src, uint8_t *dst, int width); - -void MirrorRow_Any_AVX2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void MirrorRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void MirrorRow_Any_SSE2(const uint8_t *src, uint8_t *dst, int width); - -void MirrorUVRow_AVX2(const uint8_t *src_uv, uint8_t *dst_uv, int width); - -void MirrorUVRow_SSSE3(const uint8_t *src_uv, uint8_t *dst_uv, int width); - -void MirrorUVRow_Any_AVX2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void MirrorUVRow_Any_SSSE3(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void ARGBMirrorRow_AVX2(const uint8_t *src, uint8_t *dst, int width); - -void ARGBMirrorRow_SSE2(const uint8_t *src, uint8_t *dst, int width); - -void ARGBMirrorRow_C(const uint8_t *src, uint8_t *dst, int width); - -void ARGBMirrorRow_Any_AVX2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int width); - -void ARGBMirrorRow_Any_SSE2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int width); - -void CopyRow_SSE2(const uint8_t *src, uint8_t *dst, int width); - -void CopyRow_AVX(const uint8_t *src, uint8_t *dst, int width); - -void CopyRow_ERMS(const uint8_t *src, uint8_t *dst, int width); - -void CopyRow_C(const uint8_t *src, uint8_t *dst, int count); - -void CopyRow_Any_SSE2(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void CopyRow_Any_AVX(const uint8_t *src_ptr, uint8_t *dst_ptr, int width); - -void RGB565ToARGBRow_SSE2(const uint8_t *src, uint8_t *dst, int width); - -void RGB565ToARGBRow_AVX2(const uint8_t *src_rgb565, - uint8_t *dst_argb, - int width); - -void RGB565ToARGBRow_C(const uint8_t *src_rgb565, uint8_t *dst_argb, int width); - -void RGB565ToARGBRow_Any_SSE2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int width); - -void RGB565ToARGBRow_Any_AVX2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int width); - -// Used for I420Scale, ARGBScale, and ARGBInterpolate. -void InterpolateRow_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - ptrdiff_t src_stride, - int width, - int source_y_fraction); - -void InterpolateRow_SSSE3(uint8_t *dst_ptr, - const uint8_t *src_ptr, - ptrdiff_t src_stride, - int dst_width, - int source_y_fraction); - -void InterpolateRow_AVX2(uint8_t *dst_ptr, - const uint8_t *src_ptr, - ptrdiff_t src_stride, - int dst_width, - int source_y_fraction); - -void InterpolateRow_Any_SSSE3(uint8_t *dst_ptr, - const uint8_t *src_ptr, - ptrdiff_t src_stride_ptr, - int width, - int source_y_fraction); - -void InterpolateRow_Any_AVX2(uint8_t *dst_ptr, - const uint8_t *src_ptr, - ptrdiff_t src_stride_ptr, - int width, - int source_y_fraction); - -#endif // INCLUDE_LIBYUV_ROW_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/row_any.c b/pkg/encoder/yuv/libyuv/row_any.c deleted file mode 100644 index fcc49c67..00000000 --- a/pkg/encoder/yuv/libyuv/row_any.c +++ /dev/null @@ -1,206 +0,0 @@ -/* - * Copyright 2012 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "row.h" - -#include // For memset. - -// Subsampled source needs to be increase by 1 of not even. -#define SS(width, shift) (((width) + (1 << (shift)) - 1) >> (shift)) - -// Any 1 to 1. -#define ANY11(NAMEANY, ANY_SIMD, UVSHIFT, SBPP, BPP, MASK) \ - void NAMEANY(const uint8_t* src_ptr, uint8_t* dst_ptr, int width) { \ - SIMD_ALIGNED(uint8_t vin[128]); \ - SIMD_ALIGNED(uint8_t vout[128]); \ - memset(vin, 0, sizeof(vin)); /* for YUY2 and msan */ \ - int r = width & MASK; \ - int n = width & ~MASK; \ - if (n > 0) { \ - ANY_SIMD(src_ptr, dst_ptr, n); \ - } \ - memcpy(vin, src_ptr + (n >> UVSHIFT) * SBPP, SS(r, UVSHIFT) * SBPP); \ - ANY_SIMD(vin, vout, MASK + 1); \ - memcpy(dst_ptr + n * BPP, vout, r * BPP); \ - } - -#ifdef HAS_COPYROW_AVX - -ANY11(CopyRow_Any_AVX, CopyRow_AVX, 0, 1, 1, 63) - -#endif -#ifdef HAS_COPYROW_SSE2 - -ANY11(CopyRow_Any_SSE2, CopyRow_SSE2, 0, 1, 1, 31) - -#endif - -#ifdef HAS_ARGBTOYROW_AVX2 - -ANY11(ARGBToYRow_Any_AVX2, ARGBToYRow_AVX2, 0, 4, 1, 31) - -#endif -#ifdef HAS_ABGRTOYROW_AVX2 - -ANY11(ABGRToYRow_Any_AVX2, ABGRToYRow_AVX2, 0, 4, 1, 31) - -#endif -#ifdef HAS_ARGBTOYROW_SSSE3 - -ANY11(ARGBToYRow_Any_SSSE3, ARGBToYRow_SSSE3, 0, 4, 1, 15) - -#endif -#ifdef HAS_BGRATOYROW_SSSE3 - -ANY11(BGRAToYRow_Any_SSSE3, BGRAToYRow_SSSE3, 0, 4, 1, 15) - -ANY11(ABGRToYRow_Any_SSSE3, ABGRToYRow_SSSE3, 0, 4, 1, 15) - -#endif - -#undef ANY11 - -// Any 1 to 1 interpolate. Takes 2 rows of source via stride. -#define ANY11I(NAMEANY, ANY_SIMD, TD, TS, SBPP, BPP, MASK) \ - void NAMEANY(TD* dst_ptr, const TS* src_ptr, ptrdiff_t src_stride, \ - int width, int source_y_fraction) { \ - SIMD_ALIGNED(TS vin[64 * 2]); \ - SIMD_ALIGNED(TD vout[64]); \ - memset(vin, 0, sizeof(vin)); /* for msan */ \ - int r = width & MASK; \ - int n = width & ~MASK; \ - if (n > 0) { \ - ANY_SIMD(dst_ptr, src_ptr, src_stride, n, source_y_fraction); \ - } \ - memcpy(vin, src_ptr + n * SBPP, r * SBPP * sizeof(TS)); \ - if (source_y_fraction) { \ - memcpy(vin + 64, src_ptr + src_stride + n * SBPP, \ - r * SBPP * sizeof(TS)); \ - } \ - ANY_SIMD(vout, vin, 64, MASK + 1, source_y_fraction); \ - memcpy(dst_ptr + n * BPP, vout, r * BPP * sizeof(TD)); \ - } - -#ifdef HAS_INTERPOLATEROW_AVX2 - -ANY11I(InterpolateRow_Any_AVX2, InterpolateRow_AVX2, uint8_t, uint8_t, 1, 1, 31) - -#endif -#ifdef HAS_INTERPOLATEROW_SSSE3 - -ANY11I(InterpolateRow_Any_SSSE3, - InterpolateRow_SSSE3, - uint8_t, - uint8_t, - 1, - 1, - 15) - -#endif - -#undef ANY11I - -// Any 1 to 1 mirror. -#define ANY11M(NAMEANY, ANY_SIMD, BPP, MASK) \ - void NAMEANY(const uint8_t* src_ptr, uint8_t* dst_ptr, int width) { \ - SIMD_ALIGNED(uint8_t vin[64]); \ - SIMD_ALIGNED(uint8_t vout[64]); \ - memset(vin, 0, sizeof(vin)); /* for msan */ \ - int r = width & MASK; \ - int n = width & ~MASK; \ - if (n > 0) { \ - ANY_SIMD(src_ptr + r * BPP, dst_ptr, n); \ - } \ - memcpy(vin, src_ptr, r* BPP); \ - ANY_SIMD(vin, vout, MASK + 1); \ - memcpy(dst_ptr + n * BPP, vout + (MASK + 1 - r) * BPP, r * BPP); \ - } - -#ifdef HAS_MIRRORROW_AVX2 - -ANY11M(MirrorRow_Any_AVX2, MirrorRow_AVX2, 1, 31) - -#endif -#ifdef HAS_MIRRORROW_SSSE3 - -ANY11M(MirrorRow_Any_SSSE3, MirrorRow_SSSE3, 1, 15) - -#endif -#ifdef HAS_MIRRORUVROW_AVX2 - -ANY11M(MirrorUVRow_Any_AVX2, MirrorUVRow_AVX2, 2, 15) - -#endif -#ifdef HAS_MIRRORUVROW_SSSE3 - -ANY11M(MirrorUVRow_Any_SSSE3, MirrorUVRow_SSSE3, 2, 7) - -#endif -#ifdef HAS_ARGBMIRRORROW_AVX2 - -ANY11M(ARGBMirrorRow_Any_AVX2, ARGBMirrorRow_AVX2, 4, 7) - -#endif -#ifdef HAS_ARGBMIRRORROW_SSE2 - -ANY11M(ARGBMirrorRow_Any_SSE2, ARGBMirrorRow_SSE2, 4, 3) - -#endif -#undef ANY11M - -// Any 1 to 2 with source stride (2 rows of source). Outputs UV planes. -// 128 byte row allows for 32 avx ARGB pixels. -#define ANY12S(NAMEANY, ANY_SIMD, UVSHIFT, BPP, MASK) \ - void NAMEANY(const uint8_t* src_ptr, int src_stride, uint8_t* dst_u, \ - uint8_t* dst_v, int width) { \ - SIMD_ALIGNED(uint8_t vin[128 * 2]); \ - SIMD_ALIGNED(uint8_t vout[128 * 2]); \ - memset(vin, 0, sizeof(vin)); /* for msan */ \ - int r = width & MASK; \ - int n = width & ~MASK; \ - if (n > 0) { \ - ANY_SIMD(src_ptr, src_stride, dst_u, dst_v, n); \ - } \ - memcpy(vin, src_ptr + (n >> UVSHIFT) * BPP, SS(r, UVSHIFT) * BPP); \ - memcpy(vin + 128, src_ptr + src_stride + (n >> UVSHIFT) * BPP, \ - SS(r, UVSHIFT) * BPP); \ - if ((width & 1) && UVSHIFT == 0) { /* repeat last pixel for subsample */ \ - memcpy(vin + SS(r, UVSHIFT) * BPP, vin + SS(r, UVSHIFT) * BPP - BPP, \ - BPP); \ - memcpy(vin + 128 + SS(r, UVSHIFT) * BPP, \ - vin + 128 + SS(r, UVSHIFT) * BPP - BPP, BPP); \ - } \ - ANY_SIMD(vin, 128, vout, vout + 128, MASK + 1); \ - memcpy(dst_u + (n >> 1), vout, SS(r, 1)); \ - memcpy(dst_v + (n >> 1), vout + 128, SS(r, 1)); \ - } - -#ifdef HAS_ARGBTOUVROW_AVX2 - -ANY12S(ARGBToUVRow_Any_AVX2, ARGBToUVRow_AVX2, 0, 4, 31) - -#endif -#ifdef HAS_ABGRTOUVROW_AVX2 - -ANY12S(ABGRToUVRow_Any_AVX2, ABGRToUVRow_AVX2, 0, 4, 31) - -#endif -#ifdef HAS_ARGBTOUVROW_SSSE3 - -ANY12S(ARGBToUVRow_Any_SSSE3, ARGBToUVRow_SSSE3, 0, 4, 15) - -ANY12S(BGRAToUVRow_Any_SSSE3, BGRAToUVRow_SSSE3, 0, 4, 15) - -ANY12S(ABGRToUVRow_Any_SSSE3, ABGRToUVRow_SSSE3, 0, 4, 15) - -ANY12S(RGBAToUVRow_Any_SSSE3, RGBAToUVRow_SSSE3, 0, 4, 15) - -#endif -#undef ANY12S diff --git a/pkg/encoder/yuv/libyuv/row_common.c b/pkg/encoder/yuv/libyuv/row_common.c deleted file mode 100644 index 34a93a07..00000000 --- a/pkg/encoder/yuv/libyuv/row_common.c +++ /dev/null @@ -1,887 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "row.h" - -#include -#include // For memcpy and memset. - -#define STATIC_CAST(type, expr) (type)(expr) - -// This macro controls YUV to RGB using unsigned math to extend range of -// YUV to RGB coefficients to 0 to 4 instead of 0 to 2 for more accuracy on B: -// LIBYUV_UNLIMITED_DATA - -// Macros to enable unlimited data for each colorspace -// LIBYUV_UNLIMITED_BT601 -// LIBYUV_UNLIMITED_BT709 -// LIBYUV_UNLIMITED_BT2020 - -#if !defined(LIBYUV_BIT_EXACT) && (defined(__x86_64__) || defined(_M_X64) || \ - defined(__i386__) || defined(_M_IX86)) -#define LIBYUV_ARGBTOUV_PAVGB 1 -#define LIBYUV_RGBTOU_TRUNCATE 1 -#endif -#if defined(LIBYUV_BIT_EXACT) -#define LIBYUV_UNATTENUATE_DUP 1 -#endif - -// llvm x86 is poor at ternary operator, so use branchless min/max. - -#define USE_BRANCHLESS 1 -#if USE_BRANCHLESS - -static __inline int32_t clamp0(int32_t v) { - return -(v >= 0) & v; -} - -// TODO(fbarchard): make clamp255 preserve negative values. -static __inline int32_t clamp255(int32_t v) { - return (-(v >= 255) | v) & 255; -} - -static __inline int32_t clamp1023(int32_t v) { - return (-(v >= 1023) | v) & 1023; -} - -// clamp to max -static __inline int32_t ClampMax(int32_t v, int32_t max) { - return (-(v >= max) | v) & max; -} - -static __inline uint32_t Abs(int32_t v) { - int m = -(v < 0); - return (v + m) ^ m; -} - -#else // USE_BRANCHLESS -static __inline int32_t clamp0(int32_t v) { - return (v < 0) ? 0 : v; -} - -static __inline int32_t clamp255(int32_t v) { - return (v > 255) ? 255 : v; -} - -static __inline int32_t clamp1023(int32_t v) { - return (v > 1023) ? 1023 : v; -} - -static __inline int32_t ClampMax(int32_t v, int32_t max) { - return (v > max) ? max : v; -} - -static __inline uint32_t Abs(int32_t v) { - return (v < 0) ? -v : v; -} -#endif // USE_BRANCHLESS - -static __inline uint32_t Clamp(int32_t val) { - int v = clamp0(val); - return (uint32_t) (clamp255(v)); -} - -static __inline uint32_t Clamp10(int32_t val) { - int v = clamp0(val); - return (uint32_t) (clamp1023(v)); -} - -// Little Endian -#if defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || \ - defined(_M_IX86) || defined(__arm__) || defined(_M_ARM) || \ - (defined(__BYTE_ORDER__) && __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__) -#define WRITEWORD(p, v) *(uint32_t*)(p) = v -#else -static inline void WRITEWORD(uint8_t* p, uint32_t v) { - p[0] = (uint8_t)(v & 255); - p[1] = (uint8_t)((v >> 8) & 255); - p[2] = (uint8_t)((v >> 16) & 255); - p[3] = (uint8_t)((v >> 24) & 255); -} -#endif - -void RGB565ToARGBRow_C(const uint8_t *src_rgb565, - uint8_t *dst_argb, - int width) { - int x; - for (x = 0; x < width; ++x) { - uint8_t b = STATIC_CAST(uint8_t, src_rgb565[0] & 0x1f); - uint8_t g = STATIC_CAST( - uint8_t, (src_rgb565[0] >> 5) | ((src_rgb565[1] & 0x07) << 3)); - uint8_t r = STATIC_CAST(uint8_t, src_rgb565[1] >> 3); - dst_argb[0] = STATIC_CAST(uint8_t, (b << 3) | (b >> 2)); - dst_argb[1] = STATIC_CAST(uint8_t, (g << 2) | (g >> 4)); - dst_argb[2] = STATIC_CAST(uint8_t, (r << 3) | (r >> 2)); - dst_argb[3] = 255u; - dst_argb += 4; - src_rgb565 += 2; - } -} - -// 8 bit -// Intel SSE/AVX uses the following equivalent formula -// 0x7e80 = (66 + 129 + 25) * -128 + 0x1000 (for +16) and 0x0080 for round. -// return (66 * ((int)r - 128) + 129 * ((int)g - 128) + 25 * ((int)b - 128) + -// 0x7e80) >> 8; - -static __inline uint8_t RGBToY(uint8_t r, uint8_t g, uint8_t b) { - return STATIC_CAST(uint8_t, (66 * r + 129 * g + 25 * b + 0x1080) >> 8); -} - -#define AVGB(a, b) (((a) + (b) + 1) >> 1) - -// LIBYUV_RGBTOU_TRUNCATE mimics x86 code that does not round. -#ifdef LIBYUV_RGBTOU_TRUNCATE - -static __inline uint8_t RGBToU(uint8_t r, uint8_t g, uint8_t b) { - return STATIC_CAST(uint8_t, (112 * b - 74 * g - 38 * r + 0x8000) >> 8); -} - -static __inline uint8_t RGBToV(uint8_t r, uint8_t g, uint8_t b) { - return STATIC_CAST(uint8_t, (112 * r - 94 * g - 18 * b + 0x8000) >> 8); -} - -#else -// TODO(fbarchard): Add rounding to x86 SIMD and use this -static __inline uint8_t RGBToU(uint8_t r, uint8_t g, uint8_t b) { - return STATIC_CAST(uint8_t, (112 * b - 74 * g - 38 * r + 0x8080) >> 8); -} -static __inline uint8_t RGBToV(uint8_t r, uint8_t g, uint8_t b) { - return STATIC_CAST(uint8_t, (112 * r - 94 * g - 18 * b + 0x8080) >> 8); -} -#endif - -// LIBYUV_ARGBTOUV_PAVGB mimics x86 code that subsamples with 2 pavgb. -#if !defined(LIBYUV_ARGBTOUV_PAVGB) -static __inline int RGB2xToU(uint16_t r, uint16_t g, uint16_t b) { - return STATIC_CAST( - uint8_t, ((112 / 2) * b - (74 / 2) * g - (38 / 2) * r + 0x8080) >> 8); -} -static __inline int RGB2xToV(uint16_t r, uint16_t g, uint16_t b) { - return STATIC_CAST( - uint8_t, ((112 / 2) * r - (94 / 2) * g - (18 / 2) * b + 0x8080) >> 8); -} -#endif - -// ARGBToY_C and ARGBToUV_C -// Intel version mimic SSE/AVX which does 2 pavgb -#if LIBYUV_ARGBTOUV_PAVGB -#define MAKEROWY(NAME, R, G, B, BPP) \ - void NAME##ToYRow_C(const uint8_t* src_rgb, uint8_t* dst_y, int width) { \ - int x; \ - for (x = 0; x < width; ++x) { \ - dst_y[0] = RGBToY(src_rgb[R], src_rgb[G], src_rgb[B]); \ - src_rgb += BPP; \ - dst_y += 1; \ - } \ - } \ - void NAME##ToUVRow_C(const uint8_t* src_rgb, int src_stride_rgb, \ - uint8_t* dst_u, uint8_t* dst_v, int width) { \ - const uint8_t* src_rgb1 = src_rgb + src_stride_rgb; \ - int x; \ - for (x = 0; x < width - 1; x += 2) { \ - uint8_t ab = AVGB(AVGB(src_rgb[B], src_rgb1[B]), \ - AVGB(src_rgb[B + BPP], src_rgb1[B + BPP])); \ - uint8_t ag = AVGB(AVGB(src_rgb[G], src_rgb1[G]), \ - AVGB(src_rgb[G + BPP], src_rgb1[G + BPP])); \ - uint8_t ar = AVGB(AVGB(src_rgb[R], src_rgb1[R]), \ - AVGB(src_rgb[R + BPP], src_rgb1[R + BPP])); \ - dst_u[0] = RGBToU(ar, ag, ab); \ - dst_v[0] = RGBToV(ar, ag, ab); \ - src_rgb += BPP * 2; \ - src_rgb1 += BPP * 2; \ - dst_u += 1; \ - dst_v += 1; \ - } \ - if (width & 1) { \ - uint8_t ab = AVGB(src_rgb[B], src_rgb1[B]); \ - uint8_t ag = AVGB(src_rgb[G], src_rgb1[G]); \ - uint8_t ar = AVGB(src_rgb[R], src_rgb1[R]); \ - dst_u[0] = RGBToU(ar, ag, ab); \ - dst_v[0] = RGBToV(ar, ag, ab); \ - } \ - } -#else -// ARM version does sum / 2 then multiply by 2x smaller coefficients -#define MAKEROWY(NAME, R, G, B, BPP) \ - void NAME##ToYRow_C(const uint8_t* src_rgb, uint8_t* dst_y, int width) { \ - int x; \ - for (x = 0; x < width; ++x) { \ - dst_y[0] = RGBToY(src_rgb[R], src_rgb[G], src_rgb[B]); \ - src_rgb += BPP; \ - dst_y += 1; \ - } \ - } \ - void NAME##ToUVRow_C(const uint8_t* src_rgb, int src_stride_rgb, \ - uint8_t* dst_u, uint8_t* dst_v, int width) { \ - const uint8_t* src_rgb1 = src_rgb + src_stride_rgb; \ - int x; \ - for (x = 0; x < width - 1; x += 2) { \ - uint16_t ab = (src_rgb[B] + src_rgb[B + BPP] + src_rgb1[B] + \ - src_rgb1[B + BPP] + 1) >> \ - 1; \ - uint16_t ag = (src_rgb[G] + src_rgb[G + BPP] + src_rgb1[G] + \ - src_rgb1[G + BPP] + 1) >> \ - 1; \ - uint16_t ar = (src_rgb[R] + src_rgb[R + BPP] + src_rgb1[R] + \ - src_rgb1[R + BPP] + 1) >> \ - 1; \ - dst_u[0] = RGB2xToU(ar, ag, ab); \ - dst_v[0] = RGB2xToV(ar, ag, ab); \ - src_rgb += BPP * 2; \ - src_rgb1 += BPP * 2; \ - dst_u += 1; \ - dst_v += 1; \ - } \ - if (width & 1) { \ - uint16_t ab = src_rgb[B] + src_rgb1[B]; \ - uint16_t ag = src_rgb[G] + src_rgb1[G]; \ - uint16_t ar = src_rgb[R] + src_rgb1[R]; \ - dst_u[0] = RGB2xToU(ar, ag, ab); \ - dst_v[0] = RGB2xToV(ar, ag, ab); \ - } \ - } -#endif - -MAKEROWY(ARGB, 2, 1, 0, 4) - -MAKEROWY(BGRA, 1, 2, 3, 4) - -MAKEROWY(ABGR, 0, 1, 2, 4) - -MAKEROWY(RGBA, 3, 2, 1, 4) - -#undef MAKEROWY - -// JPeg uses a variation on BT.601-1 full range -// y = 0.29900 * r + 0.58700 * g + 0.11400 * b -// u = -0.16874 * r - 0.33126 * g + 0.50000 * b + center -// v = 0.50000 * r - 0.41869 * g - 0.08131 * b + center -// BT.601 Mpeg range uses: -// b 0.1016 * 255 = 25.908 = 25 -// g 0.5078 * 255 = 129.489 = 129 -// r 0.2578 * 255 = 65.739 = 66 -// JPeg 7 bit Y (deprecated) -// b 0.11400 * 128 = 14.592 = 15 -// g 0.58700 * 128 = 75.136 = 75 -// r 0.29900 * 128 = 38.272 = 38 -// JPeg 8 bit Y: -// b 0.11400 * 256 = 29.184 = 29 -// g 0.58700 * 256 = 150.272 = 150 -// r 0.29900 * 256 = 76.544 = 77 -// JPeg 8 bit U: -// b 0.50000 * 255 = 127.5 = 127 -// g -0.33126 * 255 = -84.4713 = -84 -// r -0.16874 * 255 = -43.0287 = -43 -// JPeg 8 bit V: -// b -0.08131 * 255 = -20.73405 = -20 -// g -0.41869 * 255 = -106.76595 = -107 -// r 0.50000 * 255 = 127.5 = 127 - -// 8 bit -static __inline uint8_t RGBToYJ(uint8_t r, uint8_t g, uint8_t b) { - return (77 * r + 150 * g + 29 * b + 128) >> 8; -} - -#if defined(LIBYUV_ARGBTOUV_PAVGB) - -static __inline uint8_t RGBToUJ(uint8_t r, uint8_t g, uint8_t b) { - return (127 * b - 84 * g - 43 * r + 0x8080) >> 8; -} - -static __inline uint8_t RGBToVJ(uint8_t r, uint8_t g, uint8_t b) { - return (127 * r - 107 * g - 20 * b + 0x8080) >> 8; -} - -#else -static __inline uint8_t RGB2xToUJ(uint16_t r, uint16_t g, uint16_t b) { - return ((127 / 2) * b - (84 / 2) * g - (43 / 2) * r + 0x8080) >> 8; -} -static __inline uint8_t RGB2xToVJ(uint16_t r, uint16_t g, uint16_t b) { - return ((127 / 2) * r - (107 / 2) * g - (20 / 2) * b + 0x8080) >> 8; -} -#endif - -// ARGBToYJ_C and ARGBToUVJ_C -// Intel version mimic SSE/AVX which does 2 pavgb -#if LIBYUV_ARGBTOUV_PAVGB -#define MAKEROWYJ(NAME, R, G, B, BPP) \ - void NAME##ToYJRow_C(const uint8_t* src_rgb, uint8_t* dst_y, int width) { \ - int x; \ - for (x = 0; x < width; ++x) { \ - dst_y[0] = RGBToYJ(src_rgb[R], src_rgb[G], src_rgb[B]); \ - src_rgb += BPP; \ - dst_y += 1; \ - } \ - } \ - void NAME##ToUVJRow_C(const uint8_t* src_rgb, int src_stride_rgb, \ - uint8_t* dst_u, uint8_t* dst_v, int width) { \ - const uint8_t* src_rgb1 = src_rgb + src_stride_rgb; \ - int x; \ - for (x = 0; x < width - 1; x += 2) { \ - uint8_t ab = AVGB(AVGB(src_rgb[B], src_rgb1[B]), \ - AVGB(src_rgb[B + BPP], src_rgb1[B + BPP])); \ - uint8_t ag = AVGB(AVGB(src_rgb[G], src_rgb1[G]), \ - AVGB(src_rgb[G + BPP], src_rgb1[G + BPP])); \ - uint8_t ar = AVGB(AVGB(src_rgb[R], src_rgb1[R]), \ - AVGB(src_rgb[R + BPP], src_rgb1[R + BPP])); \ - dst_u[0] = RGBToUJ(ar, ag, ab); \ - dst_v[0] = RGBToVJ(ar, ag, ab); \ - src_rgb += BPP * 2; \ - src_rgb1 += BPP * 2; \ - dst_u += 1; \ - dst_v += 1; \ - } \ - if (width & 1) { \ - uint8_t ab = AVGB(src_rgb[B], src_rgb1[B]); \ - uint8_t ag = AVGB(src_rgb[G], src_rgb1[G]); \ - uint8_t ar = AVGB(src_rgb[R], src_rgb1[R]); \ - dst_u[0] = RGBToUJ(ar, ag, ab); \ - dst_v[0] = RGBToVJ(ar, ag, ab); \ - } \ - } -#else -// ARM version does sum / 2 then multiply by 2x smaller coefficients -#define MAKEROWYJ(NAME, R, G, B, BPP) \ - void NAME##ToYJRow_C(const uint8_t* src_rgb, uint8_t* dst_y, int width) { \ - int x; \ - for (x = 0; x < width; ++x) { \ - dst_y[0] = RGBToYJ(src_rgb[R], src_rgb[G], src_rgb[B]); \ - src_rgb += BPP; \ - dst_y += 1; \ - } \ - } \ - void NAME##ToUVJRow_C(const uint8_t* src_rgb, int src_stride_rgb, \ - uint8_t* dst_u, uint8_t* dst_v, int width) { \ - const uint8_t* src_rgb1 = src_rgb + src_stride_rgb; \ - int x; \ - for (x = 0; x < width - 1; x += 2) { \ - uint16_t ab = (src_rgb[B] + src_rgb[B + BPP] + src_rgb1[B] + \ - src_rgb1[B + BPP] + 1) >> \ - 1; \ - uint16_t ag = (src_rgb[G] + src_rgb[G + BPP] + src_rgb1[G] + \ - src_rgb1[G + BPP] + 1) >> \ - 1; \ - uint16_t ar = (src_rgb[R] + src_rgb[R + BPP] + src_rgb1[R] + \ - src_rgb1[R + BPP] + 1) >> \ - 1; \ - dst_u[0] = RGB2xToUJ(ar, ag, ab); \ - dst_v[0] = RGB2xToVJ(ar, ag, ab); \ - src_rgb += BPP * 2; \ - src_rgb1 += BPP * 2; \ - dst_u += 1; \ - dst_v += 1; \ - } \ - if (width & 1) { \ - uint16_t ab = (src_rgb[B] + src_rgb1[B]); \ - uint16_t ag = (src_rgb[G] + src_rgb1[G]); \ - uint16_t ar = (src_rgb[R] + src_rgb1[R]); \ - dst_u[0] = RGB2xToUJ(ar, ag, ab); \ - dst_v[0] = RGB2xToVJ(ar, ag, ab); \ - } \ - } - -#endif - -MAKEROWYJ(ARGB, 2, 1, 0, 4) - -MAKEROWYJ(ABGR, 0, 1, 2, 4) - -MAKEROWYJ(RGBA, 3, 2, 1, 4) - -MAKEROWYJ(RGB24, 2, 1, 0, 3) - -MAKEROWYJ(RAW, 0, 1, 2, 3) - -#undef MAKEROWYJ - -void RGB565ToYRow_C(const uint8_t *src_rgb565, uint8_t *dst_y, int width) { - int x; - for (x = 0; x < width; ++x) { - uint8_t b = src_rgb565[0] & 0x1f; - uint8_t g = STATIC_CAST( - uint8_t, (src_rgb565[0] >> 5) | ((src_rgb565[1] & 0x07) << 3)); - uint8_t r = src_rgb565[1] >> 3; - b = STATIC_CAST(uint8_t, (b << 3) | (b >> 2)); - g = STATIC_CAST(uint8_t, (g << 2) | (g >> 4)); - r = STATIC_CAST(uint8_t, (r << 3) | (r >> 2)); - dst_y[0] = RGBToY(r, g, b); - src_rgb565 += 2; - dst_y += 1; - } -} - -void RGB565ToUVRow_C(const uint8_t *src_rgb565, - int src_stride_rgb565, - uint8_t *dst_u, - uint8_t *dst_v, - int width) { - const uint8_t *next_rgb565 = src_rgb565 + src_stride_rgb565; - int x; - for (x = 0; x < width - 1; x += 2) { - uint8_t b0 = STATIC_CAST(uint8_t, src_rgb565[0] & 0x1f); - uint8_t g0 = STATIC_CAST( - uint8_t, (src_rgb565[0] >> 5) | ((src_rgb565[1] & 0x07) << 3)); - uint8_t r0 = STATIC_CAST(uint8_t, src_rgb565[1] >> 3); - uint8_t b1 = STATIC_CAST(uint8_t, src_rgb565[2] & 0x1f); - uint8_t g1 = STATIC_CAST( - uint8_t, (src_rgb565[2] >> 5) | ((src_rgb565[3] & 0x07) << 3)); - uint8_t r1 = STATIC_CAST(uint8_t, src_rgb565[3] >> 3); - uint8_t b2 = STATIC_CAST(uint8_t, next_rgb565[0] & 0x1f); - uint8_t g2 = STATIC_CAST( - uint8_t, (next_rgb565[0] >> 5) | ((next_rgb565[1] & 0x07) << 3)); - uint8_t r2 = STATIC_CAST(uint8_t, next_rgb565[1] >> 3); - uint8_t b3 = STATIC_CAST(uint8_t, next_rgb565[2] & 0x1f); - uint8_t g3 = STATIC_CAST( - uint8_t, (next_rgb565[2] >> 5) | ((next_rgb565[3] & 0x07) << 3)); - uint8_t r3 = STATIC_CAST(uint8_t, next_rgb565[3] >> 3); - - b0 = STATIC_CAST(uint8_t, (b0 << 3) | (b0 >> 2)); - g0 = STATIC_CAST(uint8_t, (g0 << 2) | (g0 >> 4)); - r0 = STATIC_CAST(uint8_t, (r0 << 3) | (r0 >> 2)); - b1 = STATIC_CAST(uint8_t, (b1 << 3) | (b1 >> 2)); - g1 = STATIC_CAST(uint8_t, (g1 << 2) | (g1 >> 4)); - r1 = STATIC_CAST(uint8_t, (r1 << 3) | (r1 >> 2)); - b2 = STATIC_CAST(uint8_t, (b2 << 3) | (b2 >> 2)); - g2 = STATIC_CAST(uint8_t, (g2 << 2) | (g2 >> 4)); - r2 = STATIC_CAST(uint8_t, (r2 << 3) | (r2 >> 2)); - b3 = STATIC_CAST(uint8_t, (b3 << 3) | (b3 >> 2)); - g3 = STATIC_CAST(uint8_t, (g3 << 2) | (g3 >> 4)); - r3 = STATIC_CAST(uint8_t, (r3 << 3) | (r3 >> 2)); - -#if LIBYUV_ARGBTOUV_PAVGB - uint8_t ab = AVGB(AVGB(b0, b2), AVGB(b1, b3)); - uint8_t ag = AVGB(AVGB(g0, g2), AVGB(g1, g3)); - uint8_t ar = AVGB(AVGB(r0, r2), AVGB(r1, r3)); - dst_u[0] = RGBToU(ar, ag, ab); - dst_v[0] = RGBToV(ar, ag, ab); -#else - uint16_t b = (b0 + b1 + b2 + b3 + 1) >> 1; - uint16_t g = (g0 + g1 + g2 + g3 + 1) >> 1; - uint16_t r = (r0 + r1 + r2 + r3 + 1) >> 1; - dst_u[0] = RGB2xToU(r, g, b); - dst_v[0] = RGB2xToV(r, g, b); -#endif - - src_rgb565 += 4; - next_rgb565 += 4; - dst_u += 1; - dst_v += 1; - } - if (width & 1) { - uint8_t b0 = STATIC_CAST(uint8_t, src_rgb565[0] & 0x1f); - uint8_t g0 = STATIC_CAST( - uint8_t, (src_rgb565[0] >> 5) | ((src_rgb565[1] & 0x07) << 3)); - uint8_t r0 = STATIC_CAST(uint8_t, src_rgb565[1] >> 3); - uint8_t b2 = STATIC_CAST(uint8_t, next_rgb565[0] & 0x1f); - uint8_t g2 = STATIC_CAST( - uint8_t, (next_rgb565[0] >> 5) | ((next_rgb565[1] & 0x07) << 3)); - uint8_t r2 = STATIC_CAST(uint8_t, next_rgb565[1] >> 3); - b0 = STATIC_CAST(uint8_t, (b0 << 3) | (b0 >> 2)); - g0 = STATIC_CAST(uint8_t, (g0 << 2) | (g0 >> 4)); - r0 = STATIC_CAST(uint8_t, (r0 << 3) | (r0 >> 2)); - b2 = STATIC_CAST(uint8_t, (b2 << 3) | (b2 >> 2)); - g2 = STATIC_CAST(uint8_t, (g2 << 2) | (g2 >> 4)); - r2 = STATIC_CAST(uint8_t, (r2 << 3) | (r2 >> 2)); - -#if LIBYUV_ARGBTOUV_PAVGB - uint8_t ab = AVGB(b0, b2); - uint8_t ag = AVGB(g0, g2); - uint8_t ar = AVGB(r0, r2); - dst_u[0] = RGBToU(ar, ag, ab); - dst_v[0] = RGBToV(ar, ag, ab); -#else - uint16_t b = b0 + b2; - uint16_t g = g0 + g2; - uint16_t r = r0 + r2; - dst_u[0] = RGB2xToU(r, g, b); - dst_v[0] = RGB2xToV(r, g, b); -#endif - } -} - -#define REPEAT8(v) (v) | ((v) << 8) -#define SHADE(f, v) v* f >> 24 - -#undef REPEAT8 -#undef SHADE - -#define REPEAT8(v) (v) | ((v) << 8) -#define SHADE(f, v) v* f >> 16 - -#undef REPEAT8 -#undef SHADE - -#define SHADE(f, v) clamp255(v + f) - -#undef SHADE - -#define SHADE(f, v) clamp0(f - v) - -#undef SHADE - -// Macros to create SIMD specific yuv to rgb conversion constants. - -// clang-format off - -#if defined(__aarch64__) || defined(__arm__) -// Bias values include subtract 128 from U and V, bias from Y and rounding. -// For B and R bias is negative. For G bias is positive. -#define YUVCONSTANTSBODY(YG, YB, UB, UG, VG, VR) \ - {{UB, VR, UG, VG, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}, \ - {YG, (UB * 128 - YB), (UG * 128 + VG * 128 + YB), (VR * 128 - YB), YB, 0, \ - 0, 0}} -#else -#define YUVCONSTANTSBODY(YG, YB, UB, UG, VG, VR) \ - {{UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, \ - UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0, UB, 0}, \ - {UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, \ - UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG, UG, VG}, \ - {0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, \ - 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR, 0, VR}, \ - {YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG, YG}, \ - {YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB, YB}} -#endif - -// clang-format on - -#define MAKEYUVCONSTANTS(name, YG, YB, UB, UG, VG, VR) \ - const struct YuvConstants SIMD_ALIGNED(kYuv##name##Constants) = \ - YUVCONSTANTSBODY(YG, YB, UB, UG, VG, VR); \ - const struct YuvConstants SIMD_ALIGNED(kYvu##name##Constants) = \ - YUVCONSTANTSBODY(YG, YB, VR, VG, UG, UB); - -// TODO(fbarchard): Generate SIMD structures from float matrix. - -// BT.601 limited range YUV to RGB reference -// R = (Y - 16) * 1.164 + V * 1.596 -// G = (Y - 16) * 1.164 - U * 0.391 - V * 0.813 -// B = (Y - 16) * 1.164 + U * 2.018 -// KR = 0.299; KB = 0.114 - -// U and V contributions to R,G,B. -#if defined(LIBYUV_UNLIMITED_DATA) || defined(LIBYUV_UNLIMITED_BT601) -#define UB 129 /* round(2.018 * 64) */ -#else -#define UB 128 /* max(128, round(2.018 * 64)) */ -#endif -#define UG 25 /* round(0.391 * 64) */ -#define VG 52 /* round(0.813 * 64) */ -#define VR 102 /* round(1.596 * 64) */ - -// Y contribution to R,G,B. Scale and bias. -#define YG 18997 /* round(1.164 * 64 * 256 * 256 / 257) */ -#define YB -1160 /* 1.164 * 64 * -16 + 64 / 2 */ - -MAKEYUVCONSTANTS(I601, YG, YB, UB, UG, VG, VR) - -#undef YG -#undef YB -#undef UB -#undef UG -#undef VG -#undef VR - -// BT.601 full range YUV to RGB reference (aka JPEG) -// * R = Y + V * 1.40200 -// * G = Y - U * 0.34414 - V * 0.71414 -// * B = Y + U * 1.77200 -// KR = 0.299; KB = 0.114 - -// U and V contributions to R,G,B. -#define UB 113 /* round(1.77200 * 64) */ -#define UG 22 /* round(0.34414 * 64) */ -#define VG 46 /* round(0.71414 * 64) */ -#define VR 90 /* round(1.40200 * 64) */ - -// Y contribution to R,G,B. Scale and bias. -#define YG 16320 /* round(1.000 * 64 * 256 * 256 / 257) */ -#define YB 32 /* 64 / 2 */ - -MAKEYUVCONSTANTS(JPEG, YG, YB, UB, UG, VG, VR) - -#undef YG -#undef YB -#undef UB -#undef UG -#undef VG -#undef VR - -// BT.709 limited range YUV to RGB reference -// R = (Y - 16) * 1.164 + V * 1.793 -// G = (Y - 16) * 1.164 - U * 0.213 - V * 0.533 -// B = (Y - 16) * 1.164 + U * 2.112 -// KR = 0.2126, KB = 0.0722 - -// U and V contributions to R,G,B. -#if defined(LIBYUV_UNLIMITED_DATA) || defined(LIBYUV_UNLIMITED_BT709) -#define UB 135 /* round(2.112 * 64) */ -#else -#define UB 128 /* max(128, round(2.112 * 64)) */ -#endif -#define UG 14 /* round(0.213 * 64) */ -#define VG 34 /* round(0.533 * 64) */ -#define VR 115 /* round(1.793 * 64) */ - -// Y contribution to R,G,B. Scale and bias. -#define YG 18997 /* round(1.164 * 64 * 256 * 256 / 257) */ -#define YB -1160 /* 1.164 * 64 * -16 + 64 / 2 */ - -MAKEYUVCONSTANTS(H709, YG, YB, UB, UG, VG, VR) - -#undef YG -#undef YB -#undef UB -#undef UG -#undef VG -#undef VR - -// BT.709 full range YUV to RGB reference -// R = Y + V * 1.5748 -// G = Y - U * 0.18732 - V * 0.46812 -// B = Y + U * 1.8556 -// KR = 0.2126, KB = 0.0722 - -// U and V contributions to R,G,B. -#define UB 119 /* round(1.8556 * 64) */ -#define UG 12 /* round(0.18732 * 64) */ -#define VG 30 /* round(0.46812 * 64) */ -#define VR 101 /* round(1.5748 * 64) */ - -// Y contribution to R,G,B. Scale and bias. (same as jpeg) -#define YG 16320 /* round(1 * 64 * 256 * 256 / 257) */ -#define YB 32 /* 64 / 2 */ - -MAKEYUVCONSTANTS(F709, YG, YB, UB, UG, VG, VR) - -#undef YG -#undef YB -#undef UB -#undef UG -#undef VG -#undef VR - -// BT.2020 limited range YUV to RGB reference -// R = (Y - 16) * 1.164384 + V * 1.67867 -// G = (Y - 16) * 1.164384 - U * 0.187326 - V * 0.65042 -// B = (Y - 16) * 1.164384 + U * 2.14177 -// KR = 0.2627; KB = 0.0593 - -// U and V contributions to R,G,B. -#if defined(LIBYUV_UNLIMITED_DATA) || defined(LIBYUV_UNLIMITED_BT2020) -#define UB 137 /* round(2.142 * 64) */ -#else -#define UB 128 /* max(128, round(2.142 * 64)) */ -#endif -#define UG 12 /* round(0.187326 * 64) */ -#define VG 42 /* round(0.65042 * 64) */ -#define VR 107 /* round(1.67867 * 64) */ - -// Y contribution to R,G,B. Scale and bias. -#define YG 19003 /* round(1.164384 * 64 * 256 * 256 / 257) */ -#define YB -1160 /* 1.164384 * 64 * -16 + 64 / 2 */ - -MAKEYUVCONSTANTS(2020, YG, YB, UB, UG, VG, VR) - -#undef YG -#undef YB -#undef UB -#undef UG -#undef VG -#undef VR - -// BT.2020 full range YUV to RGB reference -// R = Y + V * 1.474600 -// G = Y - U * 0.164553 - V * 0.571353 -// B = Y + U * 1.881400 -// KR = 0.2627; KB = 0.0593 - -#define UB 120 /* round(1.881400 * 64) */ -#define UG 11 /* round(0.164553 * 64) */ -#define VG 37 /* round(0.571353 * 64) */ -#define VR 94 /* round(1.474600 * 64) */ - -// Y contribution to R,G,B. Scale and bias. (same as jpeg) -#define YG 16320 /* round(1 * 64 * 256 * 256 / 257) */ -#define YB 32 /* 64 / 2 */ - -MAKEYUVCONSTANTS(V2020, YG, YB, UB, UG, VG, VR) - -#undef YG -#undef YB -#undef UB -#undef UG -#undef VG -#undef VR - -#undef BB -#undef BG -#undef BR - -#undef MAKEYUVCONSTANTS - -#if defined(__aarch64__) || defined(__arm__) -#define LOAD_YUV_CONSTANTS \ - int ub = yuvconstants->kUVCoeff[0]; \ - int vr = yuvconstants->kUVCoeff[1]; \ - int ug = yuvconstants->kUVCoeff[2]; \ - int vg = yuvconstants->kUVCoeff[3]; \ - int yg = yuvconstants->kRGBCoeffBias[0]; \ - int bb = yuvconstants->kRGBCoeffBias[1]; \ - int bg = yuvconstants->kRGBCoeffBias[2]; \ - int br = yuvconstants->kRGBCoeffBias[3] - -#define CALC_RGB16 \ - int32_t y1 = (uint32_t)(y32 * yg) >> 16; \ - int b16 = y1 + (u * ub) - bb; \ - int g16 = y1 + bg - (u * ug + v * vg); \ - int r16 = y1 + (v * vr) - br -#else -#define LOAD_YUV_CONSTANTS \ - int ub = yuvconstants->kUVToB[0]; \ - int ug = yuvconstants->kUVToG[0]; \ - int vg = yuvconstants->kUVToG[1]; \ - int vr = yuvconstants->kUVToR[1]; \ - int yg = yuvconstants->kYToRgb[0]; \ - int yb = yuvconstants->kYBiasToRgb[0] - -#define CALC_RGB16 \ - int32_t y1 = ((uint32_t)(y32 * yg) >> 16) + yb; \ - int8_t ui = (int8_t)u; \ - int8_t vi = (int8_t)v; \ - ui -= 0x80; \ - vi -= 0x80; \ - int b16 = y1 + (ui * ub); \ - int g16 = y1 - (ui * ug + vi * vg); \ - int r16 = y1 + (vi * vr) -#endif - -void MirrorRow_C(const uint8_t *src, uint8_t *dst, int width) { - int x; - src += width - 1; - for (x = 0; x < width - 1; x += 2) { - dst[x] = src[0]; - dst[x + 1] = src[-1]; - src -= 2; - } - if (width & 1) { - dst[width - 1] = src[0]; - } -} - -// Use scale to convert lsb formats to msb, depending how many bits there are: -// 32768 = 9 bits -// 16384 = 10 bits -// 4096 = 12 bits -// 256 = 16 bits -// TODO(fbarchard): change scale to bits -#define C16TO8(v, scale) clamp255(((v) * (scale)) >> 16) - -void CopyRow_C(const uint8_t *src, uint8_t *dst, int count) { - memcpy(dst, src, count); -} - -// Divide source RGB by alpha and store to destination. -// b = (b * 255 + (a / 2)) / a; -// g = (g * 255 + (a / 2)) / a; -// r = (r * 255 + (a / 2)) / a; -// Reciprocal method is off by 1 on some values. ie 125 -// 8.8 fixed point inverse table with 1.0 in upper short and 1 / a in lower. -#define T(a) 0x01000000 + (0x10000 / a) -const uint32_t fixed_invtbl8[256] = { - 0x01000000, 0x0100ffff, T(0x02), T(0x03), T(0x04), T(0x05), T(0x06), - T(0x07), T(0x08), T(0x09), T(0x0a), T(0x0b), T(0x0c), T(0x0d), - T(0x0e), T(0x0f), T(0x10), T(0x11), T(0x12), T(0x13), T(0x14), - T(0x15), T(0x16), T(0x17), T(0x18), T(0x19), T(0x1a), T(0x1b), - T(0x1c), T(0x1d), T(0x1e), T(0x1f), T(0x20), T(0x21), T(0x22), - T(0x23), T(0x24), T(0x25), T(0x26), T(0x27), T(0x28), T(0x29), - T(0x2a), T(0x2b), T(0x2c), T(0x2d), T(0x2e), T(0x2f), T(0x30), - T(0x31), T(0x32), T(0x33), T(0x34), T(0x35), T(0x36), T(0x37), - T(0x38), T(0x39), T(0x3a), T(0x3b), T(0x3c), T(0x3d), T(0x3e), - T(0x3f), T(0x40), T(0x41), T(0x42), T(0x43), T(0x44), T(0x45), - T(0x46), T(0x47), T(0x48), T(0x49), T(0x4a), T(0x4b), T(0x4c), - T(0x4d), T(0x4e), T(0x4f), T(0x50), T(0x51), T(0x52), T(0x53), - T(0x54), T(0x55), T(0x56), T(0x57), T(0x58), T(0x59), T(0x5a), - T(0x5b), T(0x5c), T(0x5d), T(0x5e), T(0x5f), T(0x60), T(0x61), - T(0x62), T(0x63), T(0x64), T(0x65), T(0x66), T(0x67), T(0x68), - T(0x69), T(0x6a), T(0x6b), T(0x6c), T(0x6d), T(0x6e), T(0x6f), - T(0x70), T(0x71), T(0x72), T(0x73), T(0x74), T(0x75), T(0x76), - T(0x77), T(0x78), T(0x79), T(0x7a), T(0x7b), T(0x7c), T(0x7d), - T(0x7e), T(0x7f), T(0x80), T(0x81), T(0x82), T(0x83), T(0x84), - T(0x85), T(0x86), T(0x87), T(0x88), T(0x89), T(0x8a), T(0x8b), - T(0x8c), T(0x8d), T(0x8e), T(0x8f), T(0x90), T(0x91), T(0x92), - T(0x93), T(0x94), T(0x95), T(0x96), T(0x97), T(0x98), T(0x99), - T(0x9a), T(0x9b), T(0x9c), T(0x9d), T(0x9e), T(0x9f), T(0xa0), - T(0xa1), T(0xa2), T(0xa3), T(0xa4), T(0xa5), T(0xa6), T(0xa7), - T(0xa8), T(0xa9), T(0xaa), T(0xab), T(0xac), T(0xad), T(0xae), - T(0xaf), T(0xb0), T(0xb1), T(0xb2), T(0xb3), T(0xb4), T(0xb5), - T(0xb6), T(0xb7), T(0xb8), T(0xb9), T(0xba), T(0xbb), T(0xbc), - T(0xbd), T(0xbe), T(0xbf), T(0xc0), T(0xc1), T(0xc2), T(0xc3), - T(0xc4), T(0xc5), T(0xc6), T(0xc7), T(0xc8), T(0xc9), T(0xca), - T(0xcb), T(0xcc), T(0xcd), T(0xce), T(0xcf), T(0xd0), T(0xd1), - T(0xd2), T(0xd3), T(0xd4), T(0xd5), T(0xd6), T(0xd7), T(0xd8), - T(0xd9), T(0xda), T(0xdb), T(0xdc), T(0xdd), T(0xde), T(0xdf), - T(0xe0), T(0xe1), T(0xe2), T(0xe3), T(0xe4), T(0xe5), T(0xe6), - T(0xe7), T(0xe8), T(0xe9), T(0xea), T(0xeb), T(0xec), T(0xed), - T(0xee), T(0xef), T(0xf0), T(0xf1), T(0xf2), T(0xf3), T(0xf4), - T(0xf5), T(0xf6), T(0xf7), T(0xf8), T(0xf9), T(0xfa), T(0xfb), - T(0xfc), T(0xfd), T(0xfe), 0x01000100}; -#undef T - -// Blend 2 rows into 1. -static void HalfRow_C(const uint8_t *src_uv, - ptrdiff_t src_uv_stride, - uint8_t *dst_uv, - int width) { - int x; - for (x = 0; x < width; ++x) { - dst_uv[x] = (src_uv[x] + src_uv[src_uv_stride + x] + 1) >> 1; - } -} - -// C version 2x2 -> 2x1. -void InterpolateRow_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - ptrdiff_t src_stride, - int width, - int source_y_fraction) { - int y1_fraction = source_y_fraction; - int y0_fraction = 256 - y1_fraction; - const uint8_t *src_ptr1 = src_ptr + src_stride; - int x; - assert(source_y_fraction >= 0); - assert(source_y_fraction < 256); - - if (y1_fraction == 0) { - memcpy(dst_ptr, src_ptr, width); - return; - } - if (y1_fraction == 128) { - HalfRow_C(src_ptr, src_stride, dst_ptr, width); - return; - } - for (x = 0; x < width; ++x) { - dst_ptr[0] = STATIC_CAST( - uint8_t, - (src_ptr[0] * y0_fraction + src_ptr1[0] * y1_fraction + 128) >> 8); - ++src_ptr; - ++src_ptr1; - ++dst_ptr; - } -} - -// Work around GCC 7 punning warning -Wstrict-aliasing -#if defined(__GNUC__) -typedef uint32_t __attribute__((__may_alias__)) uint32_alias_t; -#else -typedef uint32_t uint32_alias_t; -#endif - -#undef STATIC_CAST diff --git a/pkg/encoder/yuv/libyuv/row_gcc.c b/pkg/encoder/yuv/libyuv/row_gcc.c deleted file mode 100644 index 07e795e6..00000000 --- a/pkg/encoder/yuv/libyuv/row_gcc.c +++ /dev/null @@ -1,1090 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "row.h" - -// This module is for GCC x86 and x64. -#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) - -#if defined(HAS_ARGBTOYROW_SSSE3) || defined(HAS_ARGBGRAYROW_SSSE3) - -// Constants for ARGB -static const uvec8 kARGBToY = {25u, 129u, 66u, 0u, 25u, 129u, 66u, 0u, - 25u, 129u, 66u, 0u, 25u, 129u, 66u, 0u}; - - -#endif // defined(HAS_ARGBTOYROW_SSSE3) || defined(HAS_ARGBGRAYROW_SSSE3) - -#if defined(HAS_ARGBTOYROW_SSSE3) || defined(HAS_I422TOARGBROW_SSSE3) - -static const vec8 kARGBToU = {112, -74, -38, 0, 112, -74, -38, 0, - 112, -74, -38, 0, 112, -74, -38, 0}; - -static const vec8 kARGBToV = {-18, -94, 112, 0, -18, -94, 112, 0, - -18, -94, 112, 0, -18, -94, 112, 0}; - -// Constants for BGRA -static const uvec8 kBGRAToY = {0u, 66u, 129u, 25u, 0u, 66u, 129u, 25u, - 0u, 66u, 129u, 25u, 0u, 66u, 129u, 25u}; - -static const vec8 kBGRAToU = {0, -38, -74, 112, 0, -38, -74, 112, - 0, -38, -74, 112, 0, -38, -74, 112}; - -static const vec8 kBGRAToV = {0, 112, -94, -18, 0, 112, -94, -18, - 0, 112, -94, -18, 0, 112, -94, -18}; - -// Constants for ABGR -static const uvec8 kABGRToY = {66u, 129u, 25u, 0u, 66u, 129u, 25u, 0u, - 66u, 129u, 25u, 0u, 66u, 129u, 25u, 0u}; - -static const vec8 kABGRToU = {-38, -74, 112, 0, -38, -74, 112, 0, - -38, -74, 112, 0, -38, -74, 112, 0}; - -static const vec8 kABGRToV = {112, -94, -18, 0, 112, -94, -18, 0, - 112, -94, -18, 0, 112, -94, -18, 0}; - -// Constants for RGBA. -//static const uvec8 kRGBAToY = {0u, 25u, 129u, 66u, 0u, 25u, 129u, 66u, -// 0u, 25u, 129u, 66u, 0u, 25u, 129u, 66u}; - -static const vec8 kRGBAToU = {0, 112, -74, -38, 0, 112, -74, -38, - 0, 112, -74, -38, 0, 112, -74, -38}; - -static const vec8 kRGBAToV = {0, -18, -94, 112, 0, -18, -94, 112, - 0, -18, -94, 112, 0, -18, -94, 112}; - -static const uvec16 kAddY16 = {0x7e80u, 0x7e80u, 0x7e80u, 0x7e80u, - 0x7e80u, 0x7e80u, 0x7e80u, 0x7e80u}; - -static const uvec8 kAddUV128 = {128u, 128u, 128u, 128u, 128u, 128u, 128u, 128u, - 128u, 128u, 128u, 128u, 128u, 128u, 128u, 128u}; - -static const uvec16 kSub128 = {0x8080u, 0x8080u, 0x8080u, 0x8080u, - 0x8080u, 0x8080u, 0x8080u, 0x8080u}; - -#endif // defined(HAS_ARGBTOYROW_SSSE3) || defined(HAS_I422TOARGBROW_SSSE3) - -// clang-format off - -// TODO(mraptis): Consider passing R, G, B multipliers as parameter. -// round parameter is register containing value to add before shift. -#define RGBTOY(round) \ - "1: \n" \ - "movdqu (%0),%%xmm0 \n" \ - "movdqu 0x10(%0),%%xmm1 \n" \ - "movdqu 0x20(%0),%%xmm2 \n" \ - "movdqu 0x30(%0),%%xmm3 \n" \ - "psubb %%xmm5,%%xmm0 \n" \ - "psubb %%xmm5,%%xmm1 \n" \ - "psubb %%xmm5,%%xmm2 \n" \ - "psubb %%xmm5,%%xmm3 \n" \ - "movdqu %%xmm4,%%xmm6 \n" \ - "pmaddubsw %%xmm0,%%xmm6 \n" \ - "movdqu %%xmm4,%%xmm0 \n" \ - "pmaddubsw %%xmm1,%%xmm0 \n" \ - "movdqu %%xmm4,%%xmm1 \n" \ - "pmaddubsw %%xmm2,%%xmm1 \n" \ - "movdqu %%xmm4,%%xmm2 \n" \ - "pmaddubsw %%xmm3,%%xmm2 \n" \ - "lea 0x40(%0),%0 \n" \ - "phaddw %%xmm0,%%xmm6 \n" \ - "phaddw %%xmm2,%%xmm1 \n" \ - "prefetcht0 1280(%0) \n" \ - "paddw %%" #round ",%%xmm6 \n" \ - "paddw %%" #round ",%%xmm1 \n" \ - "psrlw $0x8,%%xmm6 \n" \ - "psrlw $0x8,%%xmm1 \n" \ - "packuswb %%xmm1,%%xmm6 \n" \ - "movdqu %%xmm6,(%1) \n" \ - "lea 0x10(%1),%1 \n" \ - "sub $0x10,%2 \n" \ - "jg 1b \n" - -#define RGBTOY_AVX2(round) \ - "1: \n" \ - "vmovdqu (%0),%%ymm0 \n" \ - "vmovdqu 0x20(%0),%%ymm1 \n" \ - "vmovdqu 0x40(%0),%%ymm2 \n" \ - "vmovdqu 0x60(%0),%%ymm3 \n" \ - "vpsubb %%ymm5, %%ymm0, %%ymm0 \n" \ - "vpsubb %%ymm5, %%ymm1, %%ymm1 \n" \ - "vpsubb %%ymm5, %%ymm2, %%ymm2 \n" \ - "vpsubb %%ymm5, %%ymm3, %%ymm3 \n" \ - "vpmaddubsw %%ymm0,%%ymm4,%%ymm0 \n" \ - "vpmaddubsw %%ymm1,%%ymm4,%%ymm1 \n" \ - "vpmaddubsw %%ymm2,%%ymm4,%%ymm2 \n" \ - "vpmaddubsw %%ymm3,%%ymm4,%%ymm3 \n" \ - "lea 0x80(%0),%0 \n" \ - "vphaddw %%ymm1,%%ymm0,%%ymm0 \n" /* mutates. */ \ - "vphaddw %%ymm3,%%ymm2,%%ymm2 \n" \ - "prefetcht0 1280(%0) \n" \ - "vpaddw %%" #round ",%%ymm0,%%ymm0 \n" /* Add .5 for rounding. */ \ - "vpaddw %%" #round ",%%ymm2,%%ymm2 \n" \ - "vpsrlw $0x8,%%ymm0,%%ymm0 \n" \ - "vpsrlw $0x8,%%ymm2,%%ymm2 \n" \ - "vpackuswb %%ymm2,%%ymm0,%%ymm0 \n" /* mutates. */ \ - "vpermd %%ymm0,%%ymm6,%%ymm0 \n" /* unmutate. */ \ - "vmovdqu %%ymm0,(%1) \n" \ - "lea 0x20(%1),%1 \n" \ - "sub $0x20,%2 \n" \ - "jg 1b \n" \ - "vzeroupper \n" - -// clang-format on - -#ifdef HAS_ARGBTOYROW_SSSE3 - -// Convert 16 ARGB pixels (64 bytes) to 16 Y values. -void ARGBToYRow_SSSE3(const uint8_t *src_argb, uint8_t *dst_y, int width) { - asm volatile( - "movdqa %3,%%xmm4 \n" - "movdqa %4,%%xmm5 \n" - "movdqa %5,%%xmm7 \n" - - LABELALIGN RGBTOY(xmm7) - : "+r"(src_argb), // %0 - "+r"(dst_y), // %1 - "+r"(width) // %2 - : "m"(kARGBToY), // %3 - "m"(kSub128), // %4 - "m"(kAddY16) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif // HAS_ARGBTOYROW_SSSE3 - -#if defined(HAS_ARGBTOYROW_AVX2) || defined(HAS_ABGRTOYROW_AVX2) || \ - defined(HAS_ARGBEXTRACTALPHAROW_AVX2) -// vpermd for vphaddw + vpackuswb vpermd. -static const lvec32 kPermdARGBToY_AVX = {0, 4, 1, 5, 2, 6, 3, 7}; -#endif - -#ifdef HAS_ARGBTOYROW_AVX2 - -// Convert 32 ARGB pixels (128 bytes) to 32 Y values. -void ARGBToYRow_AVX2(const uint8_t *src_argb, uint8_t *dst_y, int width) { - asm volatile( - "vbroadcastf128 %3,%%ymm4 \n" - "vbroadcastf128 %4,%%ymm5 \n" - "vbroadcastf128 %5,%%ymm7 \n" - "vmovdqu %6,%%ymm6 \n" LABELALIGN RGBTOY_AVX2( - ymm7) "vzeroupper \n" - : "+r"(src_argb), // %0 - "+r"(dst_y), // %1 - "+r"(width) // %2 - : "m"(kARGBToY), // %3 - "m"(kSub128), // %4 - "m"(kAddY16), // %5 - "m"(kPermdARGBToY_AVX) // %6 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif // HAS_ARGBTOYROW_AVX2 - -#ifdef HAS_ABGRTOYROW_AVX2 - -// Convert 32 ABGR pixels (128 bytes) to 32 Y values. -void ABGRToYRow_AVX2(const uint8_t *src_abgr, uint8_t *dst_y, int width) { - asm volatile( - "vbroadcastf128 %3,%%ymm4 \n" - "vbroadcastf128 %4,%%ymm5 \n" - "vbroadcastf128 %5,%%ymm7 \n" - "vmovdqu %6,%%ymm6 \n" LABELALIGN RGBTOY_AVX2( - ymm7) "vzeroupper \n" - : "+r"(src_abgr), // %0 - "+r"(dst_y), // %1 - "+r"(width) // %2 - : "m"(kABGRToY), // %3 - "m"(kSub128), // %4 - "m"(kAddY16), // %5 - "m"(kPermdARGBToY_AVX) // %6 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif // HAS_ABGRTOYROW_AVX2 - -#ifdef HAS_ARGBTOUVROW_SSSE3 - -void ARGBToUVRow_SSSE3(const uint8_t *src_argb, - int src_stride_argb, - uint8_t *dst_u, - uint8_t *dst_v, - int width) { - asm volatile( - "movdqa %5,%%xmm3 \n" - "movdqa %6,%%xmm4 \n" - "movdqa %7,%%xmm5 \n" - "sub %1,%2 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x00(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "movdqu 0x10(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm1 \n" - "movdqu 0x20(%0),%%xmm2 \n" - "movdqu 0x20(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm2 \n" - "movdqu 0x30(%0),%%xmm6 \n" - "movdqu 0x30(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - - "lea 0x40(%0),%0 \n" - "movdqa %%xmm0,%%xmm7 \n" - "shufps $0x88,%%xmm1,%%xmm0 \n" - "shufps $0xdd,%%xmm1,%%xmm7 \n" - "pavgb %%xmm7,%%xmm0 \n" - "movdqa %%xmm2,%%xmm7 \n" - "shufps $0x88,%%xmm6,%%xmm2 \n" - "shufps $0xdd,%%xmm6,%%xmm7 \n" - "pavgb %%xmm7,%%xmm2 \n" - "movdqa %%xmm0,%%xmm1 \n" - "movdqa %%xmm2,%%xmm6 \n" - "pmaddubsw %%xmm4,%%xmm0 \n" - "pmaddubsw %%xmm4,%%xmm2 \n" - "pmaddubsw %%xmm3,%%xmm1 \n" - "pmaddubsw %%xmm3,%%xmm6 \n" - "phaddw %%xmm2,%%xmm0 \n" - "phaddw %%xmm6,%%xmm1 \n" - "psraw $0x8,%%xmm0 \n" - "psraw $0x8,%%xmm1 \n" - "packsswb %%xmm1,%%xmm0 \n" - "paddb %%xmm5,%%xmm0 \n" - "movlps %%xmm0,(%1) \n" - "movhps %%xmm0,0x00(%1,%2,1) \n" - "lea 0x8(%1),%1 \n" - "sub $0x10,%3 \n" - "jg 1b \n" - : "+r"(src_argb), // %0 - "+r"(dst_u), // %1 - "+r"(dst_v), // %2 - "+rm"(width) // %3 - : "r"((intptr_t) (src_stride_argb)), // %4 - "m"(kARGBToV), // %5 - "m"(kARGBToU), // %6 - "m"(kAddUV128) // %7 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm6", "xmm7"); -} - -#endif // HAS_ARGBTOUVROW_SSSE3 - -#if defined(HAS_ARGBTOUVROW_AVX2) || defined(HAS_ABGRTOUVROW_AVX2) || \ - defined(HAS_ARGBTOUVJROW_AVX2) || defined(HAS_ABGRTOUVJROW_AVX2) -// vpshufb for vphaddw + vpackuswb packed to shorts. -static const lvec8 kShufARGBToUV_AVX = { - 0, 1, 8, 9, 2, 3, 10, 11, 4, 5, 12, 13, 6, 7, 14, 15, - 0, 1, 8, 9, 2, 3, 10, 11, 4, 5, 12, 13, 6, 7, 14, 15}; -#endif - -#if defined(HAS_ARGBTOUVROW_AVX2) - -void ARGBToUVRow_AVX2(const uint8_t *src_argb, - int src_stride_argb, - uint8_t *dst_u, - uint8_t *dst_v, - int width) { - asm volatile( - "vbroadcastf128 %5,%%ymm5 \n" - "vbroadcastf128 %6,%%ymm6 \n" - "vbroadcastf128 %7,%%ymm7 \n" - "sub %1,%2 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" - "vmovdqu 0x20(%0),%%ymm1 \n" - "vmovdqu 0x40(%0),%%ymm2 \n" - "vmovdqu 0x60(%0),%%ymm3 \n" - "vpavgb 0x00(%0,%4,1),%%ymm0,%%ymm0 \n" - "vpavgb 0x20(%0,%4,1),%%ymm1,%%ymm1 \n" - "vpavgb 0x40(%0,%4,1),%%ymm2,%%ymm2 \n" - "vpavgb 0x60(%0,%4,1),%%ymm3,%%ymm3 \n" - "lea 0x80(%0),%0 \n" - "vshufps $0x88,%%ymm1,%%ymm0,%%ymm4 \n" - "vshufps $0xdd,%%ymm1,%%ymm0,%%ymm0 \n" - "vpavgb %%ymm4,%%ymm0,%%ymm0 \n" - "vshufps $0x88,%%ymm3,%%ymm2,%%ymm4 \n" - "vshufps $0xdd,%%ymm3,%%ymm2,%%ymm2 \n" - "vpavgb %%ymm4,%%ymm2,%%ymm2 \n" - - "vpmaddubsw %%ymm7,%%ymm0,%%ymm1 \n" - "vpmaddubsw %%ymm7,%%ymm2,%%ymm3 \n" - "vpmaddubsw %%ymm6,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm6,%%ymm2,%%ymm2 \n" - "vphaddw %%ymm3,%%ymm1,%%ymm1 \n" - "vphaddw %%ymm2,%%ymm0,%%ymm0 \n" - "vpsraw $0x8,%%ymm1,%%ymm1 \n" - "vpsraw $0x8,%%ymm0,%%ymm0 \n" - "vpacksswb %%ymm0,%%ymm1,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vpshufb %8,%%ymm0,%%ymm0 \n" - "vpaddb %%ymm5,%%ymm0,%%ymm0 \n" - - "vextractf128 $0x0,%%ymm0,(%1) \n" - "vextractf128 $0x1,%%ymm0,0x0(%1,%2,1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x20,%3 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_argb), // %0 - "+r"(dst_u), // %1 - "+r"(dst_v), // %2 - "+rm"(width) // %3 - : "r"((intptr_t) (src_stride_argb)), // %4 - "m"(kAddUV128), // %5 - "m"(kARGBToV), // %6 - "m"(kARGBToU), // %7 - "m"(kShufARGBToUV_AVX) // %8 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif // HAS_ARGBTOUVROW_AVX2 - -#ifdef HAS_ABGRTOUVROW_AVX2 - -void ABGRToUVRow_AVX2(const uint8_t *src_abgr, - int src_stride_abgr, - uint8_t *dst_u, - uint8_t *dst_v, - int width) { - asm volatile( - "vbroadcastf128 %5,%%ymm5 \n" - "vbroadcastf128 %6,%%ymm6 \n" - "vbroadcastf128 %7,%%ymm7 \n" - "sub %1,%2 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" - "vmovdqu 0x20(%0),%%ymm1 \n" - "vmovdqu 0x40(%0),%%ymm2 \n" - "vmovdqu 0x60(%0),%%ymm3 \n" - "vpavgb 0x00(%0,%4,1),%%ymm0,%%ymm0 \n" - "vpavgb 0x20(%0,%4,1),%%ymm1,%%ymm1 \n" - "vpavgb 0x40(%0,%4,1),%%ymm2,%%ymm2 \n" - "vpavgb 0x60(%0,%4,1),%%ymm3,%%ymm3 \n" - "lea 0x80(%0),%0 \n" - "vshufps $0x88,%%ymm1,%%ymm0,%%ymm4 \n" - "vshufps $0xdd,%%ymm1,%%ymm0,%%ymm0 \n" - "vpavgb %%ymm4,%%ymm0,%%ymm0 \n" - "vshufps $0x88,%%ymm3,%%ymm2,%%ymm4 \n" - "vshufps $0xdd,%%ymm3,%%ymm2,%%ymm2 \n" - "vpavgb %%ymm4,%%ymm2,%%ymm2 \n" - - "vpmaddubsw %%ymm7,%%ymm0,%%ymm1 \n" - "vpmaddubsw %%ymm7,%%ymm2,%%ymm3 \n" - "vpmaddubsw %%ymm6,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm6,%%ymm2,%%ymm2 \n" - "vphaddw %%ymm3,%%ymm1,%%ymm1 \n" - "vphaddw %%ymm2,%%ymm0,%%ymm0 \n" - "vpsraw $0x8,%%ymm1,%%ymm1 \n" - "vpsraw $0x8,%%ymm0,%%ymm0 \n" - "vpacksswb %%ymm0,%%ymm1,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vpshufb %8,%%ymm0,%%ymm0 \n" - "vpaddb %%ymm5,%%ymm0,%%ymm0 \n" - - "vextractf128 $0x0,%%ymm0,(%1) \n" - "vextractf128 $0x1,%%ymm0,0x0(%1,%2,1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x20,%3 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_abgr), // %0 - "+r"(dst_u), // %1 - "+r"(dst_v), // %2 - "+rm"(width) // %3 - : "r"((intptr_t) (src_stride_abgr)), // %4 - "m"(kAddUV128), // %5 - "m"(kABGRToV), // %6 - "m"(kABGRToU), // %7 - "m"(kShufARGBToUV_AVX) // %8 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif // HAS_ABGRTOUVROW_AVX2 - -void BGRAToYRow_SSSE3(const uint8_t *src_bgra, uint8_t *dst_y, int width) { - asm volatile( - "movdqa %3,%%xmm4 \n" - "movdqa %4,%%xmm5 \n" - "movdqa %5,%%xmm7 \n" - - LABELALIGN RGBTOY(xmm7) - : "+r"(src_bgra), // %0 - "+r"(dst_y), // %1 - "+r"(width) // %2 - : "m"(kBGRAToY), // %3 - "m"(kSub128), // %4 - "m"(kAddY16) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -void BGRAToUVRow_SSSE3(const uint8_t *src_bgra, - int src_stride_bgra, - uint8_t *dst_u, - uint8_t *dst_v, - int width) { - asm volatile( - "movdqa %5,%%xmm3 \n" - "movdqa %6,%%xmm4 \n" - "movdqa %7,%%xmm5 \n" - "sub %1,%2 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x00(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "movdqu 0x10(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm1 \n" - "movdqu 0x20(%0),%%xmm2 \n" - "movdqu 0x20(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm2 \n" - "movdqu 0x30(%0),%%xmm6 \n" - "movdqu 0x30(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - - "lea 0x40(%0),%0 \n" - "movdqa %%xmm0,%%xmm7 \n" - "shufps $0x88,%%xmm1,%%xmm0 \n" - "shufps $0xdd,%%xmm1,%%xmm7 \n" - "pavgb %%xmm7,%%xmm0 \n" - "movdqa %%xmm2,%%xmm7 \n" - "shufps $0x88,%%xmm6,%%xmm2 \n" - "shufps $0xdd,%%xmm6,%%xmm7 \n" - "pavgb %%xmm7,%%xmm2 \n" - "movdqa %%xmm0,%%xmm1 \n" - "movdqa %%xmm2,%%xmm6 \n" - "pmaddubsw %%xmm4,%%xmm0 \n" - "pmaddubsw %%xmm4,%%xmm2 \n" - "pmaddubsw %%xmm3,%%xmm1 \n" - "pmaddubsw %%xmm3,%%xmm6 \n" - "phaddw %%xmm2,%%xmm0 \n" - "phaddw %%xmm6,%%xmm1 \n" - "psraw $0x8,%%xmm0 \n" - "psraw $0x8,%%xmm1 \n" - "packsswb %%xmm1,%%xmm0 \n" - "paddb %%xmm5,%%xmm0 \n" - "movlps %%xmm0,(%1) \n" - "movhps %%xmm0,0x00(%1,%2,1) \n" - "lea 0x8(%1),%1 \n" - "sub $0x10,%3 \n" - "jg 1b \n" - : "+r"(src_bgra), // %0 - "+r"(dst_u), // %1 - "+r"(dst_v), // %2 - "+rm"(width) // %3 - : "r"((intptr_t) (src_stride_bgra)), // %4 - "m"(kBGRAToV), // %5 - "m"(kBGRAToU), // %6 - "m"(kAddUV128) // %7 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm6", "xmm7"); -} - -void ABGRToYRow_SSSE3(const uint8_t *src_abgr, uint8_t *dst_y, int width) { - asm volatile( - "movdqa %3,%%xmm4 \n" - "movdqa %4,%%xmm5 \n" - "movdqa %5,%%xmm7 \n" - - LABELALIGN RGBTOY(xmm7) - : "+r"(src_abgr), // %0 - "+r"(dst_y), // %1 - "+r"(width) // %2 - : "m"(kABGRToY), // %3 - "m"(kSub128), // %4 - "m"(kAddY16) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -void ABGRToUVRow_SSSE3(const uint8_t *src_abgr, - int src_stride_abgr, - uint8_t *dst_u, - uint8_t *dst_v, - int width) { - asm volatile( - "movdqa %5,%%xmm3 \n" - "movdqa %6,%%xmm4 \n" - "movdqa %7,%%xmm5 \n" - "sub %1,%2 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x00(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "movdqu 0x10(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm1 \n" - "movdqu 0x20(%0),%%xmm2 \n" - "movdqu 0x20(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm2 \n" - "movdqu 0x30(%0),%%xmm6 \n" - "movdqu 0x30(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - - "lea 0x40(%0),%0 \n" - "movdqa %%xmm0,%%xmm7 \n" - "shufps $0x88,%%xmm1,%%xmm0 \n" - "shufps $0xdd,%%xmm1,%%xmm7 \n" - "pavgb %%xmm7,%%xmm0 \n" - "movdqa %%xmm2,%%xmm7 \n" - "shufps $0x88,%%xmm6,%%xmm2 \n" - "shufps $0xdd,%%xmm6,%%xmm7 \n" - "pavgb %%xmm7,%%xmm2 \n" - "movdqa %%xmm0,%%xmm1 \n" - "movdqa %%xmm2,%%xmm6 \n" - "pmaddubsw %%xmm4,%%xmm0 \n" - "pmaddubsw %%xmm4,%%xmm2 \n" - "pmaddubsw %%xmm3,%%xmm1 \n" - "pmaddubsw %%xmm3,%%xmm6 \n" - "phaddw %%xmm2,%%xmm0 \n" - "phaddw %%xmm6,%%xmm1 \n" - "psraw $0x8,%%xmm0 \n" - "psraw $0x8,%%xmm1 \n" - "packsswb %%xmm1,%%xmm0 \n" - "paddb %%xmm5,%%xmm0 \n" - "movlps %%xmm0,(%1) \n" - "movhps %%xmm0,0x00(%1,%2,1) \n" - "lea 0x8(%1),%1 \n" - "sub $0x10,%3 \n" - "jg 1b \n" - : "+r"(src_abgr), // %0 - "+r"(dst_u), // %1 - "+r"(dst_v), // %2 - "+rm"(width) // %3 - : "r"((intptr_t) (src_stride_abgr)), // %4 - "m"(kABGRToV), // %5 - "m"(kABGRToU), // %6 - "m"(kAddUV128) // %7 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm6", "xmm7"); -} - -void RGBAToUVRow_SSSE3(const uint8_t *src_rgba, - int src_stride_rgba, - uint8_t *dst_u, - uint8_t *dst_v, - int width) { - asm volatile( - "movdqa %5,%%xmm3 \n" - "movdqa %6,%%xmm4 \n" - "movdqa %7,%%xmm5 \n" - "sub %1,%2 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x00(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "movdqu 0x10(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm1 \n" - "movdqu 0x20(%0),%%xmm2 \n" - "movdqu 0x20(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm2 \n" - "movdqu 0x30(%0),%%xmm6 \n" - "movdqu 0x30(%0,%4,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - - "lea 0x40(%0),%0 \n" - "movdqa %%xmm0,%%xmm7 \n" - "shufps $0x88,%%xmm1,%%xmm0 \n" - "shufps $0xdd,%%xmm1,%%xmm7 \n" - "pavgb %%xmm7,%%xmm0 \n" - "movdqa %%xmm2,%%xmm7 \n" - "shufps $0x88,%%xmm6,%%xmm2 \n" - "shufps $0xdd,%%xmm6,%%xmm7 \n" - "pavgb %%xmm7,%%xmm2 \n" - "movdqa %%xmm0,%%xmm1 \n" - "movdqa %%xmm2,%%xmm6 \n" - "pmaddubsw %%xmm4,%%xmm0 \n" - "pmaddubsw %%xmm4,%%xmm2 \n" - "pmaddubsw %%xmm3,%%xmm1 \n" - "pmaddubsw %%xmm3,%%xmm6 \n" - "phaddw %%xmm2,%%xmm0 \n" - "phaddw %%xmm6,%%xmm1 \n" - "psraw $0x8,%%xmm0 \n" - "psraw $0x8,%%xmm1 \n" - "packsswb %%xmm1,%%xmm0 \n" - "paddb %%xmm5,%%xmm0 \n" - "movlps %%xmm0,(%1) \n" - "movhps %%xmm0,0x00(%1,%2,1) \n" - "lea 0x8(%1),%1 \n" - "sub $0x10,%3 \n" - "jg 1b \n" - : "+r"(src_rgba), // %0 - "+r"(dst_u), // %1 - "+r"(dst_v), // %2 - "+rm"(width) // %3 - : "r"((intptr_t) (src_stride_rgba)), // %4 - "m"(kRGBAToV), // %5 - "m"(kRGBAToU), // %6 - "m"(kAddUV128) // %7 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm6", "xmm7"); -} - -#ifdef HAS_MIRRORROW_SSSE3 -// Shuffle table for reversing the bytes. -static const uvec8 kShuffleMirror = {15u, 14u, 13u, 12u, 11u, 10u, 9u, 8u, - 7u, 6u, 5u, 4u, 3u, 2u, 1u, 0u}; - -void MirrorRow_SSSE3(const uint8_t *src, uint8_t *dst, int width) { - intptr_t temp_width = (intptr_t) (width); - asm volatile( - - "movdqa %3,%%xmm5 \n" - - LABELALIGN - "1: \n" - "movdqu -0x10(%0,%2,1),%%xmm0 \n" - "pshufb %%xmm5,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src), // %0 - "+r"(dst), // %1 - "+r"(temp_width) // %2 - : "m"(kShuffleMirror) // %3 - : "memory", "cc", "xmm0", "xmm5"); -} - -#endif // HAS_MIRRORROW_SSSE3 - -#ifdef HAS_MIRRORROW_AVX2 - -void MirrorRow_AVX2(const uint8_t *src, uint8_t *dst, int width) { - intptr_t temp_width = (intptr_t) (width); - asm volatile( - - "vbroadcastf128 %3,%%ymm5 \n" - - LABELALIGN - "1: \n" - "vmovdqu -0x20(%0,%2,1),%%ymm0 \n" - "vpshufb %%ymm5,%%ymm0,%%ymm0 \n" - "vpermq $0x4e,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src), // %0 - "+r"(dst), // %1 - "+r"(temp_width) // %2 - : "m"(kShuffleMirror) // %3 - : "memory", "cc", "xmm0", "xmm5"); -} - -#endif // HAS_MIRRORROW_AVX2 - -#ifdef HAS_MIRRORUVROW_SSSE3 -// Shuffle table for reversing the UV. -static const uvec8 kShuffleMirrorUV = {14u, 15u, 12u, 13u, 10u, 11u, 8u, 9u, - 6u, 7u, 4u, 5u, 2u, 3u, 0u, 1u}; - -void MirrorUVRow_SSSE3(const uint8_t *src_uv, uint8_t *dst_uv, int width) { - intptr_t temp_width = (intptr_t) (width); - asm volatile( - - "movdqa %3,%%xmm5 \n" - - LABELALIGN - "1: \n" - "movdqu -0x10(%0,%2,2),%%xmm0 \n" - "pshufb %%xmm5,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x8,%2 \n" - "jg 1b \n" - : "+r"(src_uv), // %0 - "+r"(dst_uv), // %1 - "+r"(temp_width) // %2 - : "m"(kShuffleMirrorUV) // %3 - : "memory", "cc", "xmm0", "xmm5"); -} - -#endif // HAS_MIRRORUVROW_SSSE3 - -#ifdef HAS_MIRRORUVROW_AVX2 - -void MirrorUVRow_AVX2(const uint8_t *src_uv, uint8_t *dst_uv, int width) { - intptr_t temp_width = (intptr_t) (width); - asm volatile( - - "vbroadcastf128 %3,%%ymm5 \n" - - LABELALIGN - "1: \n" - "vmovdqu -0x20(%0,%2,2),%%ymm0 \n" - "vpshufb %%ymm5,%%ymm0,%%ymm0 \n" - "vpermq $0x4e,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_uv), // %0 - "+r"(dst_uv), // %1 - "+r"(temp_width) // %2 - : "m"(kShuffleMirrorUV) // %3 - : "memory", "cc", "xmm0", "xmm5"); -} - -#endif // HAS_MIRRORUVROW_AVX2 - -#ifdef HAS_MIRRORSPLITUVROW_SSSE3 -// Shuffle table for reversing the bytes of UV channels. -static const uvec8 kShuffleMirrorSplitUV = {14u, 12u, 10u, 8u, 6u, 4u, 2u, 0u, - 15u, 13u, 11u, 9u, 7u, 5u, 3u, 1u}; - -void MirrorSplitUVRow_SSSE3(const uint8_t *src, - uint8_t *dst_u, - uint8_t *dst_v, - int width) { - intptr_t temp_width = (intptr_t) (width); - asm volatile( - "movdqa %4,%%xmm1 \n" - "lea -0x10(%0,%3,2),%0 \n" - "sub %1,%2 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "lea -0x10(%0),%0 \n" - "pshufb %%xmm1,%%xmm0 \n" - "movlpd %%xmm0,(%1) \n" - "movhpd %%xmm0,0x00(%1,%2,1) \n" - "lea 0x8(%1),%1 \n" - "sub $8,%3 \n" - "jg 1b \n" - : "+r"(src), // %0 - "+r"(dst_u), // %1 - "+r"(dst_v), // %2 - "+r"(temp_width) // %3 - : "m"(kShuffleMirrorSplitUV) // %4 - : "memory", "cc", "xmm0", "xmm1"); -} - -#endif // HAS_MIRRORSPLITUVROW_SSSE3 - -#ifdef HAS_ARGBMIRRORROW_SSE2 - -void ARGBMirrorRow_SSE2(const uint8_t *src, uint8_t *dst, int width) { - intptr_t temp_width = (intptr_t) (width); - asm volatile( - - "lea -0x10(%0,%2,4),%0 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "pshufd $0x1b,%%xmm0,%%xmm0 \n" - "lea -0x10(%0),%0 \n" - "movdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x4,%2 \n" - "jg 1b \n" - : "+r"(src), // %0 - "+r"(dst), // %1 - "+r"(temp_width) // %2 - : - : "memory", "cc", "xmm0"); -} - -#endif // HAS_ARGBMIRRORROW_SSE2 - -#ifdef HAS_ARGBMIRRORROW_AVX2 -// Shuffle table for reversing the bytes. -static const ulvec32 kARGBShuffleMirror_AVX2 = {7u, 6u, 5u, 4u, 3u, 2u, 1u, 0u}; - -void ARGBMirrorRow_AVX2(const uint8_t *src, uint8_t *dst, int width) { - intptr_t temp_width = (intptr_t) (width); - asm volatile( - - "vmovdqu %3,%%ymm5 \n" - - LABELALIGN - "1: \n" - "vpermd -0x20(%0,%2,4),%%ymm5,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x8,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src), // %0 - "+r"(dst), // %1 - "+r"(temp_width) // %2 - : "m"(kARGBShuffleMirror_AVX2) // %3 - : "memory", "cc", "xmm0", "xmm5"); -} - -#endif // HAS_ARGBMIRRORROW_AVX2 - - -#ifdef HAS_COPYROW_SSE2 - -void CopyRow_SSE2(const uint8_t *src, uint8_t *dst, int width) { - asm volatile( - "test $0xf,%0 \n" - "jne 2f \n" - "test $0xf,%1 \n" - "jne 2f \n" - - LABELALIGN - "1: \n" - "movdqa (%0),%%xmm0 \n" - "movdqa 0x10(%0),%%xmm1 \n" - "lea 0x20(%0),%0 \n" - "movdqa %%xmm0,(%1) \n" - "movdqa %%xmm1,0x10(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 1b \n" - "jmp 9f \n" - - LABELALIGN - "2: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "lea 0x20(%0),%0 \n" - "movdqu %%xmm0,(%1) \n" - "movdqu %%xmm1,0x10(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 2b \n" - - LABELALIGN "9: \n" - : "+r"(src), // %0 - "+r"(dst), // %1 - "+r"(width) // %2 - : - : "memory", "cc", "xmm0", "xmm1"); -} - -#endif // HAS_COPYROW_SSE2 - -#ifdef HAS_COPYROW_AVX - -void CopyRow_AVX(const uint8_t *src, uint8_t *dst, int width) { - asm volatile( - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" - "vmovdqu 0x20(%0),%%ymm1 \n" - "lea 0x40(%0),%0 \n" - "vmovdqu %%ymm0,(%1) \n" - "vmovdqu %%ymm1,0x20(%1) \n" - "lea 0x40(%1),%1 \n" - "sub $0x40,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src), // %0 - "+r"(dst), // %1 - "+r"(width) // %2 - : - : "memory", "cc", "xmm0", "xmm1"); -} - -#endif // HAS_COPYROW_AVX - -#ifdef HAS_COPYROW_ERMS - -// Multiple of 1. -void CopyRow_ERMS(const uint8_t *src, uint8_t *dst, int width) { - size_t width_tmp = (size_t) (width); - asm volatile( - - "rep movsb \n" - : "+S"(src), // %0 - "+D"(dst), // %1 - "+c"(width_tmp) // %2 - : - : "memory", "cc"); -} - -#endif // HAS_COPYROW_ERMS - -#ifdef HAS_INTERPOLATEROW_SSSE3 - -// Bilinear filter 16x2 -> 16x1 -void InterpolateRow_SSSE3(uint8_t *dst_ptr, - const uint8_t *src_ptr, - ptrdiff_t src_stride, - int width, - int source_y_fraction) { - asm volatile( - "sub %1,%0 \n" - "cmp $0x0,%3 \n" - "je 100f \n" - "cmp $0x80,%3 \n" - "je 50f \n" - - "movd %3,%%xmm0 \n" - "neg %3 \n" - "add $0x100,%3 \n" - "movd %3,%%xmm5 \n" - "punpcklbw %%xmm0,%%xmm5 \n" - "punpcklwd %%xmm5,%%xmm5 \n" - "pshufd $0x0,%%xmm5,%%xmm5 \n" - "mov $0x80808080,%%eax \n" - "movd %%eax,%%xmm4 \n" - "pshufd $0x0,%%xmm4,%%xmm4 \n" - - // General purpose row blend. - LABELALIGN - "1: \n" - "movdqu (%1),%%xmm0 \n" - "movdqu 0x00(%1,%4,1),%%xmm2 \n" - "movdqa %%xmm0,%%xmm1 \n" - "punpcklbw %%xmm2,%%xmm0 \n" - "punpckhbw %%xmm2,%%xmm1 \n" - "psubb %%xmm4,%%xmm0 \n" - "psubb %%xmm4,%%xmm1 \n" - "movdqa %%xmm5,%%xmm2 \n" - "movdqa %%xmm5,%%xmm3 \n" - "pmaddubsw %%xmm0,%%xmm2 \n" - "pmaddubsw %%xmm1,%%xmm3 \n" - "paddw %%xmm4,%%xmm2 \n" - "paddw %%xmm4,%%xmm3 \n" - "psrlw $0x8,%%xmm2 \n" - "psrlw $0x8,%%xmm3 \n" - "packuswb %%xmm3,%%xmm2 \n" - "movdqu %%xmm2,0x00(%1,%0,1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - "jmp 99f \n" - - // Blend 50 / 50. - LABELALIGN - "50: \n" - "movdqu (%1),%%xmm0 \n" - "movdqu 0x00(%1,%4,1),%%xmm1 \n" - "pavgb %%xmm1,%%xmm0 \n" - "movdqu %%xmm0,0x00(%1,%0,1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 50b \n" - "jmp 99f \n" - - // Blend 100 / 0 - Copy row unchanged. - LABELALIGN - "100: \n" - "movdqu (%1),%%xmm0 \n" - "movdqu %%xmm0,0x00(%1,%0,1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 100b \n" - - "99: \n" - : "+r"(dst_ptr), // %0 - "+r"(src_ptr), // %1 - "+rm"(width), // %2 - "+r"(source_y_fraction) // %3 - : "r"((intptr_t) (src_stride)) // %4 - : "memory", "cc", "eax", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif // HAS_INTERPOLATEROW_SSSE3 - -#ifdef HAS_INTERPOLATEROW_AVX2 - -// Bilinear filter 32x2 -> 32x1 -void InterpolateRow_AVX2(uint8_t *dst_ptr, - const uint8_t *src_ptr, - ptrdiff_t src_stride, - int width, - int source_y_fraction) { - asm volatile( - "sub %1,%0 \n" - "cmp $0x0,%3 \n" - "je 100f \n" - "cmp $0x80,%3 \n" - "je 50f \n" - - "vmovd %3,%%xmm0 \n" - "neg %3 \n" - "add $0x100,%3 \n" - "vmovd %3,%%xmm5 \n" - "vpunpcklbw %%xmm0,%%xmm5,%%xmm5 \n" - "vpunpcklwd %%xmm5,%%xmm5,%%xmm5 \n" - "vbroadcastss %%xmm5,%%ymm5 \n" - "mov $0x80808080,%%eax \n" - "vmovd %%eax,%%xmm4 \n" - "vbroadcastss %%xmm4,%%ymm4 \n" - - // General purpose row blend. - LABELALIGN - "1: \n" - "vmovdqu (%1),%%ymm0 \n" - "vmovdqu 0x00(%1,%4,1),%%ymm2 \n" - "vpunpckhbw %%ymm2,%%ymm0,%%ymm1 \n" - "vpunpcklbw %%ymm2,%%ymm0,%%ymm0 \n" - "vpsubb %%ymm4,%%ymm1,%%ymm1 \n" - "vpsubb %%ymm4,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm1,%%ymm5,%%ymm1 \n" - "vpmaddubsw %%ymm0,%%ymm5,%%ymm0 \n" - "vpaddw %%ymm4,%%ymm1,%%ymm1 \n" - "vpaddw %%ymm4,%%ymm0,%%ymm0 \n" - "vpsrlw $0x8,%%ymm1,%%ymm1 \n" - "vpsrlw $0x8,%%ymm0,%%ymm0 \n" - "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,0x00(%1,%0,1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 1b \n" - "jmp 99f \n" - - // Blend 50 / 50. - LABELALIGN - "50: \n" - "vmovdqu (%1),%%ymm0 \n" - "vpavgb 0x00(%1,%4,1),%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,0x00(%1,%0,1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 50b \n" - "jmp 99f \n" - - // Blend 100 / 0 - Copy row unchanged. - LABELALIGN - "100: \n" - "vmovdqu (%1),%%ymm0 \n" - "vmovdqu %%ymm0,0x00(%1,%0,1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 100b \n" - - "99: \n" - "vzeroupper \n" - : "+r"(dst_ptr), // %0 - "+r"(src_ptr), // %1 - "+r"(width), // %2 - "+r"(source_y_fraction) // %3 - : "r"((intptr_t) (src_stride)) // %4 - : "memory", "cc", "eax", "xmm0", "xmm1", "xmm2", "xmm4", "xmm5"); -} - -#endif // HAS_INTERPOLATEROW_AVX2 - -#endif // defined(__x86_64__) || defined(__i386__) diff --git a/pkg/encoder/yuv/libyuv/scale.c b/pkg/encoder/yuv/libyuv/scale.c deleted file mode 100644 index c4bd5b0b..00000000 --- a/pkg/encoder/yuv/libyuv/scale.c +++ /dev/null @@ -1,946 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "scale.h" - -#include -#include - -#include "cpu_id.h" -#include "planar_functions.h" // For CopyPlane -#include "row.h" -#include "scale_row.h" - -static __inline int Abs(int v) { - return v >= 0 ? v : -v; -} - -#define SUBSAMPLE(v, a, s) (v < 0) ? (-((-v + a) >> s)) : ((v + a) >> s) -#define CENTERSTART(dx, s) (dx < 0) ? -((-dx >> 1) + s) : ((dx >> 1) + s) - -// Scale plane, 1/2 -// This is an optimized version for scaling down a plane to 1/2 of -// its original size. - -static void ScalePlaneDown2(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr, - enum FilterMode filtering) { - int y; - void (*ScaleRowDown2)(const uint8_t *src_ptr, ptrdiff_t src_stride, - uint8_t *dst_ptr, int dst_width) = - filtering == kFilterNone - ? ScaleRowDown2_C - : (filtering == kFilterLinear ? ScaleRowDown2Linear_C - : ScaleRowDown2Box_C); - int row_stride = src_stride * 2; - (void) src_width; - (void) src_height; - if (!filtering) { - src_ptr += src_stride; // Point to odd rows. - src_stride = 0; - } - - -#if defined(HAS_SCALEROWDOWN2_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - ScaleRowDown2 = - filtering == kFilterNone - ? ScaleRowDown2_Any_SSSE3 - : (filtering == kFilterLinear ? ScaleRowDown2Linear_Any_SSSE3 - : ScaleRowDown2Box_Any_SSSE3); - if (IS_ALIGNED(dst_width, 16)) { - ScaleRowDown2 = - filtering == kFilterNone - ? ScaleRowDown2_SSSE3 - : (filtering == kFilterLinear ? ScaleRowDown2Linear_SSSE3 - : ScaleRowDown2Box_SSSE3); - } - } -#endif -#if defined(HAS_SCALEROWDOWN2_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ScaleRowDown2 = - filtering == kFilterNone - ? ScaleRowDown2_Any_AVX2 - : (filtering == kFilterLinear ? ScaleRowDown2Linear_Any_AVX2 - : ScaleRowDown2Box_Any_AVX2); - if (IS_ALIGNED(dst_width, 32)) { - ScaleRowDown2 = filtering == kFilterNone ? ScaleRowDown2_AVX2 - : (filtering == kFilterLinear - ? ScaleRowDown2Linear_AVX2 - : ScaleRowDown2Box_AVX2); - } - } -#endif - - if (filtering == kFilterLinear) { - src_stride = 0; - } - // TODO(fbarchard): Loop through source height to allow odd height. - for (y = 0; y < dst_height; ++y) { - ScaleRowDown2(src_ptr, src_stride, dst_ptr, dst_width); - src_ptr += row_stride; - dst_ptr += dst_stride; - } -} - -// Scale plane, 1/4 -// This is an optimized version for scaling down a plane to 1/4 of -// its original size. - -static void ScalePlaneDown4(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr, - enum FilterMode filtering) { - int y; - void (*ScaleRowDown4)(const uint8_t *src_ptr, ptrdiff_t src_stride, - uint8_t *dst_ptr, int dst_width) = - filtering ? ScaleRowDown4Box_C : ScaleRowDown4_C; - int row_stride = src_stride * 4; - (void) src_width; - (void) src_height; - if (!filtering) { - src_ptr += src_stride * 2; // Point to row 2. - src_stride = 0; - } - -#if defined(HAS_SCALEROWDOWN4_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - ScaleRowDown4 = - filtering ? ScaleRowDown4Box_Any_SSSE3 : ScaleRowDown4_Any_SSSE3; - if (IS_ALIGNED(dst_width, 8)) { - ScaleRowDown4 = filtering ? ScaleRowDown4Box_SSSE3 : ScaleRowDown4_SSSE3; - } - } -#endif -#if defined(HAS_SCALEROWDOWN4_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ScaleRowDown4 = - filtering ? ScaleRowDown4Box_Any_AVX2 : ScaleRowDown4_Any_AVX2; - if (IS_ALIGNED(dst_width, 16)) { - ScaleRowDown4 = filtering ? ScaleRowDown4Box_AVX2 : ScaleRowDown4_AVX2; - } - } -#endif - - if (filtering == kFilterLinear) { - src_stride = 0; - } - for (y = 0; y < dst_height; ++y) { - ScaleRowDown4(src_ptr, src_stride, dst_ptr, dst_width); - src_ptr += row_stride; - dst_ptr += dst_stride; - } -} - -// Scale plane down, 3/4 -static void ScalePlaneDown34(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr, - enum FilterMode filtering) { - int y; - void (*ScaleRowDown34_0)(const uint8_t *src_ptr, ptrdiff_t src_stride, - uint8_t *dst_ptr, int dst_width); - void (*ScaleRowDown34_1)(const uint8_t *src_ptr, ptrdiff_t src_stride, - uint8_t *dst_ptr, int dst_width); - const int filter_stride = (filtering == kFilterLinear) ? 0 : src_stride; - (void) src_width; - (void) src_height; - assert(dst_width % 3 == 0); - if (!filtering) { - ScaleRowDown34_0 = ScaleRowDown34_C; - ScaleRowDown34_1 = ScaleRowDown34_C; - } else { - ScaleRowDown34_0 = ScaleRowDown34_0_Box_C; - ScaleRowDown34_1 = ScaleRowDown34_1_Box_C; - } - -#if defined(HAS_SCALEROWDOWN34_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - if (!filtering) { - ScaleRowDown34_0 = ScaleRowDown34_Any_SSSE3; - ScaleRowDown34_1 = ScaleRowDown34_Any_SSSE3; - } else { - ScaleRowDown34_0 = ScaleRowDown34_0_Box_Any_SSSE3; - ScaleRowDown34_1 = ScaleRowDown34_1_Box_Any_SSSE3; - } - if (dst_width % 24 == 0) { - if (!filtering) { - ScaleRowDown34_0 = ScaleRowDown34_SSSE3; - ScaleRowDown34_1 = ScaleRowDown34_SSSE3; - } else { - ScaleRowDown34_0 = ScaleRowDown34_0_Box_SSSE3; - ScaleRowDown34_1 = ScaleRowDown34_1_Box_SSSE3; - } - } - } -#endif - - for (y = 0; y < dst_height - 2; y += 3) { - ScaleRowDown34_0(src_ptr, filter_stride, dst_ptr, dst_width); - src_ptr += src_stride; - dst_ptr += dst_stride; - ScaleRowDown34_1(src_ptr, filter_stride, dst_ptr, dst_width); - src_ptr += src_stride; - dst_ptr += dst_stride; - ScaleRowDown34_0(src_ptr + src_stride, -filter_stride, dst_ptr, dst_width); - src_ptr += src_stride * 2; - dst_ptr += dst_stride; - } - - // Remainder 1 or 2 rows with last row vertically unfiltered - if ((dst_height % 3) == 2) { - ScaleRowDown34_0(src_ptr, filter_stride, dst_ptr, dst_width); - src_ptr += src_stride; - dst_ptr += dst_stride; - ScaleRowDown34_1(src_ptr, 0, dst_ptr, dst_width); - } else if ((dst_height % 3) == 1) { - ScaleRowDown34_0(src_ptr, 0, dst_ptr, dst_width); - } -} - -// Scale plane, 3/8 -// This is an optimized version for scaling down a plane to 3/8 -// of its original size. -// -// Uses box filter arranges like this -// aaabbbcc -> abc -// aaabbbcc def -// aaabbbcc ghi -// dddeeeff -// dddeeeff -// dddeeeff -// ggghhhii -// ggghhhii -// Boxes are 3x3, 2x3, 3x2 and 2x2 - -static void ScalePlaneDown38(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr, - enum FilterMode filtering) { - int y; - void (*ScaleRowDown38_3)(const uint8_t *src_ptr, ptrdiff_t src_stride, - uint8_t *dst_ptr, int dst_width); - void (*ScaleRowDown38_2)(const uint8_t *src_ptr, ptrdiff_t src_stride, - uint8_t *dst_ptr, int dst_width); - const int filter_stride = (filtering == kFilterLinear) ? 0 : src_stride; - assert(dst_width % 3 == 0); - (void) src_width; - (void) src_height; - if (!filtering) { - ScaleRowDown38_3 = ScaleRowDown38_C; - ScaleRowDown38_2 = ScaleRowDown38_C; - } else { - ScaleRowDown38_3 = ScaleRowDown38_3_Box_C; - ScaleRowDown38_2 = ScaleRowDown38_2_Box_C; - } - -#if defined(HAS_SCALEROWDOWN38_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - if (!filtering) { - ScaleRowDown38_3 = ScaleRowDown38_Any_SSSE3; - ScaleRowDown38_2 = ScaleRowDown38_Any_SSSE3; - } else { - ScaleRowDown38_3 = ScaleRowDown38_3_Box_Any_SSSE3; - ScaleRowDown38_2 = ScaleRowDown38_2_Box_Any_SSSE3; - } - if (dst_width % 12 == 0 && !filtering) { - ScaleRowDown38_3 = ScaleRowDown38_SSSE3; - ScaleRowDown38_2 = ScaleRowDown38_SSSE3; - } - if (dst_width % 6 == 0 && filtering) { - ScaleRowDown38_3 = ScaleRowDown38_3_Box_SSSE3; - ScaleRowDown38_2 = ScaleRowDown38_2_Box_SSSE3; - } - } -#endif - - for (y = 0; y < dst_height - 2; y += 3) { - ScaleRowDown38_3(src_ptr, filter_stride, dst_ptr, dst_width); - src_ptr += src_stride * 3; - dst_ptr += dst_stride; - ScaleRowDown38_3(src_ptr, filter_stride, dst_ptr, dst_width); - src_ptr += src_stride * 3; - dst_ptr += dst_stride; - ScaleRowDown38_2(src_ptr, filter_stride, dst_ptr, dst_width); - src_ptr += src_stride * 2; - dst_ptr += dst_stride; - } - - // Remainder 1 or 2 rows with last row vertically unfiltered - if ((dst_height % 3) == 2) { - ScaleRowDown38_3(src_ptr, filter_stride, dst_ptr, dst_width); - src_ptr += src_stride * 3; - dst_ptr += dst_stride; - ScaleRowDown38_3(src_ptr, 0, dst_ptr, dst_width); - } else if ((dst_height % 3) == 1) { - ScaleRowDown38_3(src_ptr, 0, dst_ptr, dst_width); - } -} - -#define MIN1(x) ((x) < 1 ? 1 : (x)) - -static __inline uint32_t SumPixels(int iboxwidth, const uint16_t *src_ptr) { - uint32_t sum = 0u; - int x; - assert(iboxwidth > 0); - for (x = 0; x < iboxwidth; ++x) { - sum += src_ptr[x]; - } - return sum; -} - -static __inline uint32_t SumPixels_16(int iboxwidth, const uint32_t *src_ptr) { - uint32_t sum = 0u; - int x; - assert(iboxwidth > 0); - for (x = 0; x < iboxwidth; ++x) { - sum += src_ptr[x]; - } - return sum; -} - -static void ScaleAddCols2_C(int dst_width, - int boxheight, - int x, - int dx, - const uint16_t *src_ptr, - uint8_t *dst_ptr) { - int i; - int scaletbl[2]; - int minboxwidth = dx >> 16; - int boxwidth; - scaletbl[0] = 65536 / (MIN1(minboxwidth) * boxheight); - scaletbl[1] = 65536 / (MIN1(minboxwidth + 1) * boxheight); - for (i = 0; i < dst_width; ++i) { - int ix = x >> 16; - x += dx; - boxwidth = MIN1((x >> 16) - ix); - int scaletbl_index = boxwidth - minboxwidth; - assert((scaletbl_index == 0) || (scaletbl_index == 1)); - *dst_ptr++ = (uint8_t) (SumPixels(boxwidth, src_ptr + ix) * - scaletbl[scaletbl_index] >> - 16); - } -} - -static void ScaleAddCols0_C(int dst_width, - int boxheight, - int x, - int dx, - const uint16_t *src_ptr, - uint8_t *dst_ptr) { - int scaleval = 65536 / boxheight; - int i; - (void) dx; - src_ptr += (x >> 16); - for (i = 0; i < dst_width; ++i) { - *dst_ptr++ = (uint8_t) (src_ptr[i] * scaleval >> 16); - } -} - -static void ScaleAddCols1_C(int dst_width, - int boxheight, - int x, - int dx, - const uint16_t *src_ptr, - uint8_t *dst_ptr) { - int boxwidth = MIN1(dx >> 16); - int scaleval = 65536 / (boxwidth * boxheight); - int i; - x >>= 16; - for (i = 0; i < dst_width; ++i) { - *dst_ptr++ = (uint8_t) (SumPixels(boxwidth, src_ptr + x) * scaleval >> 16); - x += boxwidth; - } -} - -// Scale plane down to any dimensions, with interpolation. -// (boxfilter). -// -// Same method as SimpleScale, which is fixed point, outputting -// one pixel of destination using fixed point (16.16) to step -// through source, sampling a box of pixel with simple -// averaging. -static void ScalePlaneBox(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr) { - int j, k; - // Initial source x/y coordinate and step values as 16.16 fixed point. - int x = 0; - int y = 0; - int dx = 0; - int dy = 0; - const int max_y = (src_height << 16); - ScaleSlope(src_width, src_height, dst_width, dst_height, kFilterBox, &x, &y, - &dx, &dy); - src_width = Abs(src_width); - { - // Allocate a row buffer of uint16_t. - align_buffer_64(row16, src_width * 2); - void (*ScaleAddCols)(int dst_width, int boxheight, int x, int dx, - const uint16_t *src_ptr, uint8_t *dst_ptr) = - (dx & 0xffff) ? ScaleAddCols2_C - : ((dx != 0x10000) ? ScaleAddCols1_C : ScaleAddCols0_C); - void (*ScaleAddRow)(const uint8_t *src_ptr, uint16_t *dst_ptr, - int src_width) = ScaleAddRow_C; -#if defined(HAS_SCALEADDROW_SSE2) - if (TestCpuFlag(kCpuHasSSE2)) { - ScaleAddRow = ScaleAddRow_Any_SSE2; - if (IS_ALIGNED(src_width, 16)) { - ScaleAddRow = ScaleAddRow_SSE2; - } - } -#endif -#if defined(HAS_SCALEADDROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - ScaleAddRow = ScaleAddRow_Any_AVX2; - if (IS_ALIGNED(src_width, 32)) { - ScaleAddRow = ScaleAddRow_AVX2; - } - } -#endif - - - for (j = 0; j < dst_height; ++j) { - int boxheight; - int iy = y >> 16; - const uint8_t *src = src_ptr + iy * (int64_t) src_stride; - y += dy; - if (y > max_y) { - y = max_y; - } - boxheight = MIN1((y >> 16) - iy); - memset(row16, 0, src_width * 2); - for (k = 0; k < boxheight; ++k) { - ScaleAddRow(src, (uint16_t *) (row16), src_width); - src += src_stride; - } - ScaleAddCols(dst_width, boxheight, x, dx, (uint16_t *) (row16), dst_ptr); - dst_ptr += dst_stride; - } - free_aligned_buffer_64(row16); - } -} - -// Scale plane down with bilinear interpolation. -static void ScalePlaneBilinearDown(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr, - enum FilterMode filtering) { - // Initial source x/y coordinate and step values as 16.16 fixed point. - int x = 0; - int y = 0; - int dx = 0; - int dy = 0; - // TODO(fbarchard): Consider not allocating row buffer for kFilterLinear. - // Allocate a row buffer. - align_buffer_64(row, src_width); - - const int max_y = (src_height - 1) << 16; - int j; - void (*ScaleFilterCols)(uint8_t *dst_ptr, const uint8_t *src_ptr, - int dst_width, int x, int dx) = - (src_width >= 32768) ? ScaleFilterCols64_C : ScaleFilterCols_C; - void (*InterpolateRow)(uint8_t *dst_ptr, const uint8_t *src_ptr, - ptrdiff_t src_stride, int dst_width, - int source_y_fraction) = InterpolateRow_C; - ScaleSlope(src_width, src_height, dst_width, dst_height, filtering, &x, &y, - &dx, &dy); - src_width = Abs(src_width); - -#if defined(HAS_INTERPOLATEROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - InterpolateRow = InterpolateRow_Any_SSSE3; - if (IS_ALIGNED(src_width, 16)) { - InterpolateRow = InterpolateRow_SSSE3; - } - } -#endif -#if defined(HAS_INTERPOLATEROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - InterpolateRow = InterpolateRow_Any_AVX2; - if (IS_ALIGNED(src_width, 32)) { - InterpolateRow = InterpolateRow_AVX2; - } - } -#endif - -#if defined(HAS_SCALEFILTERCOLS_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3) && src_width < 32768) { - ScaleFilterCols = ScaleFilterCols_SSSE3; - } -#endif - - if (y > max_y) { - y = max_y; - } - - for (j = 0; j < dst_height; ++j) { - int yi = y >> 16; - const uint8_t *src = src_ptr + yi * (int64_t) src_stride; - if (filtering == kFilterLinear) { - ScaleFilterCols(dst_ptr, src, dst_width, x, dx); - } else { - int yf = (y >> 8) & 255; - InterpolateRow(row, src, src_stride, src_width, yf); - ScaleFilterCols(dst_ptr, row, dst_width, x, dx); - } - dst_ptr += dst_stride; - y += dy; - if (y > max_y) { - y = max_y; - } - } - free_aligned_buffer_64(row); -} - -// Scale up down with bilinear interpolation. -static void ScalePlaneBilinearUp(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr, - enum FilterMode filtering) { - int j; - // Initial source x/y coordinate and step values as 16.16 fixed point. - int x = 0; - int y = 0; - int dx = 0; - int dy = 0; - const int max_y = (src_height - 1) << 16; - void (*InterpolateRow)(uint8_t *dst_ptr, const uint8_t *src_ptr, - ptrdiff_t src_stride, int dst_width, - int source_y_fraction) = InterpolateRow_C; - void (*ScaleFilterCols)(uint8_t *dst_ptr, const uint8_t *src_ptr, - int dst_width, int x, int dx) = - filtering ? ScaleFilterCols_C : ScaleCols_C; - ScaleSlope(src_width, src_height, dst_width, dst_height, filtering, &x, &y, - &dx, &dy); - src_width = Abs(src_width); - -#if defined(HAS_INTERPOLATEROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - InterpolateRow = InterpolateRow_Any_SSSE3; - if (IS_ALIGNED(dst_width, 16)) { - InterpolateRow = InterpolateRow_SSSE3; - } - } -#endif -#if defined(HAS_INTERPOLATEROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - InterpolateRow = InterpolateRow_Any_AVX2; - if (IS_ALIGNED(dst_width, 32)) { - InterpolateRow = InterpolateRow_AVX2; - } - } -#endif - - if (filtering && src_width >= 32768) { - ScaleFilterCols = ScaleFilterCols64_C; - } -#if defined(HAS_SCALEFILTERCOLS_SSSE3) - if (filtering && TestCpuFlag(kCpuHasSSSE3) && src_width < 32768) { - ScaleFilterCols = ScaleFilterCols_SSSE3; - } -#endif - - if (!filtering && src_width * 2 == dst_width && x < 0x8000) { - ScaleFilterCols = ScaleColsUp2_C; -#if defined(HAS_SCALECOLS_SSE2) - if (TestCpuFlag(kCpuHasSSE2) && IS_ALIGNED(dst_width, 8)) { - ScaleFilterCols = ScaleColsUp2_SSE2; - } -#endif - } - - if (y > max_y) { - y = max_y; - } - { - int yi = y >> 16; - const uint8_t *src = src_ptr + yi * (int64_t) src_stride; - - // Allocate 2 row buffers. - const int row_size = (dst_width + 31) & ~31; - align_buffer_64(row, row_size * 2); - - uint8_t *rowptr = row; - int rowstride = row_size; - int lasty = yi; - - ScaleFilterCols(rowptr, src, dst_width, x, dx); - if (src_height > 1) { - src += src_stride; - } - ScaleFilterCols(rowptr + rowstride, src, dst_width, x, dx); - if (src_height > 2) { - src += src_stride; - } - - for (j = 0; j < dst_height; ++j) { - yi = y >> 16; - if (yi != lasty) { - if (y > max_y) { - y = max_y; - yi = y >> 16; - src = src_ptr + yi * (int64_t) src_stride; - } - if (yi != lasty) { - ScaleFilterCols(rowptr, src, dst_width, x, dx); - rowptr += rowstride; - rowstride = -rowstride; - lasty = yi; - if ((y + 65536) < max_y) { - src += src_stride; - } - } - } - if (filtering == kFilterLinear) { - InterpolateRow(dst_ptr, rowptr, 0, dst_width, 0); - } else { - int yf = (y >> 8) & 255; - InterpolateRow(dst_ptr, rowptr, rowstride, dst_width, yf); - } - dst_ptr += dst_stride; - y += dy; - } - free_aligned_buffer_64(row); - } -} - -// Scale plane, horizontally up by 2 times. -// Uses linear filter horizontally, nearest vertically. -// This is an optimized version for scaling up a plane to 2 times of -// its original width, using linear interpolation. -// This is used to scale U and V planes of I422 to I444. -static void ScalePlaneUp2_Linear(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr) { - void (*ScaleRowUp)(const uint8_t *src_ptr, uint8_t *dst_ptr, int dst_width) = - ScaleRowUp2_Linear_Any_C; - int i; - int y; - int dy; - - (void) src_width; - // This function can only scale up by 2 times horizontally. - assert(src_width == ((dst_width + 1) / 2)); - -#ifdef HAS_SCALEROWUP2_LINEAR_SSE2 - if (TestCpuFlag(kCpuHasSSE2)) { - ScaleRowUp = ScaleRowUp2_Linear_Any_SSE2; - } -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_SSSE3 - if (TestCpuFlag(kCpuHasSSSE3)) { - ScaleRowUp = ScaleRowUp2_Linear_Any_SSSE3; - } -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_AVX2 - if (TestCpuFlag(kCpuHasAVX2)) { - ScaleRowUp = ScaleRowUp2_Linear_Any_AVX2; - } -#endif - - - if (dst_height == 1) { - ScaleRowUp(src_ptr + ((src_height - 1) / 2) * (int64_t) src_stride, dst_ptr, - dst_width); - } else { - dy = FixedDiv(src_height - 1, dst_height - 1); - y = (1 << 15) - 1; - for (i = 0; i < dst_height; ++i) { - ScaleRowUp(src_ptr + (y >> 16) * (int64_t) src_stride, dst_ptr, dst_width); - dst_ptr += dst_stride; - y += dy; - } - } -} - -// Scale plane, up by 2 times. -// This is an optimized version for scaling up a plane to 2 times of -// its original size, using bilinear interpolation. -// This is used to scale U and V planes of I420 to I444. -static void ScalePlaneUp2_Bilinear(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr) { - void (*Scale2RowUp)(const uint8_t *src_ptr, ptrdiff_t src_stride, - uint8_t *dst_ptr, ptrdiff_t dst_stride, int dst_width) = - ScaleRowUp2_Bilinear_Any_C; - int x; - - (void) src_width; - // This function can only scale up by 2 times. - assert(src_width == ((dst_width + 1) / 2)); - assert(src_height == ((dst_height + 1) / 2)); - -#ifdef HAS_SCALEROWUP2_BILINEAR_SSE2 - if (TestCpuFlag(kCpuHasSSE2)) { - Scale2RowUp = ScaleRowUp2_Bilinear_Any_SSE2; - } -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_SSSE3 - if (TestCpuFlag(kCpuHasSSSE3)) { - Scale2RowUp = ScaleRowUp2_Bilinear_Any_SSSE3; - } -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_AVX2 - if (TestCpuFlag(kCpuHasAVX2)) { - Scale2RowUp = ScaleRowUp2_Bilinear_Any_AVX2; - } -#endif - - - Scale2RowUp(src_ptr, 0, dst_ptr, 0, dst_width); - dst_ptr += dst_stride; - for (x = 0; x < src_height - 1; ++x) { - Scale2RowUp(src_ptr, src_stride, dst_ptr, dst_stride, dst_width); - src_ptr += src_stride; - // TODO(fbarchard): Test performance of writing one row of destination at a - // time. - dst_ptr += 2 * dst_stride; - } - if (!(dst_height & 1)) { - Scale2RowUp(src_ptr, 0, dst_ptr, 0, dst_width); - } -} - -// Scale Plane to/from any dimensions, without interpolation. -// Fixed point math is used for performance: The upper 16 bits -// of x and dx is the integer part of the source position and -// the lower 16 bits are the fixed decimal part. - -static void ScalePlaneSimple(int src_width, - int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_ptr, - uint8_t *dst_ptr) { - int i; - void (*ScaleCols)(uint8_t *dst_ptr, const uint8_t *src_ptr, int dst_width, - int x, int dx) = ScaleCols_C; - // Initial source x/y coordinate and step values as 16.16 fixed point. - int x = 0; - int y = 0; - int dx = 0; - int dy = 0; - ScaleSlope(src_width, src_height, dst_width, dst_height, kFilterNone, &x, &y, - &dx, &dy); - src_width = Abs(src_width); - - if (src_width * 2 == dst_width && x < 0x8000) { - ScaleCols = ScaleColsUp2_C; -#if defined(HAS_SCALECOLS_SSE2) - if (TestCpuFlag(kCpuHasSSE2) && IS_ALIGNED(dst_width, 8)) { - ScaleCols = ScaleColsUp2_SSE2; - } -#endif - } - - for (i = 0; i < dst_height; ++i) { - ScaleCols(dst_ptr, src_ptr + (y >> 16) * (int64_t) src_stride, dst_width, x, - dx); - dst_ptr += dst_stride; - y += dy; - } -} - -// Scale a plane. -// This function dispatches to a specialized scaler based on scale factor. -LIBYUV_API -void ScalePlane(const uint8_t *src, - int src_stride, - int src_width, - int src_height, - uint8_t *dst, - int dst_stride, - int dst_width, - int dst_height, - enum FilterMode filtering) { - // Simplify filtering when possible. - filtering = ScaleFilterReduce(src_width, src_height, dst_width, dst_height, - filtering); - - // Negative height means invert the image. - if (src_height < 0) { - src_height = -src_height; - src = src + (src_height - 1) * (int64_t) src_stride; - src_stride = -src_stride; - } - // Use specialized scales to improve performance for common resolutions. - // For example, all the 1/2 scalings will use ScalePlaneDown2() - if (dst_width == src_width && dst_height == src_height) { - // Straight copy. - CopyPlane(src, src_stride, dst, dst_stride, dst_width, dst_height); - return; - } - if (dst_width == src_width && filtering != kFilterBox) { - int dy = 0; - int y = 0; - // When scaling down, use the center 2 rows to filter. - // When scaling up, last row of destination uses the last 2 source rows. - if (dst_height <= src_height) { - dy = FixedDiv(src_height, dst_height); - y = CENTERSTART(dy, -32768); // Subtract 0.5 (32768) to center filter. - } else if (src_height > 1 && dst_height > 1) { - dy = FixedDiv1(src_height, dst_height); - } - // Arbitrary scale vertically, but unscaled horizontally. - ScalePlaneVertical(src_height, dst_width, dst_height, src_stride, - dst_stride, src, dst, 0, y, dy, /*bpp=*/1, filtering); - return; - } - if (dst_width <= Abs(src_width) && dst_height <= src_height) { - // Scale down. - if (4 * dst_width == 3 * src_width && 4 * dst_height == 3 * src_height) { - // optimized, 3/4 - ScalePlaneDown34(src_width, src_height, dst_width, dst_height, src_stride, - dst_stride, src, dst, filtering); - return; - } - if (2 * dst_width == src_width && 2 * dst_height == src_height) { - // optimized, 1/2 - ScalePlaneDown2(src_width, src_height, dst_width, dst_height, src_stride, - dst_stride, src, dst, filtering); - return; - } - // 3/8 rounded up for odd sized chroma height. - if (8 * dst_width == 3 * src_width && 8 * dst_height == 3 * src_height) { - // optimized, 3/8 - ScalePlaneDown38(src_width, src_height, dst_width, dst_height, src_stride, - dst_stride, src, dst, filtering); - return; - } - if (4 * dst_width == src_width && 4 * dst_height == src_height && - (filtering == kFilterBox || filtering == kFilterNone)) { - // optimized, 1/4 - ScalePlaneDown4(src_width, src_height, dst_width, dst_height, src_stride, - dst_stride, src, dst, filtering); - return; - } - } - if (filtering == kFilterBox && dst_height * 2 < src_height) { - ScalePlaneBox(src_width, src_height, dst_width, dst_height, src_stride, - dst_stride, src, dst); - return; - } - if ((dst_width + 1) / 2 == src_width && filtering == kFilterLinear) { - ScalePlaneUp2_Linear(src_width, src_height, dst_width, dst_height, - src_stride, dst_stride, src, dst); - return; - } - if ((dst_height + 1) / 2 == src_height && (dst_width + 1) / 2 == src_width && - (filtering == kFilterBilinear || filtering == kFilterBox)) { - ScalePlaneUp2_Bilinear(src_width, src_height, dst_width, dst_height, - src_stride, dst_stride, src, dst); - return; - } - if (filtering && dst_height > src_height) { - ScalePlaneBilinearUp(src_width, src_height, dst_width, dst_height, - src_stride, dst_stride, src, dst, filtering); - return; - } - if (filtering) { - ScalePlaneBilinearDown(src_width, src_height, dst_width, dst_height, - src_stride, dst_stride, src, dst, filtering); - return; - } - ScalePlaneSimple(src_width, src_height, dst_width, dst_height, src_stride, - dst_stride, src, dst); -} - -LIBYUV_API -int I420Scale(const uint8_t *src_y, - int src_stride_y, - const uint8_t *src_u, - int src_stride_u, - const uint8_t *src_v, - int src_stride_v, - int src_width, - int src_height, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int dst_width, - int dst_height, - enum FilterMode filtering) { - int src_halfwidth = SUBSAMPLE(src_width, 1, 1); - int src_halfheight = SUBSAMPLE(src_height, 1, 1); - int dst_halfwidth = SUBSAMPLE(dst_width, 1, 1); - int dst_halfheight = SUBSAMPLE(dst_height, 1, 1); - - if (!src_y || !src_u || !src_v || src_width <= 0 || src_height == 0 || - src_width > 32768 || src_height > 32768 || !dst_y || !dst_u || !dst_v || - dst_width <= 0 || dst_height <= 0) { - return -1; - } - - ScalePlane(src_y, src_stride_y, src_width, src_height, dst_y, dst_stride_y, - dst_width, dst_height, filtering); - ScalePlane(src_u, src_stride_u, src_halfwidth, src_halfheight, dst_u, - dst_stride_u, dst_halfwidth, dst_halfheight, filtering); - ScalePlane(src_v, src_stride_v, src_halfwidth, src_halfheight, dst_v, - dst_stride_v, dst_halfwidth, dst_halfheight, filtering); - return 0; -} diff --git a/pkg/encoder/yuv/libyuv/scale.h b/pkg/encoder/yuv/libyuv/scale.h deleted file mode 100644 index ed0a1983..00000000 --- a/pkg/encoder/yuv/libyuv/scale.h +++ /dev/null @@ -1,53 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_SCALE_H_ -#define INCLUDE_LIBYUV_SCALE_H_ - -#include "basic_types.h" - -// Supported filtering. -typedef enum FilterMode { - kFilterNone = 0, // Point sample; Fastest. - kFilterLinear = 1, // Filter horizontally only. - kFilterBilinear = 2, // Faster than box, but lower quality scaling down. - kFilterBox = 3 // Highest quality. -} FilterModeEnum; - -// Scales a YUV 4:2:0 image from the src width and height to the -// dst width and height. -// If filtering is kFilterNone, a simple nearest-neighbor algorithm is -// used. This produces basic (blocky) quality at the fastest speed. -// If filtering is kFilterBilinear, interpolation is used to produce a better -// quality image, at the expense of speed. -// If filtering is kFilterBox, averaging is used to produce ever better -// quality image, at further expense of speed. -// Returns 0 if successful. - -LIBYUV_API -int I420Scale(const uint8_t *src_y, - int src_stride_y, - const uint8_t *src_u, - int src_stride_u, - const uint8_t *src_v, - int src_stride_v, - int src_width, - int src_height, - uint8_t *dst_y, - int dst_stride_y, - uint8_t *dst_u, - int dst_stride_u, - uint8_t *dst_v, - int dst_stride_v, - int dst_width, - int dst_height, - enum FilterMode filtering); - -#endif // INCLUDE_LIBYUV_SCALE_H_ diff --git a/pkg/encoder/yuv/libyuv/scale_any.c b/pkg/encoder/yuv/libyuv/scale_any.c deleted file mode 100644 index f05e55b6..00000000 --- a/pkg/encoder/yuv/libyuv/scale_any.c +++ /dev/null @@ -1,632 +0,0 @@ -/* - * Copyright 2015 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "scale_row.h" - -// Fixed scale down. -// Mask may be non-power of 2, so use MOD -#define SDANY(NAMEANY, SCALEROWDOWN_SIMD, SCALEROWDOWN_C, FACTOR, BPP, MASK) \ - void NAMEANY(const uint8_t* src_ptr, ptrdiff_t src_stride, uint8_t* dst_ptr, \ - int dst_width) { \ - int r = (int)((unsigned int)dst_width % (MASK + 1)); /* NOLINT */ \ - int n = dst_width - r; \ - if (n > 0) { \ - SCALEROWDOWN_SIMD(src_ptr, src_stride, dst_ptr, n); \ - } \ - SCALEROWDOWN_C(src_ptr + (n * FACTOR) * BPP, src_stride, \ - dst_ptr + n * BPP, r); \ - } - -// Fixed scale down for odd source width. Used by I420Blend subsampling. -// Since dst_width is (width + 1) / 2, this function scales one less pixel -// and copies the last pixel. -#define SDODD(NAMEANY, SCALEROWDOWN_SIMD, SCALEROWDOWN_C, FACTOR, BPP, MASK) \ - void NAMEANY(const uint8_t* src_ptr, ptrdiff_t src_stride, uint8_t* dst_ptr, \ - int dst_width) { \ - int r = (int)((unsigned int)(dst_width - 1) % (MASK + 1)); /* NOLINT */ \ - int n = (dst_width - 1) - r; \ - if (n > 0) { \ - SCALEROWDOWN_SIMD(src_ptr, src_stride, dst_ptr, n); \ - } \ - SCALEROWDOWN_C(src_ptr + (n * FACTOR) * BPP, src_stride, \ - dst_ptr + n * BPP, r + 1); \ - } - -#ifdef HAS_SCALEROWDOWN2_SSSE3 - -SDANY(ScaleRowDown2_Any_SSSE3, ScaleRowDown2_SSSE3, ScaleRowDown2_C, 2, 1, 15) - -SDANY(ScaleRowDown2Linear_Any_SSSE3, - ScaleRowDown2Linear_SSSE3, - ScaleRowDown2Linear_C, - 2, - 1, - 15) - -SDANY(ScaleRowDown2Box_Any_SSSE3, - ScaleRowDown2Box_SSSE3, - ScaleRowDown2Box_C, - 2, - 1, - 15) - -SDODD(ScaleRowDown2Box_Odd_SSSE3, - ScaleRowDown2Box_SSSE3, - ScaleRowDown2Box_Odd_C, - 2, - 1, - 15) - -#endif -#ifdef HAS_SCALEUVROWDOWN2BOX_SSSE3 - -SDANY(ScaleUVRowDown2Box_Any_SSSE3, - ScaleUVRowDown2Box_SSSE3, - ScaleUVRowDown2Box_C, - 2, - 2, - 3) - -#endif -#ifdef HAS_SCALEUVROWDOWN2BOX_AVX2 - -SDANY(ScaleUVRowDown2Box_Any_AVX2, - ScaleUVRowDown2Box_AVX2, - ScaleUVRowDown2Box_C, - 2, - 2, - 7) - -#endif -#ifdef HAS_SCALEROWDOWN2_AVX2 - -SDANY(ScaleRowDown2_Any_AVX2, ScaleRowDown2_AVX2, ScaleRowDown2_C, 2, 1, 31) - -SDANY(ScaleRowDown2Linear_Any_AVX2, - ScaleRowDown2Linear_AVX2, - ScaleRowDown2Linear_C, - 2, - 1, - 31) - -SDANY(ScaleRowDown2Box_Any_AVX2, - ScaleRowDown2Box_AVX2, - ScaleRowDown2Box_C, - 2, - 1, - 31) - -SDODD(ScaleRowDown2Box_Odd_AVX2, - ScaleRowDown2Box_AVX2, - ScaleRowDown2Box_Odd_C, - 2, - 1, - 31) - -#endif -#ifdef HAS_SCALEROWDOWN4_SSSE3 - -SDANY(ScaleRowDown4_Any_SSSE3, ScaleRowDown4_SSSE3, ScaleRowDown4_C, 4, 1, 7) - -SDANY(ScaleRowDown4Box_Any_SSSE3, - ScaleRowDown4Box_SSSE3, - ScaleRowDown4Box_C, - 4, - 1, - 7) - -#endif -#ifdef HAS_SCALEROWDOWN4_AVX2 - -SDANY(ScaleRowDown4_Any_AVX2, ScaleRowDown4_AVX2, ScaleRowDown4_C, 4, 1, 15) - -SDANY(ScaleRowDown4Box_Any_AVX2, - ScaleRowDown4Box_AVX2, - ScaleRowDown4Box_C, - 4, - 1, - 15) - -#endif -#ifdef HAS_SCALEROWDOWN34_SSSE3 - -SDANY(ScaleRowDown34_Any_SSSE3, - ScaleRowDown34_SSSE3, - ScaleRowDown34_C, - 4 / 3, - 1, - 23) - -SDANY(ScaleRowDown34_0_Box_Any_SSSE3, - ScaleRowDown34_0_Box_SSSE3, - ScaleRowDown34_0_Box_C, - 4 / 3, - 1, - 23) - -SDANY(ScaleRowDown34_1_Box_Any_SSSE3, - ScaleRowDown34_1_Box_SSSE3, - ScaleRowDown34_1_Box_C, - 4 / 3, - 1, - 23) - -#endif - -#ifdef HAS_SCALEROWDOWN38_SSSE3 - -SDANY(ScaleRowDown38_Any_SSSE3, - ScaleRowDown38_SSSE3, - ScaleRowDown38_C, - 8 / 3, - 1, - 11) - -SDANY(ScaleRowDown38_3_Box_Any_SSSE3, - ScaleRowDown38_3_Box_SSSE3, - ScaleRowDown38_3_Box_C, - 8 / 3, - 1, - 5) - -SDANY(ScaleRowDown38_2_Box_Any_SSSE3, - ScaleRowDown38_2_Box_SSSE3, - ScaleRowDown38_2_Box_C, - 8 / 3, - 1, - 5) - -#endif - - -#undef SDANY - -// Scale down by even scale factor. -#define SDAANY(NAMEANY, SCALEROWDOWN_SIMD, SCALEROWDOWN_C, BPP, MASK) \ - void NAMEANY(const uint8_t* src_ptr, ptrdiff_t src_stride, int src_stepx, \ - uint8_t* dst_ptr, int dst_width) { \ - int r = dst_width & MASK; \ - int n = dst_width & ~MASK; \ - if (n > 0) { \ - SCALEROWDOWN_SIMD(src_ptr, src_stride, src_stepx, dst_ptr, n); \ - } \ - SCALEROWDOWN_C(src_ptr + (n * src_stepx) * BPP, src_stride, src_stepx, \ - dst_ptr + n * BPP, r); \ - } - - - -#ifdef SASIMDONLY -// This also works and uses memcpy and SIMD instead of C, but is slower on ARM - -// Add rows box filter scale down. Using macro from row_any -#define SAROW(NAMEANY, ANY_SIMD, SBPP, BPP, MASK) \ - void NAMEANY(const uint8_t* src_ptr, uint16_t* dst_ptr, int width) { \ - SIMD_ALIGNED(uint16_t dst_temp[32]); \ - SIMD_ALIGNED(uint8_t src_temp[32]); \ - memset(dst_temp, 0, 32 * 2); /* for msan */ \ - int r = width & MASK; \ - int n = width & ~MASK; \ - if (n > 0) { \ - ANY_SIMD(src_ptr, dst_ptr, n); \ - } \ - memcpy(src_temp, src_ptr + n * SBPP, r * SBPP); \ - memcpy(dst_temp, dst_ptr + n * BPP, r * BPP); \ - ANY_SIMD(src_temp, dst_temp, MASK + 1); \ - memcpy(dst_ptr + n * BPP, dst_temp, r * BPP); \ - } - -#ifdef HAS_SCALEADDROW_SSE2 -SAROW(ScaleAddRow_Any_SSE2, ScaleAddRow_SSE2, 1, 2, 15) -#endif -#ifdef HAS_SCALEADDROW_AVX2 -SAROW(ScaleAddRow_Any_AVX2, ScaleAddRow_AVX2, 1, 2, 31) -#endif -#undef SAANY - -#else - -// Add rows box filter scale down. -#define SAANY(NAMEANY, SCALEADDROW_SIMD, SCALEADDROW_C, MASK) \ - void NAMEANY(const uint8_t* src_ptr, uint16_t* dst_ptr, int src_width) { \ - int n = src_width & ~MASK; \ - if (n > 0) { \ - SCALEADDROW_SIMD(src_ptr, dst_ptr, n); \ - } \ - SCALEADDROW_C(src_ptr + n, dst_ptr + n, src_width & MASK); \ - } - -#ifdef HAS_SCALEADDROW_SSE2 - -SAANY(ScaleAddRow_Any_SSE2, ScaleAddRow_SSE2, ScaleAddRow_C, 15) - -#endif -#ifdef HAS_SCALEADDROW_AVX2 - -SAANY(ScaleAddRow_Any_AVX2, ScaleAddRow_AVX2, ScaleAddRow_C, 31) - -#endif -#undef SAANY - -#endif // SASIMDONLY - -// Scale up horizontally 2 times using linear filter. -#define SUH2LANY(NAME, SIMD, C, MASK, PTYPE) \ - void NAME(const PTYPE* src_ptr, PTYPE* dst_ptr, int dst_width) { \ - int work_width = (dst_width - 1) & ~1; \ - int r = work_width & MASK; \ - int n = work_width & ~MASK; \ - dst_ptr[0] = src_ptr[0]; \ - if (work_width > 0) { \ - if (n != 0) { \ - SIMD(src_ptr, dst_ptr + 1, n); \ - } \ - C(src_ptr + (n / 2), dst_ptr + n + 1, r); \ - } \ - dst_ptr[dst_width - 1] = src_ptr[(dst_width - 1) / 2]; \ - } - -// Even the C versions need to be wrapped, because boundary pixels have to -// be handled differently - -SUH2LANY(ScaleRowUp2_Linear_Any_C, - ScaleRowUp2_Linear_C, - ScaleRowUp2_Linear_C, - 0, - uint8_t) - -SUH2LANY(ScaleRowUp2_Linear_16_Any_C, - ScaleRowUp2_Linear_16_C, - ScaleRowUp2_Linear_16_C, - 0, - uint16_t) - -#ifdef HAS_SCALEROWUP2_LINEAR_SSE2 - -SUH2LANY(ScaleRowUp2_Linear_Any_SSE2, - ScaleRowUp2_Linear_SSE2, - ScaleRowUp2_Linear_C, - 15, - uint8_t) - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_SSSE3 - -SUH2LANY(ScaleRowUp2_Linear_Any_SSSE3, - ScaleRowUp2_Linear_SSSE3, - ScaleRowUp2_Linear_C, - 15, - uint8_t) - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_12_SSSE3 - -SUH2LANY(ScaleRowUp2_Linear_12_Any_SSSE3, - ScaleRowUp2_Linear_12_SSSE3, - ScaleRowUp2_Linear_16_C, - 15, - uint16_t) - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_16_SSE2 - -SUH2LANY(ScaleRowUp2_Linear_16_Any_SSE2, - ScaleRowUp2_Linear_16_SSE2, - ScaleRowUp2_Linear_16_C, - 7, - uint16_t) - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_AVX2 - -SUH2LANY(ScaleRowUp2_Linear_Any_AVX2, - ScaleRowUp2_Linear_AVX2, - ScaleRowUp2_Linear_C, - 31, - uint8_t) - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_12_AVX2 - -SUH2LANY(ScaleRowUp2_Linear_12_Any_AVX2, - ScaleRowUp2_Linear_12_AVX2, - ScaleRowUp2_Linear_16_C, - 31, - uint16_t) - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_16_AVX2 - -SUH2LANY(ScaleRowUp2_Linear_16_Any_AVX2, - ScaleRowUp2_Linear_16_AVX2, - ScaleRowUp2_Linear_16_C, - 15, - uint16_t) - -#endif -#undef SUH2LANY - -// Scale up 2 times using bilinear filter. -// This function produces 2 rows at a time. -#define SU2BLANY(NAME, SIMD, C, MASK, PTYPE) \ - void NAME(const PTYPE* src_ptr, ptrdiff_t src_stride, PTYPE* dst_ptr, \ - ptrdiff_t dst_stride, int dst_width) { \ - int work_width = (dst_width - 1) & ~1; \ - int r = work_width & MASK; \ - int n = work_width & ~MASK; \ - const PTYPE* sa = src_ptr; \ - const PTYPE* sb = src_ptr + src_stride; \ - PTYPE* da = dst_ptr; \ - PTYPE* db = dst_ptr + dst_stride; \ - da[0] = (3 * sa[0] + sb[0] + 2) >> 2; \ - db[0] = (sa[0] + 3 * sb[0] + 2) >> 2; \ - if (work_width > 0) { \ - if (n != 0) { \ - SIMD(sa, sb - sa, da + 1, db - da, n); \ - } \ - C(sa + (n / 2), sb - sa, da + n + 1, db - da, r); \ - } \ - da[dst_width - 1] = \ - (3 * sa[(dst_width - 1) / 2] + sb[(dst_width - 1) / 2] + 2) >> 2; \ - db[dst_width - 1] = \ - (sa[(dst_width - 1) / 2] + 3 * sb[(dst_width - 1) / 2] + 2) >> 2; \ - } - -SU2BLANY(ScaleRowUp2_Bilinear_Any_C, - ScaleRowUp2_Bilinear_C, - ScaleRowUp2_Bilinear_C, - 0, - uint8_t) - -SU2BLANY(ScaleRowUp2_Bilinear_16_Any_C, - ScaleRowUp2_Bilinear_16_C, - ScaleRowUp2_Bilinear_16_C, - 0, - uint16_t) - -#ifdef HAS_SCALEROWUP2_BILINEAR_SSE2 - -SU2BLANY(ScaleRowUp2_Bilinear_Any_SSE2, - ScaleRowUp2_Bilinear_SSE2, - ScaleRowUp2_Bilinear_C, - 15, - uint8_t) - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_12_SSSE3 - -SU2BLANY(ScaleRowUp2_Bilinear_12_Any_SSSE3, - ScaleRowUp2_Bilinear_12_SSSE3, - ScaleRowUp2_Bilinear_16_C, - 15, - uint16_t) - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_16_SSE2 - -SU2BLANY(ScaleRowUp2_Bilinear_16_Any_SSE2, - ScaleRowUp2_Bilinear_16_SSE2, - ScaleRowUp2_Bilinear_16_C, - 7, - uint16_t) - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_SSSE3 - -SU2BLANY(ScaleRowUp2_Bilinear_Any_SSSE3, - ScaleRowUp2_Bilinear_SSSE3, - ScaleRowUp2_Bilinear_C, - 15, - uint8_t) - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_AVX2 - -SU2BLANY(ScaleRowUp2_Bilinear_Any_AVX2, - ScaleRowUp2_Bilinear_AVX2, - ScaleRowUp2_Bilinear_C, - 31, - uint8_t) - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_12_AVX2 - -SU2BLANY(ScaleRowUp2_Bilinear_12_Any_AVX2, - ScaleRowUp2_Bilinear_12_AVX2, - ScaleRowUp2_Bilinear_16_C, - 15, - uint16_t) - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_16_AVX2 - -SU2BLANY(ScaleRowUp2_Bilinear_16_Any_AVX2, - ScaleRowUp2_Bilinear_16_AVX2, - ScaleRowUp2_Bilinear_16_C, - 15, - uint16_t) - -#endif - -#undef SU2BLANY - -// Scale bi-planar plane up horizontally 2 times using linear filter. -#define SBUH2LANY(NAME, SIMD, C, MASK, PTYPE) \ - void NAME(const PTYPE* src_ptr, PTYPE* dst_ptr, int dst_width) { \ - int work_width = (dst_width - 1) & ~1; \ - int r = work_width & MASK; \ - int n = work_width & ~MASK; \ - dst_ptr[0] = src_ptr[0]; \ - dst_ptr[1] = src_ptr[1]; \ - if (work_width > 0) { \ - if (n != 0) { \ - SIMD(src_ptr, dst_ptr + 2, n); \ - } \ - C(src_ptr + n, dst_ptr + 2 * n + 2, r); \ - } \ - dst_ptr[2 * dst_width - 2] = src_ptr[((dst_width + 1) & ~1) - 2]; \ - dst_ptr[2 * dst_width - 1] = src_ptr[((dst_width + 1) & ~1) - 1]; \ - } - -SBUH2LANY(ScaleUVRowUp2_Linear_Any_C, - ScaleUVRowUp2_Linear_C, - ScaleUVRowUp2_Linear_C, - 0, - uint8_t) - -SBUH2LANY(ScaleUVRowUp2_Linear_16_Any_C, - ScaleUVRowUp2_Linear_16_C, - ScaleUVRowUp2_Linear_16_C, - 0, - uint16_t) - -#ifdef HAS_SCALEUVROWUP2_LINEAR_SSSE3 - -SBUH2LANY(ScaleUVRowUp2_Linear_Any_SSSE3, - ScaleUVRowUp2_Linear_SSSE3, - ScaleUVRowUp2_Linear_C, - 7, - uint8_t) - -#endif - -#ifdef HAS_SCALEUVROWUP2_LINEAR_AVX2 - -SBUH2LANY(ScaleUVRowUp2_Linear_Any_AVX2, - ScaleUVRowUp2_Linear_AVX2, - ScaleUVRowUp2_Linear_C, - 15, - uint8_t) - -#endif - -#ifdef HAS_SCALEUVROWUP2_LINEAR_16_SSE41 - -SBUH2LANY(ScaleUVRowUp2_Linear_16_Any_SSE41, - ScaleUVRowUp2_Linear_16_SSE41, - ScaleUVRowUp2_Linear_16_C, - 3, - uint16_t) - -#endif - -#ifdef HAS_SCALEUVROWUP2_LINEAR_16_AVX2 - -SBUH2LANY(ScaleUVRowUp2_Linear_16_Any_AVX2, - ScaleUVRowUp2_Linear_16_AVX2, - ScaleUVRowUp2_Linear_16_C, - 7, - uint16_t) - -#endif - -#undef SBUH2LANY - -// Scale bi-planar plane up 2 times using bilinear filter. -// This function produces 2 rows at a time. -#define SBU2BLANY(NAME, SIMD, C, MASK, PTYPE) \ - void NAME(const PTYPE* src_ptr, ptrdiff_t src_stride, PTYPE* dst_ptr, \ - ptrdiff_t dst_stride, int dst_width) { \ - int work_width = (dst_width - 1) & ~1; \ - int r = work_width & MASK; \ - int n = work_width & ~MASK; \ - const PTYPE* sa = src_ptr; \ - const PTYPE* sb = src_ptr + src_stride; \ - PTYPE* da = dst_ptr; \ - PTYPE* db = dst_ptr + dst_stride; \ - da[0] = (3 * sa[0] + sb[0] + 2) >> 2; \ - db[0] = (sa[0] + 3 * sb[0] + 2) >> 2; \ - da[1] = (3 * sa[1] + sb[1] + 2) >> 2; \ - db[1] = (sa[1] + 3 * sb[1] + 2) >> 2; \ - if (work_width > 0) { \ - if (n != 0) { \ - SIMD(sa, sb - sa, da + 2, db - da, n); \ - } \ - C(sa + n, sb - sa, da + 2 * n + 2, db - da, r); \ - } \ - da[2 * dst_width - 2] = (3 * sa[((dst_width + 1) & ~1) - 2] + \ - sb[((dst_width + 1) & ~1) - 2] + 2) >> \ - 2; \ - db[2 * dst_width - 2] = (sa[((dst_width + 1) & ~1) - 2] + \ - 3 * sb[((dst_width + 1) & ~1) - 2] + 2) >> \ - 2; \ - da[2 * dst_width - 1] = (3 * sa[((dst_width + 1) & ~1) - 1] + \ - sb[((dst_width + 1) & ~1) - 1] + 2) >> \ - 2; \ - db[2 * dst_width - 1] = (sa[((dst_width + 1) & ~1) - 1] + \ - 3 * sb[((dst_width + 1) & ~1) - 1] + 2) >> \ - 2; \ - } - -SBU2BLANY(ScaleUVRowUp2_Bilinear_Any_C, - ScaleUVRowUp2_Bilinear_C, - ScaleUVRowUp2_Bilinear_C, - 0, - uint8_t) - -SBU2BLANY(ScaleUVRowUp2_Bilinear_16_Any_C, - ScaleUVRowUp2_Bilinear_16_C, - ScaleUVRowUp2_Bilinear_16_C, - 0, - uint16_t) - -#ifdef HAS_SCALEUVROWUP2_BILINEAR_SSSE3 - -SBU2BLANY(ScaleUVRowUp2_Bilinear_Any_SSSE3, - ScaleUVRowUp2_Bilinear_SSSE3, - ScaleUVRowUp2_Bilinear_C, - 7, - uint8_t) - -#endif - -#ifdef HAS_SCALEUVROWUP2_BILINEAR_AVX2 - -SBU2BLANY(ScaleUVRowUp2_Bilinear_Any_AVX2, - ScaleUVRowUp2_Bilinear_AVX2, - ScaleUVRowUp2_Bilinear_C, - 15, - uint8_t) - -#endif - -#ifdef HAS_SCALEUVROWUP2_BILINEAR_16_SSE41 - -SBU2BLANY(ScaleUVRowUp2_Bilinear_16_Any_SSE41, - ScaleUVRowUp2_Bilinear_16_SSE41, - ScaleUVRowUp2_Bilinear_16_C, - 7, - uint16_t) - -#endif - -#ifdef HAS_SCALEUVROWUP2_BILINEAR_16_AVX2 - -SBU2BLANY(ScaleUVRowUp2_Bilinear_16_Any_AVX2, - ScaleUVRowUp2_Bilinear_16_AVX2, - ScaleUVRowUp2_Bilinear_16_C, - 7, - uint16_t) - -#endif - -#undef SBU2BLANY diff --git a/pkg/encoder/yuv/libyuv/scale_common.c b/pkg/encoder/yuv/libyuv/scale_common.c deleted file mode 100644 index 17eedd99..00000000 --- a/pkg/encoder/yuv/libyuv/scale_common.c +++ /dev/null @@ -1,930 +0,0 @@ -/* - * Copyright 2013 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "scale.h" - -#include - -#include "cpu_id.h" -#include "row.h" -#include "scale_row.h" - -#define STATIC_CAST(type, expr) (type)(expr) - -// TODO(fbarchard): make clamp255 preserve negative values. -static __inline int32_t clamp255(int32_t v) { - return (-(v >= 255) | v) & 255; -} - -// Use scale to convert lsb formats to msb, depending how many bits there are: -// 32768 = 9 bits -// 16384 = 10 bits -// 4096 = 12 bits -// 256 = 16 bits -// TODO(fbarchard): change scale to bits -#define C16TO8(v, scale) clamp255(((v) * (scale)) >> 16) - -static __inline int Abs(int v) { - return v >= 0 ? v : -v; -} - -// CPU agnostic row functions -void ScaleRowDown2_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width) { - int x; - (void) src_stride; - for (x = 0; x < dst_width - 1; x += 2) { - dst[0] = src_ptr[1]; - dst[1] = src_ptr[3]; - dst += 2; - src_ptr += 4; - } - if (dst_width & 1) { - dst[0] = src_ptr[1]; - } -} - -void ScaleRowDown2Linear_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width) { - const uint8_t *s = src_ptr; - int x; - (void) src_stride; - for (x = 0; x < dst_width - 1; x += 2) { - dst[0] = (s[0] + s[1] + 1) >> 1; - dst[1] = (s[2] + s[3] + 1) >> 1; - dst += 2; - s += 4; - } - if (dst_width & 1) { - dst[0] = (s[0] + s[1] + 1) >> 1; - } -} - -void ScaleRowDown2Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width) { - const uint8_t *s = src_ptr; - const uint8_t *t = src_ptr + src_stride; - int x; - for (x = 0; x < dst_width - 1; x += 2) { - dst[0] = (s[0] + s[1] + t[0] + t[1] + 2) >> 2; - dst[1] = (s[2] + s[3] + t[2] + t[3] + 2) >> 2; - dst += 2; - s += 4; - t += 4; - } - if (dst_width & 1) { - dst[0] = (s[0] + s[1] + t[0] + t[1] + 2) >> 2; - } -} - -void ScaleRowDown2Box_Odd_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width) { - const uint8_t *s = src_ptr; - const uint8_t *t = src_ptr + src_stride; - int x; - dst_width -= 1; - for (x = 0; x < dst_width - 1; x += 2) { - dst[0] = (s[0] + s[1] + t[0] + t[1] + 2) >> 2; - dst[1] = (s[2] + s[3] + t[2] + t[3] + 2) >> 2; - dst += 2; - s += 4; - t += 4; - } - if (dst_width & 1) { - dst[0] = (s[0] + s[1] + t[0] + t[1] + 2) >> 2; - dst += 1; - s += 2; - t += 2; - } - dst[0] = (s[0] + t[0] + 1) >> 1; -} - -void ScaleRowDown4_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width) { - int x; - (void) src_stride; - for (x = 0; x < dst_width - 1; x += 2) { - dst[0] = src_ptr[2]; - dst[1] = src_ptr[6]; - dst += 2; - src_ptr += 8; - } - if (dst_width & 1) { - dst[0] = src_ptr[2]; - } -} - -void ScaleRowDown4Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width) { - intptr_t stride = src_stride; - int x; - for (x = 0; x < dst_width - 1; x += 2) { - dst[0] = (src_ptr[0] + src_ptr[1] + src_ptr[2] + src_ptr[3] + - src_ptr[stride + 0] + src_ptr[stride + 1] + src_ptr[stride + 2] + - src_ptr[stride + 3] + src_ptr[stride * 2 + 0] + - src_ptr[stride * 2 + 1] + src_ptr[stride * 2 + 2] + - src_ptr[stride * 2 + 3] + src_ptr[stride * 3 + 0] + - src_ptr[stride * 3 + 1] + src_ptr[stride * 3 + 2] + - src_ptr[stride * 3 + 3] + 8) >> - 4; - dst[1] = (src_ptr[4] + src_ptr[5] + src_ptr[6] + src_ptr[7] + - src_ptr[stride + 4] + src_ptr[stride + 5] + src_ptr[stride + 6] + - src_ptr[stride + 7] + src_ptr[stride * 2 + 4] + - src_ptr[stride * 2 + 5] + src_ptr[stride * 2 + 6] + - src_ptr[stride * 2 + 7] + src_ptr[stride * 3 + 4] + - src_ptr[stride * 3 + 5] + src_ptr[stride * 3 + 6] + - src_ptr[stride * 3 + 7] + 8) >> - 4; - dst += 2; - src_ptr += 8; - } - if (dst_width & 1) { - dst[0] = (src_ptr[0] + src_ptr[1] + src_ptr[2] + src_ptr[3] + - src_ptr[stride + 0] + src_ptr[stride + 1] + src_ptr[stride + 2] + - src_ptr[stride + 3] + src_ptr[stride * 2 + 0] + - src_ptr[stride * 2 + 1] + src_ptr[stride * 2 + 2] + - src_ptr[stride * 2 + 3] + src_ptr[stride * 3 + 0] + - src_ptr[stride * 3 + 1] + src_ptr[stride * 3 + 2] + - src_ptr[stride * 3 + 3] + 8) >> - 4; - } -} - -void ScaleRowDown34_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width) { - int x; - (void) src_stride; - assert((dst_width % 3 == 0) && (dst_width > 0)); - for (x = 0; x < dst_width; x += 3) { - dst[0] = src_ptr[0]; - dst[1] = src_ptr[1]; - dst[2] = src_ptr[3]; - dst += 3; - src_ptr += 4; - } -} - -// Filter rows 0 and 1 together, 3 : 1 -void ScaleRowDown34_0_Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *d, - int dst_width) { - const uint8_t *s = src_ptr; - const uint8_t *t = src_ptr + src_stride; - int x; - assert((dst_width % 3 == 0) && (dst_width > 0)); - for (x = 0; x < dst_width; x += 3) { - uint8_t a0 = (s[0] * 3 + s[1] * 1 + 2) >> 2; - uint8_t a1 = (s[1] * 1 + s[2] * 1 + 1) >> 1; - uint8_t a2 = (s[2] * 1 + s[3] * 3 + 2) >> 2; - uint8_t b0 = (t[0] * 3 + t[1] * 1 + 2) >> 2; - uint8_t b1 = (t[1] * 1 + t[2] * 1 + 1) >> 1; - uint8_t b2 = (t[2] * 1 + t[3] * 3 + 2) >> 2; - d[0] = (a0 * 3 + b0 + 2) >> 2; - d[1] = (a1 * 3 + b1 + 2) >> 2; - d[2] = (a2 * 3 + b2 + 2) >> 2; - d += 3; - s += 4; - t += 4; - } -} - -// Filter rows 1 and 2 together, 1 : 1 -void ScaleRowDown34_1_Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *d, - int dst_width) { - const uint8_t *s = src_ptr; - const uint8_t *t = src_ptr + src_stride; - int x; - assert((dst_width % 3 == 0) && (dst_width > 0)); - for (x = 0; x < dst_width; x += 3) { - uint8_t a0 = (s[0] * 3 + s[1] * 1 + 2) >> 2; - uint8_t a1 = (s[1] * 1 + s[2] * 1 + 1) >> 1; - uint8_t a2 = (s[2] * 1 + s[3] * 3 + 2) >> 2; - uint8_t b0 = (t[0] * 3 + t[1] * 1 + 2) >> 2; - uint8_t b1 = (t[1] * 1 + t[2] * 1 + 1) >> 1; - uint8_t b2 = (t[2] * 1 + t[3] * 3 + 2) >> 2; - d[0] = (a0 + b0 + 1) >> 1; - d[1] = (a1 + b1 + 1) >> 1; - d[2] = (a2 + b2 + 1) >> 1; - d += 3; - s += 4; - t += 4; - } -} - -// Sample position: (O is src sample position, X is dst sample position) -// -// v dst_ptr at here v stop at here -// X O X X O X X O X X O X X O X -// ^ src_ptr at here -void ScaleRowUp2_Linear_C(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width) { - int src_width = dst_width >> 1; - int x; - assert((dst_width % 2 == 0) && (dst_width >= 0)); - for (x = 0; x < src_width; ++x) { - dst_ptr[2 * x + 0] = (src_ptr[x + 0] * 3 + src_ptr[x + 1] * 1 + 2) >> 2; - dst_ptr[2 * x + 1] = (src_ptr[x + 0] * 1 + src_ptr[x + 1] * 3 + 2) >> 2; - } -} - -// Sample position: (O is src sample position, X is dst sample position) -// -// src_ptr at here -// X v X X X X X X X X X -// O O O O O -// X X X X X X X X X X -// ^ dst_ptr at here ^ stop at here -// X X X X X X X X X X -// O O O O O -// X X X X X X X X X X -void ScaleRowUp2_Bilinear_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - const uint8_t *s = src_ptr; - const uint8_t *t = src_ptr + src_stride; - uint8_t *d = dst_ptr; - uint8_t *e = dst_ptr + dst_stride; - int src_width = dst_width >> 1; - int x; - assert((dst_width % 2 == 0) && (dst_width >= 0)); - for (x = 0; x < src_width; ++x) { - d[2 * x + 0] = - (s[x + 0] * 9 + s[x + 1] * 3 + t[x + 0] * 3 + t[x + 1] * 1 + 8) >> 4; - d[2 * x + 1] = - (s[x + 0] * 3 + s[x + 1] * 9 + t[x + 0] * 1 + t[x + 1] * 3 + 8) >> 4; - e[2 * x + 0] = - (s[x + 0] * 3 + s[x + 1] * 1 + t[x + 0] * 9 + t[x + 1] * 3 + 8) >> 4; - e[2 * x + 1] = - (s[x + 0] * 1 + s[x + 1] * 3 + t[x + 0] * 3 + t[x + 1] * 9 + 8) >> 4; - } -} - -// Only suitable for at most 14 bit range. -void ScaleRowUp2_Linear_16_C(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width) { - int src_width = dst_width >> 1; - int x; - assert((dst_width % 2 == 0) && (dst_width >= 0)); - for (x = 0; x < src_width; ++x) { - dst_ptr[2 * x + 0] = (src_ptr[x + 0] * 3 + src_ptr[x + 1] * 1 + 2) >> 2; - dst_ptr[2 * x + 1] = (src_ptr[x + 0] * 1 + src_ptr[x + 1] * 3 + 2) >> 2; - } -} - -// Only suitable for at most 12bit range. -void ScaleRowUp2_Bilinear_16_C(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - const uint16_t *s = src_ptr; - const uint16_t *t = src_ptr + src_stride; - uint16_t *d = dst_ptr; - uint16_t *e = dst_ptr + dst_stride; - int src_width = dst_width >> 1; - int x; - assert((dst_width % 2 == 0) && (dst_width >= 0)); - for (x = 0; x < src_width; ++x) { - d[2 * x + 0] = - (s[x + 0] * 9 + s[x + 1] * 3 + t[x + 0] * 3 + t[x + 1] * 1 + 8) >> 4; - d[2 * x + 1] = - (s[x + 0] * 3 + s[x + 1] * 9 + t[x + 0] * 1 + t[x + 1] * 3 + 8) >> 4; - e[2 * x + 0] = - (s[x + 0] * 3 + s[x + 1] * 1 + t[x + 0] * 9 + t[x + 1] * 3 + 8) >> 4; - e[2 * x + 1] = - (s[x + 0] * 1 + s[x + 1] * 3 + t[x + 0] * 3 + t[x + 1] * 9 + 8) >> 4; - } -} - -// (1-f)a + fb can be replaced with a + f(b-a) -#if defined(__arm__) || defined(__aarch64__) -#define BLENDER(a, b, f) \ - (uint8_t)((int)(a) + ((((int)((f)) * ((int)(b) - (int)(a))) + 0x8000) >> 16)) -#else -// Intel uses 7 bit math with rounding. -#define BLENDER(a, b, f) \ - (uint8_t)((int)(a) + (((int)((f) >> 9) * ((int)(b) - (int)(a)) + 0x40) >> 7)) -#endif - -void ScaleFilterCols_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx) { - int j; - for (j = 0; j < dst_width - 1; j += 2) { - int xi = x >> 16; - int a = src_ptr[xi]; - int b = src_ptr[xi + 1]; - dst_ptr[0] = BLENDER(a, b, x & 0xffff); - x += dx; - xi = x >> 16; - a = src_ptr[xi]; - b = src_ptr[xi + 1]; - dst_ptr[1] = BLENDER(a, b, x & 0xffff); - x += dx; - dst_ptr += 2; - } - if (dst_width & 1) { - int xi = x >> 16; - int a = src_ptr[xi]; - int b = src_ptr[xi + 1]; - dst_ptr[0] = BLENDER(a, b, x & 0xffff); - } -} - -void ScaleFilterCols64_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x32, - int dx) { - int64_t x = (int64_t) (x32); - int j; - for (j = 0; j < dst_width - 1; j += 2) { - int64_t xi = x >> 16; - int a = src_ptr[xi]; - int b = src_ptr[xi + 1]; - dst_ptr[0] = BLENDER(a, b, x & 0xffff); - x += dx; - xi = x >> 16; - a = src_ptr[xi]; - b = src_ptr[xi + 1]; - dst_ptr[1] = BLENDER(a, b, x & 0xffff); - x += dx; - dst_ptr += 2; - } - if (dst_width & 1) { - int64_t xi = x >> 16; - int a = src_ptr[xi]; - int b = src_ptr[xi + 1]; - dst_ptr[0] = BLENDER(a, b, x & 0xffff); - } -} - -#undef BLENDER - -// Same as 8 bit arm blender but return is cast to uint16_t -#define BLENDER(a, b, f) \ - (uint16_t)( \ - (int)(a) + \ - (int)((((int64_t)((f)) * ((int64_t)(b) - (int)(a))) + 0x8000) >> 16)) -#undef BLENDER - -void ScaleRowDown38_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width) { - int x; - (void) src_stride; - assert(dst_width % 3 == 0); - for (x = 0; x < dst_width; x += 3) { - dst[0] = src_ptr[0]; - dst[1] = src_ptr[3]; - dst[2] = src_ptr[6]; - dst += 3; - src_ptr += 8; - } -} - -// 8x3 -> 3x1 -void ScaleRowDown38_3_Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - intptr_t stride = src_stride; - int i; - assert((dst_width % 3 == 0) && (dst_width > 0)); - for (i = 0; i < dst_width; i += 3) { - dst_ptr[0] = - (src_ptr[0] + src_ptr[1] + src_ptr[2] + src_ptr[stride + 0] + - src_ptr[stride + 1] + src_ptr[stride + 2] + src_ptr[stride * 2 + 0] + - src_ptr[stride * 2 + 1] + src_ptr[stride * 2 + 2]) * - (65536 / 9) >> - 16; - dst_ptr[1] = - (src_ptr[3] + src_ptr[4] + src_ptr[5] + src_ptr[stride + 3] + - src_ptr[stride + 4] + src_ptr[stride + 5] + src_ptr[stride * 2 + 3] + - src_ptr[stride * 2 + 4] + src_ptr[stride * 2 + 5]) * - (65536 / 9) >> - 16; - dst_ptr[2] = - (src_ptr[6] + src_ptr[7] + src_ptr[stride + 6] + src_ptr[stride + 7] + - src_ptr[stride * 2 + 6] + src_ptr[stride * 2 + 7]) * - (65536 / 6) >> - 16; - src_ptr += 8; - dst_ptr += 3; - } -} - -// 8x2 -> 3x1 -void ScaleRowDown38_2_Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - intptr_t stride = src_stride; - int i; - assert((dst_width % 3 == 0) && (dst_width > 0)); - for (i = 0; i < dst_width; i += 3) { - dst_ptr[0] = (src_ptr[0] + src_ptr[1] + src_ptr[2] + src_ptr[stride + 0] + - src_ptr[stride + 1] + src_ptr[stride + 2]) * - (65536 / 6) >> - 16; - dst_ptr[1] = (src_ptr[3] + src_ptr[4] + src_ptr[5] + src_ptr[stride + 3] + - src_ptr[stride + 4] + src_ptr[stride + 5]) * - (65536 / 6) >> - 16; - dst_ptr[2] = - (src_ptr[6] + src_ptr[7] + src_ptr[stride + 6] + src_ptr[stride + 7]) * - (65536 / 4) >> - 16; - src_ptr += 8; - dst_ptr += 3; - } -} - -void ScaleAddRow_C(const uint8_t *src_ptr, uint16_t *dst_ptr, int src_width) { - int x; - assert(src_width > 0); - for (x = 0; x < src_width - 1; x += 2) { - dst_ptr[0] += src_ptr[0]; - dst_ptr[1] += src_ptr[1]; - src_ptr += 2; - dst_ptr += 2; - } - if (src_width & 1) { - dst_ptr[0] += src_ptr[0]; - } -} - -// UV scale row functions -// same as ARGB but 2 channels - -void ScaleUVRowDown2_C(const uint8_t *src_uv, - ptrdiff_t src_stride, - uint8_t *dst_uv, - int dst_width) { - int x; - (void) src_stride; - for (x = 0; x < dst_width; ++x) { - dst_uv[0] = src_uv[2]; // Store the 2nd UV - dst_uv[1] = src_uv[3]; - src_uv += 4; - dst_uv += 2; - } -} - -void ScaleUVRowDown2Linear_C(const uint8_t *src_uv, - ptrdiff_t src_stride, - uint8_t *dst_uv, - int dst_width) { - int x; - (void) src_stride; - for (x = 0; x < dst_width; ++x) { - dst_uv[0] = (src_uv[0] + src_uv[2] + 1) >> 1; - dst_uv[1] = (src_uv[1] + src_uv[3] + 1) >> 1; - src_uv += 4; - dst_uv += 2; - } -} - -void ScaleUVRowDown2Box_C(const uint8_t *src_uv, - ptrdiff_t src_stride, - uint8_t *dst_uv, - int dst_width) { - int x; - for (x = 0; x < dst_width; ++x) { - dst_uv[0] = (src_uv[0] + src_uv[2] + src_uv[src_stride] + - src_uv[src_stride + 2] + 2) >> - 2; - dst_uv[1] = (src_uv[1] + src_uv[3] + src_uv[src_stride + 1] + - src_uv[src_stride + 3] + 2) >> - 2; - src_uv += 4; - dst_uv += 2; - } -} - -void ScaleUVRowDownEven_C(const uint8_t *src_uv, - ptrdiff_t src_stride, - int src_stepx, - uint8_t *dst_uv, - int dst_width) { - const uint16_t *src = (const uint16_t *) (src_uv); - uint16_t *dst = (uint16_t *) (dst_uv); - (void) src_stride; - int x; - for (x = 0; x < dst_width - 1; x += 2) { - dst[0] = src[0]; - dst[1] = src[src_stepx]; - src += src_stepx * 2; - dst += 2; - } - if (dst_width & 1) { - dst[0] = src[0]; - } -} - -// Scales a single row of pixels using point sampling. -void ScaleCols_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx) { - int j; - for (j = 0; j < dst_width - 1; j += 2) { - dst_ptr[0] = src_ptr[x >> 16]; - x += dx; - dst_ptr[1] = src_ptr[x >> 16]; - x += dx; - dst_ptr += 2; - } - if (dst_width & 1) { - dst_ptr[0] = src_ptr[x >> 16]; - } -} - -// Scales a single row of pixels up by 2x using point sampling. -void ScaleColsUp2_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx) { - int j; - (void) x; - (void) dx; - for (j = 0; j < dst_width - 1; j += 2) { - dst_ptr[1] = dst_ptr[0] = src_ptr[0]; - src_ptr += 1; - dst_ptr += 2; - } - if (dst_width & 1) { - dst_ptr[0] = src_ptr[0]; - } -} - -void ScaleUVRowUp2_Linear_C(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width) { - int src_width = dst_width >> 1; - int x; - assert((dst_width % 2 == 0) && (dst_width >= 0)); - for (x = 0; x < src_width; ++x) { - dst_ptr[4 * x + 0] = - (src_ptr[2 * x + 0] * 3 + src_ptr[2 * x + 2] * 1 + 2) >> 2; - dst_ptr[4 * x + 1] = - (src_ptr[2 * x + 1] * 3 + src_ptr[2 * x + 3] * 1 + 2) >> 2; - dst_ptr[4 * x + 2] = - (src_ptr[2 * x + 0] * 1 + src_ptr[2 * x + 2] * 3 + 2) >> 2; - dst_ptr[4 * x + 3] = - (src_ptr[2 * x + 1] * 1 + src_ptr[2 * x + 3] * 3 + 2) >> 2; - } -} - -void ScaleUVRowUp2_Bilinear_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - const uint8_t *s = src_ptr; - const uint8_t *t = src_ptr + src_stride; - uint8_t *d = dst_ptr; - uint8_t *e = dst_ptr + dst_stride; - int src_width = dst_width >> 1; - int x; - assert((dst_width % 2 == 0) && (dst_width >= 0)); - for (x = 0; x < src_width; ++x) { - d[4 * x + 0] = (s[2 * x + 0] * 9 + s[2 * x + 2] * 3 + t[2 * x + 0] * 3 + - t[2 * x + 2] * 1 + 8) >> - 4; - d[4 * x + 1] = (s[2 * x + 1] * 9 + s[2 * x + 3] * 3 + t[2 * x + 1] * 3 + - t[2 * x + 3] * 1 + 8) >> - 4; - d[4 * x + 2] = (s[2 * x + 0] * 3 + s[2 * x + 2] * 9 + t[2 * x + 0] * 1 + - t[2 * x + 2] * 3 + 8) >> - 4; - d[4 * x + 3] = (s[2 * x + 1] * 3 + s[2 * x + 3] * 9 + t[2 * x + 1] * 1 + - t[2 * x + 3] * 3 + 8) >> - 4; - e[4 * x + 0] = (s[2 * x + 0] * 3 + s[2 * x + 2] * 1 + t[2 * x + 0] * 9 + - t[2 * x + 2] * 3 + 8) >> - 4; - e[4 * x + 1] = (s[2 * x + 1] * 3 + s[2 * x + 3] * 1 + t[2 * x + 1] * 9 + - t[2 * x + 3] * 3 + 8) >> - 4; - e[4 * x + 2] = (s[2 * x + 0] * 1 + s[2 * x + 2] * 3 + t[2 * x + 0] * 3 + - t[2 * x + 2] * 9 + 8) >> - 4; - e[4 * x + 3] = (s[2 * x + 1] * 1 + s[2 * x + 3] * 3 + t[2 * x + 1] * 3 + - t[2 * x + 3] * 9 + 8) >> - 4; - } -} - -void ScaleUVRowUp2_Linear_16_C(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width) { - int src_width = dst_width >> 1; - int x; - assert((dst_width % 2 == 0) && (dst_width >= 0)); - for (x = 0; x < src_width; ++x) { - dst_ptr[4 * x + 0] = - (src_ptr[2 * x + 0] * 3 + src_ptr[2 * x + 2] * 1 + 2) >> 2; - dst_ptr[4 * x + 1] = - (src_ptr[2 * x + 1] * 3 + src_ptr[2 * x + 3] * 1 + 2) >> 2; - dst_ptr[4 * x + 2] = - (src_ptr[2 * x + 0] * 1 + src_ptr[2 * x + 2] * 3 + 2) >> 2; - dst_ptr[4 * x + 3] = - (src_ptr[2 * x + 1] * 1 + src_ptr[2 * x + 3] * 3 + 2) >> 2; - } -} - -void ScaleUVRowUp2_Bilinear_16_C(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - const uint16_t *s = src_ptr; - const uint16_t *t = src_ptr + src_stride; - uint16_t *d = dst_ptr; - uint16_t *e = dst_ptr + dst_stride; - int src_width = dst_width >> 1; - int x; - assert((dst_width % 2 == 0) && (dst_width >= 0)); - for (x = 0; x < src_width; ++x) { - d[4 * x + 0] = (s[2 * x + 0] * 9 + s[2 * x + 2] * 3 + t[2 * x + 0] * 3 + - t[2 * x + 2] * 1 + 8) >> - 4; - d[4 * x + 1] = (s[2 * x + 1] * 9 + s[2 * x + 3] * 3 + t[2 * x + 1] * 3 + - t[2 * x + 3] * 1 + 8) >> - 4; - d[4 * x + 2] = (s[2 * x + 0] * 3 + s[2 * x + 2] * 9 + t[2 * x + 0] * 1 + - t[2 * x + 2] * 3 + 8) >> - 4; - d[4 * x + 3] = (s[2 * x + 1] * 3 + s[2 * x + 3] * 9 + t[2 * x + 1] * 1 + - t[2 * x + 3] * 3 + 8) >> - 4; - e[4 * x + 0] = (s[2 * x + 0] * 3 + s[2 * x + 2] * 1 + t[2 * x + 0] * 9 + - t[2 * x + 2] * 3 + 8) >> - 4; - e[4 * x + 1] = (s[2 * x + 1] * 3 + s[2 * x + 3] * 1 + t[2 * x + 1] * 9 + - t[2 * x + 3] * 3 + 8) >> - 4; - e[4 * x + 2] = (s[2 * x + 0] * 1 + s[2 * x + 2] * 3 + t[2 * x + 0] * 3 + - t[2 * x + 2] * 9 + 8) >> - 4; - e[4 * x + 3] = (s[2 * x + 1] * 1 + s[2 * x + 3] * 3 + t[2 * x + 1] * 3 + - t[2 * x + 3] * 9 + 8) >> - 4; - } -} - -// TODO(fbarchard): Replace 0x7f ^ f with 128-f. bug=607. -// Mimics SSSE3 blender -#define BLENDER1(a, b, f) ((a) * (0x7f ^ f) + (b)*f) >> 7 -#define BLENDERC(a, b, f, s) \ - (uint16_t)(BLENDER1(((a) >> s) & 255, ((b) >> s) & 255, f) << s) -#define BLENDER(a, b, f) BLENDERC(a, b, f, 8) | BLENDERC(a, b, f, 0) - -void ScaleUVFilterCols_C(uint8_t *dst_uv, - const uint8_t *src_uv, - int dst_width, - int x, - int dx) { - const uint16_t *src = (const uint16_t *) (src_uv); - uint16_t *dst = (uint16_t *) (dst_uv); - int j; - for (j = 0; j < dst_width - 1; j += 2) { - int xi = x >> 16; - int xf = (x >> 9) & 0x7f; - uint16_t a = src[xi]; - uint16_t b = src[xi + 1]; - dst[0] = BLENDER(a, b, xf); - x += dx; - xi = x >> 16; - xf = (x >> 9) & 0x7f; - a = src[xi]; - b = src[xi + 1]; - dst[1] = BLENDER(a, b, xf); - x += dx; - dst += 2; - } - if (dst_width & 1) { - int xi = x >> 16; - int xf = (x >> 9) & 0x7f; - uint16_t a = src[xi]; - uint16_t b = src[xi + 1]; - dst[0] = BLENDER(a, b, xf); - } -} - -#undef BLENDER1 -#undef BLENDERC -#undef BLENDER - -// Scale plane vertically with bilinear interpolation. -void ScalePlaneVertical(int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_argb, - uint8_t *dst_argb, - int x, - int y, - int dy, - int bpp, // bytes per pixel. 4 for ARGB. - enum FilterMode filtering) { - // TODO(fbarchard): Allow higher bpp. - int dst_width_bytes = dst_width * bpp; - void (*InterpolateRow)(uint8_t *dst_argb, const uint8_t *src_argb, - ptrdiff_t src_stride, int dst_width, - int source_y_fraction) = InterpolateRow_C; - const int max_y = (src_height > 1) ? ((src_height - 1) << 16) - 1 : 0; - int j; - assert(bpp >= 1 && bpp <= 4); - assert(src_height != 0); - assert(dst_width > 0); - assert(dst_height > 0); - src_argb += (x >> 16) * bpp; -#if defined(HAS_INTERPOLATEROW_SSSE3) - if (TestCpuFlag(kCpuHasSSSE3)) { - InterpolateRow = InterpolateRow_Any_SSSE3; - if (IS_ALIGNED(dst_width_bytes, 16)) { - InterpolateRow = InterpolateRow_SSSE3; - } - } -#endif -#if defined(HAS_INTERPOLATEROW_AVX2) - if (TestCpuFlag(kCpuHasAVX2)) { - InterpolateRow = InterpolateRow_Any_AVX2; - if (IS_ALIGNED(dst_width_bytes, 32)) { - InterpolateRow = InterpolateRow_AVX2; - } - } -#endif - - - for (j = 0; j < dst_height; ++j) { - int yi; - int yf; - if (y > max_y) { - y = max_y; - } - yi = y >> 16; - yf = filtering ? ((y >> 8) & 255) : 0; - InterpolateRow(dst_argb, src_argb + yi * src_stride, src_stride, - dst_width_bytes, yf); - dst_argb += dst_stride; - y += dy; - } -} - -// Simplify the filtering based on scale factors. -enum FilterMode ScaleFilterReduce(int src_width, - int src_height, - int dst_width, - int dst_height, - enum FilterMode filtering) { - if (src_width < 0) { - src_width = -src_width; - } - if (src_height < 0) { - src_height = -src_height; - } - if (filtering == kFilterBox) { - // If scaling either axis to 0.5 or larger, switch from Box to Bilinear. - if (dst_width * 2 >= src_width || dst_height * 2 >= src_height) { - filtering = kFilterBilinear; - } - } - if (filtering == kFilterBilinear) { - if (src_height == 1) { - filtering = kFilterLinear; - } - // TODO(fbarchard): Detect any odd scale factor and reduce to Linear. - if (dst_height == src_height || dst_height * 3 == src_height) { - filtering = kFilterLinear; - } - // TODO(fbarchard): Remove 1 pixel wide filter restriction, which is to - // avoid reading 2 pixels horizontally that causes memory exception. - if (src_width == 1) { - filtering = kFilterNone; - } - } - if (filtering == kFilterLinear) { - if (src_width == 1) { - filtering = kFilterNone; - } - // TODO(fbarchard): Detect any odd scale factor and reduce to None. - if (dst_width == src_width || dst_width * 3 == src_width) { - filtering = kFilterNone; - } - } - return filtering; -} - -#define CENTERSTART(dx, s) (dx < 0) ? -((-dx >> 1) + s) : ((dx >> 1) + s) - -// Compute slope values for stepping. -void ScaleSlope(int src_width, - int src_height, - int dst_width, - int dst_height, - enum FilterMode filtering, - int *x, - int *y, - int *dx, - int *dy) { - assert(x != NULL); - assert(y != NULL); - assert(dx != NULL); - assert(dy != NULL); - assert(src_width != 0); - assert(src_height != 0); - assert(dst_width > 0); - assert(dst_height > 0); - // Check for 1 pixel and avoid FixedDiv overflow. - if (dst_width == 1 && src_width >= 32768) { - dst_width = src_width; - } - if (dst_height == 1 && src_height >= 32768) { - dst_height = src_height; - } - if (filtering == kFilterBox) { - // Scale step for point sampling duplicates all pixels equally. - *dx = FixedDiv(Abs(src_width), dst_width); - *dy = FixedDiv(src_height, dst_height); - *x = 0; - *y = 0; - } else if (filtering == kFilterBilinear) { - // Scale step for bilinear sampling renders last pixel once for upsample. - if (dst_width <= Abs(src_width)) { - *dx = FixedDiv(Abs(src_width), dst_width); - *x = CENTERSTART(*dx, -32768); // Subtract 0.5 (32768) to center filter. - } else if (src_width > 1 && dst_width > 1) { - *dx = FixedDiv1(Abs(src_width), dst_width); - *x = 0; - } - if (dst_height <= src_height) { - *dy = FixedDiv(src_height, dst_height); - *y = CENTERSTART(*dy, -32768); // Subtract 0.5 (32768) to center filter. - } else if (src_height > 1 && dst_height > 1) { - *dy = FixedDiv1(src_height, dst_height); - *y = 0; - } - } else if (filtering == kFilterLinear) { - // Scale step for bilinear sampling renders last pixel once for upsample. - if (dst_width <= Abs(src_width)) { - *dx = FixedDiv(Abs(src_width), dst_width); - *x = CENTERSTART(*dx, -32768); // Subtract 0.5 (32768) to center filter. - } else if (src_width > 1 && dst_width > 1) { - *dx = FixedDiv1(Abs(src_width), dst_width); - *x = 0; - } - *dy = FixedDiv(src_height, dst_height); - *y = *dy >> 1; - } else { - // Scale step for point sampling duplicates all pixels equally. - *dx = FixedDiv(Abs(src_width), dst_width); - *dy = FixedDiv(src_height, dst_height); - *x = CENTERSTART(*dx, 0); - *y = CENTERSTART(*dy, 0); - } - // Negative src_width means horizontally mirror. - if (src_width < 0) { - *x += (dst_width - 1) * *dx; - *dx = -*dx; - // src_width = -src_width; // Caller must do this. - } -} - -#undef CENTERSTART diff --git a/pkg/encoder/yuv/libyuv/scale_gcc.c b/pkg/encoder/yuv/libyuv/scale_gcc.c deleted file mode 100644 index 716d6cfd..00000000 --- a/pkg/encoder/yuv/libyuv/scale_gcc.c +++ /dev/null @@ -1,2651 +0,0 @@ -/* - * Copyright 2013 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "row.h" -#include "scale_row.h" - -// This module is for GCC x86 and x64. -#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) - -// Offsets for source bytes 0 to 9 -static const uvec8 kShuf0 = {0, 1, 3, 4, 5, 7, 8, 9, - 128, 128, 128, 128, 128, 128, 128, 128}; - -// Offsets for source bytes 11 to 20 with 8 subtracted = 3 to 12. -static const uvec8 kShuf1 = {3, 4, 5, 7, 8, 9, 11, 12, - 128, 128, 128, 128, 128, 128, 128, 128}; - -// Offsets for source bytes 21 to 31 with 16 subtracted = 5 to 31. -static const uvec8 kShuf2 = {5, 7, 8, 9, 11, 12, 13, 15, - 128, 128, 128, 128, 128, 128, 128, 128}; - -// Offsets for source bytes 0 to 10 -static const uvec8 kShuf01 = {0, 1, 1, 2, 2, 3, 4, 5, 5, 6, 6, 7, 8, 9, 9, 10}; - -// Offsets for source bytes 10 to 21 with 8 subtracted = 3 to 13. -static const uvec8 kShuf11 = {2, 3, 4, 5, 5, 6, 6, 7, - 8, 9, 9, 10, 10, 11, 12, 13}; - -// Offsets for source bytes 21 to 31 with 16 subtracted = 5 to 31. -static const uvec8 kShuf21 = {5, 6, 6, 7, 8, 9, 9, 10, - 10, 11, 12, 13, 13, 14, 14, 15}; - -// Coefficients for source bytes 0 to 10 -static const uvec8 kMadd01 = {3, 1, 2, 2, 1, 3, 3, 1, 2, 2, 1, 3, 3, 1, 2, 2}; - -// Coefficients for source bytes 10 to 21 -static const uvec8 kMadd11 = {1, 3, 3, 1, 2, 2, 1, 3, 3, 1, 2, 2, 1, 3, 3, 1}; - -// Coefficients for source bytes 21 to 31 -static const uvec8 kMadd21 = {2, 2, 1, 3, 3, 1, 2, 2, 1, 3, 3, 1, 2, 2, 1, 3}; - -// Coefficients for source bytes 21 to 31 -static const vec16 kRound34 = {2, 2, 2, 2, 2, 2, 2, 2}; - -static const uvec8 kShuf38a = {0, 3, 6, 8, 11, 14, 128, 128, - 128, 128, 128, 128, 128, 128, 128, 128}; - -static const uvec8 kShuf38b = {128, 128, 128, 128, 128, 128, 0, 3, - 6, 8, 11, 14, 128, 128, 128, 128}; - -// Arrange words 0,3,6 into 0,1,2 -static const uvec8 kShufAc = {0, 1, 6, 7, 12, 13, 128, 128, - 128, 128, 128, 128, 128, 128, 128, 128}; - -// Arrange words 0,3,6 into 3,4,5 -static const uvec8 kShufAc3 = {128, 128, 128, 128, 128, 128, 0, 1, - 6, 7, 12, 13, 128, 128, 128, 128}; - -// Scaling values for boxes of 3x3 and 2x3 -static const uvec16 kScaleAc33 = {65536 / 9, 65536 / 9, 65536 / 6, 65536 / 9, - 65536 / 9, 65536 / 6, 0, 0}; - -// Arrange first value for pixels 0,1,2,3,4,5 -static const uvec8 kShufAb0 = {0, 128, 3, 128, 6, 128, 8, 128, - 11, 128, 14, 128, 128, 128, 128, 128}; - -// Arrange second value for pixels 0,1,2,3,4,5 -static const uvec8 kShufAb1 = {1, 128, 4, 128, 7, 128, 9, 128, - 12, 128, 15, 128, 128, 128, 128, 128}; - -// Arrange third value for pixels 0,1,2,3,4,5 -static const uvec8 kShufAb2 = {2, 128, 5, 128, 128, 128, 10, 128, - 13, 128, 128, 128, 128, 128, 128, 128}; - -// Scaling values for boxes of 3x2 and 2x2 -static const uvec16 kScaleAb2 = {65536 / 3, 65536 / 3, 65536 / 2, 65536 / 3, - 65536 / 3, 65536 / 2, 0, 0}; - -// GCC versions of row functions are verbatim conversions from Visual C. -// Generated using gcc disassembly on Visual C object file: -// objdump -D yuvscaler.obj >yuvscaler.txt - -void ScaleRowDown2_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - (void) src_stride; - asm volatile( - // 16 pixel loop. - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "lea 0x20(%0),%0 \n" - "psrlw $0x8,%%xmm0 \n" - "psrlw $0x8,%%xmm1 \n" - "packuswb %%xmm1,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - ::"memory", - "cc", "xmm0", "xmm1"); -} - -void ScaleRowDown2Linear_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - (void) src_stride; - asm volatile( - "pcmpeqb %%xmm4,%%xmm4 \n" - "psrlw $0xf,%%xmm4 \n" - "packuswb %%xmm4,%%xmm4 \n" - "pxor %%xmm5,%%xmm5 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "lea 0x20(%0),%0 \n" - "pmaddubsw %%xmm4,%%xmm0 \n" - "pmaddubsw %%xmm4,%%xmm1 \n" - "pavgw %%xmm5,%%xmm0 \n" - "pavgw %%xmm5,%%xmm1 \n" - "packuswb %%xmm1,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - ::"memory", - "cc", "xmm0", "xmm1", "xmm4", "xmm5"); -} - -void ScaleRowDown2Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "pcmpeqb %%xmm4,%%xmm4 \n" - "psrlw $0xf,%%xmm4 \n" - "packuswb %%xmm4,%%xmm4 \n" - "pxor %%xmm5,%%xmm5 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "movdqu 0x00(%0,%3,1),%%xmm2 \n" - "movdqu 0x10(%0,%3,1),%%xmm3 \n" - "lea 0x20(%0),%0 \n" - "pmaddubsw %%xmm4,%%xmm0 \n" - "pmaddubsw %%xmm4,%%xmm1 \n" - "pmaddubsw %%xmm4,%%xmm2 \n" - "pmaddubsw %%xmm4,%%xmm3 \n" - "paddw %%xmm2,%%xmm0 \n" - "paddw %%xmm3,%%xmm1 \n" - "psrlw $0x1,%%xmm0 \n" - "psrlw $0x1,%%xmm1 \n" - "pavgw %%xmm5,%%xmm0 \n" - "pavgw %%xmm5,%%xmm1 \n" - "packuswb %%xmm1,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm5"); -} - -#ifdef HAS_SCALEROWDOWN2_AVX2 - -void ScaleRowDown2_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - (void) src_stride; - asm volatile(LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" - "vmovdqu 0x20(%0),%%ymm1 \n" - "lea 0x40(%0),%0 \n" - "vpsrlw $0x8,%%ymm0,%%ymm0 \n" - "vpsrlw $0x8,%%ymm1,%%ymm1 \n" - "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - ::"memory", - "cc", "xmm0", "xmm1"); -} - -void ScaleRowDown2Linear_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - (void) src_stride; - asm volatile( - "vpcmpeqb %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrlw $0xf,%%ymm4,%%ymm4 \n" - "vpackuswb %%ymm4,%%ymm4,%%ymm4 \n" - "vpxor %%ymm5,%%ymm5,%%ymm5 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" - "vmovdqu 0x20(%0),%%ymm1 \n" - "lea 0x40(%0),%0 \n" - "vpmaddubsw %%ymm4,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm4,%%ymm1,%%ymm1 \n" - "vpavgw %%ymm5,%%ymm0,%%ymm0 \n" - "vpavgw %%ymm5,%%ymm1,%%ymm1 \n" - "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - ::"memory", - "cc", "xmm0", "xmm1", "xmm4", "xmm5"); -} - -void ScaleRowDown2Box_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "vpcmpeqb %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrlw $0xf,%%ymm4,%%ymm4 \n" - "vpackuswb %%ymm4,%%ymm4,%%ymm4 \n" - "vpxor %%ymm5,%%ymm5,%%ymm5 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" - "vmovdqu 0x20(%0),%%ymm1 \n" - "vmovdqu 0x00(%0,%3,1),%%ymm2 \n" - "vmovdqu 0x20(%0,%3,1),%%ymm3 \n" - "lea 0x40(%0),%0 \n" - "vpmaddubsw %%ymm4,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm4,%%ymm1,%%ymm1 \n" - "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" - "vpmaddubsw %%ymm4,%%ymm3,%%ymm3 \n" - "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" - "vpaddw %%ymm3,%%ymm1,%%ymm1 \n" - "vpsrlw $0x1,%%ymm0,%%ymm0 \n" - "vpsrlw $0x1,%%ymm1,%%ymm1 \n" - "vpavgw %%ymm5,%%ymm0,%%ymm0 \n" - "vpavgw %%ymm5,%%ymm1,%%ymm1 \n" - "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm5"); -} - -#endif // HAS_SCALEROWDOWN2_AVX2 - -void ScaleRowDown4_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - (void) src_stride; - asm volatile( - "pcmpeqb %%xmm5,%%xmm5 \n" - "psrld $0x18,%%xmm5 \n" - "pslld $0x10,%%xmm5 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "lea 0x20(%0),%0 \n" - "pand %%xmm5,%%xmm0 \n" - "pand %%xmm5,%%xmm1 \n" - "packuswb %%xmm1,%%xmm0 \n" - "psrlw $0x8,%%xmm0 \n" - "packuswb %%xmm0,%%xmm0 \n" - "movq %%xmm0,(%1) \n" - "lea 0x8(%1),%1 \n" - "sub $0x8,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - ::"memory", - "cc", "xmm0", "xmm1", "xmm5"); -} - -void ScaleRowDown4Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - intptr_t stridex3; - asm volatile( - "pcmpeqb %%xmm4,%%xmm4 \n" - "psrlw $0xf,%%xmm4 \n" - "movdqa %%xmm4,%%xmm5 \n" - "packuswb %%xmm4,%%xmm4 \n" - "psllw $0x3,%%xmm5 \n" - "lea 0x00(%4,%4,2),%3 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "movdqu 0x00(%0,%4,1),%%xmm2 \n" - "movdqu 0x10(%0,%4,1),%%xmm3 \n" - "pmaddubsw %%xmm4,%%xmm0 \n" - "pmaddubsw %%xmm4,%%xmm1 \n" - "pmaddubsw %%xmm4,%%xmm2 \n" - "pmaddubsw %%xmm4,%%xmm3 \n" - "paddw %%xmm2,%%xmm0 \n" - "paddw %%xmm3,%%xmm1 \n" - "movdqu 0x00(%0,%4,2),%%xmm2 \n" - "movdqu 0x10(%0,%4,2),%%xmm3 \n" - "pmaddubsw %%xmm4,%%xmm2 \n" - "pmaddubsw %%xmm4,%%xmm3 \n" - "paddw %%xmm2,%%xmm0 \n" - "paddw %%xmm3,%%xmm1 \n" - "movdqu 0x00(%0,%3,1),%%xmm2 \n" - "movdqu 0x10(%0,%3,1),%%xmm3 \n" - "lea 0x20(%0),%0 \n" - "pmaddubsw %%xmm4,%%xmm2 \n" - "pmaddubsw %%xmm4,%%xmm3 \n" - "paddw %%xmm2,%%xmm0 \n" - "paddw %%xmm3,%%xmm1 \n" - "phaddw %%xmm1,%%xmm0 \n" - "paddw %%xmm5,%%xmm0 \n" - "psrlw $0x4,%%xmm0 \n" - "packuswb %%xmm0,%%xmm0 \n" - "movq %%xmm0,(%1) \n" - "lea 0x8(%1),%1 \n" - "sub $0x8,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width), // %2 - "=&r"(stridex3) // %3 - : "r"((intptr_t) (src_stride)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#ifdef HAS_SCALEROWDOWN4_AVX2 - -void ScaleRowDown4_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - (void) src_stride; - asm volatile( - "vpcmpeqb %%ymm5,%%ymm5,%%ymm5 \n" - "vpsrld $0x18,%%ymm5,%%ymm5 \n" - "vpslld $0x10,%%ymm5,%%ymm5 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" - "vmovdqu 0x20(%0),%%ymm1 \n" - "lea 0x40(%0),%0 \n" - "vpand %%ymm5,%%ymm0,%%ymm0 \n" - "vpand %%ymm5,%%ymm1,%%ymm1 \n" - "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vpsrlw $0x8,%%ymm0,%%ymm0 \n" - "vpackuswb %%ymm0,%%ymm0,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vmovdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - ::"memory", - "cc", "xmm0", "xmm1", "xmm5"); -} - -void ScaleRowDown4Box_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "vpcmpeqb %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrlw $0xf,%%ymm4,%%ymm4 \n" - "vpsllw $0x3,%%ymm4,%%ymm5 \n" - "vpackuswb %%ymm4,%%ymm4,%%ymm4 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" - "vmovdqu 0x20(%0),%%ymm1 \n" - "vmovdqu 0x00(%0,%3,1),%%ymm2 \n" - "vmovdqu 0x20(%0,%3,1),%%ymm3 \n" - "vpmaddubsw %%ymm4,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm4,%%ymm1,%%ymm1 \n" - "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" - "vpmaddubsw %%ymm4,%%ymm3,%%ymm3 \n" - "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" - "vpaddw %%ymm3,%%ymm1,%%ymm1 \n" - "vmovdqu 0x00(%0,%3,2),%%ymm2 \n" - "vmovdqu 0x20(%0,%3,2),%%ymm3 \n" - "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" - "vpmaddubsw %%ymm4,%%ymm3,%%ymm3 \n" - "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" - "vpaddw %%ymm3,%%ymm1,%%ymm1 \n" - "vmovdqu 0x00(%0,%4,1),%%ymm2 \n" - "vmovdqu 0x20(%0,%4,1),%%ymm3 \n" - "lea 0x40(%0),%0 \n" - "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" - "vpmaddubsw %%ymm4,%%ymm3,%%ymm3 \n" - "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" - "vpaddw %%ymm3,%%ymm1,%%ymm1 \n" - "vphaddw %%ymm1,%%ymm0,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vpaddw %%ymm5,%%ymm0,%%ymm0 \n" - "vpsrlw $0x4,%%ymm0,%%ymm0 \n" - "vpackuswb %%ymm0,%%ymm0,%%ymm0 \n" - "vpermq $0xd8,%%ymm0,%%ymm0 \n" - "vmovdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (src_stride * 3)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif // HAS_SCALEROWDOWN4_AVX2 - -void ScaleRowDown34_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - (void) src_stride; - asm volatile( - "movdqa %0,%%xmm3 \n" - "movdqa %1,%%xmm4 \n" - "movdqa %2,%%xmm5 \n" - : - : "m"(kShuf0), // %0 - "m"(kShuf1), // %1 - "m"(kShuf2) // %2 - ); - asm volatile(LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x10(%0),%%xmm2 \n" - "lea 0x20(%0),%0 \n" - "movdqa %%xmm2,%%xmm1 \n" - "palignr $0x8,%%xmm0,%%xmm1 \n" - "pshufb %%xmm3,%%xmm0 \n" - "pshufb %%xmm4,%%xmm1 \n" - "pshufb %%xmm5,%%xmm2 \n" - "movq %%xmm0,(%1) \n" - "movq %%xmm1,0x8(%1) \n" - "movq %%xmm2,0x10(%1) \n" - "lea 0x18(%1),%1 \n" - "sub $0x18,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - ::"memory", - "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -void ScaleRowDown34_1_Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "movdqa %0,%%xmm2 \n" // kShuf01 - "movdqa %1,%%xmm3 \n" // kShuf11 - "movdqa %2,%%xmm4 \n" // kShuf21 - : - : "m"(kShuf01), // %0 - "m"(kShuf11), // %1 - "m"(kShuf21) // %2 - ); - asm volatile( - "movdqa %0,%%xmm5 \n" // kMadd01 - "movdqa %1,%%xmm0 \n" // kMadd11 - "movdqa %2,%%xmm1 \n" // kRound34 - : - : "m"(kMadd01), // %0 - "m"(kMadd11), // %1 - "m"(kRound34) // %2 - ); - asm volatile(LABELALIGN - "1: \n" - "movdqu (%0),%%xmm6 \n" - "movdqu 0x00(%0,%3,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - "pshufb %%xmm2,%%xmm6 \n" - "pmaddubsw %%xmm5,%%xmm6 \n" - "paddsw %%xmm1,%%xmm6 \n" - "psrlw $0x2,%%xmm6 \n" - "packuswb %%xmm6,%%xmm6 \n" - "movq %%xmm6,(%1) \n" - "movdqu 0x8(%0),%%xmm6 \n" - "movdqu 0x8(%0,%3,1),%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - "pshufb %%xmm3,%%xmm6 \n" - "pmaddubsw %%xmm0,%%xmm6 \n" - "paddsw %%xmm1,%%xmm6 \n" - "psrlw $0x2,%%xmm6 \n" - "packuswb %%xmm6,%%xmm6 \n" - "movq %%xmm6,0x8(%1) \n" - "movdqu 0x10(%0),%%xmm6 \n" - "movdqu 0x10(%0,%3,1),%%xmm7 \n" - "lea 0x20(%0),%0 \n" - "pavgb %%xmm7,%%xmm6 \n" - "pshufb %%xmm4,%%xmm6 \n" - "pmaddubsw %4,%%xmm6 \n" - "paddsw %%xmm1,%%xmm6 \n" - "psrlw $0x2,%%xmm6 \n" - "packuswb %%xmm6,%%xmm6 \n" - "movq %%xmm6,0x10(%1) \n" - "lea 0x18(%1),%1 \n" - "sub $0x18,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "m"(kMadd21) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", - "xmm6", "xmm7"); -} - -void ScaleRowDown34_0_Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "movdqa %0,%%xmm2 \n" // kShuf01 - "movdqa %1,%%xmm3 \n" // kShuf11 - "movdqa %2,%%xmm4 \n" // kShuf21 - : - : "m"(kShuf01), // %0 - "m"(kShuf11), // %1 - "m"(kShuf21) // %2 - ); - asm volatile( - "movdqa %0,%%xmm5 \n" // kMadd01 - "movdqa %1,%%xmm0 \n" // kMadd11 - "movdqa %2,%%xmm1 \n" // kRound34 - : - : "m"(kMadd01), // %0 - "m"(kMadd11), // %1 - "m"(kRound34) // %2 - ); - - asm volatile(LABELALIGN - "1: \n" - "movdqu (%0),%%xmm6 \n" - "movdqu 0x00(%0,%3,1),%%xmm7 \n" - "pavgb %%xmm6,%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - "pshufb %%xmm2,%%xmm6 \n" - "pmaddubsw %%xmm5,%%xmm6 \n" - "paddsw %%xmm1,%%xmm6 \n" - "psrlw $0x2,%%xmm6 \n" - "packuswb %%xmm6,%%xmm6 \n" - "movq %%xmm6,(%1) \n" - "movdqu 0x8(%0),%%xmm6 \n" - "movdqu 0x8(%0,%3,1),%%xmm7 \n" - "pavgb %%xmm6,%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - "pshufb %%xmm3,%%xmm6 \n" - "pmaddubsw %%xmm0,%%xmm6 \n" - "paddsw %%xmm1,%%xmm6 \n" - "psrlw $0x2,%%xmm6 \n" - "packuswb %%xmm6,%%xmm6 \n" - "movq %%xmm6,0x8(%1) \n" - "movdqu 0x10(%0),%%xmm6 \n" - "movdqu 0x10(%0,%3,1),%%xmm7 \n" - "lea 0x20(%0),%0 \n" - "pavgb %%xmm6,%%xmm7 \n" - "pavgb %%xmm7,%%xmm6 \n" - "pshufb %%xmm4,%%xmm6 \n" - "pmaddubsw %4,%%xmm6 \n" - "paddsw %%xmm1,%%xmm6 \n" - "psrlw $0x2,%%xmm6 \n" - "packuswb %%xmm6,%%xmm6 \n" - "movq %%xmm6,0x10(%1) \n" - "lea 0x18(%1),%1 \n" - "sub $0x18,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "m"(kMadd21) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", - "xmm6", "xmm7"); -} - -void ScaleRowDown38_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - (void) src_stride; - asm volatile( - "movdqa %3,%%xmm4 \n" - "movdqa %4,%%xmm5 \n" - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x10(%0),%%xmm1 \n" - "lea 0x20(%0),%0 \n" - "pshufb %%xmm4,%%xmm0 \n" - "pshufb %%xmm5,%%xmm1 \n" - "paddusb %%xmm1,%%xmm0 \n" - "movq %%xmm0,(%1) \n" - "movhlps %%xmm0,%%xmm1 \n" - "movd %%xmm1,0x8(%1) \n" - "lea 0xc(%1),%1 \n" - "sub $0xc,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "m"(kShuf38a), // %3 - "m"(kShuf38b) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm4", "xmm5"); -} - -void ScaleRowDown38_2_Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "movdqa %0,%%xmm2 \n" - "movdqa %1,%%xmm3 \n" - "movdqa %2,%%xmm4 \n" - "movdqa %3,%%xmm5 \n" - : - : "m"(kShufAb0), // %0 - "m"(kShufAb1), // %1 - "m"(kShufAb2), // %2 - "m"(kScaleAb2) // %3 - ); - asm volatile(LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x00(%0,%3,1),%%xmm1 \n" - "lea 0x10(%0),%0 \n" - "pavgb %%xmm1,%%xmm0 \n" - "movdqa %%xmm0,%%xmm1 \n" - "pshufb %%xmm2,%%xmm1 \n" - "movdqa %%xmm0,%%xmm6 \n" - "pshufb %%xmm3,%%xmm6 \n" - "paddusw %%xmm6,%%xmm1 \n" - "pshufb %%xmm4,%%xmm0 \n" - "paddusw %%xmm0,%%xmm1 \n" - "pmulhuw %%xmm5,%%xmm1 \n" - "packuswb %%xmm1,%%xmm1 \n" - "movd %%xmm1,(%1) \n" - "psrlq $0x10,%%xmm1 \n" - "movd %%xmm1,0x2(%1) \n" - "lea 0x6(%1),%1 \n" - "sub $0x6,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", - "xmm6"); -} - -void ScaleRowDown38_3_Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "movdqa %0,%%xmm2 \n" - "movdqa %1,%%xmm3 \n" - "movdqa %2,%%xmm4 \n" - "pxor %%xmm5,%%xmm5 \n" - : - : "m"(kShufAc), // %0 - "m"(kShufAc3), // %1 - "m"(kScaleAc33) // %2 - ); - asm volatile(LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" - "movdqu 0x00(%0,%3,1),%%xmm6 \n" - "movhlps %%xmm0,%%xmm1 \n" - "movhlps %%xmm6,%%xmm7 \n" - "punpcklbw %%xmm5,%%xmm0 \n" - "punpcklbw %%xmm5,%%xmm1 \n" - "punpcklbw %%xmm5,%%xmm6 \n" - "punpcklbw %%xmm5,%%xmm7 \n" - "paddusw %%xmm6,%%xmm0 \n" - "paddusw %%xmm7,%%xmm1 \n" - "movdqu 0x00(%0,%3,2),%%xmm6 \n" - "lea 0x10(%0),%0 \n" - "movhlps %%xmm6,%%xmm7 \n" - "punpcklbw %%xmm5,%%xmm6 \n" - "punpcklbw %%xmm5,%%xmm7 \n" - "paddusw %%xmm6,%%xmm0 \n" - "paddusw %%xmm7,%%xmm1 \n" - "movdqa %%xmm0,%%xmm6 \n" - "psrldq $0x2,%%xmm0 \n" - "paddusw %%xmm0,%%xmm6 \n" - "psrldq $0x2,%%xmm0 \n" - "paddusw %%xmm0,%%xmm6 \n" - "pshufb %%xmm2,%%xmm6 \n" - "movdqa %%xmm1,%%xmm7 \n" - "psrldq $0x2,%%xmm1 \n" - "paddusw %%xmm1,%%xmm7 \n" - "psrldq $0x2,%%xmm1 \n" - "paddusw %%xmm1,%%xmm7 \n" - "pshufb %%xmm3,%%xmm7 \n" - "paddusw %%xmm7,%%xmm6 \n" - "pmulhuw %%xmm4,%%xmm6 \n" - "packuswb %%xmm6,%%xmm6 \n" - "movd %%xmm6,(%1) \n" - "psrlq $0x10,%%xmm6 \n" - "movd %%xmm6,0x2(%1) \n" - "lea 0x6(%1),%1 \n" - "sub $0x6,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", - "xmm6", "xmm7"); -} - -static const uvec8 kLinearShuffleFar = {2, 3, 0, 1, 6, 7, 4, 5, - 10, 11, 8, 9, 14, 15, 12, 13}; - -static const uvec8 kLinearMadd31 = {3, 1, 1, 3, 3, 1, 1, 3, - 3, 1, 1, 3, 3, 1, 1, 3}; - -#ifdef HAS_SCALEROWUP2_LINEAR_SSE2 - -void ScaleRowUp2_Linear_SSE2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "pxor %%xmm0,%%xmm0 \n" // 0 - "pcmpeqw %%xmm6,%%xmm6 \n" - "psrlw $15,%%xmm6 \n" - "psllw $1,%%xmm6 \n" // all 2 - - LABELALIGN - "1: \n" - "movq (%0),%%xmm1 \n" // 01234567 - "movq 1(%0),%%xmm2 \n" // 12345678 - "movdqa %%xmm1,%%xmm3 \n" - "punpcklbw %%xmm2,%%xmm3 \n" // 0112233445566778 - "punpcklbw %%xmm1,%%xmm1 \n" // 0011223344556677 - "punpcklbw %%xmm2,%%xmm2 \n" // 1122334455667788 - "movdqa %%xmm1,%%xmm4 \n" - "punpcklbw %%xmm0,%%xmm4 \n" // 00112233 (16) - "movdqa %%xmm2,%%xmm5 \n" - "punpcklbw %%xmm0,%%xmm5 \n" // 11223344 (16) - "paddw %%xmm5,%%xmm4 \n" - "movdqa %%xmm3,%%xmm5 \n" - "paddw %%xmm6,%%xmm4 \n" - "punpcklbw %%xmm0,%%xmm5 \n" // 01122334 (16) - "paddw %%xmm5,%%xmm5 \n" - "paddw %%xmm4,%%xmm5 \n" // 3*near+far+2 (lo) - "psrlw $2,%%xmm5 \n" // 3/4*near+1/4*far (lo) - - "punpckhbw %%xmm0,%%xmm1 \n" // 44556677 (16) - "punpckhbw %%xmm0,%%xmm2 \n" // 55667788 (16) - "paddw %%xmm2,%%xmm1 \n" - "punpckhbw %%xmm0,%%xmm3 \n" // 45566778 (16) - "paddw %%xmm6,%%xmm1 \n" - "paddw %%xmm3,%%xmm3 \n" - "paddw %%xmm3,%%xmm1 \n" // 3*near+far+2 (hi) - "psrlw $2,%%xmm1 \n" // 3/4*near+1/4*far (hi) - - "packuswb %%xmm1,%%xmm5 \n" - "movdqu %%xmm5,(%1) \n" - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 8 sample to 16 sample - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_SSE2 - -void ScaleRowUp2_Bilinear_SSE2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - LABELALIGN - "1: \n" - "pxor %%xmm0,%%xmm0 \n" // 0 - // above line - "movq (%0),%%xmm1 \n" // 01234567 - "movq 1(%0),%%xmm2 \n" // 12345678 - "movdqa %%xmm1,%%xmm3 \n" - "punpcklbw %%xmm2,%%xmm3 \n" // 0112233445566778 - "punpcklbw %%xmm1,%%xmm1 \n" // 0011223344556677 - "punpcklbw %%xmm2,%%xmm2 \n" // 1122334455667788 - - "movdqa %%xmm1,%%xmm4 \n" - "punpcklbw %%xmm0,%%xmm4 \n" // 00112233 (16) - "movdqa %%xmm2,%%xmm5 \n" - "punpcklbw %%xmm0,%%xmm5 \n" // 11223344 (16) - "paddw %%xmm5,%%xmm4 \n" // near+far - "movdqa %%xmm3,%%xmm5 \n" - "punpcklbw %%xmm0,%%xmm5 \n" // 01122334 (16) - "paddw %%xmm5,%%xmm5 \n" // 2*near - "paddw %%xmm5,%%xmm4 \n" // 3*near+far (1, lo) - - "punpckhbw %%xmm0,%%xmm1 \n" // 44556677 (16) - "punpckhbw %%xmm0,%%xmm2 \n" // 55667788 (16) - "paddw %%xmm2,%%xmm1 \n" - "punpckhbw %%xmm0,%%xmm3 \n" // 45566778 (16) - "paddw %%xmm3,%%xmm3 \n" // 2*near - "paddw %%xmm3,%%xmm1 \n" // 3*near+far (1, hi) - - // below line - "movq (%0,%3),%%xmm6 \n" // 01234567 - "movq 1(%0,%3),%%xmm2 \n" // 12345678 - "movdqa %%xmm6,%%xmm3 \n" - "punpcklbw %%xmm2,%%xmm3 \n" // 0112233445566778 - "punpcklbw %%xmm6,%%xmm6 \n" // 0011223344556677 - "punpcklbw %%xmm2,%%xmm2 \n" // 1122334455667788 - - "movdqa %%xmm6,%%xmm5 \n" - "punpcklbw %%xmm0,%%xmm5 \n" // 00112233 (16) - "movdqa %%xmm2,%%xmm7 \n" - "punpcklbw %%xmm0,%%xmm7 \n" // 11223344 (16) - "paddw %%xmm7,%%xmm5 \n" // near+far - "movdqa %%xmm3,%%xmm7 \n" - "punpcklbw %%xmm0,%%xmm7 \n" // 01122334 (16) - "paddw %%xmm7,%%xmm7 \n" // 2*near - "paddw %%xmm7,%%xmm5 \n" // 3*near+far (2, lo) - - "punpckhbw %%xmm0,%%xmm6 \n" // 44556677 (16) - "punpckhbw %%xmm0,%%xmm2 \n" // 55667788 (16) - "paddw %%xmm6,%%xmm2 \n" // near+far - "punpckhbw %%xmm0,%%xmm3 \n" // 45566778 (16) - "paddw %%xmm3,%%xmm3 \n" // 2*near - "paddw %%xmm3,%%xmm2 \n" // 3*near+far (2, hi) - - // xmm4 xmm1 - // xmm5 xmm2 - "pcmpeqw %%xmm0,%%xmm0 \n" - "psrlw $15,%%xmm0 \n" - "psllw $3,%%xmm0 \n" // all 8 - - "movdqa %%xmm4,%%xmm3 \n" - "movdqa %%xmm5,%%xmm6 \n" - "paddw %%xmm3,%%xmm3 \n" // 6*near+2*far (1, lo) - "paddw %%xmm0,%%xmm6 \n" // 3*near+far+8 (2, lo) - "paddw %%xmm4,%%xmm3 \n" // 9*near+3*far (1, lo) - "paddw %%xmm6,%%xmm3 \n" // 9 3 3 1 + 8 (1, lo) - "psrlw $4,%%xmm3 \n" // ^ div by 16 - - "movdqa %%xmm1,%%xmm7 \n" - "movdqa %%xmm2,%%xmm6 \n" - "paddw %%xmm7,%%xmm7 \n" // 6*near+2*far (1, hi) - "paddw %%xmm0,%%xmm6 \n" // 3*near+far+8 (2, hi) - "paddw %%xmm1,%%xmm7 \n" // 9*near+3*far (1, hi) - "paddw %%xmm6,%%xmm7 \n" // 9 3 3 1 + 8 (1, hi) - "psrlw $4,%%xmm7 \n" // ^ div by 16 - - "packuswb %%xmm7,%%xmm3 \n" - "movdqu %%xmm3,(%1) \n" // save above line - - "movdqa %%xmm5,%%xmm3 \n" - "paddw %%xmm0,%%xmm4 \n" // 3*near+far+8 (1, lo) - "paddw %%xmm3,%%xmm3 \n" // 6*near+2*far (2, lo) - "paddw %%xmm3,%%xmm5 \n" // 9*near+3*far (2, lo) - "paddw %%xmm4,%%xmm5 \n" // 9 3 3 1 + 8 (lo) - "psrlw $4,%%xmm5 \n" // ^ div by 16 - - "movdqa %%xmm2,%%xmm3 \n" - "paddw %%xmm0,%%xmm1 \n" // 3*near+far+8 (1, hi) - "paddw %%xmm3,%%xmm3 \n" // 6*near+2*far (2, hi) - "paddw %%xmm3,%%xmm2 \n" // 9*near+3*far (2, hi) - "paddw %%xmm1,%%xmm2 \n" // 9 3 3 1 + 8 (hi) - "psrlw $4,%%xmm2 \n" // ^ div by 16 - - "packuswb %%xmm2,%%xmm5 \n" - "movdqu %%xmm5,(%1,%4) \n" // save below line - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 8 sample to 16 sample - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_12_SSSE3 - -void ScaleRowUp2_Linear_12_SSSE3(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width) { - asm volatile( - "movdqa %3,%%xmm5 \n" - "pcmpeqw %%xmm4,%%xmm4 \n" - "psrlw $15,%%xmm4 \n" - "psllw $1,%%xmm4 \n" // all 2 - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" // 01234567 (16) - "movdqu 2(%0),%%xmm1 \n" // 12345678 (16) - - "movdqa %%xmm0,%%xmm2 \n" - "punpckhwd %%xmm1,%%xmm2 \n" // 45566778 (16) - "punpcklwd %%xmm1,%%xmm0 \n" // 01122334 (16) - - "movdqa %%xmm2,%%xmm3 \n" - "movdqa %%xmm0,%%xmm1 \n" - "pshufb %%xmm5,%%xmm3 \n" // 54657687 (far) - "pshufb %%xmm5,%%xmm1 \n" // 10213243 (far) - - "paddw %%xmm4,%%xmm1 \n" // far+2 - "paddw %%xmm4,%%xmm3 \n" // far+2 - "paddw %%xmm0,%%xmm1 \n" // near+far+2 - "paddw %%xmm2,%%xmm3 \n" // near+far+2 - "paddw %%xmm0,%%xmm0 \n" // 2*near - "paddw %%xmm2,%%xmm2 \n" // 2*near - "paddw %%xmm1,%%xmm0 \n" // 3*near+far+2 (lo) - "paddw %%xmm3,%%xmm2 \n" // 3*near+far+2 (hi) - - "psrlw $2,%%xmm0 \n" // 3/4*near+1/4*far - "psrlw $2,%%xmm2 \n" // 3/4*near+1/4*far - "movdqu %%xmm0,(%1) \n" - "movdqu %%xmm2,16(%1) \n" - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 8 sample to 16 sample - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "m"(kLinearShuffleFar) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_12_SSSE3 - -void ScaleRowUp2_Bilinear_12_SSSE3(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "pcmpeqw %%xmm7,%%xmm7 \n" - "psrlw $15,%%xmm7 \n" - "psllw $3,%%xmm7 \n" // all 8 - "movdqa %5,%%xmm6 \n" - - LABELALIGN - "1: \n" - // above line - "movdqu (%0),%%xmm0 \n" // 01234567 (16) - "movdqu 2(%0),%%xmm1 \n" // 12345678 (16) - "movdqa %%xmm0,%%xmm2 \n" - "punpckhwd %%xmm1,%%xmm2 \n" // 45566778 (16) - "punpcklwd %%xmm1,%%xmm0 \n" // 01122334 (16) - "movdqa %%xmm2,%%xmm3 \n" - "movdqa %%xmm0,%%xmm1 \n" - "pshufb %%xmm6,%%xmm3 \n" // 54657687 (far) - "pshufb %%xmm6,%%xmm1 \n" // 10213243 (far) - "paddw %%xmm0,%%xmm1 \n" // near+far - "paddw %%xmm2,%%xmm3 \n" // near+far - "paddw %%xmm0,%%xmm0 \n" // 2*near - "paddw %%xmm2,%%xmm2 \n" // 2*near - "paddw %%xmm1,%%xmm0 \n" // 3*near+far (1, lo) - "paddw %%xmm3,%%xmm2 \n" // 3*near+far (1, hi) - - // below line - "movdqu (%0,%3,2),%%xmm1 \n" // 01234567 (16) - "movdqu 2(%0,%3,2),%%xmm4 \n" // 12345678 (16) - "movdqa %%xmm1,%%xmm3 \n" - "punpckhwd %%xmm4,%%xmm3 \n" // 45566778 (16) - "punpcklwd %%xmm4,%%xmm1 \n" // 01122334 (16) - "movdqa %%xmm3,%%xmm5 \n" - "movdqa %%xmm1,%%xmm4 \n" - "pshufb %%xmm6,%%xmm5 \n" // 54657687 (far) - "pshufb %%xmm6,%%xmm4 \n" // 10213243 (far) - "paddw %%xmm1,%%xmm4 \n" // near+far - "paddw %%xmm3,%%xmm5 \n" // near+far - "paddw %%xmm1,%%xmm1 \n" // 2*near - "paddw %%xmm3,%%xmm3 \n" // 2*near - "paddw %%xmm4,%%xmm1 \n" // 3*near+far (2, lo) - "paddw %%xmm5,%%xmm3 \n" // 3*near+far (2, hi) - - // xmm0 xmm2 - // xmm1 xmm3 - - "movdqa %%xmm0,%%xmm4 \n" - "movdqa %%xmm1,%%xmm5 \n" - "paddw %%xmm4,%%xmm4 \n" // 6*near+2*far (1, lo) - "paddw %%xmm7,%%xmm5 \n" // 3*near+far+8 (2, lo) - "paddw %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) - "paddw %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) - "psrlw $4,%%xmm4 \n" // ^ div by 16 - "movdqu %%xmm4,(%1) \n" - - "movdqa %%xmm2,%%xmm4 \n" - "movdqa %%xmm3,%%xmm5 \n" - "paddw %%xmm4,%%xmm4 \n" // 6*near+2*far (1, hi) - "paddw %%xmm7,%%xmm5 \n" // 3*near+far+8 (2, hi) - "paddw %%xmm2,%%xmm4 \n" // 9*near+3*far (1, hi) - "paddw %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, hi) - "psrlw $4,%%xmm4 \n" // ^ div by 16 - "movdqu %%xmm4,0x10(%1) \n" - - "movdqa %%xmm1,%%xmm4 \n" - "paddw %%xmm7,%%xmm0 \n" // 3*near+far+8 (1, lo) - "paddw %%xmm4,%%xmm4 \n" // 6*near+2*far (2, lo) - "paddw %%xmm4,%%xmm1 \n" // 9*near+3*far (2, lo) - "paddw %%xmm0,%%xmm1 \n" // 9 3 3 1 + 8 (2, lo) - "psrlw $4,%%xmm1 \n" // ^ div by 16 - "movdqu %%xmm1,(%1,%4,2) \n" - - "movdqa %%xmm3,%%xmm4 \n" - "paddw %%xmm7,%%xmm2 \n" // 3*near+far+8 (1, hi) - "paddw %%xmm4,%%xmm4 \n" // 6*near+2*far (2, hi) - "paddw %%xmm4,%%xmm3 \n" // 9*near+3*far (2, hi) - "paddw %%xmm2,%%xmm3 \n" // 9 3 3 1 + 8 (2, hi) - "psrlw $4,%%xmm3 \n" // ^ div by 16 - "movdqu %%xmm3,0x10(%1,%4,2) \n" - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 8 sample to 16 sample - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)), // %4 - "m"(kLinearShuffleFar) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_16_SSE2 - -void ScaleRowUp2_Linear_16_SSE2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width) { - asm volatile( - "pxor %%xmm5,%%xmm5 \n" - "pcmpeqd %%xmm4,%%xmm4 \n" - "psrld $31,%%xmm4 \n" - "pslld $1,%%xmm4 \n" // all 2 - - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" // 0123 (16b) - "movq 2(%0),%%xmm1 \n" // 1234 (16b) - - "punpcklwd %%xmm5,%%xmm0 \n" // 0123 (32b) - "punpcklwd %%xmm5,%%xmm1 \n" // 1234 (32b) - - "movdqa %%xmm0,%%xmm2 \n" - "movdqa %%xmm1,%%xmm3 \n" - - "pshufd $0b10110001,%%xmm2,%%xmm2 \n" // 1032 (even, far) - "pshufd $0b10110001,%%xmm3,%%xmm3 \n" // 2143 (odd, far) - - "paddd %%xmm4,%%xmm2 \n" // far+2 (lo) - "paddd %%xmm4,%%xmm3 \n" // far+2 (hi) - "paddd %%xmm0,%%xmm2 \n" // near+far+2 (lo) - "paddd %%xmm1,%%xmm3 \n" // near+far+2 (hi) - "paddd %%xmm0,%%xmm0 \n" // 2*near (lo) - "paddd %%xmm1,%%xmm1 \n" // 2*near (hi) - "paddd %%xmm2,%%xmm0 \n" // 3*near+far+2 (lo) - "paddd %%xmm3,%%xmm1 \n" // 3*near+far+2 (hi) - - "psrld $2,%%xmm0 \n" // 3/4*near+1/4*far (lo) - "psrld $2,%%xmm1 \n" // 3/4*near+1/4*far (hi) - "packssdw %%xmm1,%%xmm0 \n" - "pshufd $0b11011000,%%xmm0,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 4 pixel to 8 pixel - "sub $0x8,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_16_SSE2 - -void ScaleRowUp2_Bilinear_16_SSE2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "pxor %%xmm7,%%xmm7 \n" - "pcmpeqd %%xmm6,%%xmm6 \n" - "psrld $31,%%xmm6 \n" - "pslld $3,%%xmm6 \n" // all 8 - - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" // 0011 (16b, 1u1v) - "movq 4(%0),%%xmm1 \n" // 1122 (16b, 1u1v) - "punpcklwd %%xmm7,%%xmm0 \n" // 0011 (near) (32b, 1u1v) - "punpcklwd %%xmm7,%%xmm1 \n" // 1122 (near) (32b, 1u1v) - "movdqa %%xmm0,%%xmm2 \n" - "movdqa %%xmm1,%%xmm3 \n" - "pshufd $0b01001110,%%xmm2,%%xmm2 \n" // 1100 (far) (1, lo) - "pshufd $0b01001110,%%xmm3,%%xmm3 \n" // 2211 (far) (1, hi) - "paddd %%xmm0,%%xmm2 \n" // near+far (1, lo) - "paddd %%xmm1,%%xmm3 \n" // near+far (1, hi) - "paddd %%xmm0,%%xmm0 \n" // 2*near (1, lo) - "paddd %%xmm1,%%xmm1 \n" // 2*near (1, hi) - "paddd %%xmm2,%%xmm0 \n" // 3*near+far (1, lo) - "paddd %%xmm3,%%xmm1 \n" // 3*near+far (1, hi) - - "movq (%0),%%xmm0 \n" // 0123 (16b) - "movq 2(%0),%%xmm1 \n" // 1234 (16b) - "punpcklwd %%xmm7,%%xmm0 \n" // 0123 (32b) - "punpcklwd %%xmm7,%%xmm1 \n" // 1234 (32b) - "movdqa %%xmm0,%%xmm2 \n" - "movdqa %%xmm1,%%xmm3 \n" - "pshufd $0b10110001,%%xmm2,%%xmm2 \n" // 1032 (even, far) - "pshufd $0b10110001,%%xmm3,%%xmm3 \n" // 2143 (odd, far) - "paddd %%xmm0,%%xmm2 \n" // near+far (lo) - "paddd %%xmm1,%%xmm3 \n" // near+far (hi) - "paddd %%xmm0,%%xmm0 \n" // 2*near (lo) - "paddd %%xmm1,%%xmm1 \n" // 2*near (hi) - "paddd %%xmm2,%%xmm0 \n" // 3*near+far (1, lo) - "paddd %%xmm3,%%xmm1 \n" // 3*near+far (1, hi) - - "movq (%0,%3,2),%%xmm2 \n" - "movq 2(%0,%3,2),%%xmm3 \n" - "punpcklwd %%xmm7,%%xmm2 \n" // 0123 (32b) - "punpcklwd %%xmm7,%%xmm3 \n" // 1234 (32b) - "movdqa %%xmm2,%%xmm4 \n" - "movdqa %%xmm3,%%xmm5 \n" - "pshufd $0b10110001,%%xmm4,%%xmm4 \n" // 1032 (even, far) - "pshufd $0b10110001,%%xmm5,%%xmm5 \n" // 2143 (odd, far) - "paddd %%xmm2,%%xmm4 \n" // near+far (lo) - "paddd %%xmm3,%%xmm5 \n" // near+far (hi) - "paddd %%xmm2,%%xmm2 \n" // 2*near (lo) - "paddd %%xmm3,%%xmm3 \n" // 2*near (hi) - "paddd %%xmm4,%%xmm2 \n" // 3*near+far (2, lo) - "paddd %%xmm5,%%xmm3 \n" // 3*near+far (2, hi) - - "movdqa %%xmm0,%%xmm4 \n" - "movdqa %%xmm2,%%xmm5 \n" - "paddd %%xmm0,%%xmm4 \n" // 6*near+2*far (1, lo) - "paddd %%xmm6,%%xmm5 \n" // 3*near+far+8 (2, lo) - "paddd %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) - "paddd %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) - "psrld $4,%%xmm4 \n" // ^ div by 16 (1, lo) - - "movdqa %%xmm2,%%xmm5 \n" - "paddd %%xmm2,%%xmm5 \n" // 6*near+2*far (2, lo) - "paddd %%xmm6,%%xmm0 \n" // 3*near+far+8 (1, lo) - "paddd %%xmm2,%%xmm5 \n" // 9*near+3*far (2, lo) - "paddd %%xmm0,%%xmm5 \n" // 9 3 3 1 + 8 (2, lo) - "psrld $4,%%xmm5 \n" // ^ div by 16 (2, lo) - - "movdqa %%xmm1,%%xmm0 \n" - "movdqa %%xmm3,%%xmm2 \n" - "paddd %%xmm1,%%xmm0 \n" // 6*near+2*far (1, hi) - "paddd %%xmm6,%%xmm2 \n" // 3*near+far+8 (2, hi) - "paddd %%xmm1,%%xmm0 \n" // 9*near+3*far (1, hi) - "paddd %%xmm2,%%xmm0 \n" // 9 3 3 1 + 8 (1, hi) - "psrld $4,%%xmm0 \n" // ^ div by 16 (1, hi) - - "movdqa %%xmm3,%%xmm2 \n" - "paddd %%xmm3,%%xmm2 \n" // 6*near+2*far (2, hi) - "paddd %%xmm6,%%xmm1 \n" // 3*near+far+8 (1, hi) - "paddd %%xmm3,%%xmm2 \n" // 9*near+3*far (2, hi) - "paddd %%xmm1,%%xmm2 \n" // 9 3 3 1 + 8 (2, hi) - "psrld $4,%%xmm2 \n" // ^ div by 16 (2, hi) - - "packssdw %%xmm0,%%xmm4 \n" - "pshufd $0b11011000,%%xmm4,%%xmm4 \n" - "movdqu %%xmm4,(%1) \n" // store above - "packssdw %%xmm2,%%xmm5 \n" - "pshufd $0b11011000,%%xmm5,%%xmm5 \n" - "movdqu %%xmm5,(%1,%4,2) \n" // store below - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 4 pixel to 8 pixel - "sub $0x8,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_SSSE3 - -void ScaleRowUp2_Linear_SSSE3(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "pcmpeqw %%xmm4,%%xmm4 \n" - "psrlw $15,%%xmm4 \n" - "psllw $1,%%xmm4 \n" // all 2 - "movdqa %3,%%xmm3 \n" - - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" // 01234567 - "movq 1(%0),%%xmm1 \n" // 12345678 - "punpcklwd %%xmm0,%%xmm0 \n" // 0101232345456767 - "punpcklwd %%xmm1,%%xmm1 \n" // 1212343456567878 - "movdqa %%xmm0,%%xmm2 \n" - "punpckhdq %%xmm1,%%xmm2 \n" // 4545565667677878 - "punpckldq %%xmm1,%%xmm0 \n" // 0101121223233434 - "pmaddubsw %%xmm3,%%xmm2 \n" // 3*near+far (hi) - "pmaddubsw %%xmm3,%%xmm0 \n" // 3*near+far (lo) - "paddw %%xmm4,%%xmm0 \n" // 3*near+far+2 (lo) - "paddw %%xmm4,%%xmm2 \n" // 3*near+far+2 (hi) - "psrlw $2,%%xmm0 \n" // 3/4*near+1/4*far (lo) - "psrlw $2,%%xmm2 \n" // 3/4*near+1/4*far (hi) - "packuswb %%xmm2,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 8 sample to 16 sample - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "m"(kLinearMadd31) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_SSSE3 - -void ScaleRowUp2_Bilinear_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "pcmpeqw %%xmm6,%%xmm6 \n" - "psrlw $15,%%xmm6 \n" - "psllw $3,%%xmm6 \n" // all 8 - "movdqa %5,%%xmm7 \n" - - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" // 01234567 - "movq 1(%0),%%xmm1 \n" // 12345678 - "punpcklwd %%xmm0,%%xmm0 \n" // 0101232345456767 - "punpcklwd %%xmm1,%%xmm1 \n" // 1212343456567878 - "movdqa %%xmm0,%%xmm2 \n" - "punpckhdq %%xmm1,%%xmm2 \n" // 4545565667677878 - "punpckldq %%xmm1,%%xmm0 \n" // 0101121223233434 - "pmaddubsw %%xmm7,%%xmm2 \n" // 3*near+far (1, hi) - "pmaddubsw %%xmm7,%%xmm0 \n" // 3*near+far (1, lo) - - "movq (%0,%3),%%xmm1 \n" - "movq 1(%0,%3),%%xmm4 \n" - "punpcklwd %%xmm1,%%xmm1 \n" - "punpcklwd %%xmm4,%%xmm4 \n" - "movdqa %%xmm1,%%xmm3 \n" - "punpckhdq %%xmm4,%%xmm3 \n" - "punpckldq %%xmm4,%%xmm1 \n" - "pmaddubsw %%xmm7,%%xmm3 \n" // 3*near+far (2, hi) - "pmaddubsw %%xmm7,%%xmm1 \n" // 3*near+far (2, lo) - - // xmm0 xmm2 - // xmm1 xmm3 - - "movdqa %%xmm0,%%xmm4 \n" - "movdqa %%xmm1,%%xmm5 \n" - "paddw %%xmm0,%%xmm4 \n" // 6*near+2*far (1, lo) - "paddw %%xmm6,%%xmm5 \n" // 3*near+far+8 (2, lo) - "paddw %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) - "paddw %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) - "psrlw $4,%%xmm4 \n" // ^ div by 16 (1, lo) - - "movdqa %%xmm1,%%xmm5 \n" - "paddw %%xmm1,%%xmm5 \n" // 6*near+2*far (2, lo) - "paddw %%xmm6,%%xmm0 \n" // 3*near+far+8 (1, lo) - "paddw %%xmm1,%%xmm5 \n" // 9*near+3*far (2, lo) - "paddw %%xmm0,%%xmm5 \n" // 9 3 3 1 + 8 (2, lo) - "psrlw $4,%%xmm5 \n" // ^ div by 16 (2, lo) - - "movdqa %%xmm2,%%xmm0 \n" - "movdqa %%xmm3,%%xmm1 \n" - "paddw %%xmm2,%%xmm0 \n" // 6*near+2*far (1, hi) - "paddw %%xmm6,%%xmm1 \n" // 3*near+far+8 (2, hi) - "paddw %%xmm2,%%xmm0 \n" // 9*near+3*far (1, hi) - "paddw %%xmm1,%%xmm0 \n" // 9 3 3 1 + 8 (1, hi) - "psrlw $4,%%xmm0 \n" // ^ div by 16 (1, hi) - - "movdqa %%xmm3,%%xmm1 \n" - "paddw %%xmm3,%%xmm1 \n" // 6*near+2*far (2, hi) - "paddw %%xmm6,%%xmm2 \n" // 3*near+far+8 (1, hi) - "paddw %%xmm3,%%xmm1 \n" // 9*near+3*far (2, hi) - "paddw %%xmm2,%%xmm1 \n" // 9 3 3 1 + 8 (2, hi) - "psrlw $4,%%xmm1 \n" // ^ div by 16 (2, hi) - - "packuswb %%xmm0,%%xmm4 \n" - "movdqu %%xmm4,(%1) \n" // store above - "packuswb %%xmm1,%%xmm5 \n" - "movdqu %%xmm5,(%1,%4) \n" // store below - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 8 sample to 16 sample - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)), // %4 - "m"(kLinearMadd31) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_AVX2 - -void ScaleRowUp2_Linear_AVX2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "vpcmpeqw %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrlw $15,%%ymm4,%%ymm4 \n" - "vpsllw $1,%%ymm4,%%ymm4 \n" // all 2 - "vbroadcastf128 %3,%%ymm3 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%xmm0 \n" // 0123456789ABCDEF - "vmovdqu 1(%0),%%xmm1 \n" // 123456789ABCDEF0 - "vpermq $0b11011000,%%ymm0,%%ymm0 \n" - "vpermq $0b11011000,%%ymm1,%%ymm1 \n" - "vpunpcklwd %%ymm0,%%ymm0,%%ymm0 \n" - "vpunpcklwd %%ymm1,%%ymm1,%%ymm1 \n" - "vpunpckhdq %%ymm1,%%ymm0,%%ymm2 \n" - "vpunpckldq %%ymm1,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm3,%%ymm2,%%ymm1 \n" // 3*near+far (hi) - "vpmaddubsw %%ymm3,%%ymm0,%%ymm0 \n" // 3*near+far (lo) - "vpaddw %%ymm4,%%ymm0,%%ymm0 \n" // 3*near+far+2 (lo) - "vpaddw %%ymm4,%%ymm1,%%ymm1 \n" // 3*near+far+2 (hi) - "vpsrlw $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far (lo) - "vpsrlw $2,%%ymm1,%%ymm1 \n" // 3/4*near+1/4*far (hi) - "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 16 sample to 32 sample - "sub $0x20,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "m"(kLinearMadd31) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_AVX2 - -void ScaleRowUp2_Bilinear_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "vpcmpeqw %%ymm6,%%ymm6,%%ymm6 \n" - "vpsrlw $15,%%ymm6,%%ymm6 \n" - "vpsllw $3,%%ymm6,%%ymm6 \n" // all 8 - "vbroadcastf128 %5,%%ymm7 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%xmm0 \n" // 0123456789ABCDEF - "vmovdqu 1(%0),%%xmm1 \n" // 123456789ABCDEF0 - "vpermq $0b11011000,%%ymm0,%%ymm0 \n" - "vpermq $0b11011000,%%ymm1,%%ymm1 \n" - "vpunpcklwd %%ymm0,%%ymm0,%%ymm0 \n" - "vpunpcklwd %%ymm1,%%ymm1,%%ymm1 \n" - "vpunpckhdq %%ymm1,%%ymm0,%%ymm2 \n" - "vpunpckldq %%ymm1,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm7,%%ymm2,%%ymm1 \n" // 3*near+far (1, hi) - "vpmaddubsw %%ymm7,%%ymm0,%%ymm0 \n" // 3*near+far (1, lo) - - "vmovdqu (%0,%3),%%xmm2 \n" // 0123456789ABCDEF - "vmovdqu 1(%0,%3),%%xmm3 \n" // 123456789ABCDEF0 - "vpermq $0b11011000,%%ymm2,%%ymm2 \n" - "vpermq $0b11011000,%%ymm3,%%ymm3 \n" - "vpunpcklwd %%ymm2,%%ymm2,%%ymm2 \n" - "vpunpcklwd %%ymm3,%%ymm3,%%ymm3 \n" - "vpunpckhdq %%ymm3,%%ymm2,%%ymm4 \n" - "vpunpckldq %%ymm3,%%ymm2,%%ymm2 \n" - "vpmaddubsw %%ymm7,%%ymm4,%%ymm3 \n" // 3*near+far (2, hi) - "vpmaddubsw %%ymm7,%%ymm2,%%ymm2 \n" // 3*near+far (2, lo) - - // ymm0 ymm1 - // ymm2 ymm3 - - "vpaddw %%ymm0,%%ymm0,%%ymm4 \n" // 6*near+2*far (1, lo) - "vpaddw %%ymm6,%%ymm2,%%ymm5 \n" // 3*near+far+8 (2, lo) - "vpaddw %%ymm4,%%ymm0,%%ymm4 \n" // 9*near+3*far (1, lo) - "vpaddw %%ymm4,%%ymm5,%%ymm4 \n" // 9 3 3 1 + 8 (1, lo) - "vpsrlw $4,%%ymm4,%%ymm4 \n" // ^ div by 16 (1, lo) - - "vpaddw %%ymm2,%%ymm2,%%ymm5 \n" // 6*near+2*far (2, lo) - "vpaddw %%ymm6,%%ymm0,%%ymm0 \n" // 3*near+far+8 (1, lo) - "vpaddw %%ymm5,%%ymm2,%%ymm5 \n" // 9*near+3*far (2, lo) - "vpaddw %%ymm5,%%ymm0,%%ymm5 \n" // 9 3 3 1 + 8 (2, lo) - "vpsrlw $4,%%ymm5,%%ymm5 \n" // ^ div by 16 (2, lo) - - "vpaddw %%ymm1,%%ymm1,%%ymm0 \n" // 6*near+2*far (1, hi) - "vpaddw %%ymm6,%%ymm3,%%ymm2 \n" // 3*near+far+8 (2, hi) - "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 9*near+3*far (1, hi) - "vpaddw %%ymm0,%%ymm2,%%ymm0 \n" // 9 3 3 1 + 8 (1, hi) - "vpsrlw $4,%%ymm0,%%ymm0 \n" // ^ div by 16 (1, hi) - - "vpaddw %%ymm3,%%ymm3,%%ymm2 \n" // 6*near+2*far (2, hi) - "vpaddw %%ymm6,%%ymm1,%%ymm1 \n" // 3*near+far+8 (1, hi) - "vpaddw %%ymm2,%%ymm3,%%ymm2 \n" // 9*near+3*far (2, hi) - "vpaddw %%ymm2,%%ymm1,%%ymm2 \n" // 9 3 3 1 + 8 (2, hi) - "vpsrlw $4,%%ymm2,%%ymm2 \n" // ^ div by 16 (2, hi) - - "vpackuswb %%ymm0,%%ymm4,%%ymm4 \n" - "vmovdqu %%ymm4,(%1) \n" // store above - "vpackuswb %%ymm2,%%ymm5,%%ymm5 \n" - "vmovdqu %%ymm5,(%1,%4) \n" // store below - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 16 sample to 32 sample - "sub $0x20,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)), // %4 - "m"(kLinearMadd31) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_12_AVX2 - -void ScaleRowUp2_Linear_12_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width) { - asm volatile( - "vbroadcastf128 %3,%%ymm5 \n" - "vpcmpeqw %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrlw $15,%%ymm4,%%ymm4 \n" - "vpsllw $1,%%ymm4,%%ymm4 \n" // all 2 - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" // 0123456789ABCDEF (16b) - "vmovdqu 2(%0),%%ymm1 \n" // 123456789ABCDEF0 (16b) - - "vpermq $0b11011000,%%ymm0,%%ymm0 \n" // 012389AB4567CDEF - "vpermq $0b11011000,%%ymm1,%%ymm1 \n" // 12349ABC5678DEF0 - - "vpunpckhwd %%ymm1,%%ymm0,%%ymm2 \n" // 899AABBCCDDEEFF0 (near) - "vpunpcklwd %%ymm1,%%ymm0,%%ymm0 \n" // 0112233445566778 (near) - "vpshufb %%ymm5,%%ymm2,%%ymm3 \n" // 98A9BACBDCEDFE0F (far) - "vpshufb %%ymm5,%%ymm0,%%ymm1 \n" // 1021324354657687 (far) - - "vpaddw %%ymm4,%%ymm1,%%ymm1 \n" // far+2 - "vpaddw %%ymm4,%%ymm3,%%ymm3 \n" // far+2 - "vpaddw %%ymm0,%%ymm1,%%ymm1 \n" // near+far+2 - "vpaddw %%ymm2,%%ymm3,%%ymm3 \n" // near+far+2 - "vpaddw %%ymm0,%%ymm0,%%ymm0 \n" // 2*near - "vpaddw %%ymm2,%%ymm2,%%ymm2 \n" // 2*near - "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 3*near+far+2 - "vpaddw %%ymm2,%%ymm3,%%ymm2 \n" // 3*near+far+2 - - "vpsrlw $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far - "vpsrlw $2,%%ymm2,%%ymm2 \n" // 3/4*near+1/4*far - "vmovdqu %%ymm0,(%1) \n" - "vmovdqu %%ymm2,32(%1) \n" - - "lea 0x20(%0),%0 \n" - "lea 0x40(%1),%1 \n" // 16 sample to 32 sample - "sub $0x20,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "m"(kLinearShuffleFar) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_12_AVX2 - -void ScaleRowUp2_Bilinear_12_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "vbroadcastf128 %5,%%ymm5 \n" - "vpcmpeqw %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrlw $15,%%ymm4,%%ymm4 \n" - "vpsllw $3,%%ymm4,%%ymm4 \n" // all 8 - - LABELALIGN - "1: \n" - - "vmovdqu (%0),%%xmm0 \n" // 01234567 (16b) - "vmovdqu 2(%0),%%xmm1 \n" // 12345678 (16b) - "vpermq $0b11011000,%%ymm0,%%ymm0 \n" // 0123000045670000 - "vpermq $0b11011000,%%ymm1,%%ymm1 \n" // 1234000056780000 - "vpunpcklwd %%ymm1,%%ymm0,%%ymm0 \n" // 0112233445566778 (near) - "vpshufb %%ymm5,%%ymm0,%%ymm1 \n" // 1021324354657687 (far) - "vpaddw %%ymm0,%%ymm1,%%ymm1 \n" // near+far - "vpaddw %%ymm0,%%ymm0,%%ymm0 \n" // 2*near - "vpaddw %%ymm0,%%ymm1,%%ymm2 \n" // 3*near+far (1) - - "vmovdqu (%0,%3,2),%%xmm0 \n" // 01234567 (16b) - "vmovdqu 2(%0,%3,2),%%xmm1 \n" // 12345678 (16b) - "vpermq $0b11011000,%%ymm0,%%ymm0 \n" // 0123000045670000 - "vpermq $0b11011000,%%ymm1,%%ymm1 \n" // 1234000056780000 - "vpunpcklwd %%ymm1,%%ymm0,%%ymm0 \n" // 0112233445566778 (near) - "vpshufb %%ymm5,%%ymm0,%%ymm1 \n" // 1021324354657687 (far) - "vpaddw %%ymm0,%%ymm1,%%ymm1 \n" // near+far - "vpaddw %%ymm0,%%ymm0,%%ymm0 \n" // 2*near - "vpaddw %%ymm0,%%ymm1,%%ymm3 \n" // 3*near+far (2) - - "vpaddw %%ymm2,%%ymm2,%%ymm0 \n" // 6*near+2*far (1) - "vpaddw %%ymm4,%%ymm3,%%ymm1 \n" // 3*near+far+8 (2) - "vpaddw %%ymm0,%%ymm2,%%ymm0 \n" // 9*near+3*far (1) - "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 9 3 3 1 + 8 (1) - "vpsrlw $4,%%ymm0,%%ymm0 \n" // ^ div by 16 - "vmovdqu %%ymm0,(%1) \n" // store above - - "vpaddw %%ymm3,%%ymm3,%%ymm0 \n" // 6*near+2*far (2) - "vpaddw %%ymm4,%%ymm2,%%ymm1 \n" // 3*near+far+8 (1) - "vpaddw %%ymm0,%%ymm3,%%ymm0 \n" // 9*near+3*far (2) - "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 9 3 3 1 + 8 (2) - "vpsrlw $4,%%ymm0,%%ymm0 \n" // ^ div by 16 - "vmovdqu %%ymm0,(%1,%4,2) \n" // store below - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 8 sample to 16 sample - "sub $0x10,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)), // %4 - "m"(kLinearShuffleFar) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_LINEAR_16_AVX2 - -void ScaleRowUp2_Linear_16_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width) { - asm volatile( - "vpcmpeqd %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrld $31,%%ymm4,%%ymm4 \n" - "vpslld $1,%%ymm4,%%ymm4 \n" // all 2 - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%xmm0 \n" // 01234567 (16b, 1u1v) - "vmovdqu 2(%0),%%xmm1 \n" // 12345678 (16b, 1u1v) - - "vpmovzxwd %%xmm0,%%ymm0 \n" // 01234567 (32b, 1u1v) - "vpmovzxwd %%xmm1,%%ymm1 \n" // 12345678 (32b, 1u1v) - - "vpshufd $0b10110001,%%ymm0,%%ymm2 \n" // 10325476 (lo, far) - "vpshufd $0b10110001,%%ymm1,%%ymm3 \n" // 21436587 (hi, far) - - "vpaddd %%ymm4,%%ymm2,%%ymm2 \n" // far+2 (lo) - "vpaddd %%ymm4,%%ymm3,%%ymm3 \n" // far+2 (hi) - "vpaddd %%ymm0,%%ymm2,%%ymm2 \n" // near+far+2 (lo) - "vpaddd %%ymm1,%%ymm3,%%ymm3 \n" // near+far+2 (hi) - "vpaddd %%ymm0,%%ymm0,%%ymm0 \n" // 2*near (lo) - "vpaddd %%ymm1,%%ymm1,%%ymm1 \n" // 2*near (hi) - "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 3*near+far+2 (lo) - "vpaddd %%ymm1,%%ymm3,%%ymm1 \n" // 3*near+far+2 (hi) - - "vpsrld $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far (lo) - "vpsrld $2,%%ymm1,%%ymm1 \n" // 3/4*near+1/4*far (hi) - "vpackusdw %%ymm1,%%ymm0,%%ymm0 \n" - "vpshufd $0b11011000,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 8 pixel to 16 pixel - "sub $0x10,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); -} - -#endif - -#ifdef HAS_SCALEROWUP2_BILINEAR_16_AVX2 - -void ScaleRowUp2_Bilinear_16_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "vpcmpeqd %%ymm6,%%ymm6,%%ymm6 \n" - "vpsrld $31,%%ymm6,%%ymm6 \n" - "vpslld $3,%%ymm6,%%ymm6 \n" // all 8 - - LABELALIGN - "1: \n" - - "vmovdqu (%0),%%xmm0 \n" // 01234567 (16b, 1u1v) - "vmovdqu 2(%0),%%xmm1 \n" // 12345678 (16b, 1u1v) - "vpmovzxwd %%xmm0,%%ymm0 \n" // 01234567 (32b, 1u1v) - "vpmovzxwd %%xmm1,%%ymm1 \n" // 12345678 (32b, 1u1v) - "vpshufd $0b10110001,%%ymm0,%%ymm2 \n" // 10325476 (lo, far) - "vpshufd $0b10110001,%%ymm1,%%ymm3 \n" // 21436587 (hi, far) - "vpaddd %%ymm0,%%ymm2,%%ymm2 \n" // near+far (lo) - "vpaddd %%ymm1,%%ymm3,%%ymm3 \n" // near+far (hi) - "vpaddd %%ymm0,%%ymm0,%%ymm0 \n" // 2*near (lo) - "vpaddd %%ymm1,%%ymm1,%%ymm1 \n" // 2*near (hi) - "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 3*near+far (1, lo) - "vpaddd %%ymm1,%%ymm3,%%ymm1 \n" // 3*near+far (1, hi) - - "vmovdqu (%0,%3,2),%%xmm2 \n" // 01234567 (16b, 1u1v) - "vmovdqu 2(%0,%3,2),%%xmm3 \n" // 12345678 (16b, 1u1v) - "vpmovzxwd %%xmm2,%%ymm2 \n" // 01234567 (32b, 1u1v) - "vpmovzxwd %%xmm3,%%ymm3 \n" // 12345678 (32b, 1u1v) - "vpshufd $0b10110001,%%ymm2,%%ymm4 \n" // 10325476 (lo, far) - "vpshufd $0b10110001,%%ymm3,%%ymm5 \n" // 21436587 (hi, far) - "vpaddd %%ymm2,%%ymm4,%%ymm4 \n" // near+far (lo) - "vpaddd %%ymm3,%%ymm5,%%ymm5 \n" // near+far (hi) - "vpaddd %%ymm2,%%ymm2,%%ymm2 \n" // 2*near (lo) - "vpaddd %%ymm3,%%ymm3,%%ymm3 \n" // 2*near (hi) - "vpaddd %%ymm2,%%ymm4,%%ymm2 \n" // 3*near+far (2, lo) - "vpaddd %%ymm3,%%ymm5,%%ymm3 \n" // 3*near+far (2, hi) - - "vpaddd %%ymm0,%%ymm0,%%ymm4 \n" // 6*near+2*far (1, lo) - "vpaddd %%ymm6,%%ymm2,%%ymm5 \n" // 3*near+far+8 (2, lo) - "vpaddd %%ymm4,%%ymm0,%%ymm4 \n" // 9*near+3*far (1, lo) - "vpaddd %%ymm4,%%ymm5,%%ymm4 \n" // 9 3 3 1 + 8 (1, lo) - "vpsrld $4,%%ymm4,%%ymm4 \n" // ^ div by 16 (1, lo) - - "vpaddd %%ymm2,%%ymm2,%%ymm5 \n" // 6*near+2*far (2, lo) - "vpaddd %%ymm6,%%ymm0,%%ymm0 \n" // 3*near+far+8 (1, lo) - "vpaddd %%ymm5,%%ymm2,%%ymm5 \n" // 9*near+3*far (2, lo) - "vpaddd %%ymm5,%%ymm0,%%ymm5 \n" // 9 3 3 1 + 8 (2, lo) - "vpsrld $4,%%ymm5,%%ymm5 \n" // ^ div by 16 (2, lo) - - "vpaddd %%ymm1,%%ymm1,%%ymm0 \n" // 6*near+2*far (1, hi) - "vpaddd %%ymm6,%%ymm3,%%ymm2 \n" // 3*near+far+8 (2, hi) - "vpaddd %%ymm0,%%ymm1,%%ymm0 \n" // 9*near+3*far (1, hi) - "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 9 3 3 1 + 8 (1, hi) - "vpsrld $4,%%ymm0,%%ymm0 \n" // ^ div by 16 (1, hi) - - "vpaddd %%ymm3,%%ymm3,%%ymm2 \n" // 6*near+2*far (2, hi) - "vpaddd %%ymm6,%%ymm1,%%ymm1 \n" // 3*near+far+8 (1, hi) - "vpaddd %%ymm2,%%ymm3,%%ymm2 \n" // 9*near+3*far (2, hi) - "vpaddd %%ymm2,%%ymm1,%%ymm2 \n" // 9 3 3 1 + 8 (2, hi) - "vpsrld $4,%%ymm2,%%ymm2 \n" // ^ div by 16 (2, hi) - - "vpackusdw %%ymm0,%%ymm4,%%ymm4 \n" - "vpshufd $0b11011000,%%ymm4,%%ymm4 \n" - "vmovdqu %%ymm4,(%1) \n" // store above - "vpackusdw %%ymm2,%%ymm5,%%ymm5 \n" - "vpshufd $0b11011000,%%ymm5,%%ymm5 \n" - "vmovdqu %%ymm5,(%1,%4,2) \n" // store below - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 8 pixel to 16 pixel - "sub $0x10,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6"); -} - -#endif - -// Reads 16xN bytes and produces 16 shorts at a time. -void ScaleAddRow_SSE2(const uint8_t *src_ptr, - uint16_t *dst_ptr, - int src_width) { - asm volatile("pxor %%xmm5,%%xmm5 \n" - - // 16 pixel loop. - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm3 \n" - "lea 0x10(%0),%0 \n" // src_ptr += 16 - "movdqu (%1),%%xmm0 \n" - "movdqu 0x10(%1),%%xmm1 \n" - "movdqa %%xmm3,%%xmm2 \n" - "punpcklbw %%xmm5,%%xmm2 \n" - "punpckhbw %%xmm5,%%xmm3 \n" - "paddusw %%xmm2,%%xmm0 \n" - "paddusw %%xmm3,%%xmm1 \n" - "movdqu %%xmm0,(%1) \n" - "movdqu %%xmm1,0x10(%1) \n" - "lea 0x20(%1),%1 \n" - "sub $0x10,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(src_width) // %2 - : - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm5"); -} - -#ifdef HAS_SCALEADDROW_AVX2 - -// Reads 32 bytes and accumulates to 32 shorts at a time. -void ScaleAddRow_AVX2(const uint8_t *src_ptr, - uint16_t *dst_ptr, - int src_width) { - asm volatile("vpxor %%ymm5,%%ymm5,%%ymm5 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm3 \n" - "lea 0x20(%0),%0 \n" // src_ptr += 32 - "vpermq $0xd8,%%ymm3,%%ymm3 \n" - "vpunpcklbw %%ymm5,%%ymm3,%%ymm2 \n" - "vpunpckhbw %%ymm5,%%ymm3,%%ymm3 \n" - "vpaddusw (%1),%%ymm2,%%ymm0 \n" - "vpaddusw 0x20(%1),%%ymm3,%%ymm1 \n" - "vmovdqu %%ymm0,(%1) \n" - "vmovdqu %%ymm1,0x20(%1) \n" - "lea 0x40(%1),%1 \n" - "sub $0x20,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(src_width) // %2 - : - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm5"); -} - -#endif // HAS_SCALEADDROW_AVX2 - -// Constant for making pixels signed to avoid pmaddubsw -// saturation. -static const uvec8 kFsub80 = {0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, - 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80, 0x80}; - -// Constant for making pixels unsigned and adding .5 for rounding. -static const uvec16 kFadd40 = {0x4040, 0x4040, 0x4040, 0x4040, - 0x4040, 0x4040, 0x4040, 0x4040}; - -// Bilinear column filtering. SSSE3 version. -void ScaleFilterCols_SSSE3(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx) { - intptr_t x0, x1, temp_pixel; - asm volatile( - "movd %6,%%xmm2 \n" - "movd %7,%%xmm3 \n" - "movl $0x04040000,%k2 \n" - "movd %k2,%%xmm5 \n" - "pcmpeqb %%xmm6,%%xmm6 \n" - "psrlw $0x9,%%xmm6 \n" // 0x007f007f - "pcmpeqb %%xmm7,%%xmm7 \n" - "psrlw $15,%%xmm7 \n" // 0x00010001 - - "pextrw $0x1,%%xmm2,%k3 \n" - "subl $0x2,%5 \n" - "jl 29f \n" - "movdqa %%xmm2,%%xmm0 \n" - "paddd %%xmm3,%%xmm0 \n" - "punpckldq %%xmm0,%%xmm2 \n" - "punpckldq %%xmm3,%%xmm3 \n" - "paddd %%xmm3,%%xmm3 \n" - "pextrw $0x3,%%xmm2,%k4 \n" - - LABELALIGN - "2: \n" - "movdqa %%xmm2,%%xmm1 \n" - "paddd %%xmm3,%%xmm2 \n" - "movzwl 0x00(%1,%3,1),%k2 \n" - "movd %k2,%%xmm0 \n" - "psrlw $0x9,%%xmm1 \n" - "movzwl 0x00(%1,%4,1),%k2 \n" - "movd %k2,%%xmm4 \n" - "pshufb %%xmm5,%%xmm1 \n" - "punpcklwd %%xmm4,%%xmm0 \n" - "psubb %8,%%xmm0 \n" // make pixels signed. - "pxor %%xmm6,%%xmm1 \n" // 128 - f = (f ^ 127 ) + - // 1 - "paddusb %%xmm7,%%xmm1 \n" - "pmaddubsw %%xmm0,%%xmm1 \n" - "pextrw $0x1,%%xmm2,%k3 \n" - "pextrw $0x3,%%xmm2,%k4 \n" - "paddw %9,%%xmm1 \n" // make pixels unsigned. - "psrlw $0x7,%%xmm1 \n" - "packuswb %%xmm1,%%xmm1 \n" - "movd %%xmm1,%k2 \n" - "mov %w2,(%0) \n" - "lea 0x2(%0),%0 \n" - "subl $0x2,%5 \n" - "jge 2b \n" - - LABELALIGN - "29: \n" - "addl $0x1,%5 \n" - "jl 99f \n" - "movzwl 0x00(%1,%3,1),%k2 \n" - "movd %k2,%%xmm0 \n" - "psrlw $0x9,%%xmm2 \n" - "pshufb %%xmm5,%%xmm2 \n" - "psubb %8,%%xmm0 \n" // make pixels signed. - "pxor %%xmm6,%%xmm2 \n" - "paddusb %%xmm7,%%xmm2 \n" - "pmaddubsw %%xmm0,%%xmm2 \n" - "paddw %9,%%xmm2 \n" // make pixels unsigned. - "psrlw $0x7,%%xmm2 \n" - "packuswb %%xmm2,%%xmm2 \n" - "movd %%xmm2,%k2 \n" - "mov %b2,(%0) \n" - "99: \n" - : "+r"(dst_ptr), // %0 - "+r"(src_ptr), // %1 - "=&a"(temp_pixel), // %2 - "=&r"(x0), // %3 - "=&r"(x1), // %4 -#if defined(__x86_64__) - "+rm"(dst_width) // %5 -#else - "+m"(dst_width) // %5 -#endif - : "rm"(x), // %6 - "rm"(dx), // %7 -#if defined(__x86_64__) - "x"(kFsub80), // %8 - "x"(kFadd40) // %9 -#else - "m"(kFsub80), // %8 - "m"(kFadd40) // %9 -#endif - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -// Reads 4 pixels, duplicates them and writes 8 pixels. -// Alignment requirement: src_argb 16 byte aligned, dst_argb 16 byte aligned. -void ScaleColsUp2_SSE2(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx) { - (void) x; - (void) dx; - asm volatile(LABELALIGN - "1: \n" - "movdqu (%1),%%xmm0 \n" - "lea 0x10(%1),%1 \n" - "movdqa %%xmm0,%%xmm1 \n" - "punpcklbw %%xmm0,%%xmm0 \n" - "punpckhbw %%xmm1,%%xmm1 \n" - "movdqu %%xmm0,(%0) \n" - "movdqu %%xmm1,0x10(%0) \n" - "lea 0x20(%0),%0 \n" - "sub $0x20,%2 \n" - "jg 1b \n" - - : "+r"(dst_ptr), // %0 - "+r"(src_ptr), // %1 - "+r"(dst_width) // %2 - ::"memory", - "cc", "xmm0", "xmm1"); -} - -// Divide num by div and return as 16.16 fixed point result. -int FixedDiv_X86(int num, int div) { - asm volatile( - "cdq \n" - "shld $0x10,%%eax,%%edx \n" - "shl $0x10,%%eax \n" - "idiv %1 \n" - "mov %0, %%eax \n" - : "+a"(num) // %0 - : "c"(div) // %1 - : "memory", "cc", "edx"); - return num; -} - -// Divide num - 1 by div - 1 and return as 16.16 fixed point result. -int FixedDiv1_X86(int num, int div) { - asm volatile( - "cdq \n" - "shld $0x10,%%eax,%%edx \n" - "shl $0x10,%%eax \n" - "sub $0x10001,%%eax \n" - "sbb $0x0,%%edx \n" - "sub $0x1,%1 \n" - "idiv %1 \n" - "mov %0, %%eax \n" - : "+a"(num) // %0 - : "c"(div) // %1 - : "memory", "cc", "edx"); - return num; -} - -#if defined(HAS_SCALEUVROWDOWN2BOX_SSSE3) || \ - defined(HAS_SCALEUVROWDOWN2BOX_AVX2) - -// Shuffle table for splitting UV into upper and lower part of register. -static const uvec8 kShuffleSplitUV = {0u, 2u, 4u, 6u, 8u, 10u, 12u, 14u, - 1u, 3u, 5u, 7u, 9u, 11u, 13u, 15u}; -static const uvec8 kShuffleMergeUV = {0u, 8u, 2u, 10u, 4u, 12u, - 6u, 14u, 0x80, 0x80, 0x80, 0x80, - 0x80, 0x80, 0x80, 0x80}; -#endif - -#ifdef HAS_SCALEUVROWDOWN2BOX_SSSE3 - -void ScaleUVRowDown2Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "pcmpeqb %%xmm4,%%xmm4 \n" // 01010101 - "psrlw $0xf,%%xmm4 \n" - "packuswb %%xmm4,%%xmm4 \n" - "pxor %%xmm5, %%xmm5 \n" // zero - "movdqa %4,%%xmm1 \n" // split shuffler - "movdqa %5,%%xmm3 \n" // merge shuffler - - LABELALIGN - "1: \n" - "movdqu (%0),%%xmm0 \n" // 8 UV row 0 - "movdqu 0x00(%0,%3,1),%%xmm2 \n" // 8 UV row 1 - "lea 0x10(%0),%0 \n" - "pshufb %%xmm1,%%xmm0 \n" // uuuuvvvv - "pshufb %%xmm1,%%xmm2 \n" - "pmaddubsw %%xmm4,%%xmm0 \n" // horizontal add - "pmaddubsw %%xmm4,%%xmm2 \n" - "paddw %%xmm2,%%xmm0 \n" // vertical add - "psrlw $0x1,%%xmm0 \n" // round - "pavgw %%xmm5,%%xmm0 \n" - "pshufb %%xmm3,%%xmm0 \n" // merge uv - "movq %%xmm0,(%1) \n" - "lea 0x8(%1),%1 \n" // 4 UV - "sub $0x4,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "m"(kShuffleSplitUV), // %4 - "m"(kShuffleMergeUV) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif // HAS_SCALEUVROWDOWN2BOX_SSSE3 - -#ifdef HAS_SCALEUVROWDOWN2BOX_AVX2 - -void ScaleUVRowDown2Box_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "vpcmpeqb %%ymm4,%%ymm4,%%ymm4 \n" // 01010101 - "vpsrlw $0xf,%%ymm4,%%ymm4 \n" - "vpackuswb %%ymm4,%%ymm4,%%ymm4 \n" - "vpxor %%ymm5,%%ymm5,%%ymm5 \n" // zero - "vbroadcastf128 %4,%%ymm1 \n" // split shuffler - "vbroadcastf128 %5,%%ymm3 \n" // merge shuffler - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%ymm0 \n" // 16 UV row 0 - "vmovdqu 0x00(%0,%3,1),%%ymm2 \n" // 16 UV row 1 - "lea 0x20(%0),%0 \n" - "vpshufb %%ymm1,%%ymm0,%%ymm0 \n" // uuuuvvvv - "vpshufb %%ymm1,%%ymm2,%%ymm2 \n" - "vpmaddubsw %%ymm4,%%ymm0,%%ymm0 \n" // horizontal add - "vpmaddubsw %%ymm4,%%ymm2,%%ymm2 \n" - "vpaddw %%ymm2,%%ymm0,%%ymm0 \n" // vertical add - "vpsrlw $0x1,%%ymm0,%%ymm0 \n" // round - "vpavgw %%ymm5,%%ymm0,%%ymm0 \n" - "vpshufb %%ymm3,%%ymm0,%%ymm0 \n" // merge uv - "vpermq $0xd8,%%ymm0,%%ymm0 \n" // combine qwords - "vmovdqu %%xmm0,(%1) \n" - "lea 0x10(%1),%1 \n" // 8 UV - "sub $0x8,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "m"(kShuffleSplitUV), // %4 - "m"(kShuffleMergeUV) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif // HAS_SCALEUVROWDOWN2BOX_AVX2 - -static const uvec8 kUVLinearMadd31 = {3, 1, 3, 1, 1, 3, 1, 3, - 3, 1, 3, 1, 1, 3, 1, 3}; - -#ifdef HAS_SCALEUVROWUP2_LINEAR_SSSE3 - -void ScaleUVRowUp2_Linear_SSSE3(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "pcmpeqw %%xmm4,%%xmm4 \n" - "psrlw $15,%%xmm4 \n" - "psllw $1,%%xmm4 \n" // all 2 - "movdqa %3,%%xmm3 \n" - - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" // 00112233 (1u1v) - "movq 2(%0),%%xmm1 \n" // 11223344 (1u1v) - "punpcklbw %%xmm1,%%xmm0 \n" // 0101121223233434 (2u2v) - "movdqa %%xmm0,%%xmm2 \n" - "punpckhdq %%xmm0,%%xmm2 \n" // 2323232334343434 (2u2v) - "punpckldq %%xmm0,%%xmm0 \n" // 0101010112121212 (2u2v) - "pmaddubsw %%xmm3,%%xmm2 \n" // 3*near+far (1u1v16, hi) - "pmaddubsw %%xmm3,%%xmm0 \n" // 3*near+far (1u1v16, lo) - "paddw %%xmm4,%%xmm0 \n" // 3*near+far+2 (lo) - "paddw %%xmm4,%%xmm2 \n" // 3*near+far+2 (hi) - "psrlw $2,%%xmm0 \n" // 3/4*near+1/4*far (lo) - "psrlw $2,%%xmm2 \n" // 3/4*near+1/4*far (hi) - "packuswb %%xmm2,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 4 uv to 8 uv - "sub $0x8,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "m"(kUVLinearMadd31) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6"); -} - -#endif - -#ifdef HAS_SCALEUVROWUP2_BILINEAR_SSSE3 - -void ScaleUVRowUp2_Bilinear_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "pcmpeqw %%xmm6,%%xmm6 \n" - "psrlw $15,%%xmm6 \n" - "psllw $3,%%xmm6 \n" // all 8 - "movdqa %5,%%xmm7 \n" - - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" // 00112233 (1u1v) - "movq 2(%0),%%xmm1 \n" // 11223344 (1u1v) - "punpcklbw %%xmm1,%%xmm0 \n" // 0101121223233434 (2u2v) - "movdqa %%xmm0,%%xmm2 \n" - "punpckhdq %%xmm0,%%xmm2 \n" // 2323232334343434 (2u2v) - "punpckldq %%xmm0,%%xmm0 \n" // 0101010112121212 (2u2v) - "pmaddubsw %%xmm7,%%xmm2 \n" // 3*near+far (1u1v16, hi) - "pmaddubsw %%xmm7,%%xmm0 \n" // 3*near+far (1u1v16, lo) - - "movq (%0,%3),%%xmm1 \n" - "movq 2(%0,%3),%%xmm4 \n" - "punpcklbw %%xmm4,%%xmm1 \n" - "movdqa %%xmm1,%%xmm3 \n" - "punpckhdq %%xmm1,%%xmm3 \n" - "punpckldq %%xmm1,%%xmm1 \n" - "pmaddubsw %%xmm7,%%xmm3 \n" // 3*near+far (2, hi) - "pmaddubsw %%xmm7,%%xmm1 \n" // 3*near+far (2, lo) - - // xmm0 xmm2 - // xmm1 xmm3 - - "movdqa %%xmm0,%%xmm4 \n" - "movdqa %%xmm1,%%xmm5 \n" - "paddw %%xmm0,%%xmm4 \n" // 6*near+2*far (1, lo) - "paddw %%xmm6,%%xmm5 \n" // 3*near+far+8 (2, lo) - "paddw %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) - "paddw %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) - "psrlw $4,%%xmm4 \n" // ^ div by 16 (1, lo) - - "movdqa %%xmm1,%%xmm5 \n" - "paddw %%xmm1,%%xmm5 \n" // 6*near+2*far (2, lo) - "paddw %%xmm6,%%xmm0 \n" // 3*near+far+8 (1, lo) - "paddw %%xmm1,%%xmm5 \n" // 9*near+3*far (2, lo) - "paddw %%xmm0,%%xmm5 \n" // 9 3 3 1 + 8 (2, lo) - "psrlw $4,%%xmm5 \n" // ^ div by 16 (2, lo) - - "movdqa %%xmm2,%%xmm0 \n" - "movdqa %%xmm3,%%xmm1 \n" - "paddw %%xmm2,%%xmm0 \n" // 6*near+2*far (1, hi) - "paddw %%xmm6,%%xmm1 \n" // 3*near+far+8 (2, hi) - "paddw %%xmm2,%%xmm0 \n" // 9*near+3*far (1, hi) - "paddw %%xmm1,%%xmm0 \n" // 9 3 3 1 + 8 (1, hi) - "psrlw $4,%%xmm0 \n" // ^ div by 16 (1, hi) - - "movdqa %%xmm3,%%xmm1 \n" - "paddw %%xmm3,%%xmm1 \n" // 6*near+2*far (2, hi) - "paddw %%xmm6,%%xmm2 \n" // 3*near+far+8 (1, hi) - "paddw %%xmm3,%%xmm1 \n" // 9*near+3*far (2, hi) - "paddw %%xmm2,%%xmm1 \n" // 9 3 3 1 + 8 (2, hi) - "psrlw $4,%%xmm1 \n" // ^ div by 16 (2, hi) - - "packuswb %%xmm0,%%xmm4 \n" - "movdqu %%xmm4,(%1) \n" // store above - "packuswb %%xmm1,%%xmm5 \n" - "movdqu %%xmm5,(%1,%4) \n" // store below - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 4 uv to 8 uv - "sub $0x8,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)), // %4 - "m"(kUVLinearMadd31) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif - -#ifdef HAS_SCALEUVROWUP2_LINEAR_AVX2 - -void ScaleUVRowUp2_Linear_AVX2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width) { - asm volatile( - "vpcmpeqw %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrlw $15,%%ymm4,%%ymm4 \n" - "vpsllw $1,%%ymm4,%%ymm4 \n" // all 2 - "vbroadcastf128 %3,%%ymm3 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%xmm0 \n" - "vmovdqu 2(%0),%%xmm1 \n" - "vpermq $0b11011000,%%ymm0,%%ymm0 \n" - "vpermq $0b11011000,%%ymm1,%%ymm1 \n" - "vpunpcklbw %%ymm1,%%ymm0,%%ymm0 \n" - "vpunpckhdq %%ymm0,%%ymm0,%%ymm2 \n" - "vpunpckldq %%ymm0,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm3,%%ymm2,%%ymm1 \n" // 3*near+far (hi) - "vpmaddubsw %%ymm3,%%ymm0,%%ymm0 \n" // 3*near+far (lo) - "vpaddw %%ymm4,%%ymm0,%%ymm0 \n" // 3*near+far+2 (lo) - "vpaddw %%ymm4,%%ymm1,%%ymm1 \n" // 3*near+far+2 (hi) - "vpsrlw $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far (lo) - "vpsrlw $2,%%ymm1,%%ymm1 \n" // 3/4*near+1/4*far (hi) - "vpackuswb %%ymm1,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 8 uv to 16 uv - "sub $0x10,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "m"(kUVLinearMadd31) // %3 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); -} - -#endif - -#ifdef HAS_SCALEUVROWUP2_BILINEAR_AVX2 - -void ScaleUVRowUp2_Bilinear_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "vpcmpeqw %%ymm6,%%ymm6,%%ymm6 \n" - "vpsrlw $15,%%ymm6,%%ymm6 \n" - "vpsllw $3,%%ymm6,%%ymm6 \n" // all 8 - "vbroadcastf128 %5,%%ymm7 \n" - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%xmm0 \n" - "vmovdqu 2(%0),%%xmm1 \n" - "vpermq $0b11011000,%%ymm0,%%ymm0 \n" - "vpermq $0b11011000,%%ymm1,%%ymm1 \n" - "vpunpcklbw %%ymm1,%%ymm0,%%ymm0 \n" - "vpunpckhdq %%ymm0,%%ymm0,%%ymm2 \n" - "vpunpckldq %%ymm0,%%ymm0,%%ymm0 \n" - "vpmaddubsw %%ymm7,%%ymm2,%%ymm1 \n" // 3*near+far (1, hi) - "vpmaddubsw %%ymm7,%%ymm0,%%ymm0 \n" // 3*near+far (1, lo) - - "vmovdqu (%0,%3),%%xmm2 \n" // 0123456789ABCDEF - "vmovdqu 2(%0,%3),%%xmm3 \n" // 123456789ABCDEF0 - "vpermq $0b11011000,%%ymm2,%%ymm2 \n" - "vpermq $0b11011000,%%ymm3,%%ymm3 \n" - "vpunpcklbw %%ymm3,%%ymm2,%%ymm2 \n" - "vpunpckhdq %%ymm2,%%ymm2,%%ymm4 \n" - "vpunpckldq %%ymm2,%%ymm2,%%ymm2 \n" - "vpmaddubsw %%ymm7,%%ymm4,%%ymm3 \n" // 3*near+far (2, hi) - "vpmaddubsw %%ymm7,%%ymm2,%%ymm2 \n" // 3*near+far (2, lo) - - // ymm0 ymm1 - // ymm2 ymm3 - - "vpaddw %%ymm0,%%ymm0,%%ymm4 \n" // 6*near+2*far (1, lo) - "vpaddw %%ymm6,%%ymm2,%%ymm5 \n" // 3*near+far+8 (2, lo) - "vpaddw %%ymm4,%%ymm0,%%ymm4 \n" // 9*near+3*far (1, lo) - "vpaddw %%ymm4,%%ymm5,%%ymm4 \n" // 9 3 3 1 + 8 (1, lo) - "vpsrlw $4,%%ymm4,%%ymm4 \n" // ^ div by 16 (1, lo) - - "vpaddw %%ymm2,%%ymm2,%%ymm5 \n" // 6*near+2*far (2, lo) - "vpaddw %%ymm6,%%ymm0,%%ymm0 \n" // 3*near+far+8 (1, lo) - "vpaddw %%ymm5,%%ymm2,%%ymm5 \n" // 9*near+3*far (2, lo) - "vpaddw %%ymm5,%%ymm0,%%ymm5 \n" // 9 3 3 1 + 8 (2, lo) - "vpsrlw $4,%%ymm5,%%ymm5 \n" // ^ div by 16 (2, lo) - - "vpaddw %%ymm1,%%ymm1,%%ymm0 \n" // 6*near+2*far (1, hi) - "vpaddw %%ymm6,%%ymm3,%%ymm2 \n" // 3*near+far+8 (2, hi) - "vpaddw %%ymm0,%%ymm1,%%ymm0 \n" // 9*near+3*far (1, hi) - "vpaddw %%ymm0,%%ymm2,%%ymm0 \n" // 9 3 3 1 + 8 (1, hi) - "vpsrlw $4,%%ymm0,%%ymm0 \n" // ^ div by 16 (1, hi) - - "vpaddw %%ymm3,%%ymm3,%%ymm2 \n" // 6*near+2*far (2, hi) - "vpaddw %%ymm6,%%ymm1,%%ymm1 \n" // 3*near+far+8 (1, hi) - "vpaddw %%ymm2,%%ymm3,%%ymm2 \n" // 9*near+3*far (2, hi) - "vpaddw %%ymm2,%%ymm1,%%ymm2 \n" // 9 3 3 1 + 8 (2, hi) - "vpsrlw $4,%%ymm2,%%ymm2 \n" // ^ div by 16 (2, hi) - - "vpackuswb %%ymm0,%%ymm4,%%ymm4 \n" - "vmovdqu %%ymm4,(%1) \n" // store above - "vpackuswb %%ymm2,%%ymm5,%%ymm5 \n" - "vmovdqu %%ymm5,(%1,%4) \n" // store below - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 8 uv to 16 uv - "sub $0x10,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)), // %4 - "m"(kUVLinearMadd31) // %5 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif - -#ifdef HAS_SCALEUVROWUP2_LINEAR_16_SSE41 - -void ScaleUVRowUp2_Linear_16_SSE41(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width) { - asm volatile( - "pxor %%xmm5,%%xmm5 \n" - "pcmpeqd %%xmm4,%%xmm4 \n" - "psrld $31,%%xmm4 \n" - "pslld $1,%%xmm4 \n" // all 2 - - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" // 0011 (16b, 1u1v) - "movq 4(%0),%%xmm1 \n" // 1122 (16b, 1u1v) - - "punpcklwd %%xmm5,%%xmm0 \n" // 0011 (32b, 1u1v) - "punpcklwd %%xmm5,%%xmm1 \n" // 1122 (32b, 1u1v) - - "movdqa %%xmm0,%%xmm2 \n" - "movdqa %%xmm1,%%xmm3 \n" - - "pshufd $0b01001110,%%xmm2,%%xmm2 \n" // 1100 (lo, far) - "pshufd $0b01001110,%%xmm3,%%xmm3 \n" // 2211 (hi, far) - - "paddd %%xmm4,%%xmm2 \n" // far+2 (lo) - "paddd %%xmm4,%%xmm3 \n" // far+2 (hi) - "paddd %%xmm0,%%xmm2 \n" // near+far+2 (lo) - "paddd %%xmm1,%%xmm3 \n" // near+far+2 (hi) - "paddd %%xmm0,%%xmm0 \n" // 2*near (lo) - "paddd %%xmm1,%%xmm1 \n" // 2*near (hi) - "paddd %%xmm2,%%xmm0 \n" // 3*near+far+2 (lo) - "paddd %%xmm3,%%xmm1 \n" // 3*near+far+2 (hi) - - "psrld $2,%%xmm0 \n" // 3/4*near+1/4*far (lo) - "psrld $2,%%xmm1 \n" // 3/4*near+1/4*far (hi) - "packusdw %%xmm1,%%xmm0 \n" - "movdqu %%xmm0,(%1) \n" - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 2 uv to 4 uv - "sub $0x4,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5"); -} - -#endif - -#ifdef HAS_SCALEUVROWUP2_BILINEAR_16_SSE41 - -void ScaleUVRowUp2_Bilinear_16_SSE41(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "pxor %%xmm7,%%xmm7 \n" - "pcmpeqd %%xmm6,%%xmm6 \n" - "psrld $31,%%xmm6 \n" - "pslld $3,%%xmm6 \n" // all 8 - - LABELALIGN - "1: \n" - "movq (%0),%%xmm0 \n" // 0011 (16b, 1u1v) - "movq 4(%0),%%xmm1 \n" // 1122 (16b, 1u1v) - "punpcklwd %%xmm7,%%xmm0 \n" // 0011 (near) (32b, 1u1v) - "punpcklwd %%xmm7,%%xmm1 \n" // 1122 (near) (32b, 1u1v) - "movdqa %%xmm0,%%xmm2 \n" - "movdqa %%xmm1,%%xmm3 \n" - "pshufd $0b01001110,%%xmm2,%%xmm2 \n" // 1100 (far) (1, lo) - "pshufd $0b01001110,%%xmm3,%%xmm3 \n" // 2211 (far) (1, hi) - "paddd %%xmm0,%%xmm2 \n" // near+far (1, lo) - "paddd %%xmm1,%%xmm3 \n" // near+far (1, hi) - "paddd %%xmm0,%%xmm0 \n" // 2*near (1, lo) - "paddd %%xmm1,%%xmm1 \n" // 2*near (1, hi) - "paddd %%xmm2,%%xmm0 \n" // 3*near+far (1, lo) - "paddd %%xmm3,%%xmm1 \n" // 3*near+far (1, hi) - - "movq (%0,%3,2),%%xmm2 \n" - "movq 4(%0,%3,2),%%xmm3 \n" - "punpcklwd %%xmm7,%%xmm2 \n" - "punpcklwd %%xmm7,%%xmm3 \n" - "movdqa %%xmm2,%%xmm4 \n" - "movdqa %%xmm3,%%xmm5 \n" - "pshufd $0b01001110,%%xmm4,%%xmm4 \n" // 1100 (far) (2, lo) - "pshufd $0b01001110,%%xmm5,%%xmm5 \n" // 2211 (far) (2, hi) - "paddd %%xmm2,%%xmm4 \n" // near+far (2, lo) - "paddd %%xmm3,%%xmm5 \n" // near+far (2, hi) - "paddd %%xmm2,%%xmm2 \n" // 2*near (2, lo) - "paddd %%xmm3,%%xmm3 \n" // 2*near (2, hi) - "paddd %%xmm4,%%xmm2 \n" // 3*near+far (2, lo) - "paddd %%xmm5,%%xmm3 \n" // 3*near+far (2, hi) - - "movdqa %%xmm0,%%xmm4 \n" - "movdqa %%xmm2,%%xmm5 \n" - "paddd %%xmm0,%%xmm4 \n" // 6*near+2*far (1, lo) - "paddd %%xmm6,%%xmm5 \n" // 3*near+far+8 (2, lo) - "paddd %%xmm0,%%xmm4 \n" // 9*near+3*far (1, lo) - "paddd %%xmm5,%%xmm4 \n" // 9 3 3 1 + 8 (1, lo) - "psrld $4,%%xmm4 \n" // ^ div by 16 (1, lo) - - "movdqa %%xmm2,%%xmm5 \n" - "paddd %%xmm2,%%xmm5 \n" // 6*near+2*far (2, lo) - "paddd %%xmm6,%%xmm0 \n" // 3*near+far+8 (1, lo) - "paddd %%xmm2,%%xmm5 \n" // 9*near+3*far (2, lo) - "paddd %%xmm0,%%xmm5 \n" // 9 3 3 1 + 8 (2, lo) - "psrld $4,%%xmm5 \n" // ^ div by 16 (2, lo) - - "movdqa %%xmm1,%%xmm0 \n" - "movdqa %%xmm3,%%xmm2 \n" - "paddd %%xmm1,%%xmm0 \n" // 6*near+2*far (1, hi) - "paddd %%xmm6,%%xmm2 \n" // 3*near+far+8 (2, hi) - "paddd %%xmm1,%%xmm0 \n" // 9*near+3*far (1, hi) - "paddd %%xmm2,%%xmm0 \n" // 9 3 3 1 + 8 (1, hi) - "psrld $4,%%xmm0 \n" // ^ div by 16 (1, hi) - - "movdqa %%xmm3,%%xmm2 \n" - "paddd %%xmm3,%%xmm2 \n" // 6*near+2*far (2, hi) - "paddd %%xmm6,%%xmm1 \n" // 3*near+far+8 (1, hi) - "paddd %%xmm3,%%xmm2 \n" // 9*near+3*far (2, hi) - "paddd %%xmm1,%%xmm2 \n" // 9 3 3 1 + 8 (2, hi) - "psrld $4,%%xmm2 \n" // ^ div by 16 (2, hi) - - "packusdw %%xmm0,%%xmm4 \n" - "movdqu %%xmm4,(%1) \n" // store above - "packusdw %%xmm2,%%xmm5 \n" - "movdqu %%xmm5,(%1,%4,2) \n" // store below - - "lea 0x8(%0),%0 \n" - "lea 0x10(%1),%1 \n" // 2 uv to 4 uv - "sub $0x4,%2 \n" - "jg 1b \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6", - "xmm7"); -} - -#endif - -#ifdef HAS_SCALEUVROWUP2_LINEAR_16_AVX2 - -void ScaleUVRowUp2_Linear_16_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width) { - asm volatile( - "vpcmpeqd %%ymm4,%%ymm4,%%ymm4 \n" - "vpsrld $31,%%ymm4,%%ymm4 \n" - "vpslld $1,%%ymm4,%%ymm4 \n" // all 2 - - LABELALIGN - "1: \n" - "vmovdqu (%0),%%xmm0 \n" // 00112233 (16b, 1u1v) - "vmovdqu 4(%0),%%xmm1 \n" // 11223344 (16b, 1u1v) - - "vpmovzxwd %%xmm0,%%ymm0 \n" // 01234567 (32b, 1u1v) - "vpmovzxwd %%xmm1,%%ymm1 \n" // 12345678 (32b, 1u1v) - - "vpshufd $0b01001110,%%ymm0,%%ymm2 \n" // 11003322 (lo, far) - "vpshufd $0b01001110,%%ymm1,%%ymm3 \n" // 22114433 (hi, far) - - "vpaddd %%ymm4,%%ymm2,%%ymm2 \n" // far+2 (lo) - "vpaddd %%ymm4,%%ymm3,%%ymm3 \n" // far+2 (hi) - "vpaddd %%ymm0,%%ymm2,%%ymm2 \n" // near+far+2 (lo) - "vpaddd %%ymm1,%%ymm3,%%ymm3 \n" // near+far+2 (hi) - "vpaddd %%ymm0,%%ymm0,%%ymm0 \n" // 2*near (lo) - "vpaddd %%ymm1,%%ymm1,%%ymm1 \n" // 2*near (hi) - "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 3*near+far+2 (lo) - "vpaddd %%ymm1,%%ymm3,%%ymm1 \n" // 3*near+far+2 (hi) - - "vpsrld $2,%%ymm0,%%ymm0 \n" // 3/4*near+1/4*far (lo) - "vpsrld $2,%%ymm1,%%ymm1 \n" // 3/4*near+1/4*far (hi) - "vpackusdw %%ymm1,%%ymm0,%%ymm0 \n" - "vmovdqu %%ymm0,(%1) \n" - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 4 uv to 8 uv - "sub $0x8,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4"); -} - -#endif - -#ifdef HAS_SCALEUVROWUP2_BILINEAR_16_AVX2 - -void ScaleUVRowUp2_Bilinear_16_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width) { - asm volatile( - "vpcmpeqd %%ymm6,%%ymm6,%%ymm6 \n" - "vpsrld $31,%%ymm6,%%ymm6 \n" - "vpslld $3,%%ymm6,%%ymm6 \n" // all 8 - - LABELALIGN - "1: \n" - - "vmovdqu (%0),%%xmm0 \n" // 00112233 (16b, 1u1v) - "vmovdqu 4(%0),%%xmm1 \n" // 11223344 (16b, 1u1v) - "vpmovzxwd %%xmm0,%%ymm0 \n" // 01234567 (32b, 1u1v) - "vpmovzxwd %%xmm1,%%ymm1 \n" // 12345678 (32b, 1u1v) - "vpshufd $0b01001110,%%ymm0,%%ymm2 \n" // 11003322 (lo, far) - "vpshufd $0b01001110,%%ymm1,%%ymm3 \n" // 22114433 (hi, far) - "vpaddd %%ymm0,%%ymm2,%%ymm2 \n" // near+far (lo) - "vpaddd %%ymm1,%%ymm3,%%ymm3 \n" // near+far (hi) - "vpaddd %%ymm0,%%ymm0,%%ymm0 \n" // 2*near (lo) - "vpaddd %%ymm1,%%ymm1,%%ymm1 \n" // 2*near (hi) - "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 3*near+far (lo) - "vpaddd %%ymm1,%%ymm3,%%ymm1 \n" // 3*near+far (hi) - - "vmovdqu (%0,%3,2),%%xmm2 \n" // 00112233 (16b, 1u1v) - "vmovdqu 4(%0,%3,2),%%xmm3 \n" // 11223344 (16b, 1u1v) - "vpmovzxwd %%xmm2,%%ymm2 \n" // 01234567 (32b, 1u1v) - "vpmovzxwd %%xmm3,%%ymm3 \n" // 12345678 (32b, 1u1v) - "vpshufd $0b01001110,%%ymm2,%%ymm4 \n" // 11003322 (lo, far) - "vpshufd $0b01001110,%%ymm3,%%ymm5 \n" // 22114433 (hi, far) - "vpaddd %%ymm2,%%ymm4,%%ymm4 \n" // near+far (lo) - "vpaddd %%ymm3,%%ymm5,%%ymm5 \n" // near+far (hi) - "vpaddd %%ymm2,%%ymm2,%%ymm2 \n" // 2*near (lo) - "vpaddd %%ymm3,%%ymm3,%%ymm3 \n" // 2*near (hi) - "vpaddd %%ymm2,%%ymm4,%%ymm2 \n" // 3*near+far (lo) - "vpaddd %%ymm3,%%ymm5,%%ymm3 \n" // 3*near+far (hi) - - "vpaddd %%ymm0,%%ymm0,%%ymm4 \n" // 6*near+2*far (1, lo) - "vpaddd %%ymm6,%%ymm2,%%ymm5 \n" // 3*near+far+8 (2, lo) - "vpaddd %%ymm4,%%ymm0,%%ymm4 \n" // 9*near+3*far (1, lo) - "vpaddd %%ymm4,%%ymm5,%%ymm4 \n" // 9 3 3 1 + 8 (1, lo) - "vpsrld $4,%%ymm4,%%ymm4 \n" // ^ div by 16 (1, lo) - - "vpaddd %%ymm2,%%ymm2,%%ymm5 \n" // 6*near+2*far (2, lo) - "vpaddd %%ymm6,%%ymm0,%%ymm0 \n" // 3*near+far+8 (1, lo) - "vpaddd %%ymm5,%%ymm2,%%ymm5 \n" // 9*near+3*far (2, lo) - "vpaddd %%ymm5,%%ymm0,%%ymm5 \n" // 9 3 3 1 + 8 (2, lo) - "vpsrld $4,%%ymm5,%%ymm5 \n" // ^ div by 16 (2, lo) - - "vpaddd %%ymm1,%%ymm1,%%ymm0 \n" // 6*near+2*far (1, hi) - "vpaddd %%ymm6,%%ymm3,%%ymm2 \n" // 3*near+far+8 (2, hi) - "vpaddd %%ymm0,%%ymm1,%%ymm0 \n" // 9*near+3*far (1, hi) - "vpaddd %%ymm0,%%ymm2,%%ymm0 \n" // 9 3 3 1 + 8 (1, hi) - "vpsrld $4,%%ymm0,%%ymm0 \n" // ^ div by 16 (1, hi) - - "vpaddd %%ymm3,%%ymm3,%%ymm2 \n" // 6*near+2*far (2, hi) - "vpaddd %%ymm6,%%ymm1,%%ymm1 \n" // 3*near+far+8 (1, hi) - "vpaddd %%ymm2,%%ymm3,%%ymm2 \n" // 9*near+3*far (2, hi) - "vpaddd %%ymm2,%%ymm1,%%ymm2 \n" // 9 3 3 1 + 8 (2, hi) - "vpsrld $4,%%ymm2,%%ymm2 \n" // ^ div by 16 (2, hi) - - "vpackusdw %%ymm0,%%ymm4,%%ymm4 \n" - "vmovdqu %%ymm4,(%1) \n" // store above - "vpackusdw %%ymm2,%%ymm5,%%ymm5 \n" - "vmovdqu %%ymm5,(%1,%4,2) \n" // store below - - "lea 0x10(%0),%0 \n" - "lea 0x20(%1),%1 \n" // 4 uv to 8 uv - "sub $0x8,%2 \n" - "jg 1b \n" - "vzeroupper \n" - : "+r"(src_ptr), // %0 - "+r"(dst_ptr), // %1 - "+r"(dst_width) // %2 - : "r"((intptr_t) (src_stride)), // %3 - "r"((intptr_t) (dst_stride)) // %4 - : "memory", "cc", "xmm0", "xmm1", "xmm2", "xmm3", "xmm4", "xmm5", "xmm6"); -} - -#endif - -#endif // defined(__x86_64__) || defined(__i386__) diff --git a/pkg/encoder/yuv/libyuv/scale_row.h b/pkg/encoder/yuv/libyuv/scale_row.h deleted file mode 100644 index 16389cdc..00000000 --- a/pkg/encoder/yuv/libyuv/scale_row.h +++ /dev/null @@ -1,768 +0,0 @@ -/* - * Copyright 2013 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_SCALE_ROW_H_ -#define INCLUDE_LIBYUV_SCALE_ROW_H_ - -#include "basic_types.h" -#include "scale.h" - -#if defined(__pnacl__) || defined(__CLR_VER) || \ - (defined(__native_client__) && defined(__x86_64__)) || \ - (defined(__i386__) && !defined(__SSE__) && !defined(__clang__)) -#define LIBYUV_DISABLE_X86 -#endif -#if defined(__native_client__) -#define LIBYUV_DISABLE_NEON -#endif -// MemorySanitizer does not support assembly code yet. http://crbug.com/344505 -#if defined(__has_feature) -#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_NEON) -#define LIBYUV_DISABLE_NEON -#endif -#if __has_feature(memory_sanitizer) && !defined(LIBYUV_DISABLE_X86) -#define LIBYUV_DISABLE_X86 -#endif -#endif -// GCC >= 4.7.0 required for AVX2. -#if defined(__GNUC__) && (defined(__x86_64__) || defined(__i386__)) -#if (__GNUC__ > 4) || (__GNUC__ == 4 && (__GNUC_MINOR__ >= 7)) -#define GCC_HAS_AVX2 1 -#endif // GNUC >= 4.7 -#endif // __GNUC__ - -// The following are available on all x86 platforms: -#if !defined(LIBYUV_DISABLE_X86) && \ - (defined(_M_IX86) || defined(__x86_64__) || defined(__i386__)) -#define HAS_FIXEDDIV1_X86 -#define HAS_FIXEDDIV_X86 -#define HAS_SCALEADDROW_SSE2 -#define HAS_SCALECOLSUP2_SSE2 -#define HAS_SCALEFILTERCOLS_SSSE3 -#define HAS_SCALEROWDOWN2_SSSE3 -#define HAS_SCALEROWDOWN34_SSSE3 -#define HAS_SCALEROWDOWN38_SSSE3 -#define HAS_SCALEROWDOWN4_SSSE3 -#endif - -// The following are available for gcc/clang x86 platforms: -// TODO(fbarchard): Port to Visual C -#if !defined(LIBYUV_DISABLE_X86) && (defined(__x86_64__) || defined(__i386__)) -#define HAS_SCALEUVROWDOWN2BOX_SSSE3 -#define HAS_SCALEROWUP2_LINEAR_SSE2 -#define HAS_SCALEROWUP2_LINEAR_SSSE3 -#define HAS_SCALEROWUP2_BILINEAR_SSE2 -#define HAS_SCALEROWUP2_BILINEAR_SSSE3 -#define HAS_SCALEROWUP2_LINEAR_12_SSSE3 -#define HAS_SCALEROWUP2_BILINEAR_12_SSSE3 -#define HAS_SCALEROWUP2_LINEAR_16_SSE2 -#define HAS_SCALEROWUP2_BILINEAR_16_SSE2 -#define HAS_SCALEUVROWUP2_LINEAR_SSSE3 -#define HAS_SCALEUVROWUP2_BILINEAR_SSSE3 -#define HAS_SCALEUVROWUP2_LINEAR_16_SSE41 -#define HAS_SCALEUVROWUP2_BILINEAR_16_SSE41 -#endif - -// The following are available for gcc/clang x86 platforms, but -// require clang 3.4 or gcc 4.7. -// TODO(fbarchard): Port to Visual C -#if !defined(LIBYUV_DISABLE_X86) && \ - (defined(__x86_64__) || defined(__i386__)) && \ - (defined(CLANG_HAS_AVX2) || defined(GCC_HAS_AVX2)) -#define HAS_SCALEUVROWDOWN2BOX_AVX2 -#define HAS_SCALEROWUP2_LINEAR_AVX2 -#define HAS_SCALEROWUP2_BILINEAR_AVX2 -#define HAS_SCALEROWUP2_LINEAR_12_AVX2 -#define HAS_SCALEROWUP2_BILINEAR_12_AVX2 -#define HAS_SCALEROWUP2_LINEAR_16_AVX2 -#define HAS_SCALEROWUP2_BILINEAR_16_AVX2 -#define HAS_SCALEUVROWUP2_LINEAR_AVX2 -#define HAS_SCALEUVROWUP2_BILINEAR_AVX2 -#define HAS_SCALEUVROWUP2_LINEAR_16_AVX2 -#define HAS_SCALEUVROWUP2_BILINEAR_16_AVX2 -#endif - -// The following are available on all x86 platforms, but -// require VS2012, clang 3.4 or gcc 4.7. -// The code supports NaCL but requires a new compiler and validator. -#if !defined(LIBYUV_DISABLE_X86) && \ - (defined(VISUALC_HAS_AVX2) || defined(CLANG_HAS_AVX2) || \ - defined(GCC_HAS_AVX2)) -#define HAS_SCALEADDROW_AVX2 -#define HAS_SCALEROWDOWN2_AVX2 -#define HAS_SCALEROWDOWN4_AVX2 -#endif - -// Scale ARGB vertically with bilinear interpolation. -void ScalePlaneVertical(int src_height, - int dst_width, - int dst_height, - int src_stride, - int dst_stride, - const uint8_t *src_argb, - uint8_t *dst_argb, - int x, - int y, - int dy, - int bpp, - enum FilterMode filtering); - -// Simplify the filtering based on scale factors. -enum FilterMode ScaleFilterReduce(int src_width, - int src_height, - int dst_width, - int dst_height, - enum FilterMode filtering); - -// Divide num by div and return as 16.16 fixed point result. -int FixedDiv_X86(int num, int div); - -int FixedDiv1_X86(int num, int div); - -#ifdef HAS_FIXEDDIV_X86 -#define FixedDiv FixedDiv_X86 -#define FixedDiv1 FixedDiv1_X86 -#endif - -// Compute slope values for stepping. -void ScaleSlope(int src_width, - int src_height, - int dst_width, - int dst_height, - enum FilterMode filtering, - int *x, - int *y, - int *dx, - int *dy); - -void ScaleRowDown2_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width); - -void ScaleRowDown2Linear_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width); - -void ScaleRowDown2Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width); - -void ScaleRowDown2Box_Odd_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width); - -void ScaleRowDown4_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width); - -void ScaleRowDown4Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width); - -void ScaleRowDown34_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width); - -void ScaleRowDown34_0_Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *d, - int dst_width); - -void ScaleRowDown34_1_Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *d, - int dst_width); - -void ScaleRowUp2_Linear_C(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_16_C(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_16_C(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_Any_C(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_Any_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_16_Any_C(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_16_Any_C(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleCols_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx); - -void ScaleColsUp2_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int, - int); - -void ScaleFilterCols_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx); - -void ScaleFilterCols64_C(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x32, - int dx); - -void ScaleRowDown38_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst, - int dst_width); - -void ScaleRowDown38_3_Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown38_2_Box_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleAddRow_C(const uint8_t *src_ptr, uint16_t *dst_ptr, int src_width); - -void ScaleUVRowDown2_C(const uint8_t *src_uv, - ptrdiff_t src_stride, - uint8_t *dst_uv, - int dst_width); - -void ScaleUVRowDown2Linear_C(const uint8_t *src_uv, - ptrdiff_t src_stride, - uint8_t *dst_uv, - int dst_width); - -void ScaleUVRowDown2Box_C(const uint8_t *src_uv, - ptrdiff_t src_stride, - uint8_t *dst_uv, - int dst_width); - -void ScaleUVRowDownEven_C(const uint8_t *src_uv, - ptrdiff_t src_stride, - int src_stepx, - uint8_t *dst_uv, - int dst_width); - -void ScaleUVRowUp2_Linear_C(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_Any_C(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_Any_C(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_16_C(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_16_C(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_16_Any_C(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_16_Any_C(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -// Specialized scalers for x86. -void ScaleRowDown2_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Linear_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Linear_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Box_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown4_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown4Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown4_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown4Box_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown34_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown34_1_Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown34_0_Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown38_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown38_3_Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown38_2_Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Linear_SSE2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_SSE2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_12_SSSE3(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_12_SSSE3(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_16_SSE2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_16_SSE2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_SSSE3(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_AVX2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_12_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_12_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_16_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_16_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_Any_SSE2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_Any_SSE2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_12_Any_SSSE3(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_12_Any_SSSE3(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_16_Any_SSE2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_16_Any_SSE2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_Any_SSSE3(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_Any_AVX2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_Any_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_12_Any_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_12_Any_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowUp2_Linear_16_Any_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleRowUp2_Bilinear_16_Any_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleRowDown2_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Linear_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Box_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Box_Odd_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2_Any_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Linear_Any_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Box_Any_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown2Box_Odd_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown4_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown4Box_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown4_Any_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown4Box_Any_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown34_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown34_1_Box_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown34_0_Box_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown38_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown38_3_Box_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleRowDown38_2_Box_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleAddRow_SSE2(const uint8_t *src_ptr, uint16_t *dst_ptr, int src_width); - -void ScaleAddRow_AVX2(const uint8_t *src_ptr, uint16_t *dst_ptr, int src_width); - -void ScaleAddRow_Any_SSE2(const uint8_t *src_ptr, - uint16_t *dst_ptr, - int src_width); - -void ScaleAddRow_Any_AVX2(const uint8_t *src_ptr, - uint16_t *dst_ptr, - int src_width); - -void ScaleFilterCols_SSSE3(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx); - -void ScaleColsUp2_SSE2(uint8_t *dst_ptr, - const uint8_t *src_ptr, - int dst_width, - int x, - int dx); - -// UV Row functions -void ScaleUVRowDown2Box_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_uv, - int dst_width); - -void ScaleUVRowDown2Box_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_uv, - int dst_width); - -void ScaleUVRowDown2Box_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleUVRowDown2Box_Any_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Linear_SSSE3(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_Any_SSSE3(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_Any_SSSE3(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_AVX2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_Any_AVX2(const uint8_t *src_ptr, - uint8_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_Any_AVX2(const uint8_t *src_ptr, - ptrdiff_t src_stride, - uint8_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_16_SSE41(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_16_SSE41(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_16_Any_SSE41(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_16_Any_SSE41(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_16_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_16_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -void ScaleUVRowUp2_Linear_16_Any_AVX2(const uint16_t *src_ptr, - uint16_t *dst_ptr, - int dst_width); - -void ScaleUVRowUp2_Bilinear_16_Any_AVX2(const uint16_t *src_ptr, - ptrdiff_t src_stride, - uint16_t *dst_ptr, - ptrdiff_t dst_stride, - int dst_width); - -#endif // INCLUDE_LIBYUV_SCALE_ROW_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/libyuv/version.h b/pkg/encoder/yuv/libyuv/version.h deleted file mode 100644 index d45ef09d..00000000 --- a/pkg/encoder/yuv/libyuv/version.h +++ /dev/null @@ -1,16 +0,0 @@ -/* - * Copyright 2012 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#ifndef INCLUDE_LIBYUV_VERSION_H_ -#define INCLUDE_LIBYUV_VERSION_H_ - -#define LIBYUV_VERSION 1875 - -#endif // INCLUDE_LIBYUV_VERSION_H_ diff --git a/pkg/encoder/yuv/libyuv/video_common.c b/pkg/encoder/yuv/libyuv/video_common.c deleted file mode 100644 index e492402e..00000000 --- a/pkg/encoder/yuv/libyuv/video_common.c +++ /dev/null @@ -1,50 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -#include "video_common.h" - -struct FourCCAliasEntry { - uint32_t alias; - uint32_t canonical; -}; - -#define NUM_ALIASES 18 -static const struct FourCCAliasEntry kFourCCAliases[NUM_ALIASES] = { - {FOURCC_IYUV, FOURCC_I420}, - {FOURCC_YU12, FOURCC_I420}, - {FOURCC_YU16, FOURCC_I422}, - {FOURCC_YU24, FOURCC_I444}, - {FOURCC_YUYV, FOURCC_YUY2}, - {FOURCC_YUVS, FOURCC_YUY2}, // kCMPixelFormat_422YpCbCr8_yuvs - {FOURCC_HDYC, FOURCC_UYVY}, - {FOURCC_2VUY, FOURCC_UYVY}, // kCMPixelFormat_422YpCbCr8 - {FOURCC_JPEG, FOURCC_MJPG}, // Note: JPEG has DHT while MJPG does not. - {FOURCC_DMB1, FOURCC_MJPG}, - {FOURCC_BA81, FOURCC_BGGR}, // deprecated. - {FOURCC_RGB3, FOURCC_RAW}, - {FOURCC_BGR3, FOURCC_24BG}, - {FOURCC_CM32, FOURCC_BGRA}, // kCMPixelFormat_32ARGB - {FOURCC_CM24, FOURCC_RAW}, // kCMPixelFormat_24RGB - {FOURCC_L555, FOURCC_RGBO}, // kCMPixelFormat_16LE555 - {FOURCC_L565, FOURCC_RGBP}, // kCMPixelFormat_16LE565 - {FOURCC_5551, FOURCC_RGBO}, // kCMPixelFormat_16LE5551 -}; - -LIBYUV_API -uint32_t CanonicalFourCC(uint32_t fourcc) { - int i; - for (i = 0; i < NUM_ALIASES; ++i) { - if (kFourCCAliases[i].alias == fourcc) { - return kFourCCAliases[i].canonical; - } - } - // Not an alias, so return it as-is. - return fourcc; -} diff --git a/pkg/encoder/yuv/libyuv/video_common.h b/pkg/encoder/yuv/libyuv/video_common.h deleted file mode 100644 index e2aacf44..00000000 --- a/pkg/encoder/yuv/libyuv/video_common.h +++ /dev/null @@ -1,212 +0,0 @@ -/* - * Copyright 2011 The LibYuv Project Authors. All rights reserved. - * - * Use of this source code is governed by a BSD-style license - * that can be found in the LICENSE file in the root of the source - * tree. An additional intellectual property rights grant can be found - * in the file PATENTS. All contributing project authors may - * be found in the AUTHORS file in the root of the source tree. - */ - -// Common definitions for video, including fourcc and VideoFormat. - -#ifndef INCLUDE_LIBYUV_VIDEO_COMMON_H_ -#define INCLUDE_LIBYUV_VIDEO_COMMON_H_ - -#include "basic_types.h" - -////////////////////////////////////////////////////////////////////////////// -// Definition of FourCC codes -////////////////////////////////////////////////////////////////////////////// - -// Convert four characters to a FourCC code. -// Needs to be a macro otherwise the OS X compiler complains when the kFormat* -// constants are used in a switch. -#ifdef __cplusplus -#define FOURCC(a, b, c, d) \ - ((static_cast(a)) | (static_cast(b) << 8) | \ - (static_cast(c) << 16) | /* NOLINT */ \ - (static_cast(d) << 24)) /* NOLINT */ -#else -#define FOURCC(a, b, c, d) \ - (((uint32_t)(a)) | ((uint32_t)(b) << 8) | /* NOLINT */ \ - ((uint32_t)(c) << 16) | ((uint32_t)(d) << 24)) /* NOLINT */ -#endif - -// Some pages discussing FourCC codes: -// http://www.fourcc.org/yuv.php -// http://v4l2spec.bytesex.org/spec/book1.htm -// http://developer.apple.com/quicktime/icefloe/dispatch020.html -// http://msdn.microsoft.com/library/windows/desktop/dd206750.aspx#nv12 -// http://people.xiph.org/~xiphmont/containers/nut/nut4cc.txt - -// FourCC codes grouped according to implementation efficiency. -// Primary formats should convert in 1 efficient step. -// Secondary formats are converted in 2 steps. -// Auxilliary formats call primary converters. -enum FourCC { - // 10 Primary YUV formats: 5 planar, 2 biplanar, 2 packed. - FOURCC_I420 = FOURCC('I', '4', '2', '0'), - FOURCC_I422 = FOURCC('I', '4', '2', '2'), - FOURCC_I444 = FOURCC('I', '4', '4', '4'), - FOURCC_I400 = FOURCC('I', '4', '0', '0'), - FOURCC_NV21 = FOURCC('N', 'V', '2', '1'), - FOURCC_NV12 = FOURCC('N', 'V', '1', '2'), - FOURCC_YUY2 = FOURCC('Y', 'U', 'Y', '2'), - FOURCC_UYVY = FOURCC('U', 'Y', 'V', 'Y'), - FOURCC_I010 = FOURCC('I', '0', '1', '0'), // bt.601 10 bit 420 - FOURCC_I210 = FOURCC('I', '2', '1', '0'), // bt.601 10 bit 422 - - // 1 Secondary YUV format: row biplanar. deprecated. - FOURCC_M420 = FOURCC('M', '4', '2', '0'), - - // 13 Primary RGB formats: 4 32 bpp, 2 24 bpp, 3 16 bpp, 1 10 bpc 2 64 bpp - FOURCC_ARGB = FOURCC('A', 'R', 'G', 'B'), - FOURCC_BGRA = FOURCC('B', 'G', 'R', 'A'), - FOURCC_ABGR = FOURCC('A', 'B', 'G', 'R'), - FOURCC_AR30 = FOURCC('A', 'R', '3', '0'), // 10 bit per channel. 2101010. - FOURCC_AB30 = FOURCC('A', 'B', '3', '0'), // ABGR version of 10 bit - FOURCC_AR64 = FOURCC('A', 'R', '6', '4'), // 16 bit per channel. - FOURCC_AB64 = FOURCC('A', 'B', '6', '4'), // ABGR version of 16 bit - FOURCC_24BG = FOURCC('2', '4', 'B', 'G'), - FOURCC_RAW = FOURCC('r', 'a', 'w', ' '), - FOURCC_RGBA = FOURCC('R', 'G', 'B', 'A'), - FOURCC_RGBP = FOURCC('R', 'G', 'B', 'P'), // rgb565 LE. - FOURCC_RGBO = FOURCC('R', 'G', 'B', 'O'), // argb1555 LE. - FOURCC_R444 = FOURCC('R', '4', '4', '4'), // argb4444 LE. - - // 1 Primary Compressed YUV format. - FOURCC_MJPG = FOURCC('M', 'J', 'P', 'G'), - - // 14 Auxiliary YUV variations: 3 with U and V planes are swapped, 1 Alias. - FOURCC_YV12 = FOURCC('Y', 'V', '1', '2'), - FOURCC_YV16 = FOURCC('Y', 'V', '1', '6'), - FOURCC_YV24 = FOURCC('Y', 'V', '2', '4'), - FOURCC_YU12 = FOURCC('Y', 'U', '1', '2'), // Linux version of I420. - FOURCC_J420 = - FOURCC('J', '4', '2', '0'), // jpeg (bt.601 full), unofficial fourcc - FOURCC_J422 = - FOURCC('J', '4', '2', '2'), // jpeg (bt.601 full), unofficial fourcc - FOURCC_J444 = - FOURCC('J', '4', '4', '4'), // jpeg (bt.601 full), unofficial fourcc - FOURCC_J400 = - FOURCC('J', '4', '0', '0'), // jpeg (bt.601 full), unofficial fourcc - FOURCC_F420 = FOURCC('F', '4', '2', '0'), // bt.709 full, unofficial fourcc - FOURCC_F422 = FOURCC('F', '4', '2', '2'), // bt.709 full, unofficial fourcc - FOURCC_F444 = FOURCC('F', '4', '4', '4'), // bt.709 full, unofficial fourcc - FOURCC_H420 = FOURCC('H', '4', '2', '0'), // bt.709, unofficial fourcc - FOURCC_H422 = FOURCC('H', '4', '2', '2'), // bt.709, unofficial fourcc - FOURCC_H444 = FOURCC('H', '4', '4', '4'), // bt.709, unofficial fourcc - FOURCC_U420 = FOURCC('U', '4', '2', '0'), // bt.2020, unofficial fourcc - FOURCC_U422 = FOURCC('U', '4', '2', '2'), // bt.2020, unofficial fourcc - FOURCC_U444 = FOURCC('U', '4', '4', '4'), // bt.2020, unofficial fourcc - FOURCC_F010 = FOURCC('F', '0', '1', '0'), // bt.709 full range 10 bit 420 - FOURCC_H010 = FOURCC('H', '0', '1', '0'), // bt.709 10 bit 420 - FOURCC_U010 = FOURCC('U', '0', '1', '0'), // bt.2020 10 bit 420 - FOURCC_F210 = FOURCC('F', '2', '1', '0'), // bt.709 full range 10 bit 422 - FOURCC_H210 = FOURCC('H', '2', '1', '0'), // bt.709 10 bit 422 - FOURCC_U210 = FOURCC('U', '2', '1', '0'), // bt.2020 10 bit 422 - FOURCC_P010 = FOURCC('P', '0', '1', '0'), - FOURCC_P210 = FOURCC('P', '2', '1', '0'), - - // 14 Auxiliary aliases. CanonicalFourCC() maps these to canonical fourcc. - FOURCC_IYUV = FOURCC('I', 'Y', 'U', 'V'), // Alias for I420. - FOURCC_YU16 = FOURCC('Y', 'U', '1', '6'), // Alias for I422. - FOURCC_YU24 = FOURCC('Y', 'U', '2', '4'), // Alias for I444. - FOURCC_YUYV = FOURCC('Y', 'U', 'Y', 'V'), // Alias for YUY2. - FOURCC_YUVS = FOURCC('y', 'u', 'v', 's'), // Alias for YUY2 on Mac. - FOURCC_HDYC = FOURCC('H', 'D', 'Y', 'C'), // Alias for UYVY. - FOURCC_2VUY = FOURCC('2', 'v', 'u', 'y'), // Alias for UYVY on Mac. - FOURCC_JPEG = FOURCC('J', 'P', 'E', 'G'), // Alias for MJPG. - FOURCC_DMB1 = FOURCC('d', 'm', 'b', '1'), // Alias for MJPG on Mac. - FOURCC_BA81 = FOURCC('B', 'A', '8', '1'), // Alias for BGGR. - FOURCC_RGB3 = FOURCC('R', 'G', 'B', '3'), // Alias for RAW. - FOURCC_BGR3 = FOURCC('B', 'G', 'R', '3'), // Alias for 24BG. - FOURCC_CM32 = FOURCC(0, 0, 0, 32), // Alias for BGRA kCMPixelFormat_32ARGB - FOURCC_CM24 = FOURCC(0, 0, 0, 24), // Alias for RAW kCMPixelFormat_24RGB - FOURCC_L555 = FOURCC('L', '5', '5', '5'), // Alias for RGBO. - FOURCC_L565 = FOURCC('L', '5', '6', '5'), // Alias for RGBP. - FOURCC_5551 = FOURCC('5', '5', '5', '1'), // Alias for RGBO. - - // deprecated formats. Not supported, but defined for backward compatibility. - FOURCC_I411 = FOURCC('I', '4', '1', '1'), - FOURCC_Q420 = FOURCC('Q', '4', '2', '0'), - FOURCC_RGGB = FOURCC('R', 'G', 'G', 'B'), - FOURCC_BGGR = FOURCC('B', 'G', 'G', 'R'), - FOURCC_GRBG = FOURCC('G', 'R', 'B', 'G'), - FOURCC_GBRG = FOURCC('G', 'B', 'R', 'G'), - FOURCC_H264 = FOURCC('H', '2', '6', '4'), - - // Match any fourcc. - FOURCC_ANY = -1, -}; - -enum FourCCBpp { - // Canonical fourcc codes used in our code. - FOURCC_BPP_I420 = 12, - FOURCC_BPP_I422 = 16, - FOURCC_BPP_I444 = 24, - FOURCC_BPP_I411 = 12, - FOURCC_BPP_I400 = 8, - FOURCC_BPP_NV21 = 12, - FOURCC_BPP_NV12 = 12, - FOURCC_BPP_YUY2 = 16, - FOURCC_BPP_UYVY = 16, - FOURCC_BPP_M420 = 12, // deprecated - FOURCC_BPP_Q420 = 12, - FOURCC_BPP_ARGB = 32, - FOURCC_BPP_BGRA = 32, - FOURCC_BPP_ABGR = 32, - FOURCC_BPP_RGBA = 32, - FOURCC_BPP_AR30 = 32, - FOURCC_BPP_AB30 = 32, - FOURCC_BPP_AR64 = 64, - FOURCC_BPP_AB64 = 64, - FOURCC_BPP_24BG = 24, - FOURCC_BPP_RAW = 24, - FOURCC_BPP_RGBP = 16, - FOURCC_BPP_RGBO = 16, - FOURCC_BPP_R444 = 16, - FOURCC_BPP_RGGB = 8, - FOURCC_BPP_BGGR = 8, - FOURCC_BPP_GRBG = 8, - FOURCC_BPP_GBRG = 8, - FOURCC_BPP_YV12 = 12, - FOURCC_BPP_YV16 = 16, - FOURCC_BPP_YV24 = 24, - FOURCC_BPP_YU12 = 12, - FOURCC_BPP_J420 = 12, - FOURCC_BPP_J400 = 8, - FOURCC_BPP_H420 = 12, - FOURCC_BPP_H422 = 16, - FOURCC_BPP_I010 = 15, - FOURCC_BPP_I210 = 20, - FOURCC_BPP_H010 = 15, - FOURCC_BPP_H210 = 20, - FOURCC_BPP_P010 = 15, - FOURCC_BPP_P210 = 20, - FOURCC_BPP_MJPG = 0, // 0 means unknown. - FOURCC_BPP_H264 = 0, - FOURCC_BPP_IYUV = 12, - FOURCC_BPP_YU16 = 16, - FOURCC_BPP_YU24 = 24, - FOURCC_BPP_YUYV = 16, - FOURCC_BPP_YUVS = 16, - FOURCC_BPP_HDYC = 16, - FOURCC_BPP_2VUY = 16, - FOURCC_BPP_JPEG = 1, - FOURCC_BPP_DMB1 = 1, - FOURCC_BPP_BA81 = 8, - FOURCC_BPP_RGB3 = 24, - FOURCC_BPP_BGR3 = 24, - FOURCC_BPP_CM32 = 32, - FOURCC_BPP_CM24 = 24, - - // Match any fourcc. - FOURCC_BPP_ANY = 0, // 0 means unknown. -}; - -// Converts fourcc aliases into canonical ones. -LIBYUV_API uint32_t CanonicalFourCC(uint32_t fourcc); - -#endif // INCLUDE_LIBYUV_VIDEO_COMMON_H_ \ No newline at end of file diff --git a/pkg/encoder/yuv/yuv_test.go b/pkg/encoder/yuv/yuv_test.go index 6b67c29f..3f07aa69 100644 --- a/pkg/encoder/yuv/yuv_test.go +++ b/pkg/encoder/yuv/yuv_test.go @@ -115,6 +115,9 @@ func TestYuvPredefined(t *testing.T) { frame := RawFrame{Data: im, Stride: 32, W: 32, H: 32} a := pc.Process(frame, 0, PixFmt(libyuv.FourccAbgr)) + v := libyuv.Version() + t.Logf("%v", v) + if len(a) != len(should) { t.Fatalf("diffrent size a: %v, o: %v", len(a), len(should)) } From f8fb128e970b38cc5ceb059827ac985af65411e7 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 16 Oct 2023 13:24:04 +0300 Subject: [PATCH 109/361] Update CI --- .github/workflows/build.yml | 78 +++++++++--------------------- .github/workflows/docker_build.yml | 12 +++++ 2 files changed, 34 insertions(+), 56 deletions(-) create mode 100644 .github/workflows/docker_build.yml diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 4da180c5..a37d2fed 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -16,33 +16,39 @@ on: jobs: build: - name: Build strategy: matrix: os: [ ubuntu-latest, macos-latest, windows-latest ] - step: [ build, test ] runs-on: ${{ matrix.os }} steps: - - uses: actions/checkout@v3 + - uses: actions/checkout@v4 - uses: actions/setup-go@v4 with: - go-version: 1.20.7 + go-version: 1.20.8 - - name: Get Linux dev libraries and tools + - name: Linux if: matrix.os == 'ubuntu-latest' + env: + MESA_GL_VERSION_OVERRIDE: 3.3COMPAT run: | sudo apt-get -qq update - sudo apt-get -qq install -y make pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev libgl1-mesa-glx + sudo apt-get -qq install -y \ + make pkg-config \ + libvpx-dev libx264-dev libopus-dev libyuv-dev \ + libsdl2-dev libgl1-mesa-glx + + make build + xvfb-run --auto-servernum make test verify-cores - - name: Get MacOS dev libraries and tools + - name: macOS if: matrix.os == 'macos-latest' run: | brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo + make build test verify-cores - - name: Get Windows dev libraries and tools + - uses: msys2/setup-msys2@v2 if: matrix.os == 'windows-latest' - uses: msys2/setup-msys2@v2 with: msystem: MINGW64 path-type: inherit @@ -57,61 +63,21 @@ jobs: mingw-w64-x86_64-SDL2 mingw-w64-x86_64-libyuv - - name: Get Windows OpenGL drivers - if: matrix.step == 'test' && matrix.os == 'windows-latest' + - name: Windows + if: matrix.os == 'windows-latest' + env: + MESA_GL_VERSION_OVERRIDE: 3.3COMPAT shell: msys2 {0} run: | wget -q https://github.com/pal1000/mesa-dist-win/releases/download/20.2.1/mesa3d-20.2.1-release-mingw.7z "/c/Program Files/7-Zip/7z.exe" x mesa3d-20.2.1-release-mingw.7z -omesa echo -e " 2\r\n 8\r\n " >> commands ./mesa/systemwidedeploy.cmd < ./commands - - - name: Build Windows app - if: matrix.step == 'build' && matrix.os == 'windows-latest' - shell: msys2 {0} - run: | - make build - - - name: Build Linux app - if: matrix.step == 'build' && matrix.os == 'ubuntu-latest' - run: | - make build - - - name: Build macOS app - if: matrix.step == 'build' && matrix.os == 'macos-latest' - run: | - make build - - - name: Test (windows-latest) - if: matrix.step == 'test' && matrix.os == 'windows-latest' && always() - shell: msys2 {0} - env: - MESA_GL_VERSION_OVERRIDE: 3.3COMPAT - run: | - GL_CTX=-autoGlContext make test verify-cores - - - name: Test (ubuntu-latest) - if: matrix.step == 'test' && matrix.os == 'ubuntu-latest' && always() - env: - MESA_GL_VERSION_OVERRIDE: 3.3COMPAT - run: | - GL_CTX=-autoGlContext xvfb-run --auto-servernum make test verify-cores - - - name: Test (macos-latest) - if: matrix.step == 'test' && matrix.os == 'macos-latest' && always() - run: | - make test verify-cores + + make build test verify-cores - uses: actions/upload-artifact@v3 - if: matrix.step == 'test' && always() + if: always() with: name: emulator-test-frames path: _rendered/*.png - - build_docker: - name: Build (docker) - runs-on: ubuntu-latest - if: github.event_name == 'pull_request' - steps: - - uses: actions/checkout@v3 - - run: DOCKER_BUILDKIT=1 docker build --build-arg VERSION=$(./scripts/version.sh) . diff --git a/.github/workflows/docker_build.yml b/.github/workflows/docker_build.yml new file mode 100644 index 00000000..65bc5856 --- /dev/null +++ b/.github/workflows/docker_build.yml @@ -0,0 +1,12 @@ +name: docker_build +on: + pull_request: + branches: + - master + +jobs: + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - run: DOCKER_BUILDKIT=1 docker build --build-arg VERSION=$(./scripts/version.sh) . From d698660c19791959146d007f18a6d70c913510ea Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 17 Oct 2023 14:04:15 +0300 Subject: [PATCH 110/361] Allow changing video resolution during the stream --- pkg/worker/caged/libretro/caged.go | 10 ++++++++ pkg/worker/caged/libretro/frontend.go | 2 ++ .../caged/libretro/nanoarch/nanoarch.go | 15 ++++++++---- pkg/worker/coordinatorhandlers.go | 9 +++++++ pkg/worker/media/media.go | 24 ++++++++++++++++--- pkg/worker/room/room.go | 2 ++ 6 files changed, 55 insertions(+), 7 deletions(-) diff --git a/pkg/worker/caged/libretro/caged.go b/pkg/worker/caged/libretro/caged.go index de0ba038..2260b4c0 100644 --- a/pkg/worker/caged/libretro/caged.go +++ b/pkg/worker/caged/libretro/caged.go @@ -15,6 +15,8 @@ type Caged struct { conf CagedConf log *logger.Logger w, h int + + OnSysInfoChange func() } type CagedConf struct { @@ -44,6 +46,14 @@ func (c *Caged) ReloadFrontend() { c.base = frontend } +func (c *Caged) HandleOnSystemAvInfo(fn func()) { + c.base.SetOnAV(func() { + w, h := c.ViewportCalc() + c.SetViewport(w, h) + fn() + }) +} + func (c *Caged) Load(game games.GameMetadata, path string) error { c.Emulator.LoadCore(game.System) if err := c.Emulator.LoadGame(game.FullPath(path)); err != nil { diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 63d32320..052756a6 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -211,6 +211,8 @@ func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { f.nano.OnAudio = f.handleAudio } +func (f *Frontend) SetOnAV(fn func()) { f.nano.OnSystemAvInfo = fn } + func (f *Frontend) Start() { f.log.Debug().Msgf("Frontend start") diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index b601aade..1b661201 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -73,10 +73,11 @@ type Nanoarch struct { } type Handlers struct { - OnDpad func(port uint, axis uint) (shift int16) - OnKeyPress func(port uint, key int) int - OnAudio func(ptr unsafe.Pointer, frames int) - OnVideo func(data []byte, delta int32, fi FrameInfo) + OnDpad func(port uint, axis uint) (shift int16) + OnKeyPress func(port uint, key int) int + OnAudio func(ptr unsafe.Pointer, frames int) + OnVideo func(data []byte, delta int32, fi FrameInfo) + OnSystemAvInfo func() } type FrameInfo struct { @@ -689,6 +690,12 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { case C.RETRO_ENVIRONMENT_SET_SYSTEM_AV_INFO: av := *(*C.struct_retro_system_av_info)(data) Nan0.log.Info().Msgf(">>> SET SYS AV INFO: %v", av) + Nan0.sysAvInfo = av + go func() { + if Nan0.OnSystemAvInfo != nil { + Nan0.OnSystemAvInfo() + } + }() return true case C.RETRO_ENVIRONMENT_SET_GEOMETRY: geom := *(*C.struct_retro_game_geometry)(data) diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 2a791c1b..f061f159 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -137,6 +137,15 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke m.SetPixFmt(app.PixFormat()) m.SetRot(app.Rotation()) + app.HandleOnSystemAvInfo(func() { + m.VideoW, m.VideoH = app.ViewportSize() + m.VideoScale = app.Scale() + err := m.Reinit() + if err != nil { + c.log.Error().Err(err).Msgf("av reinit fail") + } + }) + r.BindAppMedia() r.StartApp() } diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 5b33404e..7c9a242e 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -116,6 +116,11 @@ type WebrtcMediaPipe struct { AudioFrame int VideoW, VideoH int VideoScale float64 + + // keep the old settings for reinit + oldPf uint32 + oldRot uint + oldFlip bool } func NewWebRtcMediaPipe(ac config.Audio, vc config.Video, log *logger.Logger) *WebrtcMediaPipe { @@ -200,6 +205,19 @@ func round(x int, scale float64) int { return (int(float64(x)*scale) + 1) & ^1 } func (wmp *WebrtcMediaPipe) ProcessVideo(v app.Video) []byte { return wmp.v.Encode(encoder.InFrame(v.Frame)) } -func (wmp *WebrtcMediaPipe) SetPixFmt(f uint32) { wmp.v.SetPixFormat(f) } -func (wmp *WebrtcMediaPipe) SetVideoFlip(b bool) { wmp.v.SetFlip(b) } -func (wmp *WebrtcMediaPipe) SetRot(r uint) { wmp.v.SetRot(r) } + +func (wmp *WebrtcMediaPipe) Reinit() error { + wmp.v.Stop() + if err := wmp.initVideo(wmp.VideoW, wmp.VideoH, wmp.VideoScale, wmp.vConf); err != nil { + return err + } + // restore old + wmp.SetPixFmt(wmp.oldPf) + wmp.SetRot(wmp.oldRot) + wmp.SetVideoFlip(wmp.oldFlip) + return nil +} + +func (wmp *WebrtcMediaPipe) SetPixFmt(f uint32) { wmp.oldPf = f; wmp.v.SetPixFormat(f) } +func (wmp *WebrtcMediaPipe) SetVideoFlip(b bool) { wmp.oldFlip = b; wmp.v.SetFlip(b) } +func (wmp *WebrtcMediaPipe) SetRot(r uint) { wmp.oldRot = r; wmp.v.SetRot(r) } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index b2341b4e..6e777e80 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -11,6 +11,8 @@ type MediaPipe interface { Destroy() // Init initializes the pipe: allocates needed resources. Init() error + // Reinit initializes video and audio pipes with the new settings. + Reinit() error // PushAudio pushes the 16bit PCM audio frames into an encoder. // Because we need to fill the buffer, the SetAudioCb should be // used in order to get the result. From afb76aa9709ddb919f50c3555a6098c48cbc3ef0 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 17 Oct 2023 17:07:57 +0300 Subject: [PATCH 111/361] Add note about empty nested config values --- pkg/config/config.yaml | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 30737b08..59a123bf 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -1,5 +1,20 @@ # The main config file +# Note. +# Be aware that when this configuration is being overwritten +# by another configuration, any empty nested part +# in the further configurations will reset (empty out) all the values. +# For example: +# the main config second config result +# ... ... ... +# list: list: list: +# gba: gba: gba: +# lib: mgba_libretro lib: "" +# roms: [ "gba", "gbc" ] roms: [] +# ... ... +# +# So do not leave empty nested keys. + # for the compatibility purposes version: 3 From e8cec39476ad59811c3af4b41b4344e61bf95416 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 17 Oct 2023 17:21:00 +0300 Subject: [PATCH 112/361] Report on broken config when downloading Libretro cores --- pkg/config/emulator.go | 5 +++-- pkg/worker/caged/libretro/manager/http.go | 12 +++++++++++- 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index dda7b486..f7d71fc3 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -60,6 +60,7 @@ type LibretroCoreConfig struct { } type CoreInfo struct { + Id string Name string AltRepo bool } @@ -101,8 +102,8 @@ func (e Emulator) GetSupportedExtensions() []string { } func (l *LibretroConfig) GetCores() (cores []CoreInfo) { - for _, core := range l.Cores.List { - cores = append(cores, CoreInfo{Name: core.Lib, AltRepo: core.AltRepo}) + for k, core := range l.Cores.List { + cores = append(cores, CoreInfo{Id: k, Name: core.Lib, AltRepo: core.AltRepo}) } return } diff --git a/pkg/worker/caged/libretro/manager/http.go b/pkg/worker/caged/libretro/manager/http.go index 1f2dbc88..72826181 100644 --- a/pkg/worker/caged/libretro/manager/http.go +++ b/pkg/worker/caged/libretro/manager/http.go @@ -116,14 +116,24 @@ func (m *Manager) download(cores []config.CoreInfo) (failed []string) { if len(cores) == 0 || m.repo == nil { return } - var prime, second []string + var prime, second, fail []string for _, n := range cores { + if n.Name == "" { + fail = append(fail, n.Id) + continue + } if !n.AltRepo { prime = append(prime, n.Name) } else { second = append(second, n.Name) } } + + if len(prime) == 0 && len(second) == 0 { + m.log.Warn().Msgf("[core-dl] couldn't find info for %v cores, check the config", fail) + return + } + m.log.Info().Msgf("[core-dl] <<< download | main: %v | alt: %v", prime, second) primeFails := m.down(prime, m.repo) if len(primeFails) > 0 && m.altRepo != nil { From 9c768277c7a3e433e99cba46e7359c4682e5bcfc Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 17 Oct 2023 19:12:54 +0300 Subject: [PATCH 113/361] Use sudo static Docker builds --- Dockerfile | 5 +++-- README.md | 4 ++-- pkg/encoder/yuv/libyuv/libyuv.go | 3 ++- 3 files changed, 7 insertions(+), 5 deletions(-) diff --git a/Dockerfile b/Dockerfile index d874271d..0d696da1 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:lunar AS build0 -ARG GO=1.20.7 +ARG GO=1.20.8 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ @@ -47,11 +47,12 @@ WORKDIR ${BUILD_PATH} # install deps RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ - gcc \ + build-essential \ libopus-dev \ libsdl2-dev \ libvpx-dev \ libyuv-dev \ + libjpeg-turbo8-dev \ libx264-dev \ pkg-config \ && rm -rf /var/lib/apt/lists/* diff --git a/README.md b/README.md index d1d837ad..db4e23cf 100644 --- a/README.md +++ b/README.md @@ -61,13 +61,13 @@ a better sense of performance. ``` # Ubuntu / Windows (WSL2) -apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev +apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev libjpeg-turbo8-dev # MacOS brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo # Windows (MSYS2) -pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,x264-git,SDL2,libyuv} +pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,x264-git,SDL2,libyuv,libjpeg-turbo} ``` Because the coordinator and workers need to run simultaneously. Workers connect to the coordinator. diff --git a/pkg/encoder/yuv/libyuv/libyuv.go b/pkg/encoder/yuv/libyuv/libyuv.go index 8bde0ad8..8eba7a31 100644 --- a/pkg/encoder/yuv/libyuv/libyuv.go +++ b/pkg/encoder/yuv/libyuv/libyuv.go @@ -3,7 +3,8 @@ package libyuv /* -#cgo !darwin LDFLAGS: -lyuv +#cgo !darwin,!st LDFLAGS: -lyuv +#cgo !darwin,st LDFLAGS: -l:libyuv.a -l:libjpeg.a -lstdc++ #cgo darwin CFLAGS: -DINCLUDE_LIBYUV_VERSION_H_ #cgo darwin LDFLAGS: -L${SRCDIR} -lstdc++ From 494ac0ed3b32c33757423328613bc925ec9e6c32 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 17 Oct 2023 21:39:16 +0300 Subject: [PATCH 114/361] Add empty rooms watcher --- pkg/com/com.go | 1 + pkg/worker/room/room.go | 2 ++ pkg/worker/watcher.go | 46 +++++++++++++++++++++++++++++++++++++++++ pkg/worker/worker.go | 3 ++- 4 files changed, 51 insertions(+), 1 deletion(-) create mode 100644 pkg/worker/watcher.go diff --git a/pkg/com/com.go b/pkg/com/com.go index 5a738039..3bb930d2 100644 --- a/pkg/com/com.go +++ b/pkg/com/com.go @@ -14,6 +14,7 @@ func NewNetMap[K comparable, T NetClient[K]]() NetMap[K, T] { } func (m *NetMap[K, T]) Add(client T) bool { return m.Put(client.Id(), client) } +func (m *NetMap[K, T]) Empty() bool { return m.Map.Len() == 0 } func (m *NetMap[K, T]) Remove(client T) { m.Map.Remove(client.Id()) } func (m *NetMap[K, T]) RemoveL(client T) int { return m.Map.RemoveL(client.Id()) } func (m *NetMap[K, T]) Reset() { m.Map = Map[K, T]{m: make(map[K]T, 10)} } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index 6e777e80..67ac6960 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -25,6 +25,7 @@ type MediaPipe interface { type SessionManager[T Session] interface { Add(T) bool + Empty() bool Find(string) T ForEach(func(T)) RemoveL(T) int @@ -126,6 +127,7 @@ func (r *Router[T]) Close() { r.mu.Lock(); r.room.Close(); r.r func (r *Router[T]) FindUser(uid Uid) T { return r.users.Find(uid.Id()) } func (r *Router[T]) Room() *Room[T] { r.mu.Lock(); defer r.mu.Unlock(); return r.room } func (r *Router[T]) SetRoom(room *Room[T]) { r.mu.Lock(); r.room = room; r.mu.Unlock() } +func (r *Router[T]) HasRoom() bool { r.mu.Lock(); defer r.mu.Unlock(); return r.room != nil } func (r *Router[T]) Users() SessionManager[T] { return r.users } type AppSession struct { diff --git a/pkg/worker/watcher.go b/pkg/worker/watcher.go new file mode 100644 index 00000000..953b0036 --- /dev/null +++ b/pkg/worker/watcher.go @@ -0,0 +1,46 @@ +package worker + +import ( + "time" + + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/giongto35/cloud-game/v3/pkg/worker/room" +) + +type Watcher struct { + r *room.GameRouter + t *time.Ticker + done chan struct{} + log *logger.Logger +} + +func NewWatcher(p time.Duration, router *room.GameRouter, log *logger.Logger) *Watcher { + return &Watcher{ + r: router, + t: time.NewTicker(p), + done: make(chan struct{}), + log: log, + } +} + +func (w *Watcher) Run() { + go func() { + for { + select { + case <-w.t.C: + if w.r.HasRoom() && w.r.Users().Empty() { + w.r.Close() + w.log.Warn().Msgf("Forced room close!") + } + case <-w.done: + return + } + } + }() +} + +func (w *Watcher) Stop() error { + w.t.Stop() + close(w.done) + return nil +} diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 0c0f1d5a..04e3ae27 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -21,7 +21,7 @@ type Worker struct { log *logger.Logger mana *caged.Manager router *room.GameRouter - services [2]interface { + services [3]interface { Run() Stop() error } @@ -64,6 +64,7 @@ func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { log.Warn().Err(err).Msgf("cloud storage fail, using no storage") } worker.storage = st + worker.services[2] = NewWatcher(30*time.Minute, worker.router, log) return worker, nil } From 61c70d3289ff55cbefa05663673a4b0be60b1402 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 18 Oct 2023 13:53:35 +0300 Subject: [PATCH 115/361] Use static CC build --- pkg/encoder/yuv/libyuv/libyuv.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/encoder/yuv/libyuv/libyuv.go b/pkg/encoder/yuv/libyuv/libyuv.go index 8eba7a31..e7a19739 100644 --- a/pkg/encoder/yuv/libyuv/libyuv.go +++ b/pkg/encoder/yuv/libyuv/libyuv.go @@ -4,7 +4,7 @@ package libyuv /* #cgo !darwin,!st LDFLAGS: -lyuv -#cgo !darwin,st LDFLAGS: -l:libyuv.a -l:libjpeg.a -lstdc++ +#cgo !darwin,st LDFLAGS: -l:libyuv.a -l:libjpeg.a -l:libstdc++.a -static-libgcc #cgo darwin CFLAGS: -DINCLUDE_LIBYUV_VERSION_H_ #cgo darwin LDFLAGS: -L${SRCDIR} -lstdc++ From f7c2524098ae0bcdd778951b7220e148b6d43450 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 18 Oct 2023 14:24:47 +0300 Subject: [PATCH 116/361] Add libjpeg to builds --- .github/workflows/build.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index a37d2fed..5fccc156 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -35,7 +35,7 @@ jobs: sudo apt-get -qq update sudo apt-get -qq install -y \ make pkg-config \ - libvpx-dev libx264-dev libopus-dev libyuv-dev \ + libvpx-dev libx264-dev libopus-dev libyuv-dev libjpeg-turbo8-dev \ libsdl2-dev libgl1-mesa-glx make build @@ -62,6 +62,7 @@ jobs: mingw-w64-x86_64-x264-git mingw-w64-x86_64-SDL2 mingw-w64-x86_64-libyuv + mingw-w64-x86_64-libjpeg-turbo - name: Windows if: matrix.os == 'windows-latest' From 1b82c48dc109dc64482337a8cb70a0d9167f896b Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 18 Oct 2023 20:37:57 +0300 Subject: [PATCH 117/361] Don't show the share popup message --- web/js/controller.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/js/controller.js b/web/js/controller.js index 78457be9..1950eaa1 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -51,7 +51,7 @@ }; const onGameRoomAvailable = () => { - message.show('Now you can share you game!'); + // room is ready }; const onConnectionReady = () => { From a8d47fd1bf489a25a18980b70b12720642e5e042 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 18 Oct 2023 20:42:46 +0300 Subject: [PATCH 118/361] Don't nil peerconnection while receiving ICE --- pkg/network/webrtc/webrtc.go | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/pkg/network/webrtc/webrtc.go b/pkg/network/webrtc/webrtc.go index d05b07c3..ed0c3ca6 100644 --- a/pkg/network/webrtc/webrtc.go +++ b/pkg/network/webrtc/webrtc.go @@ -185,6 +185,9 @@ func (p *Peer) handleICEState(onConnect func()) func(webrtc.ICEConnectionState) } func (p *Peer) AddCandidate(candidate string, decoder Decoder) error { + // !to add test when the connection is closed but it is still + // receiving ice candidates + var iceCandidate webrtc.ICECandidateInit if err := decoder(candidate, &iceCandidate); err != nil { return err @@ -204,7 +207,6 @@ func (p *Peer) Disconnect() { // ignore this due to DTLS fatal: conn is closed _ = p.conn.Close() } - p.conn = nil p.log.Debug().Msg("WebRTC stop") } From 7977bce8a3e38f52f983f77b031b42b7afc805a0 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 18 Oct 2023 21:28:37 +0300 Subject: [PATCH 119/361] Fix dangling rooms when multiplaying --- pkg/worker/coordinatorhandlers.go | 4 ++-- pkg/worker/room/room.go | 1 + 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index f061f159..9fee6460 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -162,8 +162,8 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com.Uid], w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) + c.log.Debug().Msgf(">>> users: %v", w.router.Users()) user.Disconnect() - w.router.SetRoom(nil) } } @@ -171,7 +171,7 @@ func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com. func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) - w.router.SetRoom(nil) + c.log.Debug().Msgf(">>> users: %v", w.router.Users()) } } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index 67ac6960..51978532 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -119,6 +119,7 @@ func (r *Router[T]) FindRoom(id string) *Room[T] { func (r *Router[T]) Remove(user T) { if left := r.users.RemoveL(user); left == 0 { r.Close() + r.SetRoom(nil) } } From fb5d8c216b8e70f615ed885f94c4d0ee07f1a134 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 18 Oct 2023 21:46:02 +0300 Subject: [PATCH 120/361] Don't change players when there is no game --- pkg/coordinator/userhandlers.go | 2 +- web/js/controller.js | 6 +++--- web/js/input/touch.js | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/pkg/coordinator/userhandlers.go b/pkg/coordinator/userhandlers.go index 441dce08..426fd74f 100644 --- a/pkg/coordinator/userhandlers.go +++ b/pkg/coordinator/userhandlers.go @@ -92,7 +92,7 @@ func (u *User) HandleChangePlayer(rq api.ChangePlayerUserRequest) { resp, err := u.w.ChangePlayer(u.Id(), int(rq)) // !to make it a little less convoluted if err != nil || resp == nil || *resp == -1 { - u.log.Error().Err(err).Msg("player switch failed for some reason") + u.log.Error().Err(err).Msgf("player select fail, req: %v", rq) return } u.Notify(api.ChangePlayer, rq) diff --git a/web/js/controller.js b/web/js/controller.js index 1950eaa1..5ae5443c 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -238,9 +238,9 @@ state.keyRelease(data.key); }; - const updatePlayerIndex = idx => { + const updatePlayerIndex = (idx, not_game = false) => { playerIndex.value = idx + 1; - api.game.setPlayerIndex(idx); + !not_game && api.game.setPlayerIndex(idx); }; // noop function for the state @@ -421,7 +421,7 @@ event.sub(GAME_SAVED, () => message.show('Saved')); event.sub(GAME_LOADED, () => message.show('Loaded')); event.sub(GAME_PLAYER_IDX, data => { - updatePlayerIndex(+data.index); + updatePlayerIndex(+data.index, state !== app.state.game); }); event.sub(GAME_PLAYER_IDX_SET, idx => { if (!isNaN(+idx)) message.show(+idx + 1); diff --git a/web/js/input/touch.js b/web/js/input/touch.js index 97b45a9a..a0a8c32d 100644 --- a/web/js/input/touch.js +++ b/web/js/input/touch.js @@ -278,7 +278,7 @@ const touch = (() => { // touch/mouse events for player slider. playerSlider.addEventListener('oninput', handlePlayerSlider); playerSlider.addEventListener('onchange', handlePlayerSlider); - playerSlider.addEventListener('mouseup', handlePlayerSlider); + playerSlider.addEventListener('click', handlePlayerSlider); playerSlider.addEventListener('touchend', handlePlayerSlider); // Bind events for menu From e4aab1019c4abdd181e49d4d6b3a74717830ea72 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 19 Oct 2023 17:15:25 +0300 Subject: [PATCH 121/361] Don't copy YUV planes in x264 --- pkg/config/config.yaml | 2 +- pkg/encoder/h264/libx264.go | 14 +++------ pkg/encoder/h264/x264.go | 53 +++++++++++++---------------------- pkg/encoder/h264/x264_test.go | 29 +++++++++++++++++++ 4 files changed, 53 insertions(+), 45 deletions(-) create mode 100644 pkg/encoder/h264/x264_test.go diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 59a123bf..95dc4e4d 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -260,7 +260,7 @@ encoder: # see: https://trac.ffmpeg.org/wiki/Encode/H.264 h264: # Constant Rate Factor (CRF) 0-51 (default: 23) - crf: 23 + crf: 26 # ultrafast, superfast, veryfast, faster, fast, medium, slow, slower, veryslow, placebo preset: superfast # baseline, main, high, high10, high422, high444 diff --git a/pkg/encoder/h264/libx264.go b/pkg/encoder/h264/libx264.go index 775f9563..0539b437 100644 --- a/pkg/encoder/h264/libx264.go +++ b/pkg/encoder/h264/libx264.go @@ -362,10 +362,10 @@ type Sei struct { } type Image struct { - ICsp int32 /* Colorspace */ - IPlane int32 /* Number of image planes */ - IStride [4]int32 /* Strides for each plane */ - Plane [4]unsafe.Pointer /* Pointers to each plane */ + ICsp int32 /* Colorspace */ + IPlane int32 /* Number of image planes */ + IStride [4]int32 /* Strides for each plane */ + Plane [4]uintptr /* Pointers to each plane */ } type ImageProperties struct { @@ -455,12 +455,6 @@ type Picture struct { Opaque unsafe.Pointer } -func (p *Picture) freePlanes() { - for _, ptr := range p.Img.Plane { - C.free(ptr) - } -} - func (t *T) cptr() *C.x264_t { return (*C.x264_t)(unsafe.Pointer(t)) } func (n *Nal) cptr() *C.x264_nal_t { return (*C.x264_nal_t)(unsafe.Pointer(n)) } diff --git a/pkg/encoder/h264/x264.go b/pkg/encoder/h264/x264.go index c4b4ea00..ee7cb097 100644 --- a/pkg/encoder/h264/x264.go +++ b/pkg/encoder/h264/x264.go @@ -1,7 +1,5 @@ package h264 -// #include -import "C" import ( "fmt" "unsafe" @@ -18,7 +16,6 @@ type H264 struct { nals []*Nal in, out *Picture - y, u, v []byte } type Options struct { @@ -86,35 +83,26 @@ func NewEncoder(w, h int, opts *Options) (encoder *H264, err error) { encoder = &H264{ csp: param.ICsp, - lumaSize: int32(w * h), - chromaSize: int32(w*h) / 4, + lumaSize: param.IWidth * param.IHeight, + chromaSize: param.IWidth * param.IHeight / 4, nals: make([]*Nal, 1), - width: int32(w), + width: param.IWidth, out: new(Picture), + in: &Picture{ + Img: Image{ + ICsp: param.ICsp, + IPlane: 3, + IStride: [4]int32{ + 0: param.IWidth, + 1: param.IWidth >> 1, + 2: param.IWidth >> 1, + }, + }, + }, } - // pool - var picIn Picture - - picIn.Img.ICsp = encoder.csp - picIn.Img.IPlane = 3 - picIn.Img.IStride[0] = encoder.width - picIn.Img.IStride[1] = encoder.width >> 1 - picIn.Img.IStride[2] = encoder.width >> 1 - - picIn.Img.Plane[0] = C.malloc(C.size_t(encoder.lumaSize)) - picIn.Img.Plane[1] = C.malloc(C.size_t(encoder.chromaSize)) - picIn.Img.Plane[2] = C.malloc(C.size_t(encoder.chromaSize)) - - encoder.y = unsafe.Slice((*byte)(picIn.Img.Plane[0]), encoder.lumaSize) - encoder.u = unsafe.Slice((*byte)(picIn.Img.Plane[1]), encoder.chromaSize) - encoder.v = unsafe.Slice((*byte)(picIn.Img.Plane[2]), encoder.chromaSize) - - encoder.in = &picIn - if encoder.ref = EncoderOpen(¶m); encoder.ref == nil { err = fmt.Errorf("x264: cannot open the encoder") - return } return } @@ -122,15 +110,16 @@ func NewEncoder(w, h int, opts *Options) (encoder *H264, err error) { func LibVersion() int { return int(Build) } func (e *H264) LoadBuf(yuv []byte) { - copy(e.y, yuv[:e.lumaSize]) - copy(e.u, yuv[e.lumaSize:e.lumaSize+e.chromaSize]) - copy(e.v, yuv[e.lumaSize+e.chromaSize:]) + e.in.Img.Plane[0] = uintptr(unsafe.Pointer(&yuv[0])) + e.in.Img.Plane[1] = uintptr(unsafe.Pointer(&yuv[e.lumaSize])) + e.in.Img.Plane[2] = uintptr(unsafe.Pointer(&yuv[e.lumaSize+e.chromaSize])) } func (e *H264) Encode() []byte { e.in.IPts += 1 if ret := EncoderEncode(e.ref, e.nals, &e.nnals, e.in, e.out); ret > 0 { - return C.GoBytes(e.nals[0].PPayload, C.int(ret)) + return unsafe.Slice((*byte)(e.nals[0].PPayload), ret) + //return C.GoBytes(e.nals[0].PPayload, C.int(ret)) } return []byte{} } @@ -148,10 +137,6 @@ func (e *H264) SetFlip(b bool) { } func (e *H264) Shutdown() error { - e.y = nil - e.u = nil - e.v = nil - e.in.freePlanes() EncoderClose(e.ref) return nil } diff --git a/pkg/encoder/h264/x264_test.go b/pkg/encoder/h264/x264_test.go new file mode 100644 index 00000000..e819ba18 --- /dev/null +++ b/pkg/encoder/h264/x264_test.go @@ -0,0 +1,29 @@ +package h264 + +import "testing" + +func TestH264Encode(t *testing.T) { + h264, err := NewEncoder(120, 120, nil) + if err != nil { + t.Error(err) + } + data := make([]byte, 120*120*1.5) + h264.LoadBuf(data) + h264.Encode() + if err := h264.Shutdown(); err != nil { + t.Error(err) + } +} + +func Benchmark(b *testing.B) { + w, h := 1920, 1080 + h264, err := NewEncoder(w, h, nil) + if err != nil { + b.Error(err) + } + data := make([]byte, int(float64(w)*float64(h)*1.5)) + for i := 0; i < b.N; i++ { + h264.LoadBuf(data) + h264.Encode() + } +} From a69a934029185333405b570f10a0445c41f27526 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 19 Oct 2023 21:36:02 +0300 Subject: [PATCH 122/361] Remove unused csp param --- pkg/encoder/h264/x264.go | 2 -- 1 file changed, 2 deletions(-) diff --git a/pkg/encoder/h264/x264.go b/pkg/encoder/h264/x264.go index ee7cb097..ae8634cb 100644 --- a/pkg/encoder/h264/x264.go +++ b/pkg/encoder/h264/x264.go @@ -11,7 +11,6 @@ type H264 struct { width int32 lumaSize int32 chromaSize int32 - csp int32 nnals int32 nals []*Nal @@ -82,7 +81,6 @@ func NewEncoder(w, h int, opts *Options) (encoder *H264, err error) { param.Rc.FRfConstant = float32(opts.Crf) encoder = &H264{ - csp: param.ICsp, lumaSize: param.IWidth * param.IHeight, chromaSize: param.IWidth * param.IHeight / 4, nals: make([]*Nal, 1), From e80e31da4283abe80ad0cb754d8ab24bfe2faad1 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 19 Oct 2023 22:26:34 +0300 Subject: [PATCH 123/361] Use low pass filter with GBA --- pkg/config/config.yaml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 95dc4e4d..344aa10e 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -203,6 +203,9 @@ emulator: gba: lib: mgba_libretro roms: [ "gba", "gbc" ] + options: + mgba_audio_low_pass_filter: enabled + mgba_audio_low_pass_range: 40 pcsx: lib: pcsx_rearmed_libretro roms: [ "cue", "chd" ] From 9ec6541322fbd41838f4e26fe1285f3192f39fb6 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 20 Oct 2023 13:33:56 +0300 Subject: [PATCH 124/361] Update dependencies --- go.mod | 8 ++++---- go.sum | 14 ++++++++------ 2 files changed, 12 insertions(+), 10 deletions(-) diff --git a/go.mod b/go.mod index a5880268..82368bb6 100644 --- a/go.mod +++ b/go.mod @@ -11,10 +11,10 @@ require ( github.com/gorilla/websocket v1.5.0 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.0.1 - github.com/pion/ice/v3 v3.0.1 - github.com/pion/interceptor v0.1.22 + github.com/pion/ice/v3 v3.0.2 + github.com/pion/interceptor v0.1.24 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.0-beta.5 + github.com/pion/webrtc/v4 v4.0.0-beta.6 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.31.0 github.com/veandco/go-sdl2 v0.4.35 @@ -27,7 +27,7 @@ require ( github.com/davecgh/go-spew v1.1.1 // indirect github.com/google/uuid v1.3.1 // indirect github.com/mattn/go-colorable v0.1.13 // indirect - github.com/mattn/go-isatty v0.0.19 // indirect + github.com/mattn/go-isatty v0.0.20 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/mapstructure v1.5.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect diff --git a/go.sum b/go.sum index 62291f5c..fed062e6 100644 --- a/go.sum +++ b/go.sum @@ -46,8 +46,9 @@ github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA= github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg= github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM= -github.com/mattn/go-isatty v0.0.19 h1:JITubQf0MOLdlGRuRq+jtsDlekdYPia9ZFsB8h/APPA= github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= +github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= @@ -67,10 +68,11 @@ github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= -github.com/pion/ice/v3 v3.0.1 h1:dwWGgIFDlYrKrCW13LihifuFabGw375hoU0347S9wNw= github.com/pion/ice/v3 v3.0.1/go.mod h1:j4tfTlj4aSEQN9gP3IdliSHcUTWTu9tlOZL0c59MFXo= -github.com/pion/interceptor v0.1.22 h1:khhimAF0/VmGaIfeE+bA3X1jm0lD8C8HOGcU7vpWcPA= -github.com/pion/interceptor v0.1.22/go.mod h1:wkbPYAak5zKsfpVDYMtEfWEy8D4zL+rpxCxPImLOg3Y= +github.com/pion/ice/v3 v3.0.2 h1:dNQnKsjLvOWz+PaI4tw1VnLYTp9adihC1HIASFGajmI= +github.com/pion/ice/v3 v3.0.2/go.mod h1:q3BDzTsxbqP0ySMSHrFuw2MYGUx/AC3WQfRGC5F/0Is= +github.com/pion/interceptor v0.1.24 h1:lN4ua3yUAJCgNKQKcZIM52wFjBgjN0r7shLj91PkJ0c= +github.com/pion/interceptor v0.1.24/go.mod h1:wkbPYAak5zKsfpVDYMtEfWEy8D4zL+rpxCxPImLOg3Y= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= github.com/pion/mdns v0.0.8/go.mod h1:hYE72WX8WDveIhg7fmXgMKivD3Puklk0Ymzog0lSyaI= @@ -101,8 +103,8 @@ github.com/pion/transport/v3 v3.0.1 h1:gDTlPJwROfSfz6QfSi0ZmeCSkFcnWWiiR9ES0ouAN github.com/pion/transport/v3 v3.0.1/go.mod h1:UY7kiITrlMv7/IKgd5eTUcaahZx5oUN3l9SzK5f5xE0= github.com/pion/turn/v3 v3.0.1 h1:wLi7BTQr6/Q20R0vt/lHbjv6y4GChFtC33nkYbasoT8= github.com/pion/turn/v3 v3.0.1/go.mod h1:MrJDKgqryDyWy1/4NT9TWfXWGMC7UHT6pJIv1+gMeNE= -github.com/pion/webrtc/v4 v4.0.0-beta.5 h1:mW4Z8I50IG2ATa9i6tgClGMTdvTUHrxfAefReI0V2QE= -github.com/pion/webrtc/v4 v4.0.0-beta.5/go.mod h1:epqb0qKpAf5GWPMeDmK1W9Za+dJqlDcx4iKp7+aem6I= +github.com/pion/webrtc/v4 v4.0.0-beta.6 h1:swTwlzDY+1zDtW7ogXjNwlUY0xW733UUIAUMNUTCkPw= +github.com/pion/webrtc/v4 v4.0.0-beta.6/go.mod h1:UcyD8jIeTkFqfYJqoHT9qwUSmrtacKaXxgOEujOdhZ8= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= From da7059dc792b97111672171491fb79f8af03f8b3 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 20 Oct 2023 17:44:39 +0300 Subject: [PATCH 125/361] Tame logs --- pkg/worker/coordinatorhandlers.go | 2 -- 1 file changed, 2 deletions(-) diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 9fee6460..047e7d3a 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -162,7 +162,6 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com.Uid], w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) - c.log.Debug().Msgf(">>> users: %v", w.router.Users()) user.Disconnect() } } @@ -171,7 +170,6 @@ func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com. func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) - c.log.Debug().Msgf(">>> users: %v", w.router.Users()) } } From 377306dc80d8b3413fe6e2a1b49bfbc423572647 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 20 Oct 2023 17:50:48 +0300 Subject: [PATCH 126/361] Clean frontend tests --- pkg/worker/caged/libretro/frontend_test.go | 87 ++++++++++------------ 1 file changed, 41 insertions(+), 46 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index 60a08dee..0fa88f10 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -29,10 +29,11 @@ type TestFrontend struct { } type testRun struct { - room string - system string - rom string - emulationTicks int + name string + room string + system string + rom string + frames int } type game struct { @@ -138,22 +139,19 @@ func (emu *TestFrontend) Shutdown() { emu.Frontend.Shutdown() } -// dumpState returns the current emulator state and -// the latest saved state for its session. -// Locks the emulator. -func (emu *TestFrontend) dumpState() (string, string) { +// dumpState returns both current and previous emulator save state as MD5 hash string. +func (emu *TestFrontend) dumpState() (cur string, prev string) { emu.mu.Lock() - bytes, _ := os.ReadFile(emu.HashPath()) - lastStateHash := hash(bytes) + b, _ := os.ReadFile(emu.HashPath()) + prev = hash(b) emu.mu.Unlock() emu.mu.Lock() - state, _ := nanoarch.SaveState() + b, _ = nanoarch.SaveState() emu.mu.Unlock() - stateHash := hash(state) + cur = hash(b) - fmt.Printf("mem: %v, dat: %v\n", stateHash, lastStateHash) - return stateHash, lastStateHash + return } func BenchmarkEmulators(b *testing.B) { @@ -180,36 +178,33 @@ func BenchmarkEmulators(b *testing.B) { } } -// Tests a successful emulator state save. -func TestSave(t *testing.T) { +func TestSavePersistence(t *testing.T) { tests := []testRun{ - {room: "test_save_ok_00", system: sushi.system, rom: sushi.rom, emulationTicks: 100}, - {room: "test_save_ok_01", system: angua.system, rom: angua.rom, emulationTicks: 10}, + {system: sushi.system, rom: sushi.rom, frames: 100}, + {system: angua.system, rom: angua.rom, frames: 100}, } for _, test := range tests { - t.Logf("Testing [%v] save with [%v]\n", test.system, test.rom) + t.Run(fmt.Sprintf("If saves persistent on %v - %v", test.system, test.rom), func(t *testing.T) { + front := DefaultFrontend(test.room, test.system, test.rom) - front := DefaultFrontend(test.room, test.system, test.rom) + for test.frames > 0 { + front.Tick() + test.frames-- + } - for test.emulationTicks > 0 { - front.Tick() - test.emulationTicks-- - } + _, _ = front.dumpState() + if err := front.Save(); err != nil { + t.Error(err) + } - fmt.Printf("[%-14v] ", "before save") - _, _ = front.dumpState() - if err := front.Save(); err != nil { - t.Errorf("Save fail %v", err) - } - fmt.Printf("[%-14v] ", "after save") - snapshot1, snapshot2 := front.dumpState() + hash1, hash2 := front.dumpState() + if hash1 != hash2 { + t.Errorf("It seems that the previous state is diffrent: %v != %v", hash1, hash2) + } - if snapshot1 != snapshot2 { - t.Errorf("It seems rom state save has failed: %v != %v", snapshot1, snapshot2) - } - - front.Shutdown() + front.Shutdown() + }) } } @@ -222,9 +217,9 @@ func TestSave(t *testing.T) { // Compare states (a) and (b), should be =. func TestLoad(t *testing.T) { tests := []testRun{ - {room: "test_load_00", system: alwa.system, rom: alwa.rom, emulationTicks: 100}, - {room: "test_load_01", system: sushi.system, rom: sushi.rom, emulationTicks: 1000}, - {room: "test_load_02", system: angua.system, rom: angua.rom, emulationTicks: 100}, + {room: "test_load_00", system: alwa.system, rom: alwa.rom, frames: 100}, + {room: "test_load_01", system: sushi.system, rom: sushi.rom, frames: 1000}, + {room: "test_load_02", system: angua.system, rom: angua.rom, frames: 100}, } for _, test := range tests { @@ -235,10 +230,10 @@ func TestLoad(t *testing.T) { fmt.Printf("[%-14v] ", "initial") mock.dumpState() - for ticks := test.emulationTicks; ticks > 0; ticks-- { + for ticks := test.frames; ticks > 0; ticks-- { mock.Tick() } - fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.emulationTicks)) + fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.frames)) mock.dumpState() if err := mock.Save(); err != nil { @@ -247,10 +242,10 @@ func TestLoad(t *testing.T) { fmt.Printf("[%-14v] ", "saved") snapshot1, _ := mock.dumpState() - for ticks := test.emulationTicks; ticks > 0; ticks-- { + for ticks := test.frames; ticks > 0; ticks-- { mock.Tick() } - fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.emulationTicks)) + fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.frames)) mock.dumpState() if err := mock.Load(); err != nil { @@ -273,11 +268,11 @@ func TestStateConcurrency(t *testing.T) { seed int }{ { - run: testRun{room: "test_concurrency_00", system: sushi.system, rom: sushi.rom, emulationTicks: 120}, + run: testRun{room: "test_concurrency_00", system: sushi.system, rom: sushi.rom, frames: 120}, seed: 42, }, { - run: testRun{room: "test_concurrency_01", system: angua.system, rom: angua.rom, emulationTicks: 300}, + run: testRun{room: "test_concurrency_01", system: angua.system, rom: angua.rom, frames: 300}, seed: 42 + 42, }, } @@ -304,7 +299,7 @@ func TestStateConcurrency(t *testing.T) { _ = mock.Save() - for i := 0; i < test.run.emulationTicks; i++ { + for i := 0; i < test.run.frames; i++ { qLock.Lock() mock.Tick() qLock.Unlock() From 38dc69e4a2b88da3367a57dfc01da33a037cc0f4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 20 Oct 2023 20:19:04 +0300 Subject: [PATCH 127/361] Show hanged rooms --- pkg/worker/coordinatorhandlers.go | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 047e7d3a..970f023d 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -79,7 +79,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke } user.Index = rq.PlayerIndex - r := w.router.FindRoom(rq.Rid) + r := w.router.FindRoom(rq.Room.Rid) if r == nil { // new room uid := rq.Room.Rid @@ -89,10 +89,13 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke game := games.GameMetadata(rq.Game) r = room.NewRoom[*room.GameSession](uid, nil, w.router.Users(), nil) - r.HandleClose = func() { c.CloseRoom(uid) } + r.HandleClose = func() { + c.CloseRoom(uid) + c.log.Debug().Msgf("room close request %v sent") + } if other := w.router.Room(); other != nil { - c.log.Error().Msgf("concurrent room creation: %v", uid) + c.log.Error().Msgf("concurrent room creation: %v / %v", uid, w.router.Room().Id()) return api.EmptyPacket } From 10c4cd9b7f313589ce6e35ac60de45639d89d768 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 20 Oct 2023 18:50:04 +0300 Subject: [PATCH 128/361] Add start/stop frontend lock --- pkg/worker/caged/libretro/frontend.go | 50 +++++++++++----------- pkg/worker/caged/libretro/frontend_test.go | 17 +++++++- pkg/worker/coordinatorhandlers.go | 2 +- 3 files changed, 41 insertions(+), 28 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 052756a6..80392ded 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -66,7 +66,8 @@ type Frontend struct { th int // draw threads vw, vh int // out frame size - mu sync.Mutex + mu sync.Mutex + mui sync.Mutex DisableCanvasPool bool SaveOnClose bool @@ -198,7 +199,7 @@ func (f *Frontend) Shutdown() { f.SetAudioCb(noAudio) f.SetVideoCb(noVideo) f.mu.Unlock() - f.log.Debug().Msgf("frontend closed") + f.log.Debug().Msgf("frontend shutdown done") } func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { @@ -214,11 +215,14 @@ func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { func (f *Frontend) SetOnAV(fn func()) { f.nano.OnSystemAvInfo = fn } func (f *Frontend) Start() { - f.log.Debug().Msgf("Frontend start") + f.log.Debug().Msgf("frontend start") f.done = make(chan struct{}) f.nano.LastFrameTime = time.Now().UnixNano() + + f.mui.Lock() defer f.Shutdown() + defer f.mui.Unlock() if f.HasSave() { // advance 1 frame for Mupen save state @@ -248,34 +252,28 @@ func (f *Frontend) Start() { } } -func (f *Frontend) PixFormat() uint32 { return f.nano.Video.PixFmt.C } -func (f *Frontend) Rotation() uint { return f.nano.Rot } +func (f *Frontend) AudioSampleRate() int { return f.nano.AudioSampleRate() } +func (f *Frontend) FPS() int { return f.nano.VideoFramerate() } func (f *Frontend) Flipped() bool { return f.nano.IsGL() } func (f *Frontend) FrameSize() (int, int) { return f.nano.GeometryBase() } -func (f *Frontend) FPS() int { return f.nano.VideoFramerate() } -func (f *Frontend) HashPath() string { return f.storage.GetSavePath() } func (f *Frontend) HasSave() bool { return os.Exists(f.HashPath()) } -func (f *Frontend) SRAMPath() string { return f.storage.GetSRAMPath() } -func (f *Frontend) AudioSampleRate() int { return f.nano.AudioSampleRate() } +func (f *Frontend) HashPath() string { return f.storage.GetSavePath() } func (f *Frontend) Input(player int, data []byte) { f.input.setInput(player, data) } -func (f *Frontend) LoadGame(path string) error { return f.nano.LoadGame(path) } -func (f *Frontend) RestoreGameState() error { return f.Load() } -func (f *Frontend) Scale() float64 { return f.scale } func (f *Frontend) IsPortrait() bool { return f.nano.IsPortrait() } +func (f *Frontend) LoadGame(path string) error { return f.nano.LoadGame(path) } +func (f *Frontend) PixFormat() uint32 { return f.nano.Video.PixFmt.C } +func (f *Frontend) RestoreGameState() error { return f.Load() } +func (f *Frontend) Rotation() uint { return f.nano.Rot } +func (f *Frontend) SRAMPath() string { return f.storage.GetSRAMPath() } func (f *Frontend) SaveGameState() error { return f.Save() } +func (f *Frontend) Scale() float64 { return f.scale } func (f *Frontend) SetAudioCb(cb func(app.Audio)) { f.onAudio = cb } func (f *Frontend) SetSessionId(name string) { f.storage.SetMainSaveName(name) } func (f *Frontend) SetVideoCb(ff func(app.Video)) { f.onVideo = ff } -func (f *Frontend) SetViewport(width int, height int) { - f.mu.Lock() - f.vw, f.vh = width, height - f.mu.Unlock() -} - -// Tick runs one emulation frame. -func (f *Frontend) Tick() { f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } -func (f *Frontend) ToggleMultitap() { f.nano.ToggleMultitap() } -func (f *Frontend) ViewportSize() (int, int) { return f.vw, f.vh } +func (f *Frontend) SetViewport(w, h int) { f.mu.Lock(); f.vw, f.vh = w, h; f.mu.Unlock() } +func (f *Frontend) Tick() { f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } +func (f *Frontend) ToggleMultitap() { f.nano.ToggleMultitap() } +func (f *Frontend) ViewportSize() (int, int) { return f.vw, f.vh } func (f *Frontend) ViewportCalc() (nw int, nh int) { w, h := f.FrameSize() @@ -307,8 +305,11 @@ func (f *Frontend) ViewportCalc() (nw int, nh int) { } func (f *Frontend) Close() { - f.log.Debug().Msgf("frontend close called") + f.log.Debug().Msgf("frontend close") + close(f.done) + f.mui.Lock() + defer f.mui.Unlock() // Save game on quit if it was saved before (shared or click-saved). if f.SaveOnClose && f.HasSave() { f.log.Debug().Msg("Save on quit") @@ -316,9 +317,8 @@ func (f *Frontend) Close() { f.log.Error().Err(err).Msg("save on quit failed") } } - - close(f.done) f.nano.Close() + f.log.Debug().Msgf("frontend closed") } // Save writes the current state to the filesystem. diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index 0fa88f10..7c13cb76 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -10,6 +10,7 @@ import ( "path/filepath" "sync" "testing" + "time" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" @@ -67,9 +68,9 @@ func EmulatorMock(room string, system string) *TestFrontend { conf.Emulator.Storage = expand("tests", "storage") l := logger.Default() - l2 := l.Extend(l.Level(logger.ErrorLevel).With()) + l2 := l.Extend(l.Level(logger.WarnLevel).With()) - if err := manager.CheckCores(conf.Emulator, l); err != nil { + if err := manager.CheckCores(conf.Emulator, l2); err != nil { panic(err) } @@ -354,6 +355,18 @@ func TestConcurrentInput(t *testing.T) { wg.Wait() } +func TestStartStop(t *testing.T) { + f1 := DefaultFrontend("sushi", sushi.system, sushi.rom) + go f1.Start() + time.Sleep(1 * time.Second) + f1.Close() + + f2 := DefaultFrontend("sushi", sushi.system, sushi.rom) + go f2.Start() + time.Sleep(100 * time.Millisecond) + f2.Close() +} + // expand joins a list of file path elements. func expand(p ...string) string { ph, _ := filepath.Abs(filepath.FromSlash(filepath.Join(p...))) diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 970f023d..7384c8c6 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -91,7 +91,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke r = room.NewRoom[*room.GameSession](uid, nil, w.router.Users(), nil) r.HandleClose = func() { c.CloseRoom(uid) - c.log.Debug().Msgf("room close request %v sent") + c.log.Debug().Msgf("room close request %v sent", uid) } if other := w.router.Room(); other != nil { From 10507d9c53599367dd375c5177c10aef93e7e373 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 21 Oct 2023 00:07:10 +0300 Subject: [PATCH 129/361] Reorder shutdown functions --- pkg/worker/caged/libretro/frontend.go | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 80392ded..462a10d2 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -217,11 +217,20 @@ func (f *Frontend) SetOnAV(fn func()) { f.nano.OnSystemAvInfo = fn } func (f *Frontend) Start() { f.log.Debug().Msgf("frontend start") + f.mui.Lock() f.done = make(chan struct{}) f.nano.LastFrameTime = time.Now().UnixNano() - f.mui.Lock() - defer f.Shutdown() + defer func() { + // Save game on quit if it was saved before (shared or click-saved). + if f.SaveOnClose && f.HasSave() { + f.log.Debug().Msg("save on quit") + if err := f.Save(); err != nil { + f.log.Error().Err(err).Msg("save on quit failed") + } + } + f.Shutdown() + }() defer f.mui.Unlock() if f.HasSave() { @@ -306,17 +315,11 @@ func (f *Frontend) ViewportCalc() (nw int, nh int) { func (f *Frontend) Close() { f.log.Debug().Msgf("frontend close") + close(f.done) f.mui.Lock() defer f.mui.Unlock() - // Save game on quit if it was saved before (shared or click-saved). - if f.SaveOnClose && f.HasSave() { - f.log.Debug().Msg("Save on quit") - if err := f.Save(); err != nil { - f.log.Error().Err(err).Msg("save on quit failed") - } - } f.nano.Close() f.log.Debug().Msgf("frontend closed") } From cb968d782a6b31c82a1eab32e36463dd929e2400 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 21 Oct 2023 02:37:44 +0300 Subject: [PATCH 130/361] Show rooms in the list --- pkg/api/coordinator.go | 1 + pkg/coordinator/hub.go | 9 +++++++-- web/js/workerManager.js | 13 ++++++++++++- 3 files changed, 20 insertions(+), 3 deletions(-) diff --git a/pkg/api/coordinator.go b/pkg/api/coordinator.go index 6c79bc8b..9cdf22b7 100644 --- a/pkg/api/coordinator.go +++ b/pkg/api/coordinator.go @@ -36,6 +36,7 @@ type Server struct { PingURL string `json:"ping_url"` Port string `json:"port,omitempty"` Replicas uint32 `json:"replicas,omitempty"` + Room string `json:"room,omitempty"` Tag string `json:"tag,omitempty"` Zone string `json:"zone,omitempty"` } diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index 8d19fb4f..8b57df74 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -144,8 +144,9 @@ func (h *Hub) handleWorkerConnection() http.HandlerFunc { } func (h *Hub) GetServerList() (r []api.Server) { + debug := h.conf.Coordinator.Debug h.workers.ForEach(func(w *Worker) { - r = append(r, api.Server{ + server := api.Server{ Addr: w.Addr, Id: w.Id(), IsBusy: !w.HasSlot(), @@ -154,7 +155,11 @@ func (h *Hub) GetServerList() (r []api.Server) { Port: w.Port, Tag: w.Tag, Zone: w.Zone, - }) + } + if debug { + server.Room = w.RoomId + } + r = append(r, server) }) return } diff --git a/web/js/workerManager.js b/web/js/workerManager.js index d8fe4d18..56f463e4 100644 --- a/web/js/workerManager.js +++ b/web/js/workerManager.js @@ -37,7 +37,7 @@ const workerManager = (() => { }, 'is_busy': { caption: 'State', - renderer: (data) => data?.is_busy === true ? 'R' : '' + renderer: renderStateEl }, 'use': { caption: 'Use', @@ -112,6 +112,17 @@ const workerManager = (() => { }) } + function renderStateEl(server) { + const state = server?.is_busy === true ? 'R' : '' + if (server.room) { + return gui.create('a', (el) => { + el.innerText = state; + el.href = "/?id="+server.room; + }) + } + return state + } + panel.toggle(false); trigger.addEventListener('click', () => { From 3e116fcc52d3f2dd01e0a9d828e54f4986577341 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 21 Oct 2023 18:45:38 +0300 Subject: [PATCH 131/361] Drop users when coordinator is lost --- pkg/worker/coordinatorhandlers.go | 2 + pkg/worker/room/room.go | 12 ++++- pkg/worker/room/room_test.go | 28 ------------ pkg/worker/room/router_test.go | 74 +++++++++++++++++++++++++++++++ pkg/worker/worker.go | 5 ++- 5 files changed, 91 insertions(+), 30 deletions(-) create mode 100644 pkg/worker/room/router_test.go diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 7384c8c6..737c7bd9 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -165,6 +165,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com.Uid], w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) + c.log.Debug().Msgf(">>> users: %v", w.router.Users()) user.Disconnect() } } @@ -173,6 +174,7 @@ func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com. func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) + c.log.Debug().Msgf(">>> users: %v", w.router.Users()) } } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index 51978532..0f111456 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -119,7 +119,7 @@ func (r *Router[T]) FindRoom(id string) *Room[T] { func (r *Router[T]) Remove(user T) { if left := r.users.RemoveL(user); left == 0 { r.Close() - r.SetRoom(nil) + r.SetRoom(nil) // !to remove } } @@ -130,6 +130,16 @@ func (r *Router[T]) Room() *Room[T] { r.mu.Lock(); defer r.mu.Unlock() func (r *Router[T]) SetRoom(room *Room[T]) { r.mu.Lock(); r.room = room; r.mu.Unlock() } func (r *Router[T]) HasRoom() bool { r.mu.Lock(); defer r.mu.Unlock(); return r.room != nil } func (r *Router[T]) Users() SessionManager[T] { return r.users } +func (r *Router[T]) Reset() { + r.mu.Lock() + if r.room != nil { + r.room.Close() + r.room = nil + } + r.users.ForEach(func(u T) { u.Disconnect() }) + r.users.Reset() + r.mu.Unlock() +} type AppSession struct { Uid diff --git a/pkg/worker/room/room_test.go b/pkg/worker/room/room_test.go index ed67e48c..e41004b9 100644 --- a/pkg/worker/room/room_test.go +++ b/pkg/worker/room/room_test.go @@ -269,34 +269,6 @@ func BenchmarkRoom(b *testing.B) { } } -type tSession struct{} - -func (t tSession) SendAudio([]byte, int32) {} -func (t tSession) SendVideo([]byte, int32) {} -func (t tSession) SendData([]byte) {} -func (t tSession) Disconnect() {} -func (t tSession) Id() string { return "1" } - -func TestRouter(t *testing.T) { - u := com.NewNetMap[string, *tSession]() - router := Router[*tSession]{users: &u} - - var r *Room[*tSession] - - router.SetRoom(&Room[*tSession]{id: "test001"}) - room := router.FindRoom("test001") - if room == nil { - t.Errorf("no room, but should be") - } - router.SetRoom(r) - room = router.FindRoom("x") - if room != nil { - t.Errorf("a room, but should not be") - } - router.SetRoom(nil) - router.Close() -} - // expand joins a list of file path elements. func expand(p ...string) string { ph, _ := filepath.Abs(filepath.FromSlash(filepath.Join(p...))) diff --git a/pkg/worker/room/router_test.go b/pkg/worker/room/router_test.go new file mode 100644 index 00000000..f404073c --- /dev/null +++ b/pkg/worker/room/router_test.go @@ -0,0 +1,74 @@ +package room + +import ( + "testing" + + "github.com/giongto35/cloud-game/v3/pkg/com" +) + +type tSession struct { + id string + connected bool +} + +func (t *tSession) SendAudio([]byte, int32) {} +func (t *tSession) SendVideo([]byte, int32) {} +func (t *tSession) SendData([]byte) {} +func (t *tSession) Connect() { t.connected = true } +func (t *tSession) Disconnect() { t.connected = false } +func (t *tSession) Id() string { return t.id } + +type lookMap struct { + com.NetMap[string, *tSession] + prev com.NetMap[string, *tSession] // we could use pointers in the original :3 +} + +func (l *lookMap) Reset() { + l.prev = com.NewNetMap[string, *tSession]() + l.Map.ForEach(func(s *tSession) { l.prev.Add(s) }) + l.NetMap.Reset() +} + +func TestRouter(t *testing.T) { + router := newTestRouter() + + var r *Room[*tSession] + + router.SetRoom(&Room[*tSession]{id: "test001"}) + room := router.FindRoom("test001") + if room == nil { + t.Errorf("no room, but should be") + } + router.SetRoom(r) + room = router.FindRoom("x") + if room != nil { + t.Errorf("a room, but should not be") + } + router.SetRoom(nil) + router.Close() +} + +func TestRouterReset(t *testing.T) { + u := lookMap{NetMap: com.NewNetMap[string, *tSession]()} + router := Router[*tSession]{users: &u} + + router.AddUser(&tSession{id: "1", connected: true}) + router.AddUser(&tSession{id: "2", connected: false}) + router.AddUser(&tSession{id: "3", connected: true}) + + router.Reset() + + disconnected := true + u.prev.ForEach(func(u *tSession) { disconnected = disconnected && !u.connected }) + if !disconnected { + t.Errorf("not all users were disconnected, but should") + } + if !router.Users().Empty() { + t.Errorf("has users after reset, but should not") + } +} + +func newTestRouter() *Router[*tSession] { + u := com.NewNetMap[string, *tSession]() + return &Router[*tSession]{users: &u} +} diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 04e3ae27..6ff68e03 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -69,7 +69,7 @@ func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { return worker, nil } -func (w *Worker) Reset() { w.router.Close() } +func (w *Worker) Reset() { w.router.Reset() } func (w *Worker) Start(done chan struct{}) { for _, s := range w.services { @@ -77,6 +77,9 @@ func (w *Worker) Start(done chan struct{}) { s.Run() } } + + // !to restore alive worker info when coordinator connection was lost + go func() { remoteAddr := w.conf.Worker.Network.CoordinatorAddress defer func() { From 65251061160c384e3eae7b992e965cdeb4cccac5 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 24 Oct 2023 02:46:57 +0300 Subject: [PATCH 132/361] Update video encoders --- pkg/config/config.yaml | 2 + pkg/config/worker.go | 5 ++- pkg/encoder/encoder.go | 54 +++++++++++++++---------- pkg/encoder/h264/libx264.go | 11 +++-- pkg/encoder/h264/x264.go | 73 +++++++++++++++------------------- pkg/encoder/h264/x264_test.go | 4 +- pkg/encoder/vpx/libvpx.go | 2 + pkg/worker/media/media.go | 29 +++----------- pkg/worker/media/media_test.go | 36 +++++++++++++---- 9 files changed, 116 insertions(+), 100 deletions(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 344aa10e..cbfe0ab5 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -260,6 +260,8 @@ encoder: video: # h264, vpx (VP8) codec: h264 + # Threaded encoder if supported, 0 - auto, 1 - nope, >1 - multi-threaded + threads: 0 # see: https://trac.ffmpeg.org/wiki/Encode/H.264 h264: # Constant Rate Factor (CRF) 0-51 (default: 23) diff --git a/pkg/config/worker.go b/pkg/config/worker.go index ab6af2cc..c0c39adf 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -52,8 +52,9 @@ type Audio struct { } type Video struct { - Codec string - H264 struct { + Codec string + Threads int + H264 struct { Crf uint8 LogLevel int32 Preset string diff --git a/pkg/encoder/encoder.go b/pkg/encoder/encoder.go index 60e960d0..a9f9003c 100644 --- a/pkg/encoder/encoder.go +++ b/pkg/encoder/encoder.go @@ -2,9 +2,11 @@ package encoder import ( "fmt" - "sync" "sync/atomic" + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/encoder/h264" + "github.com/giongto35/cloud-game/v3/pkg/encoder/vpx" "github.com/giongto35/cloud-game/v3/pkg/encoder/yuv" "github.com/giongto35/cloud-game/v3/pkg/logger" ) @@ -16,6 +18,7 @@ type ( LoadBuf(input []byte) Encode() []byte IntraRefresh() + Info() string SetFlip(bool) Shutdown() error } @@ -28,7 +31,6 @@ type Video struct { y yuv.Conv pf yuv.PixFmt rot uint - mu sync.Mutex } type VideoCodec string @@ -36,6 +38,7 @@ type VideoCodec string const ( H264 VideoCodec = "h264" VP8 VideoCodec = "vp8" + VPX VideoCodec = "vpx" ) // NewVideoEncoder returns new video encoder. @@ -43,13 +46,27 @@ const ( // converts them into YUV I420 format, // encodes with provided video encoder, and // puts the result into the output channel. -func NewVideoEncoder(codec Encoder, w, h int, scale float64, log *logger.Logger) *Video { - return &Video{codec: codec, y: yuv.NewYuvConv(w, h, scale), log: log} +func NewVideoEncoder(w, h, dw, dh int, scale float64, conf config.Video, log *logger.Logger) (*Video, error) { + var enc Encoder + var err error + switch VideoCodec(conf.Codec) { + case H264: + opts := h264.Options(conf.H264) + enc, err = h264.NewEncoder(dw, dh, conf.Threads, &opts) + case VP8, VPX: + opts := vpx.Options(conf.Vpx) + enc, err = vpx.NewEncoder(dw, dh, &opts) + default: + err = fmt.Errorf("unsupported codec: %v", conf.Codec) + } + if err != nil { + return nil, err + } + + return &Video{codec: enc, y: yuv.NewYuvConv(w, h, scale), log: log}, nil } func (v *Video) Encode(frame InFrame) OutFrame { - v.mu.Lock() - defer v.mu.Unlock() if v.stopped.Load() { return nil } @@ -64,7 +81,9 @@ func (v *Video) Encode(frame InFrame) OutFrame { return nil } -func (v *Video) Info() string { return fmt.Sprintf("libyuv: %v", v.y.Version()) } +func (v *Video) Info() string { + return fmt.Sprintf("%v, libyuv: %v", v.codec.Info(), v.y.Version()) +} func (v *Video) SetPixFormat(f uint32) { switch f { @@ -77,16 +96,10 @@ func (v *Video) SetPixFormat(f uint32) { } } -// SetRot sets the rotation angle of the frames. -func (v *Video) SetRot(r uint) { - switch r { - // de-rotate - case 90: - v.rot = 270 - case 270: - v.rot = 90 - default: - v.rot = r +// SetRot sets the de-rotation angle of the frames. +func (v *Video) SetRot(a uint) { + if a > 0 { + v.rot = (a + 180) % 360 } } @@ -94,11 +107,12 @@ func (v *Video) SetRot(r uint) { func (v *Video) SetFlip(b bool) { v.codec.SetFlip(b) } func (v *Video) Stop() { - v.stopped.Store(true) - v.mu.Lock() - defer v.mu.Unlock() + if v.stopped.Swap(true) { + return + } v.rot = 0 + defer func() { v.codec = nil }() if err := v.codec.Shutdown(); err != nil { v.log.Error().Err(err).Msg("failed to close the encoder") } diff --git a/pkg/encoder/h264/libx264.go b/pkg/encoder/h264/libx264.go index 0539b437..6be21eb6 100644 --- a/pkg/encoder/h264/libx264.go +++ b/pkg/encoder/h264/libx264.go @@ -8,6 +8,11 @@ package h264 #include "stdint.h" #include "x264.h" #include + +static int x264_encode( x264_t *h, uintptr_t pp_nal, int *pi_nal, x264_picture_t *pic_in, x264_picture_t *pic_out ) { + return x264_encoder_encode(h, (x264_nal_t **)pp_nal, pi_nal, pic_in, pic_out); +} + */ import "C" import "unsafe" @@ -505,16 +510,16 @@ func EncoderOpen(param *Param) *T { // EncoderEncode - encode one picture. // Returns the number of bytes in the returned NALs, negative on error and zero if no NAL units returned. -func EncoderEncode(enc *T, ppNal []*Nal, piNal *int32, picIn *Picture, picOut *Picture) int32 { +func EncoderEncode(enc *T, ppNal **Nal, piNal *int32, picIn *Picture, picOut *Picture) int32 { cenc := enc.cptr() - cppNal := (**C.x264_nal_t)(unsafe.Pointer(&ppNal[0])) + cppNal := C.uintptr_t(uintptr(unsafe.Pointer(ppNal))) cpiNal := (*C.int)(unsafe.Pointer(piNal)) cpicIn := picIn.cptr() cpicOut := picOut.cptr() - return (int32)(C.x264_encoder_encode(cenc, cppNal, cpiNal, cpicIn, cpicOut)) + return (int32)(C.x264_encode(cenc, cppNal, cpiNal, cpicIn, cpicOut)) } // EncoderClose closes an encoder handler. diff --git a/pkg/encoder/h264/x264.go b/pkg/encoder/h264/x264.go index ae8634cb..8b10ce58 100644 --- a/pkg/encoder/h264/x264.go +++ b/pkg/encoder/h264/x264.go @@ -8,12 +8,10 @@ import ( type H264 struct { ref *T - width int32 - lumaSize int32 - chromaSize int32 - nnals int32 - nals []*Nal - + pnals *Nal // array of NALs + nnals int32 // number of NALs + y int32 // Y size + uv int32 // U or V size in, out *Picture } @@ -32,11 +30,11 @@ type Options struct { Tune string } -func NewEncoder(w, h int, opts *Options) (encoder *H264, err error) { +func NewEncoder(w, h int, th int, opts *Options) (encoder *H264, err error) { libVersion := LibVersion() - if libVersion < 150 { - return nil, fmt.Errorf("x264: the library version should be newer than v150, you have got version %v", libVersion) + if libVersion < 156 { + return nil, fmt.Errorf("x264: the library version should be newer than v155, you have got version %v", libVersion) } if opts == nil { @@ -63,39 +61,28 @@ func NewEncoder(w, h int, opts *Options) (encoder *H264, err error) { } } - // legacy encoder lacks of this param - param.IBitdepth = 8 + ww, hh := int32(w), int32(h) - if libVersion > 155 { - param.ICsp = CspI420 - } else { - param.ICsp = 1 - } - param.IWidth = int32(w) - param.IHeight = int32(h) + param.IBitdepth = 8 + param.ICsp = CspI420 + param.IWidth = ww + param.IHeight = hh param.ILogLevel = opts.LogLevel param.ISyncLookahead = 0 - param.IThreads = 1 - + param.IThreads = int32(th) + if th != 1 { + param.BSlicedThreads = 1 + } param.Rc.IRcMethod = RcCrf param.Rc.FRfConstant = float32(opts.Crf) encoder = &H264{ - lumaSize: param.IWidth * param.IHeight, - chromaSize: param.IWidth * param.IHeight / 4, - nals: make([]*Nal, 1), - width: param.IWidth, - out: new(Picture), + y: ww * hh, + uv: ww * hh / 4, + pnals: new(Nal), + out: new(Picture), in: &Picture{ - Img: Image{ - ICsp: param.ICsp, - IPlane: 3, - IStride: [4]int32{ - 0: param.IWidth, - 1: param.IWidth >> 1, - 2: param.IWidth >> 1, - }, - }, + Img: Image{ICsp: param.ICsp, IPlane: 3, IStride: [4]int32{0: ww, 1: ww >> 1, 2: ww >> 1}}, }, } @@ -109,23 +96,27 @@ func LibVersion() int { return int(Build) } func (e *H264) LoadBuf(yuv []byte) { e.in.Img.Plane[0] = uintptr(unsafe.Pointer(&yuv[0])) - e.in.Img.Plane[1] = uintptr(unsafe.Pointer(&yuv[e.lumaSize])) - e.in.Img.Plane[2] = uintptr(unsafe.Pointer(&yuv[e.lumaSize+e.chromaSize])) + e.in.Img.Plane[1] = uintptr(unsafe.Pointer(&yuv[e.y])) + e.in.Img.Plane[2] = uintptr(unsafe.Pointer(&yuv[e.y+e.uv])) } -func (e *H264) Encode() []byte { +func (e *H264) Encode() (b []byte) { e.in.IPts += 1 - if ret := EncoderEncode(e.ref, e.nals, &e.nnals, e.in, e.out); ret > 0 { - return unsafe.Slice((*byte)(e.nals[0].PPayload), ret) - //return C.GoBytes(e.nals[0].PPayload, C.int(ret)) + bytes := EncoderEncode(e.ref, &e.pnals, &e.nnals, e.in, e.out) + if bytes > 0 { + // we merge multiple NALs stored in **pnals into a single byte stream + // ret contains the total size of NALs in bytes, i.e. each e.pnals[...].PPayload * IPayload + b = unsafe.Slice((*byte)(e.pnals.PPayload), bytes) } - return []byte{} + return } func (e *H264) IntraRefresh() { // !to implement } +func (e *H264) Info() string { return fmt.Sprintf("x264: v%v", LibVersion()) } + func (e *H264) SetFlip(b bool) { if b { e.in.Img.ICsp |= CspVflip diff --git a/pkg/encoder/h264/x264_test.go b/pkg/encoder/h264/x264_test.go index e819ba18..b13c0bc4 100644 --- a/pkg/encoder/h264/x264_test.go +++ b/pkg/encoder/h264/x264_test.go @@ -3,7 +3,7 @@ package h264 import "testing" func TestH264Encode(t *testing.T) { - h264, err := NewEncoder(120, 120, nil) + h264, err := NewEncoder(120, 120, 0, nil) if err != nil { t.Error(err) } @@ -17,7 +17,7 @@ func TestH264Encode(t *testing.T) { func Benchmark(b *testing.B) { w, h := 1920, 1080 - h264, err := NewEncoder(w, h, nil) + h264, err := NewEncoder(w, h, 0, nil) if err != nil { b.Error(err) } diff --git a/pkg/encoder/vpx/libvpx.go b/pkg/encoder/vpx/libvpx.go index ca423e0d..81988b9c 100644 --- a/pkg/encoder/vpx/libvpx.go +++ b/pkg/encoder/vpx/libvpx.go @@ -163,6 +163,8 @@ func (vpx *Vpx) Encode() []byte { return C.GoBytes(fb.ptr, fb.size) } +func (vpx *Vpx) Info() string { return fmt.Sprintf("vpx: %v", C.GoString(C.vpx_codec_version_str())) } + func (vpx *Vpx) IntraRefresh() { // !to implement } diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 7c9a242e..588259ac 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -8,9 +8,7 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/encoder" - "github.com/giongto35/cloud-game/v3/pkg/encoder/h264" "github.com/giongto35/cloud-game/v3/pkg/encoder/opus" - "github.com/giongto35/cloud-game/v3/pkg/encoder/vpx" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" ) @@ -145,6 +143,7 @@ func (wmp *WebrtcMediaPipe) Init() error { if err := wmp.initVideo(wmp.VideoW, wmp.VideoH, wmp.VideoScale, wmp.vConf); err != nil { return err } + wmp.log.Debug().Msgf("%v", wmp.v.Info()) return nil } @@ -175,29 +174,11 @@ func (wmp *WebrtcMediaPipe) encodeAudio(pcm samples) { wmp.onAudio(data) } -func (wmp *WebrtcMediaPipe) initVideo(w, h int, scale float64, conf config.Video) error { - var enc encoder.Encoder - var err error - +func (wmp *WebrtcMediaPipe) initVideo(w, h int, scale float64, conf config.Video) (err error) { sw, sh := round(w, scale), round(h, scale) - - wmp.log.Debug().Msgf("Scale: %vx%v -> %vx%v", w, h, sw, sh) - - wmp.log.Info().Msgf("Video codec: %v", conf.Codec) - if conf.Codec == string(encoder.H264) { - wmp.log.Debug().Msgf("x264: build v%v", h264.LibVersion()) - opts := h264.Options(conf.H264) - enc, err = h264.NewEncoder(sw, sh, &opts) - } else { - opts := vpx.Options(conf.Vpx) - enc, err = vpx.NewEncoder(sw, sh, &opts) - } - if err != nil { - return fmt.Errorf("couldn't create a video encoder: %w", err) - } - wmp.v = encoder.NewVideoEncoder(enc, w, h, scale, wmp.log) - wmp.log.Debug().Msgf("%v", wmp.v.Info()) - return nil + wmp.v, err = encoder.NewVideoEncoder(w, h, sw, sh, scale, conf, wmp.log) + wmp.log.Debug().Msgf("media scale: %vx%v -> %vx%v", w, h, sw, sh) + return err } func round(x int, scale float64) int { return (int(float64(x)*scale) + 1) & ^1 } diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index e99522ef..93568cc2 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -6,9 +6,8 @@ import ( "reflect" "testing" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/encoder" - "github.com/giongto35/cloud-game/v3/pkg/encoder/h264" - "github.com/giongto35/cloud-game/v3/pkg/encoder/vpx" "github.com/giongto35/cloud-game/v3/pkg/logger" ) @@ -38,15 +37,36 @@ func BenchmarkH264(b *testing.B) { run(1920, 1080, encoder.H264, b.N, nil, nil, func BenchmarkVP8(b *testing.B) { run(1920, 1080, encoder.VP8, b.N, nil, nil, b) } func run(w, h int, cod encoder.VideoCodec, count int, a *image.RGBA, b *image.RGBA, backend testing.TB) { - var enc encoder.Encoder - if cod == encoder.H264 { - enc, _ = h264.NewEncoder(w, h, nil) - } else { - enc, _ = vpx.NewEncoder(w, h, nil) + conf := config.Video{ + Codec: string(cod), + Threads: 0, + H264: struct { + Crf uint8 + LogLevel int32 + Preset string + Profile string + Tune string + }{ + Crf: 30, + LogLevel: 0, + Preset: "ultrafast", + Profile: "baseline", + Tune: "zerolatency", + }, + Vpx: struct { + Bitrate uint + KeyframeInterval uint + }{ + Bitrate: 1000, + KeyframeInterval: 5, + }, } logger.SetGlobalLevel(logger.Disabled) - ve := encoder.NewVideoEncoder(enc, w, h, 1, l) + ve, err := encoder.NewVideoEncoder(w, h, w, h, 1, conf, l) + if err != nil { + backend.Error(err) + } defer ve.Stop() if a == nil { From 07f40351fad89ea27e7c21b44a48e6e530daca05 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 24 Oct 2023 12:41:40 +0300 Subject: [PATCH 133/361] Show PCSX boot logo by default --- pkg/config/config.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index cbfe0ab5..eeec4122 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -213,6 +213,7 @@ emulator: folder: psx # see: https://github.com/libretro/pcsx_rearmed/blob/master/frontend/libretro_core_options.h options: + "pcsx_rearmed_show_bios_bootlogo": enabled "pcsx_rearmed_drc": enabled "pcsx_rearmed_display_internal_fps": disabled # MAME core requires additional manual setup, please read: From 7f2f1d70b11f48c38d63166bc7bad0e1f1e7987b Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Wed, 25 Oct 2023 21:41:36 +0300 Subject: [PATCH 134/361] Add configurable debouncer for spammy Libretro callbacks --- pkg/config/config.yaml | 3 + pkg/config/emulator.go | 1 + pkg/worker/caged/libretro/caged.go | 14 +- pkg/worker/caged/libretro/frontend.go | 39 +++--- pkg/worker/caged/libretro/frontend_test.go | 8 +- .../caged/libretro/nanoarch/nanoarch.go | 121 +++++++++++------- .../caged/libretro/nanoarch/nanoarch_test.go | 22 ++++ pkg/worker/coordinatorhandlers.go | 9 +- 8 files changed, 131 insertions(+), 86 deletions(-) create mode 100644 pkg/worker/caged/libretro/nanoarch/nanoarch_test.go diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index eeec4122..3ffc0891 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -139,6 +139,9 @@ emulator: libretro: # use zip compression for emulator save states saveCompression: true + # Sets a limiter function for some spammy core callbacks. + # 0 - disabled, otherwise -- time in milliseconds for ignoring repeated calls except the last. + debounceMs: 0 # Libretro cores logging level: DEBUG = 0, INFO, WARN, ERROR, DUMMY = INT_MAX logLevel: 1 cores: diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index f7d71fc3..84e57ed8 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -32,6 +32,7 @@ type LibretroConfig struct { } List map[string]LibretroCoreConfig } + DebounceMs int SaveCompression bool LogLevel int } diff --git a/pkg/worker/caged/libretro/caged.go b/pkg/worker/caged/libretro/caged.go index 2260b4c0..20f95847 100644 --- a/pkg/worker/caged/libretro/caged.go +++ b/pkg/worker/caged/libretro/caged.go @@ -46,21 +46,15 @@ func (c *Caged) ReloadFrontend() { c.base = frontend } -func (c *Caged) HandleOnSystemAvInfo(fn func()) { - c.base.SetOnAV(func() { - w, h := c.ViewportCalc() - c.SetViewport(w, h) - fn() - }) -} +// VideoChangeCb adds a callback when video params are changed by the app. +func (c *Caged) VideoChangeCb(fn func()) { c.base.SetVideoChangeCb(fn) } func (c *Caged) Load(game games.GameMetadata, path string) error { c.Emulator.LoadCore(game.System) if err := c.Emulator.LoadGame(game.FullPath(path)); err != nil { return err } - w, h := c.ViewportCalc() - c.SetViewport(w, h) + c.ViewportRecalculate() return nil } @@ -87,7 +81,7 @@ func (c *Caged) EnableCloudStorage(uid string, storage cloud.Storage) { func (c *Caged) PixFormat() uint32 { return c.Emulator.PixFormat() } func (c *Caged) Rotation() uint { return c.Emulator.Rotation() } func (c *Caged) AudioSampleRate() int { return c.Emulator.AudioSampleRate() } -func (c *Caged) ViewportSize() (int, int) { return c.Emulator.ViewportSize() } +func (c *Caged) ViewportSize() (int, int) { return c.base.ViewportSize() } func (c *Caged) Scale() float64 { return c.Emulator.Scale() } func (c *Caged) SendControl(port int, data []byte) { c.base.Input(port, data) } func (c *Caged) Start() { go c.Emulator.Start() } diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 462a10d2..e33f6b0f 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -30,11 +30,8 @@ type Emulator interface { IsPortrait() bool // Start is called after LoadGame Start() - // SetViewport sets viewport size - SetViewport(width int, height int) - // ViewportCalc calculates the viewport size with the aspect ratio and scale - ViewportCalc() (nw int, nh int) - ViewportSize() (w, h int) + // ViewportRecalculate calculates output resolution with aspect and scale + ViewportRecalculate() RestoreGameState() error // SetSessionId sets distinct name for the game session (in order to save/load it later) SetSessionId(name string) @@ -112,8 +109,13 @@ func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { nano := nanoarch.NewNano(path) log = log.Extend(log.With().Str("m", "Libretro")) - ll := log.Extend(log.Level(logger.Level(conf.Libretro.LogLevel)).With()) - nano.SetLogger(ll) + level := logger.Level(conf.Libretro.LogLevel) + if level == logger.DebugLevel { + level = logger.TraceLevel + nano.SetLogger(log.Extend(log.Level(level).With())) + } else { + nano.SetLogger(log) + } // Check if room is on local storage, if not, pull from GCS to local storage log.Info().Msgf("Local storage path: %v", conf.Storage) @@ -139,6 +141,12 @@ func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { } f.linkNano(nano) + if conf.Libretro.DebounceMs > 0 { + t := time.Duration(conf.Libretro.DebounceMs) * time.Millisecond + f.nano.SetVideoDebounce(t) + f.log.Debug().Msgf("set debounce time: %v", t) + } + return f, nil } @@ -212,7 +220,7 @@ func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { f.nano.OnAudio = f.handleAudio } -func (f *Frontend) SetOnAV(fn func()) { f.nano.OnSystemAvInfo = fn } +func (f *Frontend) SetVideoChangeCb(fn func()) { f.nano.OnSystemAvInfo = fn } func (f *Frontend) Start() { f.log.Debug().Msgf("frontend start") @@ -264,7 +272,7 @@ func (f *Frontend) Start() { func (f *Frontend) AudioSampleRate() int { return f.nano.AudioSampleRate() } func (f *Frontend) FPS() int { return f.nano.VideoFramerate() } func (f *Frontend) Flipped() bool { return f.nano.IsGL() } -func (f *Frontend) FrameSize() (int, int) { return f.nano.GeometryBase() } +func (f *Frontend) FrameSize() (int, int) { return f.nano.BaseWidth(), f.nano.BaseHeight() } func (f *Frontend) HasSave() bool { return os.Exists(f.HashPath()) } func (f *Frontend) HashPath() string { return f.storage.GetSavePath() } func (f *Frontend) Input(player int, data []byte) { f.input.setInput(player, data) } @@ -279,14 +287,14 @@ func (f *Frontend) Scale() float64 { return f.scale } func (f *Frontend) SetAudioCb(cb func(app.Audio)) { f.onAudio = cb } func (f *Frontend) SetSessionId(name string) { f.storage.SetMainSaveName(name) } func (f *Frontend) SetVideoCb(ff func(app.Video)) { f.onVideo = ff } -func (f *Frontend) SetViewport(w, h int) { f.mu.Lock(); f.vw, f.vh = w, h; f.mu.Unlock() } func (f *Frontend) Tick() { f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } func (f *Frontend) ToggleMultitap() { f.nano.ToggleMultitap() } +func (f *Frontend) ViewportRecalculate() { f.mu.Lock(); f.vw, f.vh = f.ViewportCalc(); f.mu.Unlock() } func (f *Frontend) ViewportSize() (int, int) { return f.vw, f.vh } func (f *Frontend) ViewportCalc() (nw int, nh int) { w, h := f.FrameSize() - f.log.Debug().Msgf("Viewport source size: %dx%d", w, h) + nw, nh = w, h aspect, aw, ah := f.conf.AspectRatio.Keep, f.conf.AspectRatio.Width, f.conf.AspectRatio.Height // calc the aspect ratio @@ -298,29 +306,24 @@ func (f *Frontend) ViewportCalc() (nw int, nh int) { nw = aw nh = int(math.Round(float64(aw)/ratio/2) * 2) } - f.log.Debug().Msgf("Viewport aspect change: %dx%d (%f) -> %dx%d", aw, ah, ratio, nw, nh) - } else { - nw, nh = w, h } if f.IsPortrait() { nw, nh = nh, nw - f.log.Debug().Msgf("Set portrait mode") } - f.log.Info().Msgf("Viewport final size: %dx%d", nw, nh) + f.log.Debug().Msgf("viewport: %dx%d -> %dx%d", w, h, nw, nh) return } func (f *Frontend) Close() { f.log.Debug().Msgf("frontend close") - close(f.done) f.mui.Lock() - defer f.mui.Unlock() f.nano.Close() + f.mui.Unlock() f.log.Debug().Msgf("frontend closed") } diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index 7c13cb76..ab64042c 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -128,8 +128,7 @@ func (emu *TestFrontend) loadRom(game string) { if err != nil { log.Fatal(err) } - w, h := emu.FrameSize() - emu.SetViewport(w, h) + emu.ViewportRecalculate() } // Shutdown closes the emulator and cleans its resources. @@ -228,31 +227,26 @@ func TestLoad(t *testing.T) { mock := DefaultFrontend(test.room, test.system, test.rom) - fmt.Printf("[%-14v] ", "initial") mock.dumpState() for ticks := test.frames; ticks > 0; ticks-- { mock.Tick() } - fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.frames)) mock.dumpState() if err := mock.Save(); err != nil { t.Errorf("Save fail %v", err) } - fmt.Printf("[%-14v] ", "saved") snapshot1, _ := mock.dumpState() for ticks := test.frames; ticks > 0; ticks-- { mock.Tick() } - fmt.Printf("[%-14v] ", fmt.Sprintf("emulated %d", test.frames)) mock.dumpState() if err := mock.Load(); err != nil { t.Errorf("Load fail %v", err) } - fmt.Printf("[%-14v] ", "restored") snapshot2, _ := mock.dumpState() if snapshot1 != snapshot2 { diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 1b661201..4b412a3c 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -5,6 +5,7 @@ import ( "fmt" "runtime" "strings" + "sync" "sync/atomic" "time" "unsafe" @@ -47,13 +48,15 @@ type Nanoarch struct { enabled bool value C.unsigned } - options *map[string]string - reserved chan struct{} // limits concurrent use - Rot uint - serializeSize C.size_t - stopped atomic.Bool - sysAvInfo C.struct_retro_system_av_info - sysInfo C.struct_retro_system_info + options *map[string]string + reserved chan struct{} // limits concurrent use + Rot uint + serializeSize C.size_t + stopped atomic.Bool + sys struct { + av C.struct_retro_system_av_info + i C.struct_retro_system_info + } tickTime int64 cSaveDirectory *C.char cSystemDirectory *C.char @@ -69,6 +72,7 @@ type Nanoarch struct { vfr bool sdlCtx *graphics.SDL hackSkipHwContextDestroy bool + limiter func(func()) log *logger.Logger } @@ -119,6 +123,7 @@ func (p PixFmt) String() string { var Nan0 = Nanoarch{ reserved: make(chan struct{}, 1), // this thing forbids concurrent use of the emulator stopped: atomic.Bool{}, + limiter: func(fn func()) { fn() }, Handlers: Handlers{ OnDpad: func(uint, uint) int16 { return 0 }, OnKeyPress: func(uint, int) int { return 0 }, @@ -139,18 +144,15 @@ func NewNano(localPath string) *Nanoarch { return nano } -func (n *Nanoarch) AudioSampleRate() int { return int(n.sysAvInfo.timing.sample_rate) } -func (n *Nanoarch) VideoFramerate() int { return int(n.sysAvInfo.timing.fps) } -func (n *Nanoarch) IsPortrait() bool { return n.Rot == 90 || n.Rot == 270 } -func (n *Nanoarch) GeometryBase() (int, int) { - return int(n.sysAvInfo.geometry.base_width), int(n.sysAvInfo.geometry.base_height) -} -func (n *Nanoarch) GeometryMax() (int, int) { - return int(n.sysAvInfo.geometry.max_width), int(n.sysAvInfo.geometry.max_height) -} -func (n *Nanoarch) WaitReady() { <-n.reserved } -func (n *Nanoarch) Close() { n.stopped.Store(true); n.reserved <- struct{}{} } -func (n *Nanoarch) SetLogger(log *logger.Logger) { n.log = log } +func (n *Nanoarch) AudioSampleRate() int { return int(n.sys.av.timing.sample_rate) } +func (n *Nanoarch) VideoFramerate() int { return int(n.sys.av.timing.fps) } +func (n *Nanoarch) IsPortrait() bool { return 90 == n.Rot%180 } +func (n *Nanoarch) BaseWidth() int { return int(n.sys.av.geometry.base_width) } +func (n *Nanoarch) BaseHeight() int { return int(n.sys.av.geometry.base_height) } +func (n *Nanoarch) WaitReady() { <-n.reserved } +func (n *Nanoarch) Close() { n.stopped.Store(true); n.reserved <- struct{}{} } +func (n *Nanoarch) SetLogger(log *logger.Logger) { n.log = log } +func (n *Nanoarch) SetVideoDebounce(t time.Duration) { n.limiter = NewLimit(t) } func (n *Nanoarch) CoreLoad(meta Metadata) { var err error @@ -219,16 +221,16 @@ func (n *Nanoarch) CoreLoad(meta Metadata) { C.bridge_retro_init(retroInit) } - C.bridge_retro_get_system_info(retroGetSystemInfo, &n.sysInfo) + C.bridge_retro_get_system_info(retroGetSystemInfo, &n.sys.i) n.log.Debug().Msgf("System >>> %s (%s) [%s] nfp: %v", - C.GoString(n.sysInfo.library_name), C.GoString(n.sysInfo.library_version), - C.GoString(n.sysInfo.valid_extensions), bool(n.sysInfo.need_fullpath)) + C.GoString(n.sys.i.library_name), C.GoString(n.sys.i.library_version), + C.GoString(n.sys.i.valid_extensions), bool(n.sys.i.need_fullpath)) } func (n *Nanoarch) LoadGame(path string) error { game := C.struct_retro_game_info{} - big := bool(n.sysInfo.need_fullpath) // big ROMs are loaded by cores later + big := bool(n.sys.i.need_fullpath) // big ROMs are loaded by cores later if big { size, err := os.StatSize(path) if err != nil { @@ -256,17 +258,17 @@ func (n *Nanoarch) LoadGame(path string) error { return fmt.Errorf("core failed to load ROM: %v", path) } - C.bridge_retro_get_system_av_info(retroGetSystemAVInfo, &n.sysAvInfo) + C.bridge_retro_get_system_av_info(retroGetSystemAVInfo, &n.sys.av) n.log.Info().Msgf("System A/V >>> %vx%v (%vx%v), [%vfps], AR [%v], audio [%vHz]", - n.sysAvInfo.geometry.base_width, n.sysAvInfo.geometry.base_height, - n.sysAvInfo.geometry.max_width, n.sysAvInfo.geometry.max_height, - n.sysAvInfo.timing.fps, n.sysAvInfo.geometry.aspect_ratio, n.sysAvInfo.timing.sample_rate, + n.sys.av.geometry.base_width, n.sys.av.geometry.base_height, + n.sys.av.geometry.max_width, n.sys.av.geometry.max_height, + n.sys.av.timing.fps, n.sys.av.geometry.aspect_ratio, n.sys.av.timing.sample_rate, ) n.serializeSize = C.bridge_retro_serialize_size(retroSerializeSize) n.log.Info().Msgf("Save file size: %v", byteCountBinary(int64(n.serializeSize))) - Nan0.tickTime = int64(time.Second / time.Duration(n.sysAvInfo.timing.fps)) + Nan0.tickTime = int64(time.Second / time.Duration(n.sys.av.timing.fps)) if n.vfr { n.log.Info().Msgf("variable framerate (VFR) is enabled") } @@ -274,10 +276,9 @@ func (n *Nanoarch) LoadGame(path string) error { n.stopped.Store(false) if n.Video.gl.enabled { - //setRotation(image.F180) // flip Y coordinates of OpenGL - bufS := uint(n.sysAvInfo.geometry.max_width*n.sysAvInfo.geometry.max_height) * n.Video.PixFmt.BPP + bufS := uint(n.sys.av.geometry.max_width*n.sys.av.geometry.max_height) * n.Video.PixFmt.BPP graphics.SetBuffer(int(bufS)) - n.log.Info().Msgf("Set buffer: %v", byteCountBinary(int64(bufS))) + n.log.Debug().Msgf("Set buffer: %v", byteCountBinary(int64(bufS))) if n.LibCo { C.same_thread(C.init_video_cgo) } else { @@ -414,9 +415,6 @@ func printOpenGLDriverInfo() { openGLInfo.Grow(128) openGLInfo.WriteString(fmt.Sprintf("\n[OpenGL] Version: %v\n", graphics.GetGLVersionInfo())) openGLInfo.WriteString(fmt.Sprintf("[OpenGL] Vendor: %v\n", graphics.GetGLVendorInfo())) - // This string is often the name of the GPU. - // In the case of Mesa3d, it would be i.e "Gallium 0.4 on NVA8". - // It might even say "Direct3D" if the Windows Direct3D wrapper is being used. openGLInfo.WriteString(fmt.Sprintf("[OpenGL] Renderer: %v\n", graphics.GetGLRendererInfo())) openGLInfo.WriteString(fmt.Sprintf("[OpenGL] GLSL Version: %v", graphics.GetGLSLInfo())) Nan0.log.Debug().Msg(openGLInfo.String()) @@ -655,7 +653,7 @@ func coreLog(level C.enum_retro_log_level, msg *C.char) { switch level { // with debug level cores have too much logs case C.RETRO_LOG_DEBUG: - Nan0.log.Debug().MsgFunc(func() string { return m(msg) }) + Nan0.log.Trace().MsgFunc(func() string { return m(msg) }) case C.RETRO_LOG_INFO: Nan0.log.Info().MsgFunc(func() string { return m(msg) }) case C.RETRO_LOG_WARN: @@ -688,18 +686,27 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { switch cmd { case C.RETRO_ENVIRONMENT_SET_SYSTEM_AV_INFO: - av := *(*C.struct_retro_system_av_info)(data) - Nan0.log.Info().Msgf(">>> SET SYS AV INFO: %v", av) - Nan0.sysAvInfo = av - go func() { - if Nan0.OnSystemAvInfo != nil { - Nan0.OnSystemAvInfo() - } - }() + Nan0.sys.av = *(*C.struct_retro_system_av_info)(data) + Nan0.log.Debug().Msgf(">>> system av change: %v", Nan0.sys.av) + if Nan0.OnSystemAvInfo != nil { + go Nan0.OnSystemAvInfo() + } return true case C.RETRO_ENVIRONMENT_SET_GEOMETRY: geom := *(*C.struct_retro_game_geometry)(data) - Nan0.log.Info().Msgf(">>> GEOMETRY: %v", geom) + Nan0.log.Debug().Msgf(">>> geometry change: %v", geom) + // some cores are eager to change resolution too many times + // in a small period of time, thus we have some debouncer here + Nan0.limiter(func() { + lw := Nan0.sys.av.geometry.base_width + lh := Nan0.sys.av.geometry.base_height + if lw != geom.base_width || lh != geom.base_height { + Nan0.sys.av.geometry = geom + if Nan0.OnSystemAvInfo != nil { + go Nan0.OnSystemAvInfo() + } + } + }) return true case C.RETRO_ENVIRONMENT_SET_ROTATION: setRotation((*(*uint)(data) % 4) * 90) @@ -739,7 +746,7 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { //window.SetShouldClose(true) return false case C.RETRO_ENVIRONMENT_GET_VARIABLE: - if (*Nan0.options) == nil { + if Nan0.options == nil || *Nan0.options == nil { return false } rv := (*C.struct_retro_variable)(data) @@ -818,8 +825,8 @@ func initVideo() { sdl, err := graphics.NewSDLContext(graphics.Config{ Ctx: context, - W: int(Nan0.sysAvInfo.geometry.max_width), - H: int(Nan0.sysAvInfo.geometry.max_height), + W: int(Nan0.sys.av.geometry.max_width), + H: int(Nan0.sys.av.geometry.max_height), GLAutoContext: Nan0.Video.gl.autoCtx, GLVersionMajor: uint(Nan0.Video.hw.version_major), GLVersionMinor: uint(Nan0.Video.hw.version_minor), @@ -849,3 +856,23 @@ func deinitVideo() { Nan0.Video.gl.autoCtx = false Nan0.hackSkipHwContextDestroy = false } + +type limit struct { + d time.Duration + t *time.Timer + mu sync.Mutex +} + +func NewLimit(d time.Duration) func(f func()) { + l := &limit{d: d} + return func(f func()) { l.push(f) } +} + +func (d *limit) push(f func()) { + d.mu.Lock() + defer d.mu.Unlock() + if d.t != nil { + d.t.Stop() + } + d.t = time.AfterFunc(d.d, f) +} diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch_test.go b/pkg/worker/caged/libretro/nanoarch/nanoarch_test.go new file mode 100644 index 00000000..48f1152a --- /dev/null +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch_test.go @@ -0,0 +1,22 @@ +package nanoarch + +import ( + "sync/atomic" + "testing" + "time" +) + +func TestLimit(t *testing.T) { + c := atomic.Int32{} + lim := NewLimit(50 * time.Millisecond) + + for i := 0; i < 10; i++ { + lim(func() { + c.Add(1) + }) + } + + if c.Load() > 1 { + t.Errorf("should be just 1") + } +} diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 737c7bd9..e675d33d 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -140,12 +140,13 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke m.SetPixFmt(app.PixFormat()) m.SetRot(app.Rotation()) - app.HandleOnSystemAvInfo(func() { + // recreate the video encoder + app.VideoChangeCb(func() { + app.ViewportRecalculate() m.VideoW, m.VideoH = app.ViewportSize() m.VideoScale = app.Scale() - err := m.Reinit() - if err != nil { - c.log.Error().Err(err).Msgf("av reinit fail") + if err := m.Reinit(); err != nil { + c.log.Error().Err(err).Msgf("reinit fail") } }) From 99ceb5d72cb54eb9b615d03befacc0eaddc8b8a2 Mon Sep 17 00:00:00 2001 From: guangwu Date: Thu, 26 Oct 2023 20:10:56 +0800 Subject: [PATCH 135/361] fix: typo --- pkg/encoder/yuv/yuv_test.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/encoder/yuv/yuv_test.go b/pkg/encoder/yuv/yuv_test.go index 3f07aa69..2575d486 100644 --- a/pkg/encoder/yuv/yuv_test.go +++ b/pkg/encoder/yuv/yuv_test.go @@ -119,7 +119,7 @@ func TestYuvPredefined(t *testing.T) { t.Logf("%v", v) if len(a) != len(should) { - t.Fatalf("diffrent size a: %v, o: %v", len(a), len(should)) + t.Fatalf("different size a: %v, o: %v", len(a), len(should)) } for i := 0; i < len(a); i++ { From 5d65ff14d554be98929b096075a78ab0d6f30d32 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 26 Oct 2023 16:39:00 +0300 Subject: [PATCH 136/361] Fix test --- pkg/worker/caged/libretro/frontend_test.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index ab64042c..50dd78c6 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -200,7 +200,7 @@ func TestSavePersistence(t *testing.T) { hash1, hash2 := front.dumpState() if hash1 != hash2 { - t.Errorf("It seems that the previous state is diffrent: %v != %v", hash1, hash2) + t.Errorf("%v != %v", hash1, hash2) } front.Shutdown() From ad07ad2014f89871618719500c2284e01a24e2eb Mon Sep 17 00:00:00 2001 From: Himaj333 <78681144+HimajPatil@users.noreply.github.com> Date: Thu, 26 Oct 2023 19:22:06 +0530 Subject: [PATCH 137/361] Fixed README.md --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index db4e23cf..ae86ce7e 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,7 @@ Discord: [Join Us](https://discord.gg/sXRQZa2zeP) ## Try it at **[cloudretro.io](https://cloudretro.io)** -Direct play an existing game: * -*[Pokemon Emerald](https://cloudretro.io/?id=1bd37d4b5dfda87c___Pokemon%20-%20Emerald%20Version%20(U))** +Direct play an existing game: **[Pokemon Emerald](https://cloudretro.io/?id=1bd37d4b5dfda87c___Pokemon%20-%20Emerald%20Version%20(U))** ## Introduction From d805ba8eb83d0a509c18b250628bc78938cee79b Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 1 Nov 2023 01:25:29 +0300 Subject: [PATCH 138/361] Update dependencies --- go.mod | 4 ++-- go.sum | 8 ++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/go.mod b/go.mod index 82368bb6..e11342a3 100644 --- a/go.mod +++ b/go.mod @@ -5,7 +5,7 @@ go 1.20 require ( github.com/VictoriaMetrics/metrics v1.24.0 github.com/cavaliergopher/grab/v3 v3.0.1 - github.com/fsnotify/fsnotify v1.6.0 + github.com/fsnotify/fsnotify v1.7.0 github.com/goccy/go-json v0.10.2 github.com/gofrs/flock v0.8.1 github.com/gorilla/websocket v1.5.0 @@ -25,7 +25,7 @@ require ( require ( github.com/davecgh/go-spew v1.1.1 // indirect - github.com/google/uuid v1.3.1 // indirect + github.com/google/uuid v1.4.0 // indirect github.com/mattn/go-colorable v0.1.13 // indirect github.com/mattn/go-isatty v0.0.20 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect diff --git a/go.sum b/go.sum index fed062e6..1eb82e82 100644 --- a/go.sum +++ b/go.sum @@ -8,8 +8,8 @@ github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo= github.com/fsnotify/fsnotify v1.4.9/go.mod h1:znqG4EE+3YCdAaPaxE2ZRY/06pZUdp0tY4IgpuI1SZQ= -github.com/fsnotify/fsnotify v1.6.0 h1:n+5WquG0fcWoWp6xPWfHdbskMCQaFnG6PfBrh1Ky4HY= -github.com/fsnotify/fsnotify v1.6.0/go.mod h1:sl3t1tCWJFWoRz9R8WJCbQihKKwmorjAbSClcnxKAGw= +github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA= +github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM= github.com/go-task/slim-sprig v0.0.0-20210107165309-348f09dbbbc0/go.mod h1:fyg7847qk6SyHyPtNmDHnmrv/HOrqktSC+C9fM+CJOE= github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU= github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I= @@ -29,8 +29,9 @@ github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMyw github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= -github.com/google/uuid v1.3.1 h1:KjJaJ9iWZ3jOFZIf1Lqf4laDRCasjl0BCmnEGxkdLb4= github.com/google/uuid v1.3.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/google/uuid v1.4.0 h1:MtMxsa51/r9yyhkyLsVeVt0B+BGQZzpQiTQ4eHZ8bc4= +github.com/google/uuid v1.4.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.0 h1:PPwGk2jz7EePpoHN/+ClbZu8SPxiqlu12wZP/3sWmnc= github.com/gorilla/websocket v1.5.0/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= @@ -184,7 +185,6 @@ golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBc golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.0.0-20220908164124-27713097b956/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.2.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= From 2e91feb861de737fd4f28b08051097cd84c9dddb Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 1 Nov 2023 01:21:58 +0300 Subject: [PATCH 139/361] Add initial automatic aspect ratio change Depending on the configuration param coreAspectRatio, video streams may have automatic aspect ratio correction in the browser with the value provided by the cores themselves. --- pkg/api/api.go | 10 +- pkg/api/user.go | 4 + pkg/api/worker.go | 7 ++ pkg/config/config.yaml | 12 +-- pkg/config/emulator.go | 34 +++---- pkg/coordinator/userapi.go | 4 +- pkg/coordinator/userhandlers.go | 2 +- pkg/network/webrtc/webrtc.go | 27 +++--- pkg/worker/caged/app/app.go | 3 + pkg/worker/caged/libretro/caged.go | 5 +- pkg/worker/caged/libretro/frontend.go | 43 ++++----- .../caged/libretro/nanoarch/nanoarch.go | 91 +++++++++++-------- pkg/worker/coordinatorhandlers.go | 44 ++++++--- pkg/worker/media/media.go | 8 ++ pkg/worker/room/room.go | 1 + web/css/main.css | 29 +++--- web/index.html | 34 +++---- web/js/api/api.js | 13 ++- web/js/controller.js | 14 ++- web/js/event/event.js | 2 + web/js/network/webrtc.js | 27 +++--- web/js/stream/stream.js | 49 +++++++++- 22 files changed, 296 insertions(+), 167 deletions(-) diff --git a/pkg/api/api.go b/pkg/api/api.go index 6a8e96f6..f85daa8d 100644 --- a/pkg/api/api.go +++ b/pkg/api/api.go @@ -62,8 +62,9 @@ func (o *Out) GetPayload() any { return o.Payload } // Packet codes: // -// x, 1xx - user codes -// 2xx - worker codes +// x, 1xx - user codes +// 15x - webrtc data exchange codes +// 2xx - worker codes const ( CheckLatency PT = 3 InitSession PT = 4 @@ -84,6 +85,7 @@ const ( CloseRoom PT = 202 IceCandidate = WebrtcIce TerminateSession PT = 204 + AppVideoChange PT = 150 ) func (p PT) String() string { @@ -124,6 +126,8 @@ func (p PT) String() string { return "CloseRoom" case TerminateSession: return "TerminateSession" + case AppVideoChange: + return "AppVideoChange" default: return "Unknown" } @@ -160,3 +164,5 @@ func UnwrapChecked[T any](bytes []byte, err error) (*T, error) { } return Unwrap[T](bytes), nil } + +func Wrap(t any) ([]byte, error) { return json.Marshal(t) } diff --git a/pkg/api/user.go b/pkg/api/user.go index 84d8ee62..aef4305d 100644 --- a/pkg/api/user.go +++ b/pkg/api/user.go @@ -11,6 +11,10 @@ type ( RecordUser string `json:"record_user,omitempty"` PlayerIndex int `json:"player_index"` } + GameStartUserResponse struct { + RoomId string `json:"roomId"` + Av *AppVideoInfo `json:"av"` + } IceServer struct { Urls string `json:"urls,omitempty"` Username string `json:"username,omitempty"` diff --git a/pkg/api/worker.go b/pkg/api/worker.go index b206c5c1..045fa429 100644 --- a/pkg/api/worker.go +++ b/pkg/api/worker.go @@ -33,6 +33,7 @@ type ( } StartGameResponse struct { Room + AV *AppVideoInfo `json:"av"` Record bool } RecordGameRequest[T Id] struct { @@ -59,4 +60,10 @@ type ( Stateful[T] } WebrtcInitResponse string + + AppVideoInfo struct { + W int `json:"w"` + H int `json:"h"` + A float32 `json:"a"` + } ) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 3ffc0891..13104af5 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -118,14 +118,6 @@ emulator: # (removed) threads: 0 - aspectRatio: - # enable aspect ratio changing - # (experimental) - keep: false - # recalculate emulator game frame size to the given WxH - width: 320 - height: 240 - # enable autosave for emulator states if set to a non-zero value of seconds autosaveSec: 0 @@ -189,6 +181,7 @@ emulator: # - isGlAllowed (bool) # - usesLibCo (bool) # - hasMultitap (bool) + # - coreAspectRatio (bool) -- correct the aspect ratio on the client with the info from the core. # - vfr (bool) # (experimental) # Enable variable frame rate only for cores that can't produce a constant frame rate. @@ -210,6 +203,7 @@ emulator: mgba_audio_low_pass_filter: enabled mgba_audio_low_pass_range: 40 pcsx: + coreAspectRatio: true lib: pcsx_rearmed_libretro roms: [ "cue", "chd" ] # example of folder override @@ -227,6 +221,8 @@ emulator: nes: lib: nestopia_libretro roms: [ "nes" ] + options: + nestopia_aspect: "uncorrected" snes: lib: snes9x_libretro roms: [ "smc", "sfc", "swc", "fig", "bs" ] diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index 84e57ed8..da8f5b2e 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -8,11 +8,6 @@ import ( type Emulator struct { Threads int - AspectRatio struct { - Keep bool - Width int - Height int - } Storage string LocalPath string Libretro LibretroConfig @@ -44,20 +39,21 @@ type LibretroRepoConfig struct { } type LibretroCoreConfig struct { - AltRepo bool - AutoGlContext bool // hack: keep it here to pass it down the emulator - Folder string - Hacks []string - HasMultitap bool - Height int - IsGlAllowed bool - Lib string - Options map[string]string - Roms []string - Scale float64 - UsesLibCo bool - VFR bool - Width int + AltRepo bool + AutoGlContext bool // hack: keep it here to pass it down the emulator + CoreAspectRatio bool + Folder string + Hacks []string + HasMultitap bool + Height int + IsGlAllowed bool + Lib string + Options map[string]string + Roms []string + Scale float64 + UsesLibCo bool + VFR bool + Width int } type CoreInfo struct { diff --git a/pkg/coordinator/userapi.go b/pkg/coordinator/userapi.go index 4f922d9a..ed1ebcea 100644 --- a/pkg/coordinator/userapi.go +++ b/pkg/coordinator/userapi.go @@ -37,4 +37,6 @@ func (u *User) SendWebrtcOffer(sdp string) { u.Notify(api.WebrtcOffer, sdp) } func (u *User) SendWebrtcIceCandidate(candidate string) { u.Notify(api.WebrtcIce, candidate) } // StartGame signals the user that everything is ready to start a game. -func (u *User) StartGame() { u.Notify(api.StartGame, u.w.RoomId) } +func (u *User) StartGame(av *api.AppVideoInfo) { + u.Notify(api.StartGame, api.GameStartUserResponse{RoomId: u.w.RoomId, Av: av}) +} diff --git a/pkg/coordinator/userhandlers.go b/pkg/coordinator/userhandlers.go index 426fd74f..81b6bf4f 100644 --- a/pkg/coordinator/userhandlers.go +++ b/pkg/coordinator/userhandlers.go @@ -56,7 +56,7 @@ func (u *User) HandleStartGame(rq api.GameStartUserRequest, launcher games.Launc return } u.log.Info().Str("id", startGameResp.Rid).Msg("Received room response from worker") - u.StartGame() + u.StartGame(startGameResp.AV) // send back recording status if conf.Recording.Enabled && rq.Record { diff --git a/pkg/network/webrtc/webrtc.go b/pkg/network/webrtc/webrtc.go index ed0c3ca6..f94d7915 100644 --- a/pkg/network/webrtc/webrtc.go +++ b/pkg/network/webrtc/webrtc.go @@ -32,13 +32,13 @@ func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp if p.conn != nil && p.conn.ConnectionState() == webrtc.PeerConnectionStateConnected { return } - p.log.Info().Msg("WebRTC start") + p.log.Debug().Msg("WebRTC start") if p.conn, err = p.api.NewPeer(); err != nil { - return "", err + return } p.conn.OnICECandidate(p.handleICECandidate(onICECandidate)) // plug in the [video] track (out) - video, err := newTrack("video", "game-video", vCodec) + video, err := newTrack("video", "video", vCodec) if err != nil { return "", err } @@ -49,7 +49,7 @@ func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp p.log.Debug().Msgf("Added [%s] track", video.Codec().MimeType) // plug in the [audio] track (out) - audio, err := newTrack("audio", "game-audio", aCodec) + audio, err := newTrack("audio", "audio", aCodec) if err != nil { return "", err } @@ -59,21 +59,19 @@ func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp p.log.Debug().Msgf("Added [%s] track", audio.Codec().MimeType) p.a = audio - // plug in the [input] data channel (in) - if err = p.addInputChannel("game-input"); err != nil { + // plug in the [data] channel (in and out) + if err = p.addDataChannel("data"); err != nil { return "", err } - p.log.Debug().Msg("Added [input/bytes] chan") + p.log.Debug().Msg("Added [data] chan") - p.conn.OnICEConnectionStateChange(p.handleICEState(func() { - p.log.Info().Msg("Start streaming") - })) + p.conn.OnICEConnectionStateChange(p.handleICEState(func() { p.log.Info().Msg("Connected") })) // Stream provider supposes to send offer offer, err := p.conn.CreateOffer(nil) if err != nil { return "", err } - p.log.Info().Msg("Created Offer") + p.log.Debug().Msg("Created Offer") err = p.conn.SetLocalDescription(offer) if err != nil { @@ -210,15 +208,16 @@ func (p *Peer) Disconnect() { p.log.Debug().Msg("WebRTC stop") } -// addInputChannel creates a new WebRTC data channel for user input. +// addDataChannel creates a new WebRTC data channel for user input. // Default params -- ordered: true, negotiated: false. -func (p *Peer) addInputChannel(label string) error { +func (p *Peer) addDataChannel(label string) error { ch, err := p.conn.CreateDataChannel(label, nil) if err != nil { return err } ch.OnOpen(func() { - p.log.Debug().Str("label", ch.Label()).Uint16("id", *ch.ID()).Msg("Data channel [input] opened") + p.log.Debug().Str("label", ch.Label()).Uint16("id", *ch.ID()). + Msg("Data channel [input] opened") }) ch.OnError(p.logx) ch.OnMessage(func(m webrtc.DataChannelMessage) { diff --git a/pkg/worker/caged/app/app.go b/pkg/worker/caged/app/app.go index a1917b4d..fcf34fd9 100644 --- a/pkg/worker/caged/app/app.go +++ b/pkg/worker/caged/app/app.go @@ -2,6 +2,8 @@ package app type App interface { AudioSampleRate() int + AspectRatio() float32 + AspectEnabled() bool Init() error ViewportSize() (int, int) Start() @@ -9,6 +11,7 @@ type App interface { SetAudioCb(func(Audio)) SetVideoCb(func(Video)) + SetDataCb(func([]byte)) SendControl(port int, data []byte) } diff --git a/pkg/worker/caged/libretro/caged.go b/pkg/worker/caged/libretro/caged.go index 20f95847..f71017bf 100644 --- a/pkg/worker/caged/libretro/caged.go +++ b/pkg/worker/caged/libretro/caged.go @@ -14,9 +14,6 @@ type Caged struct { base *Frontend // maintains the root for mad embedding conf CagedConf log *logger.Logger - w, h int - - OnSysInfoChange func() } type CagedConf struct { @@ -78,6 +75,8 @@ func (c *Caged) EnableCloudStorage(uid string, storage cloud.Storage) { } } +func (c *Caged) AspectEnabled() bool { return c.base.nano.Aspect } +func (c *Caged) AspectRatio() float32 { return c.base.AspectRatio() } func (c *Caged) PixFormat() uint32 { return c.Emulator.PixFormat() } func (c *Caged) Rotation() uint { return c.Emulator.Rotation() } func (c *Caged) AudioSampleRate() int { return c.Emulator.AudioSampleRate() } diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index e33f6b0f..6a729cb3 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -3,7 +3,6 @@ package libretro import ( "errors" "fmt" - "math" "path/filepath" "sync" "sync/atomic" @@ -20,6 +19,7 @@ import ( type Emulator interface { SetAudioCb(func(app.Audio)) SetVideoCb(func(app.Video)) + SetDataCb(func([]byte)) LoadCore(name string) LoadGame(path string) error FPS() int @@ -57,6 +57,7 @@ type Frontend struct { log *logger.Logger nano *nanoarch.Nanoarch onAudio func(app.Audio) + onData func([]byte) onVideo func(app.Video) storage Storage scale float64 @@ -90,6 +91,7 @@ const ( var ( audioPool sync.Pool noAudio = func(app.Audio) {} + noData = func([]byte) {} noVideo = func(app.Video) {} videoPool sync.Pool ) @@ -135,6 +137,7 @@ func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { input: NewGameSessionInput(), log: log, onAudio: noAudio, + onData: noData, onVideo: noVideo, storage: store, th: conf.Threads, @@ -153,14 +156,15 @@ func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { func (f *Frontend) LoadCore(emu string) { conf := f.conf.GetLibretroCoreConfig(emu) meta := nanoarch.Metadata{ - AutoGlContext: conf.AutoGlContext, - Hacks: conf.Hacks, - HasMultitap: conf.HasMultitap, - HasVFR: conf.VFR, - IsGlAllowed: conf.IsGlAllowed, - LibPath: conf.Lib, - Options: conf.Options, - UsesLibCo: conf.UsesLibCo, + AutoGlContext: conf.AutoGlContext, + Hacks: conf.Hacks, + HasMultitap: conf.HasMultitap, + HasVFR: conf.VFR, + IsGlAllowed: conf.IsGlAllowed, + LibPath: conf.Lib, + Options: conf.Options, + UsesLibCo: conf.UsesLibCo, + CoreAspectRatio: conf.CoreAspectRatio, } f.mu.Lock() scale := 1.0 @@ -224,6 +228,13 @@ func (f *Frontend) SetVideoChangeCb(fn func()) { f.nano.OnSystemAvInfo = fn } func (f *Frontend) Start() { f.log.Debug().Msgf("frontend start") + if f.nano.Stopped.Load() { + f.log.Warn().Msgf("frontend stopped during the start") + f.mui.Lock() + defer f.mui.Unlock() + f.Shutdown() + return + } f.mui.Lock() f.done = make(chan struct{}) @@ -269,6 +280,7 @@ func (f *Frontend) Start() { } } +func (f *Frontend) AspectRatio() float32 { return f.nano.AspectRatio() } func (f *Frontend) AudioSampleRate() int { return f.nano.AudioSampleRate() } func (f *Frontend) FPS() int { return f.nano.VideoFramerate() } func (f *Frontend) Flipped() bool { return f.nano.IsGL() } @@ -286,6 +298,7 @@ func (f *Frontend) SaveGameState() error { return f.Save() } func (f *Frontend) Scale() float64 { return f.scale } func (f *Frontend) SetAudioCb(cb func(app.Audio)) { f.onAudio = cb } func (f *Frontend) SetSessionId(name string) { f.storage.SetMainSaveName(name) } +func (f *Frontend) SetDataCb(cb func([]byte)) { f.onData = cb } func (f *Frontend) SetVideoCb(ff func(app.Video)) { f.onVideo = ff } func (f *Frontend) Tick() { f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } func (f *Frontend) ToggleMultitap() { f.nano.ToggleMultitap() } @@ -296,18 +309,6 @@ func (f *Frontend) ViewportCalc() (nw int, nh int) { w, h := f.FrameSize() nw, nh = w, h - aspect, aw, ah := f.conf.AspectRatio.Keep, f.conf.AspectRatio.Width, f.conf.AspectRatio.Height - // calc the aspect ratio - if aspect && aw > 0 && ah > 0 { - ratio := float64(w) / float64(ah) - nw = int(math.Round(float64(ah)*ratio/2) * 2) - nh = ah - if nw > aw { - nw = aw - nh = int(math.Round(float64(aw)/ratio/2) * 2) - } - } - if f.IsPortrait() { nw, nh = nh, nw } diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 4b412a3c..cd4d3649 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -52,7 +52,7 @@ type Nanoarch struct { reserved chan struct{} // limits concurrent use Rot uint serializeSize C.size_t - stopped atomic.Bool + Stopped atomic.Bool sys struct { av C.struct_retro_system_av_info i C.struct_retro_system_info @@ -70,6 +70,7 @@ type Nanoarch struct { PixFmt PixFmt } vfr bool + Aspect bool sdlCtx *graphics.SDL hackSkipHwContextDestroy bool limiter func(func()) @@ -91,14 +92,15 @@ type FrameInfo struct { } type Metadata struct { - LibPath string // the full path to some emulator lib - IsGlAllowed bool - UsesLibCo bool - AutoGlContext bool - HasMultitap bool - HasVFR bool - Options map[string]string - Hacks []string + LibPath string // the full path to some emulator lib + IsGlAllowed bool + UsesLibCo bool + AutoGlContext bool + HasMultitap bool + HasVFR bool + Options map[string]string + Hacks []string + CoreAspectRatio bool } type PixFmt struct { @@ -122,7 +124,7 @@ func (p PixFmt) String() string { // Nan0 is a global link for C callbacks to Go var Nan0 = Nanoarch{ reserved: make(chan struct{}, 1), // this thing forbids concurrent use of the emulator - stopped: atomic.Bool{}, + Stopped: atomic.Bool{}, limiter: func(fn func()) { fn() }, Handlers: Handlers{ OnDpad: func(uint, uint) int16 { return 0 }, @@ -144,13 +146,14 @@ func NewNano(localPath string) *Nanoarch { return nano } +func (n *Nanoarch) AspectRatio() float32 { return float32(n.sys.av.geometry.aspect_ratio) } func (n *Nanoarch) AudioSampleRate() int { return int(n.sys.av.timing.sample_rate) } func (n *Nanoarch) VideoFramerate() int { return int(n.sys.av.timing.fps) } func (n *Nanoarch) IsPortrait() bool { return 90 == n.Rot%180 } func (n *Nanoarch) BaseWidth() int { return int(n.sys.av.geometry.base_width) } func (n *Nanoarch) BaseHeight() int { return int(n.sys.av.geometry.base_height) } func (n *Nanoarch) WaitReady() { <-n.reserved } -func (n *Nanoarch) Close() { n.stopped.Store(true); n.reserved <- struct{}{} } +func (n *Nanoarch) Close() { n.Stopped.Store(true); n.reserved <- struct{}{} } func (n *Nanoarch) SetLogger(log *logger.Logger) { n.log = log } func (n *Nanoarch) SetVideoDebounce(t time.Duration) { n.limiter = NewLimit(t) } @@ -158,6 +161,7 @@ func (n *Nanoarch) CoreLoad(meta Metadata) { var err error n.LibCo = meta.UsesLibCo n.vfr = meta.HasVFR + n.Aspect = meta.CoreAspectRatio n.Video.gl.autoCtx = meta.AutoGlContext n.Video.gl.enabled = meta.IsGlAllowed @@ -258,12 +262,17 @@ func (n *Nanoarch) LoadGame(path string) error { return fmt.Errorf("core failed to load ROM: %v", path) } - C.bridge_retro_get_system_av_info(retroGetSystemAVInfo, &n.sys.av) + var av C.struct_retro_system_av_info + C.bridge_retro_get_system_av_info(retroGetSystemAVInfo, &av) n.log.Info().Msgf("System A/V >>> %vx%v (%vx%v), [%vfps], AR [%v], audio [%vHz]", - n.sys.av.geometry.base_width, n.sys.av.geometry.base_height, - n.sys.av.geometry.max_width, n.sys.av.geometry.max_height, - n.sys.av.timing.fps, n.sys.av.geometry.aspect_ratio, n.sys.av.timing.sample_rate, + av.geometry.base_width, av.geometry.base_height, + av.geometry.max_width, av.geometry.max_height, + av.timing.fps, av.geometry.aspect_ratio, av.timing.sample_rate, ) + if isGeometryDifferent(av.geometry) { + geometryChange(av.geometry) + } + n.sys.av = av n.serializeSize = C.bridge_retro_serialize_size(retroSerializeSize) n.log.Info().Msgf("Save file size: %v", byteCountBinary(int64(n.serializeSize))) @@ -273,7 +282,7 @@ func (n *Nanoarch) LoadGame(path string) error { n.log.Info().Msgf("variable framerate (VFR) is enabled") } - n.stopped.Store(false) + n.Stopped.Store(false) if n.Video.gl.enabled { bufS := uint(n.sys.av.geometry.max_width*n.sys.av.geometry.max_height) * n.Video.PixFmt.BPP @@ -348,6 +357,7 @@ func (n *Nanoarch) Shutdown() { } setRotation(0) + Nan0.sys.av = C.struct_retro_system_av_info{} if err := closeLib(coreLib); err != nil { n.log.Error().Err(err).Msg("lib close failed") } @@ -376,7 +386,7 @@ func (n *Nanoarch) Run() { } func (n *Nanoarch) IsGL() bool { return n.Video.gl.enabled } -func (n *Nanoarch) IsStopped() bool { return n.stopped.Load() } +func (n *Nanoarch) IsStopped() bool { return n.Stopped.Load() } func videoSetPixelFormat(format uint32) (C.bool, error) { switch format { @@ -550,7 +560,7 @@ var ( //export coreVideoRefresh func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { - if Nan0.stopped.Load() { + if Nan0.Stopped.Load() { Nan0.log.Warn().Msgf(">>> skip video") return } @@ -636,7 +646,7 @@ func coreAudioSample(l, r C.int16_t) { //export coreAudioSampleBatch func coreAudioSampleBatch(data unsafe.Pointer, frames C.size_t) C.size_t { - if Nan0.stopped.Load() { + if Nan0.Stopped.Load() { if Nan0.log.GetLevel() < logger.InfoLevel { Nan0.log.Warn().Msgf(">>> skip %v audio frames", frames) } @@ -686,27 +696,18 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { switch cmd { case C.RETRO_ENVIRONMENT_SET_SYSTEM_AV_INFO: - Nan0.sys.av = *(*C.struct_retro_system_av_info)(data) - Nan0.log.Debug().Msgf(">>> system av change: %v", Nan0.sys.av) - if Nan0.OnSystemAvInfo != nil { - go Nan0.OnSystemAvInfo() + Nan0.log.Debug().Msgf("retro_set_system_av_info") + av := *(*C.struct_retro_system_av_info)(data) + if isGeometryDifferent(av.geometry) { + geometryChange(av.geometry) } return true case C.RETRO_ENVIRONMENT_SET_GEOMETRY: + Nan0.log.Debug().Msgf("retro_set_geometry") geom := *(*C.struct_retro_game_geometry)(data) - Nan0.log.Debug().Msgf(">>> geometry change: %v", geom) - // some cores are eager to change resolution too many times - // in a small period of time, thus we have some debouncer here - Nan0.limiter(func() { - lw := Nan0.sys.av.geometry.base_width - lh := Nan0.sys.av.geometry.base_height - if lw != geom.base_width || lh != geom.base_height { - Nan0.sys.av.geometry = geom - if Nan0.OnSystemAvInfo != nil { - go Nan0.OnSystemAvInfo() - } - } - }) + if isGeometryDifferent(geom) { + geometryChange(geom) + } return true case C.RETRO_ENVIRONMENT_SET_ROTATION: setRotation((*(*uint)(data) % 4) * 90) @@ -876,3 +877,21 @@ func (d *limit) push(f func()) { } d.t = time.AfterFunc(d.d, f) } + +func geometryChange(geom C.struct_retro_game_geometry) { + Nan0.limiter(func() { + old := Nan0.sys.av.geometry + Nan0.sys.av.geometry = geom + if Nan0.OnSystemAvInfo != nil { + Nan0.log.Debug().Msgf(">>> geometry change %v -> %v", old, geom) + if Nan0.Aspect { + go Nan0.OnSystemAvInfo() + } + } + }) +} + +func isGeometryDifferent(geom C.struct_retro_game_geometry) bool { + return Nan0.sys.av.geometry.base_width != geom.base_width || + Nan0.sys.av.geometry.base_height != geom.base_height +} diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index e675d33d..d5d9dd8e 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -112,6 +112,31 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke r.SetApp(app) + m := media.NewWebRtcMediaPipe(w.conf.Encoder.Audio, w.conf.Encoder.Video, w.log) + + // recreate the video encoder + app.VideoChangeCb(func() { + app.ViewportRecalculate() + m.VideoW, m.VideoH = app.ViewportSize() + m.VideoScale = app.Scale() + + if m.IsInitialized() { + if err := m.Reinit(); err != nil { + c.log.Error().Err(err).Msgf("reinit fail") + } + } + + data, err := api.Wrap(api.Out{T: uint8(api.AppVideoChange), Payload: api.AppVideoInfo{ + W: m.VideoW, + H: m.VideoH, + A: app.AspectRatio(), + }}) + if err != nil { + c.log.Error().Err(err).Msgf("wrap") + } + r.Send(data) + }) + w.log.Info().Msgf("Starting the game: %v", rq.Game.Name) if err := app.Load(game, w.conf.Worker.Library.BasePath); err != nil { c.log.Error().Err(err).Msgf("couldn't load the game %v", game) @@ -120,7 +145,6 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke return api.EmptyPacket } - m := media.NewWebRtcMediaPipe(w.conf.Encoder.Audio, w.conf.Encoder.Video, w.log) m.AudioSrcHz = app.AudioSampleRate() m.AudioFrame = w.conf.Encoder.Audio.Frame m.VideoW, m.VideoH = app.ViewportSize() @@ -140,16 +164,6 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke m.SetPixFmt(app.PixFormat()) m.SetRot(app.Rotation()) - // recreate the video encoder - app.VideoChangeCb(func() { - app.ViewportRecalculate() - m.VideoW, m.VideoH = app.ViewportSize() - m.VideoScale = app.Scale() - if err := m.Reinit(); err != nil { - c.log.Error().Err(err).Msgf("reinit fail") - } - }) - r.BindAppMedia() r.StartApp() } @@ -159,7 +173,13 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke c.RegisterRoom(r.Id()) - return api.Out{Payload: api.StartGameResponse{Room: api.Room{Rid: r.Id()}, Record: w.conf.Recording.Enabled}} + response := api.StartGameResponse{Room: api.Room{Rid: r.Id()}, Record: w.conf.Recording.Enabled} + if r.App().AspectEnabled() { + ww, hh := r.App().ViewportSize() + response.AV = &api.AppVideoInfo{W: ww, H: hh, A: r.App().AspectRatio()} + } + + return api.Out{Payload: response} } // HandleTerminateSession handles cases when a user has been disconnected from the websocket of coordinator. diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 588259ac..70758b1c 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -115,6 +115,8 @@ type WebrtcMediaPipe struct { VideoW, VideoH int VideoScale float64 + initialized bool + // keep the old settings for reinit oldPf uint32 oldRot uint @@ -144,6 +146,7 @@ func (wmp *WebrtcMediaPipe) Init() error { return err } wmp.log.Debug().Msgf("%v", wmp.v.Info()) + wmp.initialized = true return nil } @@ -188,6 +191,10 @@ func (wmp *WebrtcMediaPipe) ProcessVideo(v app.Video) []byte { } func (wmp *WebrtcMediaPipe) Reinit() error { + if !wmp.initialized { + return nil + } + wmp.v.Stop() if err := wmp.initVideo(wmp.VideoW, wmp.VideoH, wmp.VideoScale, wmp.vConf); err != nil { return err @@ -199,6 +206,7 @@ func (wmp *WebrtcMediaPipe) Reinit() error { return nil } +func (wmp *WebrtcMediaPipe) IsInitialized() bool { return wmp.initialized } func (wmp *WebrtcMediaPipe) SetPixFmt(f uint32) { wmp.oldPf = f; wmp.v.SetPixFormat(f) } func (wmp *WebrtcMediaPipe) SetVideoFlip(b bool) { wmp.oldFlip = b; wmp.v.SetFlip(b) } func (wmp *WebrtcMediaPipe) SetRot(r uint) { wmp.oldRot = r; wmp.v.SetRot(r) } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index 0f111456..c52f091d 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -81,6 +81,7 @@ func (r *Room[T]) Id() string { return r.id } func (r *Room[T]) SetApp(app app.App) { r.app = app } func (r *Room[T]) SetMedia(m MediaPipe) { r.media = m } func (r *Room[T]) StartApp() { r.app.Start() } +func (r *Room[T]) Send(data []byte) { r.users.ForEach(func(u T) { u.SendData(data) }) } func (r *Room[T]) Close() { if r == nil || r.closed { diff --git a/web/css/main.css b/web/css/main.css index d106b1be..5efbf875 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -22,7 +22,7 @@ body { display: flex; overflow: hidden; - width: 556px; + width: 640px; height: 286px; position: absolute; @@ -65,6 +65,11 @@ body { background-size: 100% 100%; } +#controls-right { + position: absolute; + left: 70px; +} + #circle-pad-holder { display: block; @@ -83,11 +88,10 @@ body { } #guide-txt { - color: #bababa; + color: #979797; font-size: 8px; top: 269px; - left: 30px; - width: 1000px; + left: 68px; position: absolute; user-select: none; @@ -166,7 +170,7 @@ body { align-items: center; justify-content: center; - width: 256px; + width: 320px; height: 240px; position: absolute; top: 23px; @@ -416,11 +420,11 @@ body { } .game-screen { - width: 100%; - height: 102%; /* lol */ - background-color: #222222; position: absolute; - display: flex; + object-fit: contain; + width: inherit; + height: inherit; + background-color: #222222; } #menu-screen { @@ -428,7 +432,7 @@ body { display: block; overflow: hidden; - width: 256px; + width: 320px; height: 240px; background-image: url('/img/screen_background5.png'); @@ -444,6 +448,7 @@ body { height: 36px; background-color: #FFCF9E; opacity: 0.75; + mix-blend-mode: lighten; top: 50%; left: 0; @@ -459,7 +464,7 @@ body { top: 102px; /* 240px - 36 / 2 */ left: 0; - z-index: 1; + /*z-index: 1;*/ } @@ -481,7 +486,7 @@ body { left: 15px; top: 7px; - width: 226px; + width: 288px; height: 25px; } diff --git a/web/index.html b/web/index.html index 4f44140f..e082abde 100644 --- a/web/index.html +++ b/web/index.html @@ -47,26 +47,28 @@
- -
+
{{if .Recording.Enabled}} -
+ class="record-user" aria-label=""> +
{{end}}
diff --git a/web/js/input/touch.js b/web/js/input/touch.js index a246ef56..d60a30b4 100644 --- a/web/js/input/touch.js +++ b/web/js/input/touch.js @@ -34,6 +34,8 @@ dpadToggle.addEventListener('change', (e) => { pub(DPAD_TOGGLE, {checked: e.target.checked}); }); +const getKey = (el) => el.dataset.key + let dpadMode = true; const deadZone = 0.1; @@ -157,17 +159,17 @@ function handleVpadJoystickMove(event) { const _handleButton = (key, state) => checkVpadState(key, state) function handleButtonDown() { - _handleButton(this.getAttribute('value'), true); + _handleButton(getKey(this), true); } function handleButtonUp() { - _handleButton(this.getAttribute('value'), false); + _handleButton(getKey(this), false); } function handleButtonClick() { - _handleButton(this.getAttribute('value'), true); + _handleButton(getKey(this), true); setTimeout(() => { - _handleButton(this.getAttribute('value'), false); + _handleButton(getKey(this), false); }, 30); } @@ -286,6 +288,9 @@ playerSlider.addEventListener('oninput', handlePlayerSlider); playerSlider.addEventListener('onchange', handlePlayerSlider); playerSlider.addEventListener('click', handlePlayerSlider); playerSlider.addEventListener('touchend', handlePlayerSlider); +playerSlider.onkeydown = (e) => { + e.preventDefault(); +} // Bind events for menu // TODO change this flow @@ -308,7 +313,7 @@ export const touch = { init: () => { // add buttons into the state 🤦 Array.from(document.querySelectorAll('.btn,.btn-big')).forEach((el) => { - vpadState[el.getAttribute('value')] = false; + vpadState[getKey(el)] = false; }); window.addEventListener('mousemove', handleWindowMove); From 104498dec0228fd01a0971d4cda103c32b51c706 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 18 Mar 2024 13:45:01 +0300 Subject: [PATCH 194/361] Fix wrong import order of some modules --- web/js/app.js | 24 ++++++------------------ web/js/gui.js | 2 +- web/js/input/touch.js | 16 ++++++++-------- web/js/network/socket.js | 2 +- 4 files changed, 16 insertions(+), 28 deletions(-) diff --git a/web/js/app.js b/web/js/app.js index 5e951d26..408125dc 100644 --- a/web/js/app.js +++ b/web/js/app.js @@ -1,3 +1,9 @@ +import {log} from 'log'; +import {opts, settings} from 'settings'; + +settings.init(); +log.level = settings.loadOr(opts.LOG_LEVEL, log.DEFAULT); + import {api} from 'api'; import { pub, @@ -36,8 +42,6 @@ import { } from 'event'; import {gui} from 'gui'; import {keyboard, KEY, joystick, retropad, touch} from 'input'; -import {log} from 'log'; -import {opts, settings} from 'settings'; import {socket, webrtc} from 'network'; import {debounce} from 'utils'; @@ -512,22 +516,6 @@ sub(SETTINGS_CHANGED, () => { // initial app state setState(app.state.eden); -settings.init(); - -(() => { - let lvl = settings.loadOr(opts.LOG_LEVEL, log.DEFAULT); - // migrate old log level options - // !to remove at some point - if (isNaN(lvl)) { - console.warn( - `The log value [${lvl}] is not supported! ` + - `The default value [debug] will be used instead.`); - settings.set(opts.LOG_LEVEL, `${log.DEFAULT}`) - lvl = log.DEFAULT - } - log.level = lvl -})(); - keyboard.init(); joystick.init(); touch.init(); diff --git a/web/js/gui.js b/web/js/gui.js index 0d295ea1..8be85b19 100644 --- a/web/js/gui.js +++ b/web/js/gui.js @@ -31,7 +31,7 @@ const select = (key = '', callback = () => ({}), values = {values: [], labels: [ }; el.append(select); - select.append(_option('none', current === '')); + select.append(_option(0, current === '', 'none')); values.values.forEach((value, index) => { select.append(_option(value, current === value, values.labels?.[index])); }); diff --git a/web/js/input/touch.js b/web/js/input/touch.js index d60a30b4..fb2c1ed1 100644 --- a/web/js/input/touch.js +++ b/web/js/input/touch.js @@ -292,14 +292,6 @@ playerSlider.onkeydown = (e) => { e.preventDefault(); } -// Bind events for menu -// TODO change this flow -pub(MENU_HANDLER_ATTACHED, {event: 'mousedown', handler: handleMenuDown}); -pub(MENU_HANDLER_ATTACHED, {event: 'touchstart', handler: handleMenuDown}); -pub(MENU_HANDLER_ATTACHED, {event: 'touchend', handler: handleMenuUp}); - -sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); - /** * Touch controls. * @@ -311,6 +303,14 @@ sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); */ export const touch = { init: () => { + // Bind events for menu + // TODO change this flow + pub(MENU_HANDLER_ATTACHED, {event: 'mousedown', handler: handleMenuDown}); + pub(MENU_HANDLER_ATTACHED, {event: 'touchstart', handler: handleMenuDown}); + pub(MENU_HANDLER_ATTACHED, {event: 'touchend', handler: handleMenuUp}); + + sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); + // add buttons into the state 🤦 Array.from(document.querySelectorAll('.btn,.btn-big')).forEach((el) => { vpadState[getKey(el)] = false; diff --git a/web/js/network/socket.js b/web/js/network/socket.js index 47314d9d..e153f441 100644 --- a/web/js/network/socket.js +++ b/web/js/network/socket.js @@ -20,7 +20,7 @@ const init = (roomId, wid, zone) => { let objParams = {room_id: roomId, zone: zone}; if (wid) objParams.wid = wid; const url = buildUrl(objParams) - console.info(`[ws] connecting to ${url}`); + log.info(`[ws] connecting to ${url}`); conn = new WebSocket(url.toString()); conn.onopen = () => { log.info('[ws] <- open connection'); From ff6c344a15a1a0fbc2f6ee8d9d8133c50550542c Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 21 Mar 2024 16:01:56 +0300 Subject: [PATCH 195/361] Update dependencies --- go.mod | 6 +++--- go.sum | 10 ++++++---- 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/go.mod b/go.mod index 37f7db61..abe5f5c0 100644 --- a/go.mod +++ b/go.mod @@ -11,7 +11,7 @@ require ( github.com/gorilla/websocket v1.5.1 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.1.0 - github.com/minio/minio-go/v7 v7.0.68 + github.com/minio/minio-go/v7 v7.0.69 github.com/pion/ice/v3 v3.0.3 github.com/pion/interceptor v0.1.25 github.com/pion/logging v0.2.2 @@ -45,8 +45,8 @@ require ( github.com/pion/mdns v0.0.12 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.14 // indirect - github.com/pion/rtp v1.8.3 // indirect - github.com/pion/sctp v1.8.12 // indirect + github.com/pion/rtp v1.8.4 // indirect + github.com/pion/sctp v1.8.13 // indirect github.com/pion/sdp/v3 v3.0.8 // indirect github.com/pion/srtp/v3 v3.0.1 // indirect github.com/pion/stun/v2 v2.0.0 // indirect diff --git a/go.sum b/go.sum index 73859611..70024001 100644 --- a/go.sum +++ b/go.sum @@ -63,8 +63,8 @@ github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWE github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.68 h1:hTqSIfLlpXaKuNy4baAp4Jjy2sqZEN9hRxD0M4aOfrQ= -github.com/minio/minio-go/v7 v7.0.68/go.mod h1:XAvOPJQ5Xlzk5o3o/ArO2NMbhSGkimC+bpW/ngRKDmQ= +github.com/minio/minio-go/v7 v7.0.69 h1:l8AnsQFyY1xiwa/DaQskY4NXSLA2yrGsW5iD9nRPVS0= +github.com/minio/minio-go/v7 v7.0.69/go.mod h1:XAvOPJQ5Xlzk5o3o/ArO2NMbhSGkimC+bpW/ngRKDmQ= github.com/minio/sha256-simd v1.0.1 h1:6kaan5IFmwTNynnKKpDHe6FWHohJOHhCPchzK49dzMM= github.com/minio/sha256-simd v1.0.1/go.mod h1:Pz6AKMiUdngCLpeTL/RJY1M9rUuPMYujV5xJjtbRSN8= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= @@ -106,11 +106,13 @@ github.com/pion/rtcp v1.2.13/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9 github.com/pion/rtcp v1.2.14 h1:KCkGV3vJ+4DAJmvP0vaQShsb0xkRfWkO540Gy102KyE= github.com/pion/rtcp v1.2.14/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9L4= github.com/pion/rtp v1.8.2/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= -github.com/pion/rtp v1.8.3 h1:VEHxqzSVQxCkKDSHro5/4IUUG1ea+MFdqR2R3xSpNU8= github.com/pion/rtp v1.8.3/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= +github.com/pion/rtp v1.8.4 h1:VqNGMNjMDMy9y0d+h+0dfjiWVKUEDQvA963jhJwu200= +github.com/pion/rtp v1.8.4/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/sctp v1.8.5/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= -github.com/pion/sctp v1.8.12 h1:2VX50pedElH+is6FI+OKyRTeN5oy4mrk2HjnGa3UCmY= github.com/pion/sctp v1.8.12/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= +github.com/pion/sctp v1.8.13 h1:YUJR44pWM2FPUhkl8l+vDyF2EDE3aTWtr3c+LDhCRcQ= +github.com/pion/sctp v1.8.13/go.mod h1:YKSgO/bO/6aOMP9LCie1DuD7m+GamiK2yIiPM6vH+GA= github.com/pion/sdp/v3 v3.0.8 h1:yd/wkrS0nzXEAb+uwv1TL3SG/gzsTiXHVOtXtD7EKl0= github.com/pion/sdp/v3 v3.0.8/go.mod h1:B5xmvENq5IXJimIO4zfp6LAe1fD9N+kFv+V/1lOdz8M= github.com/pion/srtp/v3 v3.0.1 h1:AkIQRIZ+3tAOJMQ7G301xtrD1vekQbNeRO7eY1K8ZHk= From 4d5033f03c575c4a938fca5eb0ad02cf1848e0a6 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 21 Mar 2024 16:03:52 +0300 Subject: [PATCH 196/361] Allow duplicate frames Some cores for performance reasons may return duplicate frames (i.e. previous frames) instead of rendering them again. --- pkg/config/config.yaml | 2 ++ pkg/config/emulator.go | 1 + pkg/worker/caged/libretro/frontend.go | 11 ++++++++++- pkg/worker/caged/libretro/nanoarch/nanoarch.go | 13 ++++++++----- 4 files changed, 21 insertions(+), 6 deletions(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 57cb39de..60fc6f53 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -135,6 +135,8 @@ emulator: # Sets a limiter function for some spammy core callbacks. # 0 - disabled, otherwise -- time in milliseconds for ignoring repeated calls except the last. debounceMs: 0 + # Allow duplicate frames + dup: true # Libretro cores logging level: DEBUG = 0, INFO, WARN, ERROR, DUMMY = INT_MAX logLevel: 1 cores: diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index 49bf6713..24993cbe 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -28,6 +28,7 @@ type LibretroConfig struct { List map[string]LibretroCoreConfig } DebounceMs int + Dup bool SaveCompression bool LogLevel int } diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 1b6638e3..935a24f3 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -93,6 +93,7 @@ var ( noData = func([]byte) {} noVideo = func(app.Video) {} videoPool sync.Pool + lastFrame *app.Video ) // NewFrontend implements Emulator interface for a Libretro frontend. @@ -156,6 +157,7 @@ func (f *Frontend) LoadCore(emu string) { conf := f.conf.GetLibretroCoreConfig(emu) meta := nanoarch.Metadata{ AutoGlContext: conf.AutoGlContext, + FrameDup: f.conf.Libretro.Dup, Hacks: conf.Hacks, HasVFR: conf.VFR, Hid: conf.Hid, @@ -190,7 +192,6 @@ func (f *Frontend) handleAudio(audio unsafe.Pointer, samples int) { } func (f *Frontend) handleVideo(data []byte, delta int32, fi nanoarch.FrameInfo) { - // !to merge both pools fr, _ := videoPool.Get().(*app.Video) if fr == nil { fr = new(app.Video) @@ -200,10 +201,17 @@ func (f *Frontend) handleVideo(data []byte, delta int32, fi nanoarch.FrameInfo) fr.Frame.H = int(fi.H) fr.Frame.Stride = int(fi.Stride) fr.Duration = delta + + lastFrame = fr f.onVideo(*fr) + videoPool.Put(fr) } +func (f *Frontend) handleDup() { + f.onVideo(*lastFrame) +} + func (f *Frontend) Shutdown() { f.mu.Lock() f.nano.Shutdown() @@ -224,6 +232,7 @@ func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { f.nano.OnDpad = f.input.isDpadTouched f.nano.OnVideo = f.handleVideo f.nano.OnAudio = f.handleAudio + f.nano.OnDup = f.handleDup } func (f *Frontend) SetVideoChangeCb(fn func()) { diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 95cd24a6..94ff0b0d 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -78,6 +78,7 @@ type Handlers struct { OnKeyPress func(port uint, key int) int OnAudio func(ptr unsafe.Pointer, frames int) OnVideo func(data []byte, delta int32, fi FrameInfo) + OnDup func() OnSystemAvInfo func() } @@ -88,6 +89,7 @@ type FrameInfo struct { } type Metadata struct { + FrameDup bool LibPath string // the full path to some emulator lib IsGlAllowed bool UsesLibCo bool @@ -127,6 +129,7 @@ var Nan0 = Nanoarch{ OnKeyPress: func(uint, int) int { return 0 }, OnAudio: func(unsafe.Pointer, int) {}, OnVideo: func([]byte, int32, FrameInfo) {}, + OnDup: func() {}, }, } @@ -559,9 +562,9 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { } Nan0.LastFrameTime = t - // some cores can return nothing - // !to add duplicate if can dup + // when the core returns a duplicate frame if data == nil { + Nan0.Handlers.OnDup() return } @@ -694,9 +697,9 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { setRotation((*(*uint)(data) % 4) * 90) return true case C.RETRO_ENVIRONMENT_GET_CAN_DUPE: - // !to implement frame dup (nil) some time later - *(*C.bool)(data) = C.bool(false) - return false + dup := C.bool(Nan0.meta.FrameDup) + *(*C.bool)(data) = dup + return dup case C.RETRO_ENVIRONMENT_GET_USERNAME: *(**C.char)(data) = Nan0.cUserName return true From 84f55691eb34f7f524b64cba951a591d8bc49582 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 21 Mar 2024 23:02:02 +0300 Subject: [PATCH 197/361] Check if dup frame didn't exist FBNeo can return dup frame flag before its first frame. --- pkg/worker/caged/libretro/frontend.go | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 935a24f3..77be7be8 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -209,7 +209,9 @@ func (f *Frontend) handleVideo(data []byte, delta int32, fi nanoarch.FrameInfo) } func (f *Frontend) handleDup() { - f.onVideo(*lastFrame) + if lastFrame != nil { + f.onVideo(*lastFrame) + } } func (f *Frontend) Shutdown() { @@ -217,6 +219,7 @@ func (f *Frontend) Shutdown() { f.nano.Shutdown() f.SetAudioCb(noAudio) f.SetVideoCb(noVideo) + lastFrame = nil f.mu.Unlock() f.log.Debug().Msgf("frontend shutdown done") } From 5da77a6b4fd975ef46263f00112c97bbe97fb98f Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 21 Mar 2024 23:02:53 +0300 Subject: [PATCH 198/361] Fix aspect ratio of PSX games in full-screen --- web/js/stream.js | 28 +++++++++++++--------------- 1 file changed, 13 insertions(+), 15 deletions(-) diff --git a/web/js/stream.js b/web/js/stream.js index cd213464..3ccfaee4 100644 --- a/web/js/stream.js +++ b/web/js/stream.js @@ -86,28 +86,26 @@ screen.addEventListener('canplay', () => { useCustomScreen(options.mirrorMode === 'mirror'); }, false); +const screenToAspect = (el) => { + const w = window.screen.width ?? window.innerWidth; + const hh = el.innerHeight || el.clientHeight || 0; + const dw = (w - hh * state.aspect) / 2 + screen.style.padding = `0 ${dw}px` +} + screen.addEventListener('fullscreenchange', () => { state.fullscreen = !!document.fullscreenElement; - const w = window.screen.width ?? window.innerWidth; - const h = window.screen.height ?? window.innerHeight; - - const ww = document.documentElement.innerWidth; - const hh = document.documentElement.innerHeight; - - screen.style.padding = '0' - if (state.fullscreen) { - const dw = (w - ww * state.aspect) / 2 - screen.style.padding = `0 ${dw}px` + if (!state.fullscreen) { + screen.style.padding = '0' + } else { + screenToAspect(document.fullscreenElement); // chrome bug setTimeout(() => { - const dw = (h - hh * state.aspect) / 2 - screen.style.padding = `0 ${dw}px` + screenToAspect(document.fullscreenElement) }, 1) - makeFullscreen(true); - } else { - makeFullscreen(false); } + makeFullscreen(state.fullscreen); // !to flipped }) From 084c14175e5167998a682388b8282d8e744eff1a Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 22 Mar 2024 00:17:22 +0300 Subject: [PATCH 199/361] Use AR correction in MAME --- pkg/config/config.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 60fc6f53..d9505247 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -224,6 +224,7 @@ emulator: # https://docs.libretro.com/library/fbneo/ mame: lib: fbneo_libretro + coreAspectRatio: true roms: [ "zip" ] nes: lib: nestopia_libretro From ecbe7f6ad9f72d58f8a79c3475b92aa12d30f630 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 31 Mar 2024 21:22:41 +0300 Subject: [PATCH 200/361] Remove unused ping stats module --- web/js/event.js | 2 -- web/js/stats.js | 90 +++++++------------------------------------------ 2 files changed, 12 insertions(+), 80 deletions(-) diff --git a/web/js/event.js b/web/js/event.js index df189044..e2ae32a1 100644 --- a/web/js/event.js +++ b/web/js/event.js @@ -51,8 +51,6 @@ export const pub = (topic, data) => { // events export const LATENCY_CHECK_REQUESTED = 'latencyCheckRequested'; -export const PING_REQUEST = 'pingRequest'; -export const PING_RESPONSE = 'pingResponse'; export const WORKER_LIST_FETCHED = 'workerListFetched'; diff --git a/web/js/stats.js b/web/js/stats.js index 126ca4a8..fdd2c444 100644 --- a/web/js/stats.js +++ b/web/js/stats.js @@ -3,9 +3,7 @@ import { pub, sub, STATS_TOGGLE, - HELP_OVERLAY_TOGGLED, - PING_REQUEST, - PING_RESPONSE + HELP_OVERLAY_TOGGLED } from 'event'; import {log} from 'log'; import {webrtc} from 'network'; @@ -20,6 +18,10 @@ let active = false; // !to add connection drop notice +// internal events +const WEBRTC_STATS_FRAME = 'STATS_WEBRTC_FRAME_STATS'; +const WEBRTC_STATS_RTT = 'STATS_WEBRTC_ICE_RTT'; + const statsOverlayEl = document.getElementById('stats-overlay'); /** @@ -149,73 +151,6 @@ const moduleUi = (label = '', withGraph = false, postfix = () => 'ms') => { return {el: ui, update, withPostfix} } -/** - * Latency stats submodule. - * - * Accumulates the simple rolling mean value - * between the next server request and following server response values. - * - * window - * _____________ - * | | - * [1, 1, 3, 4, 1, 4, 3, 1, 2, 1, 1, 1, 2, ... n] - * | - * stats_snapshot_period - * mean = round(next - mean / length % window) - * - * Events: - * <- PING_RESPONSE - * <- PING_REQUEST - * - * ?Interface: - * HTMLElement get() - * void enable() - * void disable() - * void render() - * - * @version 1 - */ -const latency = (() => { - let listeners = []; - - let mean = 0; - let length = 0; - let previous = 0; - const window = 5; - - const ui = moduleUi('Ping(c)', true); - - const onPingRequest = (data) => previous = data.time; - - const onPingResponse = () => { - length++; - const delta = Date.now() - previous; - mean += Math.round((delta - mean) / length); - - if (length % window === 0) { - length = 1; - mean = delta; - } - } - - const enable = () => { - listeners.push( - sub(PING_RESPONSE, onPingResponse), - sub(PING_REQUEST, onPingRequest) - ); - } - - const disable = () => { - while (listeners.length) listeners.shift().unsub(); - } - - const render = () => ui.update(mean); - - const get = () => ui.el; - - return {get, enable, disable, render} -})(event, moduleUi); - /** * User agent memory stats. * @@ -264,25 +199,25 @@ const clientMemory = (() => { return {get, enable, disable, render} })(moduleUi, performance, window); - const webRTCStats_ = (() => { let interval = null function getStats() { if (!webrtc.isConnected()) return; - webrtc.getConnection().getStats(null).then(stats => { + + webrtc.getConnection().getStats().then(stats => { let frameStatValue = '?'; stats.forEach(report => { if (report["framesReceived"] !== undefined && report["framesDecoded"] !== undefined && report["framesDropped"] !== undefined) { frameStatValue = report["framesReceived"] - report["framesDecoded"] - report["framesDropped"]; - pub('STATS_WEBRTC_FRAME_STATS', frameStatValue) + pub(WEBRTC_STATS_FRAME, frameStatValue) } else if (report["framerateMean"] !== undefined) { frameStatValue = Math.round(report["framerateMean"] * 100) / 100; - pub('STATS_WEBRTC_FRAME_STATS', frameStatValue) + pub(WEBRTC_STATS_FRAME, frameStatValue) } if (report["nominated"] && report["currentRoundTripTime"] !== undefined) { - pub('STATS_WEBRTC_ICE_RTT', report["currentRoundTripTime"] * 1000); + pub(WEBRTC_STATS_RTT, report["currentRoundTripTime"] * 1000); } }); }); @@ -339,12 +274,12 @@ const webRTCRttStats = (() => { let value = 0; let listener; - const ui = moduleUi('RTT', true, () => 'ms'); + const ui = moduleUi('Ping', true, () => 'ms'); const get = () => ui.el; const enable = () => { - listener = sub('STATS_WEBRTC_ICE_RTT', onStats); + listener = sub(WEBRTC_STATS_RTT, onStats); } const disable = () => { @@ -421,7 +356,6 @@ const render = () => modules(m => m.render(), false); // add submodules _modules.push( webRTCRttStats, - // latency, clientMemory, webRTCStats_, webRTCFrameStats From 7377b4f15b17c31742f4dd7b90a920781ca181e0 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 31 Mar 2024 21:30:46 +0300 Subject: [PATCH 201/361] Update dependencies --- go.mod | 14 +++++++------- go.sum | 34 +++++++++++++++++++--------------- 2 files changed, 26 insertions(+), 22 deletions(-) diff --git a/go.mod b/go.mod index abe5f5c0..5b0b031c 100644 --- a/go.mod +++ b/go.mod @@ -3,7 +3,7 @@ module github.com/giongto35/cloud-game/v3 go 1.22 require ( - github.com/VictoriaMetrics/metrics v1.33.0 + github.com/VictoriaMetrics/metrics v1.33.1 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.7.0 github.com/goccy/go-json v0.10.2 @@ -13,9 +13,9 @@ require ( github.com/knadh/koanf/v2 v2.1.0 github.com/minio/minio-go/v7 v7.0.69 github.com/pion/ice/v3 v3.0.3 - github.com/pion/interceptor v0.1.25 + github.com/pion/interceptor v0.1.27 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.0-beta.13 + github.com/pion/webrtc/v4 v4.0.0-beta.14 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.32.0 github.com/veandco/go-sdl2 v0.4.38 @@ -40,18 +40,18 @@ require ( github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect github.com/modern-go/reflect2 v1.0.2 // indirect - github.com/pion/datachannel v1.5.5 // indirect + github.com/pion/datachannel v1.5.6 // indirect github.com/pion/dtls/v2 v2.2.10 // indirect github.com/pion/mdns v0.0.12 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.14 // indirect - github.com/pion/rtp v1.8.4 // indirect + github.com/pion/rtp v1.8.5 // indirect github.com/pion/sctp v1.8.13 // indirect - github.com/pion/sdp/v3 v3.0.8 // indirect + github.com/pion/sdp/v3 v3.0.9 // indirect github.com/pion/srtp/v3 v3.0.1 // indirect github.com/pion/stun/v2 v2.0.0 // indirect github.com/pion/transport/v2 v2.2.4 // indirect - github.com/pion/transport/v3 v3.0.1 // indirect + github.com/pion/transport/v3 v3.0.2 // indirect github.com/pion/turn/v3 v3.0.1 // indirect github.com/pmezard/go-difflib v1.0.0 // indirect github.com/stretchr/testify v1.9.0 // indirect diff --git a/go.sum b/go.sum index 70024001..6daceafc 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,5 @@ -github.com/VictoriaMetrics/metrics v1.33.0 h1:EnkDEaGiL2u95t+W76GfecC/LMYpy+tFrexYzBWQIAc= -github.com/VictoriaMetrics/metrics v1.33.0/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= +github.com/VictoriaMetrics/metrics v1.33.1 h1:CNV3tfm2Kpv7Y9W3ohmvqgFWPR55tV2c7M2U6OIo+UM= +github.com/VictoriaMetrics/metrics v1.33.1/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -85,51 +85,50 @@ github.com/onsi/ginkgo v1.16.5/go.mod h1:+E8gABHa3K6zRBolWtd+ROzc/U5bkGt0FwiG042 github.com/onsi/gomega v1.7.1/go.mod h1:XdKZgCCFLUoM/7CFJVPcG8C1xQ1AJ0vpAezJrB7JYyY= github.com/onsi/gomega v1.10.1/go.mod h1:iN09h71vgCQne3DLsj+A5owkum+a2tYe+TOCB1ybHNo= github.com/onsi/gomega v1.17.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAlGdZY= -github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew8= github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= +github.com/pion/datachannel v1.5.6 h1:1IxKJntfSlYkpUj8LlYRSWpYiTTC02nUrOE8T3DqGeg= +github.com/pion/datachannel v1.5.6/go.mod h1:1eKT6Q85pRnr2mHiWHxJwO50SfZRtWHTsNIVb/NfGW4= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= github.com/pion/dtls/v2 v2.2.10 h1:u2Axk+FyIR1VFTPurktB+1zoEPGIW3bmyj3LEFrXjAA= github.com/pion/dtls/v2 v2.2.10/go.mod h1:d9SYc9fch0CqK90mRk1dC7AkzzpwJj6u2GU3u+9pqFE= github.com/pion/ice/v3 v3.0.3 h1:Mu5QkZ2pYmcjq9JETDcDR7F8UzjP1VHmcZmgU0yqsyk= github.com/pion/ice/v3 v3.0.3/go.mod h1:YMLU7qbKfVjmEv7EoZPIVEI+kNYxWCdPK3VS0BU+U4Q= -github.com/pion/interceptor v0.1.25 h1:pwY9r7P6ToQ3+IF0bajN0xmk/fNw/suTgaTdlwTDmhc= -github.com/pion/interceptor v0.1.25/go.mod h1:wkbPYAak5zKsfpVDYMtEfWEy8D4zL+rpxCxPImLOg3Y= +github.com/pion/interceptor v0.1.27 h1:mZ01OiGiukwRxezmDGzYjjokCVlDOk4T6BfaL5qrtGo= +github.com/pion/interceptor v0.1.27/go.mod h1:/vVaqLwDjGv4GRbgmChIKZIT5EXFDijwmj4WmIYy9bI= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= github.com/pion/mdns v0.0.12 h1:CiMYlY+O0azojWDmxdNr7ADGrnZ+V6Ilfner+6mSVK8= github.com/pion/mdns v0.0.12/go.mod h1:VExJjv8to/6Wqm1FXK+Ii/Z9tsVk/F5sD/N70cnYFbk= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= -github.com/pion/rtcp v1.2.10/go.mod h1:ztfEwXZNLGyF1oQDttz/ZKIBaeeg/oWbRYqzBM9TL1I= github.com/pion/rtcp v1.2.12/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9L4= -github.com/pion/rtcp v1.2.13/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9L4= github.com/pion/rtcp v1.2.14 h1:KCkGV3vJ+4DAJmvP0vaQShsb0xkRfWkO540Gy102KyE= github.com/pion/rtcp v1.2.14/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9L4= -github.com/pion/rtp v1.8.2/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/rtp v1.8.3/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= -github.com/pion/rtp v1.8.4 h1:VqNGMNjMDMy9y0d+h+0dfjiWVKUEDQvA963jhJwu200= github.com/pion/rtp v1.8.4/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= +github.com/pion/rtp v1.8.5 h1:uYzINfaK+9yWs7r537z/Rc1SvT8ILjBcmDOpJcTB+OU= +github.com/pion/rtp v1.8.5/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/sctp v1.8.5/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= -github.com/pion/sctp v1.8.12/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= github.com/pion/sctp v1.8.13 h1:YUJR44pWM2FPUhkl8l+vDyF2EDE3aTWtr3c+LDhCRcQ= github.com/pion/sctp v1.8.13/go.mod h1:YKSgO/bO/6aOMP9LCie1DuD7m+GamiK2yIiPM6vH+GA= -github.com/pion/sdp/v3 v3.0.8 h1:yd/wkrS0nzXEAb+uwv1TL3SG/gzsTiXHVOtXtD7EKl0= github.com/pion/sdp/v3 v3.0.8/go.mod h1:B5xmvENq5IXJimIO4zfp6LAe1fD9N+kFv+V/1lOdz8M= +github.com/pion/sdp/v3 v3.0.9 h1:pX++dCHoHUwq43kuwf3PyJfHlwIj4hXA7Vrifiq0IJY= +github.com/pion/sdp/v3 v3.0.9/go.mod h1:B5xmvENq5IXJimIO4zfp6LAe1fD9N+kFv+V/1lOdz8M= github.com/pion/srtp/v3 v3.0.1 h1:AkIQRIZ+3tAOJMQ7G301xtrD1vekQbNeRO7eY1K8ZHk= github.com/pion/srtp/v3 v3.0.1/go.mod h1:3R3a1qIOIxBkVTLGFjafKK6/fJoTdQDhcC67HOyMbJ8= github.com/pion/stun/v2 v2.0.0 h1:A5+wXKLAypxQri59+tmQKVs7+l6mMM+3d+eER9ifRU0= github.com/pion/stun/v2 v2.0.0/go.mod h1:22qRSh08fSEttYUmJZGlriq9+03jtVmXNODgLccj8GQ= -github.com/pion/transport v0.14.1 h1:XSM6olwW+o8J4SCmOBb/BpwZypkHeyM0PGFCxNQBr40= github.com/pion/transport v0.14.1/go.mod h1:4tGmbk00NeYA3rUa9+n+dzCCoKkcy3YlYb99Jn2fNnI= github.com/pion/transport/v2 v2.2.1/go.mod h1:cXXWavvCnFF6McHTft3DWS9iic2Mftcz1Aq29pGcU5g= github.com/pion/transport/v2 v2.2.4 h1:41JJK6DZQYSeVLxILA2+F4ZkKb4Xd/tFJZRFZQ9QAlo= github.com/pion/transport/v2 v2.2.4/go.mod h1:q2U/tf9FEfnSBGSW6w5Qp5PFWRLRj3NjLhCCgpRK4p0= -github.com/pion/transport/v3 v3.0.1 h1:gDTlPJwROfSfz6QfSi0ZmeCSkFcnWWiiR9ES0ouANiM= github.com/pion/transport/v3 v3.0.1/go.mod h1:UY7kiITrlMv7/IKgd5eTUcaahZx5oUN3l9SzK5f5xE0= +github.com/pion/transport/v3 v3.0.2 h1:r+40RJR25S9w3jbA6/5uEPTzcdn7ncyU44RWCbHkLg4= +github.com/pion/transport/v3 v3.0.2/go.mod h1:nIToODoOlb5If2jF9y2Igfx3PFYWfuXi37m0IlWa/D0= github.com/pion/turn/v3 v3.0.1 h1:wLi7BTQr6/Q20R0vt/lHbjv6y4GChFtC33nkYbasoT8= github.com/pion/turn/v3 v3.0.1/go.mod h1:MrJDKgqryDyWy1/4NT9TWfXWGMC7UHT6pJIv1+gMeNE= -github.com/pion/webrtc/v4 v4.0.0-beta.13 h1:nIhz2viUhaFvKlbLDpF/XQqlsS+PhfYTxd8qcAo1pL8= -github.com/pion/webrtc/v4 v4.0.0-beta.13/go.mod h1:ojwmbdrsIkmRXPumQf9OFIkTJVB9AV/Z9ItMpNvsuhM= +github.com/pion/webrtc/v4 v4.0.0-beta.14 h1:pNBIkhCsLBdgeCzCNIK5xBWdTWGf7to6ifMw+fvYTMQ= +github.com/pion/webrtc/v4 v4.0.0-beta.14/go.mod h1:MMP3NBhZaFIHbVLWqJdILOkXbDh4V0as+v4SA6Gi08E= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -166,6 +165,7 @@ golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5y golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= golang.org/x/crypto v0.12.0/go.mod h1:NF0Gs7EO5K4qLn+Ylc+fih8BSTeIjAP05siRnAh98yw= golang.org/x/crypto v0.18.0/go.mod h1:R0j02AL6hcrfOiy9T4ZYp/rcWeMxM3L6QYxlOuEG1mg= +golang.org/x/crypto v0.19.0/go.mod h1:Iy9bg/ha4yyC70EfRS8jz+B6ybOBKMaSxLj6P6oBDfU= golang.org/x/crypto v0.21.0 h1:X31++rzVUdKhX5sWmSOFZxx8UW/ldWx55cbf08iNAMA= golang.org/x/crypto v0.21.0/go.mod h1:0BP7YvVV9gBbVKyeTG0Gyn+gZm94bibOW5BjDEYAOMs= golang.org/x/image v0.15.0 h1:kOELfmgrmJlw4Cdb7g/QGuB3CvDrXbqEIww/pNtNBm8= @@ -187,6 +187,7 @@ golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= golang.org/x/net v0.14.0/go.mod h1:PpSgVXXLK0OxS0F31C1/tv6XNguvCrnXIDrFMspZIUI= golang.org/x/net v0.20.0/go.mod h1:z8BVo6PvndSri0LbOE3hAn0apkU+1YvI6E70E9jsnvY= +golang.org/x/net v0.21.0/go.mod h1:bIjVDfnllIU7BJ2DNgfnXvpSvtn8VRwhlsaeUTyUS44= golang.org/x/net v0.22.0 h1:9sGLhx7iRIHEiX0oAJ3MRZMUCElJgy7Br1nO+AMN3Tc= golang.org/x/net v0.22.0/go.mod h1:JKghWKKOSdJwpW2GEx0Ja7fmaKnMsbu+MWVZTokSYmg= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -218,6 +219,7 @@ golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.16.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.17.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/sys v0.18.0 h1:DBdB3niSjOA/O0blCZBqDefyWNYveAYMNF1Wum0DYQ4= golang.org/x/sys v0.18.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= @@ -228,6 +230,8 @@ golang.org/x/term v0.7.0/go.mod h1:P32HKFT3hSsZrRxla30E9HqToFYAQPCMs/zFMBUFqPY= golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= golang.org/x/term v0.11.0/go.mod h1:zC9APTIj3jG3FdV/Ons+XE1riIZXG4aZ4GTHiPZJPIU= golang.org/x/term v0.16.0/go.mod h1:yn7UURbUtPyrVJPGPq404EukNFxcm/foM+bV/bfcDsY= +golang.org/x/term v0.17.0/go.mod h1:lLRBjIVuehSbZlaOtGMbcMncT+aqLLLmKrsjNrUguwk= +golang.org/x/term v0.18.0/go.mod h1:ILwASektA3OnRv7amZ1xhE/KTR+u50pbXfZ03+6Nx58= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= From 3e0fcfbfcfc811082aad9fe1c8c23b42b24cf30f Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 31 Mar 2024 21:31:18 +0300 Subject: [PATCH 202/361] Enable SCTP zero checksums --- pkg/network/webrtc/factory.go | 1 + 1 file changed, 1 insertion(+) diff --git a/pkg/network/webrtc/factory.go b/pkg/network/webrtc/factory.go index 0eaa9dd7..e450abfb 100644 --- a/pkg/network/webrtc/factory.go +++ b/pkg/network/webrtc/factory.go @@ -74,6 +74,7 @@ func NewApiFactory(conf config.Webrtc, log *logger.Logger, mod ModApiFun) (api * } s.SetICEMulticastDNSMode(ice.MulticastDNSModeDisabled) + s.EnableSCTPZeroChecksum(true) if mod != nil { mod(m, i, &s) From f557d169970214d1690b3614b754d0e40b46c651 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 31 Mar 2024 22:08:32 +0300 Subject: [PATCH 203/361] Fix broken link --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 654dc6d6..24c5a405 100644 --- a/README.md +++ b/README.md @@ -125,7 +125,7 @@ application [installed](https://docs.docker.com/compose/install/). By clicking these deep link, you can join the game directly and play it together with other people. -- [Play Pokemon Emerald](https://cloudretro.io/?id=652e45d78d2b91cd%7CPokemon%20-%20Emerald%20Version%20%28U%29) +- [Play Pokemon Emerald](https://cloudretro.io/?id=652e45d78d2b91cd___Pokemon%20-%20Emerald%20Version%20(U)) - [Fire Emblem](https://cloudretro.io/?id=314ea4d7f9c94d25___Fire%20Emblem%20%28U%29%20%5B%21%5D) - [Samurai Showdown 4](https://cloudretro.io/?id=733c73064c368832___samsho4) - [Metal Slug X](https://cloudretro.io/?id=2a9c4b3f1c872d28___mslugx) From cebbcdf2562b0e5241259d0d30f004dcedf1c30f Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 2 Apr 2024 00:55:25 +0300 Subject: [PATCH 204/361] Refactor WebRTC stats --- web/js/app.js | 48 ++++++++- web/js/event.js | 1 - web/js/network/webrtc.js | 5 +- web/js/stats.js | 223 ++++++++------------------------------- 4 files changed, 92 insertions(+), 185 deletions(-) diff --git a/web/js/app.js b/web/js/app.js index 408125dc..e6473b8a 100644 --- a/web/js/app.js +++ b/web/js/app.js @@ -29,7 +29,6 @@ import { RECORDING_STATUS_CHANGED, RECORDING_TOGGLED, SETTINGS_CHANGED, - STATS_TOGGLE, WEBRTC_CONNECTION_CLOSED, WEBRTC_CONNECTION_READY, WEBRTC_ICE_CANDIDATE_FOUND, @@ -38,7 +37,7 @@ import { WEBRTC_NEW_CONNECTION, WEBRTC_SDP_ANSWER, WEBRTC_SDP_OFFER, - WORKER_LIST_FETCHED + WORKER_LIST_FETCHED, } from 'event'; import {gui} from 'gui'; import {keyboard, KEY, joystick, retropad, touch} from 'input'; @@ -395,7 +394,7 @@ const app = { message.show('Saving the game.'); break; case KEY.STATS: - pub(STATS_TOGGLE); + stats.toggle(); break; case KEY.SETTINGS: break; @@ -449,7 +448,7 @@ const app = { window.location = window.location.pathname; break; case KEY.STATS: - pub(STATS_TOGGLE); + stats.toggle(); break; case KEY.DTOGGLE: handleToggle(); @@ -527,3 +526,44 @@ const wid = new URLSearchParams(document.location.search).get('wid'); // if from URL -> start game immediately! socket.init(roomId, wid, zone); api.transport = socket; + +// stats +let WEBRTC_STATS_FRAME_DELAY; +let WEBRTC_STATS_RTT; + +stats.modules = [ + { + mui: stats.mui('Ping', true), + init() { + WEBRTC_STATS_RTT = (v) => (this.val = v) + }, + }, + { + mui: stats.mui('FrameDelay', false, () => ''), + init() { + WEBRTC_STATS_FRAME_DELAY = (v) => (this.val = v) + } + }, + { + async stats() { + const stats = await webrtc.stats(); + if (!stats) return; + + stats.forEach(report => { + const {framesReceived, framesDecoded, framesDropped} = report; + if (framesReceived !== undefined && framesDecoded !== undefined && framesDropped !== undefined) { + WEBRTC_STATS_FRAME_DELAY(framesReceived - framesDecoded - framesDropped) + } + const {nominated, currentRoundTripTime} = report; + if (nominated && currentRoundTripTime !== undefined) { + WEBRTC_STATS_RTT(currentRoundTripTime * 1000); + } + }); + }, + enable() { + this.interval = window.setInterval(this.stats, 999); + }, + disable() { + window.clearInterval(this.interval); + }, + }] diff --git a/web/js/event.js b/web/js/event.js index e2ae32a1..6a742af1 100644 --- a/web/js/event.js +++ b/web/js/event.js @@ -87,7 +87,6 @@ export const AXIS_CHANGED = 'axisChanged'; export const CONTROLLER_UPDATED = 'controllerUpdated'; export const DPAD_TOGGLE = 'dpadToggle'; -export const STATS_TOGGLE = 'statsToggle'; export const HELP_OVERLAY_TOGGLED = 'helpOverlayToggled'; export const SETTINGS_CHANGED = 'settingsChanged'; diff --git a/web/js/network/webrtc.js b/web/js/network/webrtc.js index 5e8ae47d..53e02988 100644 --- a/web/js/network/webrtc.js +++ b/web/js/network/webrtc.js @@ -168,7 +168,10 @@ export const webrtc = { input: (data) => dataChannel.send(data), isConnected: () => connected, isInputReady: () => inputReady, - getConnection: () => connection, + stats: async () => { + if (!connected) return Promise.resolve(); + return await connection.getStats() + }, stop, set onData(fn) { onData = fn diff --git a/web/js/stats.js b/web/js/stats.js index fdd2c444..6bc5fb34 100644 --- a/web/js/stats.js +++ b/web/js/stats.js @@ -1,12 +1,7 @@ -import {env} from 'env'; import { - pub, sub, - STATS_TOGGLE, HELP_OVERLAY_TOGGLED } from 'event'; -import {log} from 'log'; -import {webrtc} from 'network'; const _modules = []; let tempHide = false; @@ -18,10 +13,6 @@ let active = false; // !to add connection drop notice -// internal events -const WEBRTC_STATS_FRAME = 'STATS_WEBRTC_FRAME_STATS'; -const WEBRTC_STATS_RTT = 'STATS_WEBRTC_ICE_RTT'; - const statsOverlayEl = document.getElementById('stats-overlay'); /** @@ -73,18 +64,16 @@ const graph = (parent, opts = { /** * Draws a bar graph on the canvas. + * + * @example + * +-------+ +-------+ +---------+ + * | | |+---+ | |+---+ | + * | | |||||| | ||||||+---+ + * | | |||||| | ||||||||||| + * +-------+ +----+--+ +---------+ + * [] [3] [3, 2] */ const render = () => { - // 0,0 w,0 0,0 w,0 0,0 w,0 - // +-------+ +-------+ +---------+ - // | | |+---+ | |+---+ | - // | | |||||| | ||||||+---+ - // | | |||||| | ||||||||||| - // +-------+ +----+--+ +---------+ - // 0,h w,h 0,h w,h 0,h w,h - // [] [3] [3, 2] - // - _context.clearRect(0, 0, _canvas.width, _canvas.height); maxN = data[0] || 1; @@ -109,7 +98,12 @@ const graph = (parent, opts = { _context.fillRect(x, y, w, h); } - return {add, get, max, render} + const clear = () => { + data = []; + render(); + } + + return {add, get, max, render, clear} } /** @@ -148,155 +142,34 @@ const moduleUi = (label = '', withGraph = false, postfix = () => 'ms') => { _value.textContent = `${value < 1 ? '<1' : value} ${_graph ? `(${_graph.max()}) ` : ''}${postfix_(value)}`; } - return {el: ui, update, withPostfix} + const clear = () => { + _graph && _graph.clear(); + } + + return {el: ui, update, withPostfix, clear} } -/** - * User agent memory stats. - * - * ?Interface: - * HTMLElement get() - * void enable() - * void disable() - * void render() - * - * @version 1 - */ -const clientMemory = (() => { - let active = false; +const modules = (fn, force = true) => _modules.forEach(m => (force || m.get) && fn(m)) - const measures = ['B', 'KB', 'MB', 'GB']; - const precision = 1; - let mLog = 0; - - const ui = moduleUi('Memory', false, (x) => (x > 0) ? measures[mLog] : ''); - - const get = () => ui.el; - - const enable = () => { - active = true; - render(); +const module = (mod) => { + mod = { + val: 0, + enable: () => ({}), + ...mod, + _disable: function () { + mod.val = 0; + mod.disable && mod.disable(); + mod.mui && mod.mui.clear(); + }, + ...(mod.mui && { + get: () => mod.mui.el, + render: () => mod.mui.update(mod.val) + }) } - - const disable = () => active = false; - - const render = () => { - if (!active) return; - - const m = performance.memory.usedJSHeapSize; - let newValue = 'N/A'; - - if (m > 0) { - mLog = Math.floor(Math.log(m) / Math.log(1000)); - newValue = Math.round(m * precision / Math.pow(1000, mLog)) / precision; - } - - ui.update(newValue); - } - - if (window.performance && !performance.memory) performance.memory = {usedJSHeapSize: 0, totalJSHeapSize: 0}; - - return {get, enable, disable, render} -})(moduleUi, performance, window); - -const webRTCStats_ = (() => { - let interval = null - - function getStats() { - if (!webrtc.isConnected()) return; - - webrtc.getConnection().getStats().then(stats => { - let frameStatValue = '?'; - stats.forEach(report => { - if (report["framesReceived"] !== undefined && report["framesDecoded"] !== undefined && report["framesDropped"] !== undefined) { - frameStatValue = report["framesReceived"] - report["framesDecoded"] - report["framesDropped"]; - pub(WEBRTC_STATS_FRAME, frameStatValue) - } else if (report["framerateMean"] !== undefined) { - frameStatValue = Math.round(report["framerateMean"] * 100) / 100; - pub(WEBRTC_STATS_FRAME, frameStatValue) - } - - if (report["nominated"] && report["currentRoundTripTime"] !== undefined) { - pub(WEBRTC_STATS_RTT, report["currentRoundTripTime"] * 1000); - } - }); - }); - } - - const enable = () => { - interval = window.setInterval(getStats, 1000); - } - - const disable = () => window.clearInterval(interval); - - return {enable, disable, internal: true} -})(event, webrtc, window); - -/** - * User agent frame stats. - * - * ?Interface: - * HTMLElement get() - * void enable() - * void disable() - * void render() - * - * @version 1 - */ -const webRTCFrameStats = (() => { - let value = 0; - let listener; - - const label = env.getBrowser() === 'firefox' ? 'FramerateMean' : 'FrameDelay'; - const ui = moduleUi(label, false, () => ''); - - const get = () => ui.el; - - const enable = () => { - listener = sub('STATS_WEBRTC_FRAME_STATS', onStats); - } - - const disable = () => { - value = 0; - if (listener) listener.unsub(); - } - - const render = () => ui.update(value); - - function onStats(val) { - value = val; - } - - return {get, enable, disable, render} -})(env, event, moduleUi); - -const webRTCRttStats = (() => { - let value = 0; - let listener; - - const ui = moduleUi('Ping', true, () => 'ms'); - - const get = () => ui.el; - - const enable = () => { - listener = sub(WEBRTC_STATS_RTT, onStats); - } - - const disable = () => { - value = 0; - if (listener) listener.unsub(); - } - - const render = () => ui.update(value); - - function onStats(val) { - value = val; - } - - return {get, enable, disable, render} -})(event, moduleUi); - -const modules = (fn, force = true) => _modules.forEach(m => (force || !m.internal) && fn(m)) + mod.init?.(); + _modules.push(mod); + modules(m => m.get && statsOverlayEl.append(m.get()), false); +} const enable = () => { active = true; @@ -321,15 +194,13 @@ function draw(timestamp) { const disable = () => { active = false; - modules(m => m.disable()); + modules(m => m._disable()); _hide(); } const _show = () => statsOverlayEl.style.visibility = 'visible'; const _hide = () => statsOverlayEl.style.visibility = 'hidden'; -const onToggle = () => active ? disable() : enable(); - /** * Handles help overlay toggle event. * Workaround for a not normal app layout layering. @@ -354,21 +225,15 @@ const onHelpOverlayToggle = (overlay) => { const render = () => modules(m => m.render(), false); // add submodules -_modules.push( - webRTCRttStats, - clientMemory, - webRTCStats_, - webRTCFrameStats -); -modules(m => statsOverlayEl.append(m.get()), false); - -sub(STATS_TOGGLE, onToggle); sub(HELP_OVERLAY_TOGGLED, onHelpOverlayToggle) /** * App statistics module. */ export const stats = { - enable, - disable + toggle: () => active ? disable() : enable(), + set modules(m) { + m && m.forEach(mod => module(mod)) + }, + mui: moduleUi, } From effa5c46c59a4faeed7f7167de78f6d5150e2af3 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 3 Apr 2024 19:52:42 +0300 Subject: [PATCH 205/361] Update UA/PLT detection --- web/js/env.js | 73 ++++++++++++++++------------------------ web/js/input/joystick.js | 18 +++++----- web/js/stream.js | 10 +++--- 3 files changed, 43 insertions(+), 58 deletions(-) diff --git a/web/js/env.js b/web/js/env.js index ef1ef3d5..b9d5f2e7 100644 --- a/web/js/env.js +++ b/web/js/env.js @@ -3,6 +3,9 @@ const page = document.getElementsByTagName('html')[0]; const gameBoy = document.getElementById('gamebody'); const sourceLink = document.getElementsByClassName('source')[0]; +export const browser = {unknown: 0, firefox: 1, chrome: 2, edge: 3, safari: 4} +export const platform = {unknown: 0, windows: 1, linux: 2, macos: 3, android: 4,} + let isLayoutSwitched = false; // Window rerender / rotate screen if needed @@ -44,53 +47,35 @@ const rescaleGameBoy = (targetWidth, targetHeight) => { gameBoy.style['transform'] = transformations.join(' '); } -const getOS = () => { - // linux? ios? - let OSName = 'unknown'; - if (navigator.appVersion.indexOf('Win') !== -1) OSName = 'win'; - else if (navigator.appVersion.indexOf('Mac') !== -1) OSName = 'mac'; - else if (navigator.userAgent.indexOf('Linux') !== -1) OSName = 'linux'; - else if (navigator.userAgent.indexOf('Android') !== -1) OSName = 'android'; - return OSName; -}; +const os = () => { + const ua = window.navigator.userAgent; + // noinspection JSUnresolvedReference,JSDeprecatedSymbols + const plt = window.navigator?.userAgentData?.platform || window.navigator.platform; + const macs = ["Macintosh", "MacIntel"]; + const wins = ["Win32", "Win64", "Windows"]; + if (wins.indexOf(plt) !== -1) return platform.windows; + if (macs.indexOf(plt) !== -1) return platform.macos; + if (/Linux/.test(plt)) return platform.linux; + if (/Android/.test(ua)) return platform.android; + return platform.unknown +} -const getBrowser = () => { - let browserName = 'unknown'; - if (navigator.userAgent.indexOf('Firefox') !== -1) browserName = 'firefox'; - if (navigator.userAgent.indexOf('Chrome') !== -1) browserName = 'chrome'; - if (navigator.userAgent.indexOf('Edge') !== -1) browserName = 'edge'; - if (navigator.userAgent.indexOf('Version/') !== -1) browserName = 'safari'; - if (navigator.userAgent.indexOf('UCBrowser') !== -1) browserName = 'uc'; - return browserName; -}; +const _browser = () => { + if (navigator.userAgent.indexOf('Firefox') !== -1) return browser.firefox; + if (navigator.userAgent.indexOf('Chrome') !== -1) return browser.chrome; + if (navigator.userAgent.indexOf('Edge') !== -1) return browser.edge; + if (navigator.userAgent.indexOf('Version/') !== -1) return browser.safari; + return browser.unknown; +} + +const isMobile = () => /Mobi|Android|iPhone/i.test(navigator.userAgent); const isPortrait = () => getWidth(page) < getHeight(page); const toggleFullscreen = (enable, element) => { const el = enable ? element : document; - - if (enable) { - if (el.requestFullscreen) { - el.requestFullscreen(); - } else if (el.mozRequestFullScreen) { /* Firefox */ - el.mozRequestFullScreen(); - } else if (el.webkitRequestFullscreen) { /* Chrome, Safari and Opera */ - el.webkitRequestFullscreen(); - } else if (el.msRequestFullscreen) { /* IE/Edge */ - el.msRequestFullscreen(); - } - } else { - if (el.exitFullscreen) { - el.exitFullscreen(); - } else if (el.mozCancelFullScreen) { /* Firefox */ - el.mozCancelFullScreen(); - } else if (el.webkitExitFullscreen) { /* Chrome, Safari and Opera */ - el.webkitExitFullscreen(); - } else if (el.msExitFullscreen) { /* IE/Edge */ - el.msExitFullscreen(); - } - } -}; + enable ? el.requestFullscreen?.() : el.exitFullscreen?.(); +} function getHeight(el) { return parseFloat(getComputedStyle(el, null).height.replace("px", "")); @@ -105,9 +90,9 @@ window.addEventListener('orientationchange', fixScreenLayout); document.addEventListener('DOMContentLoaded', () => fixScreenLayout(), false); export const env = { - getOs: getOS, - getBrowser: getBrowser, - isMobileDevice: () => /Mobi|Android|iPhone/i.test(navigator.userAgent), + getOs: os(), + getBrowser: _browser(), + isMobileDevice: isMobile(), display: () => ({ isPortrait: isPortrait, toggleFullscreen: toggleFullscreen, diff --git a/web/js/input/joystick.js b/web/js/input/joystick.js index b7f9a54a..4faa30ce 100644 --- a/web/js/input/joystick.js +++ b/web/js/input/joystick.js @@ -8,7 +8,7 @@ import { KEY_PRESSED, KEY_RELEASED } from 'event'; -import {env} from 'env'; +import {env, browser as br, platform} from 'env'; import {KEY} from 'input'; import {log} from 'log'; @@ -98,10 +98,10 @@ const onGamepadConnected = (e) => { // Ref: https://github.com/giongto35/cloud-game/issues/14 // get mapping first (default KeyMap2) - let os = env.getOs(); - let browser = env.getBrowser(); + const os = env.getOs(); + const browser = env.getBrowser(); - if (os === 'android') { + if (os === platform.android) { // default of android is KeyMap1 joystickMap = { 2: KEY.A, @@ -135,7 +135,7 @@ const onGamepadConnected = (e) => { }; } - if (os === 'android' && (browser === 'firefox' || browser === 'uc')) { //KeyMap2 + if (os === platform.android && browser === br.firefox) { //KeyMap2 joystickMap = { 0: KEY.A, 1: KEY.B, @@ -152,7 +152,7 @@ const onGamepadConnected = (e) => { }; } - if (os === 'win' && browser === 'firefox') { //KeyMap3 + if (os === platform.windows && browser === br.firefox) { //KeyMap3 joystickMap = { 1: KEY.A, 2: KEY.B, @@ -165,7 +165,7 @@ const onGamepadConnected = (e) => { }; } - if (os === 'mac' && browser === 'safari') { //KeyMap4 + if (os === platform.macos && browser === br.safari) { //KeyMap4 joystickMap = { 1: KEY.A, 2: KEY.B, @@ -182,7 +182,7 @@ const onGamepadConnected = (e) => { }; } - if (os === 'mac' && browser === 'firefox') { //KeyMap5 + if (os === platform.macos && browser === br.firefox) { //KeyMap5 joystickMap = { 1: KEY.A, 2: KEY.B, @@ -201,7 +201,7 @@ const onGamepadConnected = (e) => { // https://bugs.chromium.org/p/chromium/issues/detail?id=1076272 if (gamepad.id.includes('PLAYSTATION(R)3')) { - if (browser === 'chrome') { + if (browser === br.chrome) { joystickMap = { 1: KEY.A, 0: KEY.B, diff --git a/web/js/stream.js b/web/js/stream.js index 3ccfaee4..9a3d68b0 100644 --- a/web/js/stream.js +++ b/web/js/stream.js @@ -26,7 +26,7 @@ let options = { aspect: 4 / 3 }; -const mute = (mute) => screen.muted = mute +const mute = (mute) => (screen.muted = mute) const _stream = () => { screen.play() @@ -96,14 +96,14 @@ const screenToAspect = (el) => { screen.addEventListener('fullscreenchange', () => { state.fullscreen = !!document.fullscreenElement; - if (!state.fullscreen) { - screen.style.padding = '0' - } else { + if (state.fullscreen) { screenToAspect(document.fullscreenElement); // chrome bug setTimeout(() => { screenToAspect(document.fullscreenElement) }, 1) + } else { + screen.style.padding = '0' } makeFullscreen(state.fullscreen); @@ -115,7 +115,7 @@ const makeFullscreen = (make = false) => { } const forceFullscreenMaybe = () => { - const touchMode = env.isMobileDevice(); + const touchMode = env.isMobileDevice; log.debug('touch check', touchMode) !touchMode && options.forceFullscreen && toggleFullscreen(); } From 22d1bd7620260db17eb5fdefddf24d80007242a4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 7 Apr 2024 00:14:04 +0300 Subject: [PATCH 206/361] Add screen component --- web/css/main.css | 42 +++----------- web/css/ui.css | 21 +++++++ web/index.html | 8 +-- web/js/app.js | 56 +++++++----------- web/js/env.js | 12 ++-- web/js/gui.js | 8 +-- web/js/menu.js | 17 ++++++ web/js/screen.js | 48 +++++++++++++++ web/js/settings.js | 11 +++- web/js/stats.js | 7 +-- web/js/stream.js | 141 +++++++++++++++++---------------------------- 11 files changed, 192 insertions(+), 179 deletions(-) create mode 100644 web/js/menu.js create mode 100644 web/js/screen.js diff --git a/web/css/main.css b/web/css/main.css index 270b7ce8..f9fdf5f4 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -3,12 +3,11 @@ src: url('/fonts/6809-Chargen.woff2'); } - +/*noinspection CssInvalidPseudoSelector*/ .no-media-controls::-webkit-media-controls { display: none !important; } - html { /* force full size for Firefox */ width: 100%; @@ -170,25 +169,6 @@ body { transform: translateY(-50%); } - -#bottom-screen { - display: flex; - align-items: center; - justify-content: center; - - width: 320px; - height: 240px; - position: absolute; - top: 23px; - left: 150px; - overflow: hidden; - background-color: #333; - - border-radius: 5px 5px 5px 5px; - - box-shadow: 0 0 2px 2px rgba(25, 25, 25, 1); -} - #color-button-holder { display: block; width: 120px; @@ -419,14 +399,8 @@ body { opacity: 0.75; } -#bottom-screen { - position: absolute; - /* popups under the screen fix */ - z-index: -1; -} - .game-screen { - position: absolute; + position: relative; object-fit: contain; width: inherit; height: inherit; @@ -665,6 +639,7 @@ body { position: absolute; z-index: 200; backface-visibility: hidden; + cursor: default; display: flex; flex-direction: column; @@ -674,13 +649,13 @@ body { right: 1.1em; color: #fff; background: #000; - opacity: .765; - padding: .5em 1em .1em 1em; + opacity: .465; + font-size: 2vh; font-family: monospace; - font-size: 40%; + min-width: 3.5em; - width: 70px; + padding-right: .2em; visibility: hidden; } @@ -689,8 +664,7 @@ body { display: flex; flex-flow: wrap; justify-content: space-between; - - margin-bottom: .7em; + align-items: center; } #stats-overlay > div > div { diff --git a/web/css/ui.css b/web/css/ui.css index ce3cfd27..28041893 100644 --- a/web/css/ui.css +++ b/web/css/ui.css @@ -227,3 +227,24 @@ .app-button:hover { color: #7e7e7e; } + + +#screen { + display: flex; + align-items: center; + justify-content: center; + + position: absolute; + /* popups under the screen fix */ + z-index: -1; + + width: 320px; + height: 240px; + top: 23px; + left: 150px; + overflow: hidden; + background-color: #333; + + border-radius: 5px 5px 5px 5px; + box-shadow: 0 0 2px 2px rgba(25, 25, 25, 1); +} diff --git a/web/index.html b/web/index.html index 8093f5d4..580bcdb5 100644 --- a/web/index.html +++ b/web/index.html @@ -8,7 +8,6 @@ - @@ -31,14 +30,9 @@
-
+
- -
-
+ +
- Arrows (move), ZXCVAS;'./ (game ABXYL1-L3R1-R3), 1/2 (1st/2nd player), - Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy the link to the - clipboard) + Arrows (move), ZXCVAS;'./ (game ABXYL1-L3R1-R3), + Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy the link)
@@ -55,6 +61,9 @@
+ +
@@ -91,10 +100,9 @@
{{end}}
-
- 69ff8ae +
Cloudretro (ɔ) 2024 - Source code on GitHub + 69ff8ae
diff --git a/web/js/api.js b/web/js/api.js index 6b93264b..736328ee 100644 --- a/web/js/api.js +++ b/web/js/api.js @@ -19,6 +19,277 @@ const endpoints = { APP_VIDEO_CHANGE: 150, } +let transport = { + send: (packet) => { + log.warn('Default transport is used! Change it with the api.transport variable.', packet) + }, + keyboard: (packet) => { + log.warn('Default transport is used! Change it with the api.transport variable.', packet) + }, + mouse: (packet) => { + log.warn('Default transport is used! Change it with the api.transport variable.', packet) + } +} + +const packet = (type, payload, id) => { + const packet = {t: type} + if (id !== undefined) packet.id = id + if (payload !== undefined) packet.p = payload + transport.send(packet) +} + +const decodeBytes = (b) => String.fromCharCode.apply(null, new Uint8Array(b)) + +const keyboardPress = (() => { + // 0 1 2 3 4 5 6 + // [CODE ] P MOD + const buffer = new ArrayBuffer(7) + const dv = new DataView(buffer) + + return (pressed = false, e) => { + if (e.repeat) return // skip pressed key events + + const key = libretro.mod + let code = libretro.map('', e.code) + let shift = e.shiftKey + + // a special Esc for &$&!& Firefox + if (shift && code === 96) { + code = 27 + shift = false + } + + const mod = 0 + | (e.altKey && key.ALT) + | (e.ctrlKey && key.CTRL) + | (e.metaKey && key.META) + | (shift && key.SHIFT) + | (e.getModifierState('NumLock') && key.NUMLOCK) + | (e.getModifierState('CapsLock') && key.CAPSLOCK) + | (e.getModifierState('ScrollLock') && key.SCROLLOCK) + dv.setUint32(0, code) + dv.setUint8(4, +pressed) + dv.setUint16(5, mod) + transport.keyboard(buffer) + } +})() + +const mouse = { + MOVEMENT: 0, + BUTTONS: 1 +} + +const mouseMove = (() => { + // 0 1 2 3 4 + // T DX DY + const buffer = new ArrayBuffer(5) + const dv = new DataView(buffer) + + return (dx = 0, dy = 0) => { + dv.setUint8(0, mouse.MOVEMENT) + dv.setInt16(1, dx) + dv.setInt16(3, dy) + transport.mouse(buffer) + } +})() + +const mousePress = (() => { + // 0 1 + // T B + const buffer = new ArrayBuffer(2) + const dv = new DataView(buffer) + + // 0: Main button pressed, usually the left button or the un-initialized state + // 1: Auxiliary button pressed, usually the wheel button or the middle button (if present) + // 2: Secondary button pressed, usually the right button + // 3: Fourth button, typically the Browser Back button + // 4: Fifth button, typically the Browser Forward button + + const b2r = [1, 4, 2, 0, 0] // browser mouse button to retro button + // assumed that only one button pressed / released + + return (button = 0, pressed = false) => { + dv.setUint8(0, mouse.BUTTONS) + dv.setUint8(1, pressed ? b2r[button] : 0) + transport.mouse(buffer) + } +})() + + +const libretro = function () {// RETRO_KEYBOARD + const retro = { + '': 0, + 'Unidentified': 0, + 'Unknown': 0, // ??? + 'First': 0, // ??? + 'Backspace': 8, + 'Tab': 9, + 'Clear': 12, + 'Enter': 13, 'Return': 13, + 'Pause': 19, + 'Escape': 27, + 'Space': 32, + 'Exclaim': 33, + 'Quotedbl': 34, + 'Hash': 35, + 'Dollar': 36, + 'Ampersand': 38, + 'Quote': 39, + 'Leftparen': 40, '(': 40, + 'Rightparen': 41, ')': 41, + 'Asterisk': 42, + 'Plus': 43, + 'Comma': 44, + 'Minus': 45, + 'Period': 46, + 'Slash': 47, + 'Digit0': 48, + 'Digit1': 49, + 'Digit2': 50, + 'Digit3': 51, + 'Digit4': 52, + 'Digit5': 53, + 'Digit6': 54, + 'Digit7': 55, + 'Digit8': 56, + 'Digit9': 57, + 'Colon': 58, ':': 58, + 'Semicolon': 59, ';': 59, + 'Less': 60, '<': 60, + 'Equal': 61, '=': 61, + 'Greater': 62, '>': 62, + 'Question': 63, '?': 63, + // RETROK_AT = 64, + 'BracketLeft': 91, '[': 91, + 'Backslash': 92, '\\': 92, + 'BracketRight': 93, ']': 93, + // RETROK_CARET = 94, + // RETROK_UNDERSCORE = 95, + 'Backquote': 96, '`': 96, + 'KeyA': 97, + 'KeyB': 98, + 'KeyC': 99, + 'KeyD': 100, + 'KeyE': 101, + 'KeyF': 102, + 'KeyG': 103, + 'KeyH': 104, + 'KeyI': 105, + 'KeyJ': 106, + 'KeyK': 107, + 'KeyL': 108, + 'KeyM': 109, + 'KeyN': 110, + 'KeyO': 111, + 'KeyP': 112, + 'KeyQ': 113, + 'KeyR': 114, + 'KeyS': 115, + 'KeyT': 116, + 'KeyU': 117, + 'KeyV': 118, + 'KeyW': 119, + 'KeyX': 120, + 'KeyY': 121, + 'KeyZ': 122, + '{': 123, + '|': 124, + '}': 125, + 'Tilde': 126, '~': 126, + 'Delete': 127, + + 'Numpad0': 256, + 'Numpad1': 257, + 'Numpad2': 258, + 'Numpad3': 259, + 'Numpad4': 260, + 'Numpad5': 261, + 'Numpad6': 262, + 'Numpad7': 263, + 'Numpad8': 264, + 'Numpad9': 265, + 'NumpadDecimal': 266, + 'NumpadDivide': 267, + 'NumpadMultiply': 268, + 'NumpadSubtract': 269, + 'NumpadAdd': 270, + 'NumpadEnter': 271, + 'NumpadEqual': 272, + + 'ArrowUp': 273, + 'ArrowDown': 274, + 'ArrowRight': 275, + 'ArrowLeft': 276, + 'Insert': 277, + 'Home': 278, + 'End': 279, + 'PageUp': 280, + 'PageDown': 281, + + 'F1': 282, + 'F2': 283, + 'F3': 284, + 'F4': 285, + 'F5': 286, + 'F6': 287, + 'F7': 288, + 'F8': 289, + 'F9': 290, + 'F10': 291, + 'F11': 292, + 'F12': 293, + 'F13': 294, + 'F14': 295, + 'F15': 296, + + 'NumLock': 300, + 'CapsLock': 301, + 'ScrollLock': 302, + 'ShiftRight': 303, + 'ShiftLeft': 304, + 'ControlRight': 305, + 'ControlLeft': 306, + 'AltRight': 307, + 'AltLeft': 308, + 'MetaRight': 309, + 'MetaLeft': 310, + // RETROK_LSUPER = 311, + // RETROK_RSUPER = 312, + // RETROK_MODE = 313, + // RETROK_COMPOSE = 314, + + // RETROK_HELP = 315, + // RETROK_PRINT = 316, + // RETROK_SYSREQ = 317, + // RETROK_BREAK = 318, + // RETROK_MENU = 319, + 'Power': 320, + // RETROK_EURO = 321, + // RETROK_UNDO = 322, + // RETROK_OEM_102 = 323, + } + + const retroMod = { + NONE: 0x0000, + SHIFT: 0x01, + CTRL: 0x02, + ALT: 0x04, + META: 0x08, + NUMLOCK: 0x10, + CAPSLOCK: 0x20, + SCROLLOCK: 0x40, + } + + const _map = (key = '', code = '') => { + return retro[code] || retro[key] || 0 + } + + return { + map: _map, + mod: retroMod, + } +}() + /** * Server API. * @@ -38,6 +309,15 @@ export const api = { getWorkerList: () => packet(endpoints.GET_WORKER_LIST), }, game: { + input: { + keyboard: { + press: keyboardPress, + }, + mouse: { + move: mouseMove, + press: mousePress, + } + }, load: () => packet(endpoints.GAME_LOAD), save: () => packet(endpoints.GAME_SAVE), setPlayerIndex: (i) => packet(endpoints.GAME_SET_PLAYER_INDEX, i), @@ -53,18 +333,3 @@ export const api = { quit: (roomId) => packet(endpoints.GAME_QUIT, {room_id: roomId}), } } - -let transport = { - send: (packet) => { - log.warn('Default transport is used! Change it with the api.transport variable.', packet) - } -} - -const packet = (type, payload, id) => { - const packet = {t: type}; - if (id !== undefined) packet.id = id; - if (payload !== undefined) packet.p = payload; - transport.send(packet); -} - -const decodeBytes = (b) => String.fromCharCode.apply(null, new Uint8Array(b)) diff --git a/web/js/app.js b/web/js/app.js index 23b363f3..ad5bb6c6 100644 --- a/web/js/app.js +++ b/web/js/app.js @@ -1,19 +1,13 @@ import {log} from 'log'; import {opts, settings} from 'settings'; - -settings.init(); -log.level = settings.loadOr(opts.LOG_LEVEL, log.DEFAULT); - import {api} from 'api'; import { - pub, - sub, APP_VIDEO_CHANGED, AXIS_CHANGED, CONTROLLER_UPDATED, DPAD_TOGGLE, + FULLSCREEN_CHANGE, GAME_ERROR_NO_FREE_SLOTS, - GAME_LOADED, GAME_PLAYER_IDX, GAME_PLAYER_IDX_SET, GAME_ROOM_AVAILABLE, @@ -21,12 +15,19 @@ import { GAMEPAD_CONNECTED, GAMEPAD_DISCONNECTED, HELP_OVERLAY_TOGGLED, + KB_MOUSE_FLAG, KEY_PRESSED, KEY_RELEASED, + KEYBOARD_KEY_DOWN, + KEYBOARD_KEY_UP, LATENCY_CHECK_REQUESTED, MESSAGE, + MOUSE_MOVED, + MOUSE_PRESSED, + POINTER_LOCK_CHANGE, RECORDING_STATUS_CHANGED, RECORDING_TOGGLED, + REFRESH_INPUT, SETTINGS_CHANGED, WEBRTC_CONNECTION_CLOSED, WEBRTC_CONNECTION_READY, @@ -37,9 +38,11 @@ import { WEBRTC_SDP_ANSWER, WEBRTC_SDP_OFFER, WORKER_LIST_FETCHED, + pub, + sub, } from 'event'; import {gui} from 'gui'; -import {keyboard, KEY, joystick, retropad, touch} from 'input'; +import {input, KEY} from 'input'; import {socket, webrtc} from 'network'; import {debounce} from 'utils'; @@ -53,7 +56,10 @@ import {stats} from './stats.js?v=3'; import {stream} from './stream.js?v=3'; import {workerManager} from "./workerManager.js?v=3"; -// application state +settings.init(); +log.level = settings.loadOr(opts.LOG_LEVEL, log.DEFAULT); + +// application display state let state; let lastState; @@ -102,18 +108,7 @@ const setState = (newState = app.state.eden) => { } }; -const onGameRoomAvailable = () => { - // room is ready -}; - -const onConnectionReady = () => { - // start a game right away or show the menu - if (room.getId()) { - startGame(); - } else { - state.menuReady(); - } -}; +const onConnectionReady = () => room.id ? startGame() : state.menuReady() const onLatencyCheck = async (data) => { message.show('Connecting to fastest server...'); @@ -169,23 +164,21 @@ const startGame = () => { setState(app.state.game); - stream.play() + screen.toggle(stream) api.game.start( gameList.selected, - room.getId(), + room.id, recording.isActive(), recording.getUser(), +playerIndex.value - 1, - ); + ) - // clear menu screen - retropad.poll.disable(); - screen.toggle(stream); + gameList.disable() + input.retropad.toggle(false) gui.show(keyButtons[KEY.SAVE]); gui.show(keyButtons[KEY.LOAD]); - // end clear - retropad.poll.enable(); + input.retropad.toggle(true) }; const saveGame = debounce(() => api.game.save(), 1000); @@ -204,16 +197,14 @@ const onMessage = (m) => { pub(WEBRTC_ICE_CANDIDATE_RECEIVED, {candidate: payload}); break; case api.endpoint.GAME_START: - if (payload.av) { - pub(APP_VIDEO_CHANGED, payload.av) - } + payload.av && pub(APP_VIDEO_CHANGED, payload.av) + payload.kb_mouse && pub(KB_MOUSE_FLAG) pub(GAME_ROOM_AVAILABLE, {roomId: payload.roomId}); break; case api.endpoint.GAME_SAVE: pub(GAME_SAVED); break; case api.endpoint.GAME_LOAD: - pub(GAME_LOADED); break; case api.endpoint.GAME_SET_PLAYER_INDEX: pub(GAME_PLAYER_IDX_SET, payload); @@ -252,7 +243,7 @@ const onKeyPress = (data) => { if (KEY.HELP === data.key) helpScreen.show(true, event); } - state.keyPress(data.key); + state.keyPress(data.key, data.code) }; // pre-state key release handler @@ -279,7 +270,7 @@ const onKeyRelease = data => { // change app state if settings if (KEY.SETTINGS === data.key) setState(app.state.settings); - state.keyRelease(data.key); + state.keyRelease(data.key, data.code); }; const updatePlayerIndex = (idx, not_game = false) => { @@ -301,8 +292,10 @@ const onAxisChanged = (data) => { state.axisChanged(data.id, data.value); }; -const handleToggle = () => { +const handleToggle = (force = false) => { const toggle = document.getElementById('dpad-toggle'); + + force && toggle.setAttribute('checked', '') toggle.checked = !toggle.checked; pub(DPAD_TOGGLE, {checked: toggle.checked}); }; @@ -402,10 +395,13 @@ const app = { game: { ..._default, name: 'game', - axisChanged: (id, value) => retropad.setAxisChanged(id, value), - keyPress: key => retropad.setKeyState(key, true), + axisChanged: (id, value) => input.retropad.setAxisChanged(id, value), + keyboardInput: (pressed, e) => api.game.input.keyboard.press(pressed, e), + mouseMove: (e) => api.game.input.mouse.move(e.dx, e.dy), + mousePress: (e) => api.game.input.mouse.press(e.b, e.p), + keyPress: (key) => input.retropad.setKeyState(key, true), keyRelease: function (key) { - retropad.setKeyState(key, false); + input.retropad.setKeyState(key, false); switch (key) { case KEY.JOIN: // or SHARE @@ -436,8 +432,8 @@ const app = { updatePlayerIndex(3); break; case KEY.QUIT: - retropad.poll.disable(); - api.game.quit(room.getId()); + input.retropad.toggle(false) + api.game.quit(room.id) room.reset(); window.location = window.location.pathname; break; @@ -453,10 +449,37 @@ const app = { } }; +// switch keyboard+mouse / retropad +const kbmEl = document.getElementById('kbm') +const kbmEl2 = document.getElementById('kbm2') +let kbmSkip = false +const kbmCb = () => { + input.kbm = kbmSkip + kbmSkip = !kbmSkip + pub(REFRESH_INPUT) +} +gui.multiToggle([kbmEl, kbmEl2], { + list: [ + {caption: '⌨️+🖱️', cb: kbmCb}, + {caption: ' 🎮 ', cb: kbmCb} + ] +}) +sub(KB_MOUSE_FLAG, () => { + gui.show(kbmEl, kbmEl2) + handleToggle(true) + message.show('Keyboard and mouse work in fullscreen') +}) + +// Browser lock API +document.onpointerlockchange = () => pub(POINTER_LOCK_CHANGE, document.pointerLockElement) +document.onfullscreenchange = () => pub(FULLSCREEN_CHANGE, document.fullscreenElement) + // subscriptions sub(MESSAGE, onMessage); -sub(GAME_ROOM_AVAILABLE, onGameRoomAvailable, 2); +sub(GAME_ROOM_AVAILABLE, async () => { + stream.play() +}, 2) sub(GAME_SAVED, () => message.show('Saved')); sub(GAME_PLAYER_IDX, data => { updatePlayerIndex(+data.index, state !== app.state.game); @@ -479,14 +502,25 @@ sub(WEBRTC_ICE_CANDIDATE_RECEIVED, (data) => webrtc.addCandidate(data.candidate) sub(WEBRTC_ICE_CANDIDATES_FLUSH, () => webrtc.flushCandidates()); sub(WEBRTC_CONNECTION_READY, onConnectionReady); sub(WEBRTC_CONNECTION_CLOSED, () => { - retropad.poll.disable(); + input.retropad.toggle(false) webrtc.stop(); }); sub(LATENCY_CHECK_REQUESTED, onLatencyCheck); sub(GAMEPAD_CONNECTED, () => message.show('Gamepad connected')); sub(GAMEPAD_DISCONNECTED, () => message.show('Gamepad disconnected')); + +// keyboard handler in the Screen Lock mode +sub(KEYBOARD_KEY_DOWN, (v) => state.keyboardInput?.(true, v)) +sub(KEYBOARD_KEY_UP, (v) => state.keyboardInput?.(false, v)) + +// mouse handler in the Screen Lock mode +sub(MOUSE_MOVED, (e) => state.mouseMove?.(e)) +sub(MOUSE_PRESSED, (e) => state.mousePress?.(e)) + +// general keyboard handler sub(KEY_PRESSED, onKeyPress); sub(KEY_RELEASED, onKeyRelease); + sub(SETTINGS_CHANGED, () => message.show('Settings have been updated')); sub(AXIS_CHANGED, onAxisChanged); sub(CONTROLLER_UPDATED, data => webrtc.input(data)); @@ -496,18 +530,13 @@ sub(RECORDING_STATUS_CHANGED, handleRecordingStatus); sub(SETTINGS_CHANGED, () => { const s = settings.get(); log.level = s[opts.LOG_LEVEL]; - if (state.showPing !== s[opts.SHOW_PING]) { - state.showPing = s[opts.SHOW_PING]; - stats.toggle(); - } }); // initial app state setState(app.state.eden); -keyboard.init(); -joystick.init(); -touch.init(); +input.init() + stream.init(); screen.init(); @@ -516,28 +545,72 @@ let [roomId, zone] = room.loadMaybe(); const wid = new URLSearchParams(document.location.search).get('wid'); // if from URL -> start game immediately! socket.init(roomId, wid, zone); -api.transport = socket; +api.transport = { + send: socket.send, + keyboard: webrtc.keyboard, + mouse: webrtc.mouse, +} // stats let WEBRTC_STATS_RTT; +let VIDEO_BITRATE; +let GET_V_CODEC, SET_CODEC; + +const bitrate = (() => { + let bytesPrev, timestampPrev + const w = [0, 0, 0, 0, 0, 0] + const n = w.length + let i = 0 + return (now, bytes) => { + w[i++ % n] = timestampPrev ? Math.floor(8 * (bytes - bytesPrev) / (now - timestampPrev)) : 0 + bytesPrev = bytes + timestampPrev = now + return Math.floor(w.reduce((a, b) => a + b) / n) + } +})() stats.modules = [ { - mui: stats.mui(), + mui: stats.mui('', '<1'), init() { WEBRTC_STATS_RTT = (v) => (this.val = v) }, }, + { + mui: stats.mui('', '', false, () => ''), + init() { + GET_V_CODEC = (v) => (this.val = v + ' @ ') + } + }, + { + mui: stats.mui('', '', false, () => ''), + init() { + sub(APP_VIDEO_CHANGED, (payload) => (this.val = `${payload.w}x${payload.h}`)) + }, + }, + { + mui: stats.mui('', '', false, () => ' kb/s', 'stats-bitrate'), + init() { + VIDEO_BITRATE = (v) => (this.val = v) + } + }, { async stats() { const stats = await webrtc.stats(); if (!stats) return; stats.forEach(report => { - const {nominated, currentRoundTripTime} = report; + if (!SET_CODEC && report.mimeType?.startsWith('video/')) { + GET_V_CODEC(report.mimeType.replace('video/', '').toLowerCase()) + SET_CODEC = 1 + } + const {nominated, currentRoundTripTime, type, kind} = report; if (nominated && currentRoundTripTime !== undefined) { WEBRTC_STATS_RTT(currentRoundTripTime * 1000); } + if (type === 'inbound-rtp' && kind === 'video') { + VIDEO_BITRATE(bitrate(report.timestamp, report.bytesReceived)) + } }); }, enable() { @@ -548,5 +621,4 @@ stats.modules = [ }, }] -state.showPing = settings.loadOr(opts.SHOW_PING, true); -state.showPing && stats.toggle(); +stats.toggle() diff --git a/web/js/env.js b/web/js/env.js index bda02725..a725c87d 100644 --- a/web/js/env.js +++ b/web/js/env.js @@ -1,3 +1,8 @@ +import { + pub, + TRANSFORM_CHANGE +} from 'event'; + // UI const page = document.getElementsByTagName('html')[0]; const gameBoy = document.getElementById('gamebody'); @@ -47,6 +52,8 @@ const rescaleGameBoy = (targetWidth, targetHeight) => { gameBoy.style['transform'] = transformations.join(' '); } +new MutationObserver(() => pub(TRANSFORM_CHANGE)).observe(gameBoy, {attributeFilter: ['style']}) + const os = () => { const ua = window.navigator.userAgent; // noinspection JSUnresolvedReference,JSDeprecatedSymbols diff --git a/web/js/event.js b/web/js/event.js index 6a742af1..8ade9024 100644 --- a/web/js/event.js +++ b/web/js/event.js @@ -56,7 +56,6 @@ export const WORKER_LIST_FETCHED = 'workerListFetched'; export const GAME_ROOM_AVAILABLE = 'gameRoomAvailable'; export const GAME_SAVED = 'gameSaved'; -export const GAME_LOADED = 'gameLoaded'; export const GAME_PLAYER_IDX = 'gamePlayerIndex'; export const GAME_PLAYER_IDX_SET = 'gamePlayerIndexSet' export const GAME_ERROR_NO_FREE_SLOTS = 'gameNoFreeSlots' @@ -83,9 +82,19 @@ export const KEY_PRESSED = 'keyPressed'; export const KEY_RELEASED = 'keyReleased'; export const KEYBOARD_TOGGLE_FILTER_MODE = 'keyboardToggleFilterMode'; export const KEYBOARD_KEY_PRESSED = 'keyboardKeyPressed'; +export const KEYBOARD_KEY_DOWN = 'keyboardKeyDown'; +export const KEYBOARD_KEY_UP = 'keyboardKeyUp'; + export const AXIS_CHANGED = 'axisChanged'; export const CONTROLLER_UPDATED = 'controllerUpdated'; +export const MOUSE_MOVED = 'mouseMoved' +export const MOUSE_PRESSED = 'mousePressed' + +export const FULLSCREEN_CHANGE = 'fsc' +export const POINTER_LOCK_CHANGE = 'plc' +export const TRANSFORM_CHANGE = 'tc' + export const DPAD_TOGGLE = 'dpadToggle'; export const HELP_OVERLAY_TOGGLED = 'helpOverlayToggled'; @@ -95,3 +104,6 @@ export const RECORDING_TOGGLED = 'recordingToggle' export const RECORDING_STATUS_CHANGED = 'recordingStatusChanged' export const APP_VIDEO_CHANGED = 'appVideoChanged' +export const KB_MOUSE_FLAG = 'kbMouseFlag' + +export const REFRESH_INPUT = 'refreshInput' diff --git a/web/js/gameList.js b/web/js/gameList.js index 48ef73b6..bb92b34c 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -1,8 +1,4 @@ -import { - sub, - MENU_PRESSED, - MENU_RELEASED -} from 'event'; +import {MENU_PRESSED, MENU_RELEASED, sub} from 'event'; import {gui} from 'gui'; const TOP_POSITION = 102 @@ -21,13 +17,6 @@ const games = (() => { return list[index].title // selected by the game title, oof }, set index(i) { - //-2 | - //-1 | | - // 0 < | < - // 1 | | - // 2 < < | - //+1 | | - //+2 | index = i < -1 ? i = 0 : i > list.length ? i = list.length - 1 : (i % list.length + list.length) % list.length @@ -90,10 +79,41 @@ const ui = (() => { let onTransitionEnd = () => ({}) - //rootEl.addEventListener('transitionend', () => onTransitionEnd()) - let items = [] + const marque = (() => { + const speed = 1 + const sep = ' '.repeat(10) + + let el = null + let raf = 0 + let txt = null + let w = 0 + + const move = () => { + const shift = parseFloat(getComputedStyle(el).left) - speed + el.style.left = w + shift < 1 ? `0px` : `${shift}px` + raf = requestAnimationFrame(move) + } + + return { + reset() { + cancelAnimationFrame(raf) + el && (el.style.left = `0px`) + }, + enable(cap) { + txt && (el.textContent = txt) // restore the text + el = cap + txt = el.textContent + el.textContent += sep + w = el.scrollWidth // keep the text width + el.textContent += txt + cancelAnimationFrame(raf) + raf = requestAnimationFrame(move) + } + } + })() + const item = (parent) => { const title = parent.firstChild.firstChild const desc = parent.children[1] @@ -106,16 +126,20 @@ const ui = (() => { }, } + const isOverflown = () => title.scrollWidth > title.clientWidth + const _title = { - animate: () => title.classList.add('text-move'), - pick: () => title.classList.add('pick'), - reset: () => title.classList.remove('pick', 'text-move'), + pick: () => { + title.classList.add('pick') + isOverflown() && marque.enable(title) + }, + reset: () => { + title.classList.remove('pick') + isOverflown() && marque.reset() + } } - const clear = () => { - _title.reset() - // _desc.hide() - } + const clear = () => _title.reset() return { get description() { @@ -132,7 +156,7 @@ const ui = (() => { rootEl.innerHTML = games.list.map(game => `
` + `
${game.title}
` + - //`
${game.system}
` + + `
${game.system}
` + `
`) .join('') items = [...rootEl.querySelectorAll('.menu-item')].map(x => item(x)) @@ -191,21 +215,14 @@ const select = (index) => { scroll.onShift = (delta) => select(games.index + delta) -let hasTransition = true // needed for cases when MENU_RELEASE called instead MENU_PRESSED - scroll.onStop = () => { const item = ui.selected - if (item) { - item.title.pick() - item.title.animate() - // hasTransition ? (ui.onTransitionEnd = item.description.show) : item.description.show() - } + item && item.title.pick() } sub(MENU_PRESSED, (position) => { if (games.empty()) return ui.onTransitionEnd = ui.NO_TRANSITION - hasTransition = false scroll.scroll(scroll.state.DRAG) ui.selected && ui.selected.clear() ui.drag.startPos(position) @@ -215,15 +232,14 @@ sub(MENU_RELEASED, (position) => { if (games.empty()) return ui.drag.stopPos(position) select(ui.roundIndex) - hasTransition = !hasTransition scroll.scroll(scroll.state.IDLE) - hasTransition = true }) /** * Game list module. */ export const gameList = { + disable: () => ui.selected?.clear(), scroll: (x) => { if (games.empty()) return scroll.scroll(x) diff --git a/web/js/gui.js b/web/js/gui.js index df3a97bb..b6eb9d94 100644 --- a/web/js/gui.js +++ b/web/js/gui.js @@ -175,8 +175,8 @@ const binding = (key = '', value = '', cb = () => ({})) => { return el; } -const show = (el) => { - el.classList.remove('hidden'); +const show = (...els) => { + els.forEach(el => el.classList.remove('hidden')) } const inputN = (key = '', cb = () => ({}), current = 0) => { @@ -201,6 +201,23 @@ const toggle = (el, what) => { what ? show(el) : hide(el) } +const multiToggle = (elements = [], options = {list: []}) => { + if (!options.list.length || !elements.length) return + + let i = 0 + + const setText = () => elements.forEach(el => el.innerText = options.list[i].caption) + + const handleClick = () => { + options.list[i].cb() + i = (i + 1) % options.list.length + setText() + } + + setText() + elements.forEach(el => el.addEventListener('click', handleClick)) +} + const fadeIn = async (el, speed = .1) => { el.style.opacity = '0'; el.style.display = 'block'; @@ -252,6 +269,7 @@ export const gui = { fragment, hide, inputN, + multiToggle, panel, select, show, diff --git a/web/js/input/input.js b/web/js/input/input.js index a6aa333d..a636c6ab 100644 --- a/web/js/input/input.js +++ b/web/js/input/input.js @@ -1,5 +1,56 @@ -export {joystick} from './joystick.js?v=3'; +import { + REFRESH_INPUT, + KB_MOUSE_FLAG, + pub, + sub +} from 'event'; + export {KEY} from './keys.js?v=3'; -export {keyboard} from './keyboard.js?v=3' -export {retropad} from './retropad.js?v=3'; -export {touch} from './touch.js?v=3'; + +import {joystick} from './joystick.js?v=3'; +import {keyboard} from './keyboard.js?v=3' +import {pointer} from './pointer.js?v=3'; +import {retropad} from './retropad.js?v=3'; +import {touch} from './touch.js?v=3'; + +export {joystick, keyboard, pointer, retropad, touch}; + +const input_state = { + joystick: true, + keyboard: false, + pointer: true, // aka mouse + retropad: true, + touch: true, + + kbm: false, +} + +const init = () => { + keyboard.init() + joystick.init() + touch.init() +} + +sub(KB_MOUSE_FLAG, () => { + input_state.kbm = true + pub(REFRESH_INPUT) +}) + +export const input = { + state: input_state, + init, + retropad: { + ...retropad, + toggle(on = true) { + if (on === input_state.retropad) return + input_state.retropad = on + on ? retropad.enable() : retropad.disable() + } + }, + set kbm(v) { + input_state.kbm = v + }, + get kbm() { + return input_state.kbm + } +} diff --git a/web/js/input/keyboard.js b/web/js/input/keyboard.js index 1ccba499..b29b61bf 100644 --- a/web/js/input/keyboard.js +++ b/web/js/input/keyboard.js @@ -1,12 +1,14 @@ import { pub, sub, - KEYBOARD_TOGGLE_FILTER_MODE, AXIS_CHANGED, DPAD_TOGGLE, KEY_PRESSED, KEY_RELEASED, - KEYBOARD_KEY_PRESSED + KEYBOARD_KEY_PRESSED, + KEYBOARD_KEY_DOWN, + KEYBOARD_KEY_UP, + KEYBOARD_TOGGLE_FILTER_MODE, } from 'event'; import {KEY} from 'input'; import {log} from 'log' @@ -47,11 +49,16 @@ const defaultMap = Object.freeze({ }); let keyMap = {}; +// special mode for changing button bindings in the options let isKeysFilteredMode = true; +// if the browser supports Keyboard Lock API (Firefox does not) +let hasKeyboardLock = ('keyboard' in navigator) && ('lock' in navigator.keyboard) + +let locked = false const remap = (map = {}) => { settings.set(opts.INPUT_KEYBOARD_MAP, map); - log.info('Keyboard keys have been remapped') + log.debug('Keyboard keys have been remapped') } sub(KEYBOARD_TOGGLE_FILTER_MODE, data => { @@ -88,9 +95,16 @@ function onDpadToggle(checked) { } } +const lock = async (lock) => { + locked = lock + if (hasKeyboardLock) { + lock ? await navigator.keyboard.lock() : navigator.keyboard.unlock() + } + // if the browser doesn't support keyboard lock, it will be emulated +} + const onKey = (code, evt, state) => { const key = keyMap[code] - if (key === undefined) return if (dpadState[key] !== undefined) { dpadState[key] = state @@ -103,7 +117,7 @@ const onKey = (code, evt, state) => { return } } - pub(evt, {key: key}) + pub(evt, {key: key, code: code}) } sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); @@ -115,28 +129,35 @@ export const keyboard = { init: () => { keyMap = settings.loadOr(opts.INPUT_KEYBOARD_MAP, defaultMap); const body = document.body; - // !to use prevent default as everyone + body.addEventListener('keyup', e => { - e.stopPropagation(); - if (isKeysFilteredMode) { - onKey(e.code, KEY_RELEASED, false) - } else { - pub(KEYBOARD_KEY_PRESSED, {key: e.code}); + e.stopPropagation() + !hasKeyboardLock && locked && e.preventDefault() + + let lock = locked + // hack with Esc up when outside of lock + if (e.code === 'Escape') { + lock = true } - }, false); + + isKeysFilteredMode ? + (lock ? pub(KEYBOARD_KEY_UP, e) : onKey(e.code, KEY_RELEASED, false)) + : pub(KEYBOARD_KEY_PRESSED, {key: e.code}) + }, false) body.addEventListener('keydown', e => { - e.stopPropagation(); - if (isKeysFilteredMode) { - onKey(e.code, KEY_PRESSED, true) - } else { - pub(KEYBOARD_KEY_PRESSED, {key: e.code}); - } - }); + e.stopPropagation() + !hasKeyboardLock && locked && e.preventDefault() - log.info('[input] keyboard has been initialized'); + isKeysFilteredMode ? + (locked ? pub(KEYBOARD_KEY_DOWN, e) : onKey(e.code, KEY_PRESSED, true)) : + pub(KEYBOARD_KEY_PRESSED, {key: e.code}) + }) + + log.info('[input] keyboard has been initialized') }, settings: { remap - } + }, + lock, } diff --git a/web/js/input/pointer.js b/web/js/input/pointer.js new file mode 100644 index 00000000..e0fab075 --- /dev/null +++ b/web/js/input/pointer.js @@ -0,0 +1,153 @@ +// Pointer (aka mouse) stuff +import { + MOUSE_PRESSED, + MOUSE_MOVED, + pub +} from 'event'; +import {browser, env} from 'env'; + +const hasRawPointer = 'onpointerrawupdate' in window + +const p = {dx: 0, dy: 0} + +const move = (e, cb, single = false) => { + // !to fix ff https://github.com/w3c/pointerlock/issues/42 + if (single) { + p.dx = e.movementX + p.dy = e.movementY + cb(p) + } else { + const _events = e.getCoalescedEvents?.() + if (_events && (hasRawPointer || _events.length > 1)) { + for (let i = 0; i < _events.length; i++) { + p.dx = _events[i].movementX + p.dy = _events[i].movementY + cb(p) + } + } + } +} + +const _track = (el, cb, single) => { + const _move = (e) => { + move(e, cb, single) + } + el.addEventListener(hasRawPointer ? 'pointerrawupdate' : 'pointermove', _move) + return () => { + el.removeEventListener(hasRawPointer ? 'pointerrawupdate' : 'pointermove', _move) + } +} + +const dpiScaler = () => { + let ex = 0 + let ey = 0 + let scaled = {dx: 0, dy: 0} + return { + scale(x, y, src_w, src_h, dst_w, dst_h) { + scaled.dx = x / (src_w / dst_w) + ex + scaled.dy = y / (src_h / dst_h) + ey + + ex = scaled.dx % 1 + ey = scaled.dy % 1 + + scaled.dx -= ex + scaled.dy -= ey + + return scaled + } + } +} + +const dpi = dpiScaler() + +const handlePointerMove = (el, cb) => { + let w, h = 0 + let s = false + const dw = 640, dh = 480 + return (p) => { + ({w, h, s} = cb()) + pub(MOUSE_MOVED, s ? dpi.scale(p.dx, p.dy, w, h, dw, dh) : p) + } +} + +const trackPointer = (el, cb) => { + let mpu, mpd + let noTrack + + // disable coalesced mouse move events + const single = true + + // coalesced event are broken since FF 120 + const isFF = env.getBrowser === browser.firefox + + const pm = handlePointerMove(el, cb) + + return (enabled) => { + if (enabled) { + !noTrack && (noTrack = _track(el, pm, isFF || single)) + mpu = pointer.handle.up(el) + mpd = pointer.handle.down(el) + return + } + + mpu?.() + mpd?.() + noTrack?.() + noTrack = null + } +} + +const handleDown = ((b = {b: null, p: true}) => (e) => { + b.b = e.button + pub(MOUSE_PRESSED, b) +})() + +const handleUp = ((b = {b: null, p: false}) => (e) => { + b.b = e.button + pub(MOUSE_PRESSED, b) +})() + +const autoHide = (el, time = 3000) => { + let tm + let move + const cl = el.classList + + const hide = (force = false) => { + cl.add('no-pointer') + !force && el.addEventListener('pointermove', move) + } + + move = () => { + cl.remove('no-pointer') + clearTimeout(tm) + tm = setTimeout(hide, time) + } + + const show = () => { + clearTimeout(tm) + el.removeEventListener('pointermove', move) + cl.remove('no-pointer') + } + + return { + autoHide: (on) => on ? show() : hide() + } +} + +export const pointer = { + autoHide, + lock: async (el) => { + await el.requestPointerLock(/*{ unadjustedMovement: true}*/) + }, + track: trackPointer, + handle: { + down: (el) => { + el.onpointerdown = handleDown + return () => (el.onpointerdown = null) + }, + up: (el) => { + el.onpointerup = handleUp + return () => (el.onpointerup = null) + } + } +} diff --git a/web/js/input/retropad.js b/web/js/input/retropad.js index 6e39c69f..2ecbd659 100644 --- a/web/js/input/retropad.js +++ b/web/js/input/retropad.js @@ -94,7 +94,8 @@ const _getState = () => { const _poll = poll(pollingIntervalMs, sendControllerState) export const retropad = { - poll: _poll, + enable: () => _poll.enable(), + disable: () => _poll.disable(), setKeyState, setAxisChanged, } diff --git a/web/js/input/touch.js b/web/js/input/touch.js index fb2c1ed1..f98359fc 100644 --- a/web/js/input/touch.js +++ b/web/js/input/touch.js @@ -39,6 +39,8 @@ const getKey = (el) => el.dataset.key let dpadMode = true; const deadZone = 0.1; +let enabled = false + function onDpadToggle(checked) { if (dpadMode === checked) { return //error? @@ -237,6 +239,8 @@ function handleMenuUp(evt) { // Common events function handleWindowMove(event) { + if (!enabled) return + event.preventDefault(); handleVpadJoystickMove(event); handleMenuMove(event); @@ -303,6 +307,7 @@ playerSlider.onkeydown = (e) => { */ export const touch = { init: () => { + enabled = true // Bind events for menu // TODO change this flow pub(MENU_HANDLER_ATTACHED, {event: 'mousedown', handler: handleMenuDown}); @@ -316,10 +321,11 @@ export const touch = { vpadState[getKey(el)] = false; }); - window.addEventListener('mousemove', handleWindowMove); + window.addEventListener('pointermove', handleWindowMove); window.addEventListener('touchmove', handleWindowMove, {passive: false}); window.addEventListener('mouseup', handleWindowUp); log.info('[input] touch input has been initialized'); - } + }, + toggle: (v) => v === undefined ? (enabled = !enabled) : (enabled = v) } diff --git a/web/js/network/webrtc.js b/web/js/network/webrtc.js index ae12748c..3bc5ff76 100644 --- a/web/js/network/webrtc.js +++ b/web/js/network/webrtc.js @@ -9,7 +9,9 @@ import { import {log} from 'log'; let connection; -let dataChannel; +let dataChannel +let keyboardChannel +let mouseChannel let mediaStream; let candidates = []; let isAnswered = false; @@ -30,6 +32,16 @@ const start = (iceservers) => { log.debug('[rtc] ondatachannel', e.channel.label) e.channel.binaryType = "arraybuffer"; + if (e.channel.label === 'keyboard') { + keyboardChannel = e.channel + return + } + + if (e.channel.label === 'mouse') { + mouseChannel = e.channel + return + } + dataChannel = e.channel; dataChannel.onopen = () => { log.info('[rtc] the input channel has been opened'); @@ -39,7 +51,10 @@ const start = (iceservers) => { if (onData) { dataChannel.onmessage = onData; } - dataChannel.onclose = () => log.info('[rtc] the input channel has been closed'); + dataChannel.onclose = () => { + inputReady = false + log.info('[rtc] the input channel has been closed') + } } connection.oniceconnectionstatechange = ice.onIceConnectionStateChange; connection.onicegatheringstatechange = ice.onIceStateChange; @@ -62,8 +77,16 @@ const stop = () => { connection = null; } if (dataChannel) { - dataChannel.close(); - dataChannel = null; + dataChannel.close() + dataChannel = null + } + if (keyboardChannel) { + keyboardChannel?.close() + keyboardChannel = null + } + if (mouseChannel) { + mouseChannel?.close() + mouseChannel = null } candidates = []; log.info('[rtc] WebRTC has been closed'); @@ -162,7 +185,9 @@ export const webrtc = { }); isFlushing = false; }, - input: (data) => dataChannel.send(data), + keyboard: (data) => keyboardChannel?.send(data), + mouse: (data) => mouseChannel?.send(data), + input: (data) => inputReady && dataChannel.send(data), isConnected: () => connected, isInputReady: () => inputReady, stats: async () => { diff --git a/web/js/room.js b/web/js/room.js index f8f2e37f..1321fc10 100644 --- a/web/js/room.js +++ b/web/js/room.js @@ -30,7 +30,7 @@ const parseURLForRoom = () => { }; sub(GAME_ROOM_AVAILABLE, data => { - room.setId(data.roomId); + room.id = data.roomId room.save(data.roomId); }, 1); @@ -38,8 +38,10 @@ sub(GAME_ROOM_AVAILABLE, data => { * Game room module. */ export const room = { - getId: () => id, - setId: (id_) => { + get id() { + return id + }, + set id(id_) { id = id_; roomLabel.value = id; }, @@ -51,7 +53,7 @@ export const room = { localStorage.setItem('roomID', roomIndex); }, load: () => localStorage.getItem('roomID'), - getLink: () => window.location.href.split('?')[0] + `?id=${encodeURIComponent(room.getId())}`, + getLink: () => window.location.href.split('?')[0] + `?id=${encodeURIComponent(room.id)}`, loadMaybe: () => { // localStorage first //roomID = loadRoomID(); diff --git a/web/js/screen.js b/web/js/screen.js index 955df691..b4342e3c 100644 --- a/web/js/screen.js +++ b/web/js/screen.js @@ -1,8 +1,15 @@ +import { + sub, + SETTINGS_CHANGED, + REFRESH_INPUT, +} from 'event'; +import {env} from 'env'; +import {input, pointer, keyboard} from 'input'; import {opts, settings} from 'settings'; -import {SETTINGS_CHANGED, sub} from "event"; -import {env} from "env"; +import {gui} from 'gui'; -const rootEl = document.getElementById('screen'); +const rootEl = document.getElementById('screen') +const footerEl = document.getElementsByClassName('screen__footer')[0] const state = { components: [], @@ -10,30 +17,63 @@ const state = { forceFullscreen: false, } -const toggle = (component, force) => { - component && (state.current = component); // keep the last component - state.components.forEach(c => c.toggle(false)); - state.current?.toggle(force); - component && !env.isMobileDevice && !state.current?.noFullscreen && state.forceFullscreen && fullscreen(); +const toggle = async (component, force) => { + component && (state.current = component) // keep the last component + state.components.forEach(c => c.toggle(false)) + state.current?.toggle(force) + state.forceFullscreen && fullscreen(true) } const init = () => { - state.forceFullscreen = settings.loadOr(opts.FORCE_FULLSCREEN, false); + state.forceFullscreen = settings.loadOr(opts.FORCE_FULLSCREEN, false) sub(SETTINGS_CHANGED, () => { - state.forceFullscreen = settings.get()[opts.FORCE_FULLSCREEN]; - }); + state.forceFullscreen = settings.get()[opts.FORCE_FULLSCREEN] + }) } +const cursor = pointer.autoHide(rootEl, 2000) + +const trackPointer = pointer.track(rootEl, () => { + const display = state.current; + return {...display.video.size, s: !!display?.hasDisplay} +}) + const fullscreen = () => { - let h = parseFloat(getComputedStyle(rootEl, null) - .height - .replace('px', '') - ) - env.display().toggleFullscreen(h !== window.innerHeight, rootEl); + if (state.current?.noFullscreen) return + + let h = parseFloat(getComputedStyle(rootEl, null).height.replace('px', '')) + env.display().toggleFullscreen(h !== window.innerHeight, rootEl) } -rootEl.addEventListener('fullscreenchange', () => { - state.current?.onFullscreen?.(document.fullscreenElement !== null) +const controls = async (locked = false) => { + if (!state.current?.hasDisplay) return + if (env.isMobileDevice) return + if (!input.kbm) return + + if (locked) { + await pointer.lock(rootEl) + } + + // oof, remove hover:hover when the pointer is forcibly locked, + // leaving the element in the hovered state + locked ? footerEl.classList.remove('hover') : footerEl.classList.add('hover') + + trackPointer(locked) + await keyboard.lock(locked) + input.retropad.toggle(!locked) +} + +rootEl.addEventListener('fullscreenchange', async () => { + const fs = document.fullscreenElement !== null + + cursor.autoHide(!fs) + gui.toggle(footerEl, fs) + await controls(fs) + state.current?.onFullscreen?.(fs) +}) + +sub(REFRESH_INPUT, async () => { + await controls(document.fullscreenElement !== null) }) export const screen = { diff --git a/web/js/settings.js b/web/js/settings.js index 39ef121d..7dc30b06 100644 --- a/web/js/settings.js +++ b/web/js/settings.js @@ -23,7 +23,6 @@ export const opts = { MIRROR_SCREEN: 'mirror.screen', VOLUME: 'volume', FORCE_FULLSCREEN: 'force.fullscreen', - SHOW_PING: 'show.ping', } @@ -229,6 +228,14 @@ const set = (key, value, updateProvider = true) => { } } +const changed = (key, obj, key2) => { + if (!store.settings.hasOwnProperty(key)) return + const newValue = store.settings[key] + const changed = newValue !== obj[key2] + changed && (obj[key2] = newValue) + return changed +} + const _reset = () => { for (let _option of Object.keys(_defaults)) { const value = _defaults[_option]; @@ -340,6 +347,7 @@ export const settings = { getStore, get, set, + changed, remove, import: _import, export: _export, @@ -488,6 +496,8 @@ const render = function () { case opts.INPUT_KEYBOARD_MAP: _option(data).withName('Keyboard bindings') .withClass('keyboard-bindings') + .withDescription( + 'Bindings for RetroPad. There is an alternate ESC key [Shift+`] (tilde) for cores with keyboard+mouse controls (DosBox)') .add(Object.keys(value).map(k => gui.binding(value[k], k, onKeyBindingChange))) .build(); break; @@ -500,7 +510,6 @@ const render = function () { case opts.VOLUME: _option(data).withName('Volume (%)') .add(gui.inputN(k, onChange, value)) - .restartNeeded() .build() break; case opts.FORCE_FULLSCREEN: @@ -511,12 +520,6 @@ const render = function () { .add(gui.checkbox(k, onChange, value, 'Enabled', 'settings__option-checkbox')) .build() break; - case opts.SHOW_PING: - _option(data).withName('Show ping') - .withDescription('Always display ping info on the screen') - .add(gui.checkbox(k, onChange, value, 'Enabled', 'settings__option-checkbox')) - .build() - break; default: _option(data).withName(k).add(value).build(); } diff --git a/web/js/stats.js b/web/js/stats.js index 3ef1648c..d8d28974 100644 --- a/web/js/stats.js +++ b/web/js/stats.js @@ -110,19 +110,23 @@ const graph = (parent, opts = { * Get cached module UI. * * HTML: - *
LABEL
VALUE[]
+ * `
LABEL
VALUE[]
` * * @param label The name of the stat to show. + * @param nan A value to show when zero. * @param withGraph True if to draw a graph. * @param postfix Supposed to be the name of the stat passed as a function. + * @param cl Class of the UI div element. * @returns {{el: HTMLDivElement, update: function}} */ -const moduleUi = (label = '', withGraph = false, postfix = () => 'ms') => { +const moduleUi = (label = '', nan = '', withGraph = false, postfix = () => 'ms', cl = '') => { const ui = document.createElement('div'), _label = document.createElement('div'), _value = document.createElement('span'); ui.append(_label, _value); + cl && ui.classList.add(cl) + let postfix_ = postfix; let _graph; @@ -139,7 +143,7 @@ const moduleUi = (label = '', withGraph = false, postfix = () => 'ms') => { const update = (value) => { if (_graph) _graph.add(value); // 203 (333) ms - _value.textContent = `${value < 1 ? '<1' : value} ${_graph ? `(${_graph.max()}) ` : ''}${postfix_(value)}`; + _value.textContent = `${value < 1 ? nan : value}${_graph ? `(${_graph.max()}) ` : ''}${postfix_(value)}`; } const clear = () => { @@ -157,7 +161,7 @@ const module = (mod) => { enable: () => ({}), ...mod, _disable: function () { - mod.val = 0; + // mod.val = 0; mod.disable && mod.disable(); mod.mui && mod.mui.clear(); }, diff --git a/web/js/stream.js b/web/js/stream.js index 8356026a..7e09a5f9 100644 --- a/web/js/stream.js +++ b/web/js/stream.js @@ -1,13 +1,14 @@ import { sub, APP_VIDEO_CHANGED, - SETTINGS_CHANGED -} from 'event' ; -import {gui} from 'gui'; + SETTINGS_CHANGED, + TRANSFORM_CHANGE +} from 'event'; import {log} from 'log'; import {opts, settings} from 'settings'; -const videoEl = document.getElementById('stream'); +const videoEl = document.getElementById('stream') +const mirrorEl = document.getElementById('mirror-stream') const options = { volume: 0.5, @@ -21,151 +22,151 @@ const state = { timerId: null, w: 0, h: 0, - aspect: 4 / 3 + aspect: 4 / 3, + ready: false } const mute = (mute) => (videoEl.muted = mute) -const _stream = () => { +const play = () => { videoEl.play() - .then(() => log.info('Media can autoplay')) - .catch(error => { - log.error('Media failed to play', error); - }); + .then(() => { + state.ready = true + videoEl.poster = '' + useCustomScreen(options.mirrorMode === 'mirror') + }) + .catch(error => log.error('Can\'t autoplay', error)) } const toggle = (show) => state.screen.toggleAttribute('hidden', show === undefined ? show : !show) -videoEl.onerror = (e) => { - // video playback failed - show a message saying why - switch (e.target.error.code) { - case e.target.error.MEDIA_ERR_ABORTED: - log.error('You aborted the video playback.'); - break; - case e.target.error.MEDIA_ERR_NETWORK: - log.error('A network error caused the video download to fail part-way.'); - break; - case e.target.error.MEDIA_ERR_DECODE: - log.error('The video playback was aborted due to a corruption problem or because the video used features your browser did not support.'); - break; - case e.target.error.MEDIA_ERR_SRC_NOT_SUPPORTED: - log.error('The video could not be loaded, either because the server or network failed or because the format is not supported.'); - break; - default: - log.error('An unknown video error occurred.'); - break; - } -}; +// Track resize even when the underlying media stream changes its video size +videoEl.addEventListener('resize', () => { + recalculateSize() + if (state.screen === videoEl) return + + state.screen.setAttribute('width', videoEl.videoWidth) + state.screen.setAttribute('height', videoEl.videoHeight) +}) -videoEl.addEventListener('loadedmetadata', () => { - if (state.screen !== videoEl) { - state.screen.setAttribute('width', videoEl.videoWidth); - state.screen.setAttribute('height', videoEl.videoHeight); - } -}, false); videoEl.addEventListener('loadstart', () => { - videoEl.volume = options.volume; - videoEl.poster = options.poster; -}, false); -videoEl.addEventListener('play', () => { - videoEl.poster = ''; - useCustomScreen(options.mirrorMode === 'mirror'); -}, false); + videoEl.volume = options.volume / 100 + videoEl.poster = options.poster +}) -const screenToAspect = (el) => { - const w = window.screen.width ?? window.innerWidth; - const hh = el.innerHeight || el.clientHeight || 0; - const dw = (w - hh * state.aspect) / 2 - videoEl.style.padding = `0 ${dw}px` -} +videoEl.onfocus = () => videoEl.blur() +videoEl.onerror = (e) => log.error('Playback error', e) -const onFullscreen = (y) => { - if (y) { - screenToAspect(document.fullscreenElement); - // chrome bug +const onFullscreen = (fullscreen) => { + const el = document.fullscreenElement + + if (fullscreen) { + // timeout is due to a chrome bug setTimeout(() => { - screenToAspect(document.fullscreenElement) + // aspect ratio calc + const w = window.screen.width ?? window.innerWidth + const hh = el.innerHeight || el.clientHeight || 0 + const dw = (w - hh * state.aspect) / 2 + state.screen.style.padding = `0 ${dw}px` + state.screen.classList.toggle('with-footer') }, 1) } else { - videoEl.style.padding = '0' + state.screen.style.padding = '0' + state.screen.classList.toggle('with-footer') } - videoEl.classList.toggle('no-media-controls', !!y) + + if (el === videoEl) { + videoEl.classList.toggle('no-media-controls', !fullscreen) + videoEl.blur() + } +} + +const vs = {w: 1, h: 1} + +const recalculateSize = () => { + const fullscreen = document.fullscreenElement !== null + const {aspect, screen} = state + + let width, height + if (fullscreen) { + // we can't get the real
- +
+
diff --git a/web/js/stream.js b/web/js/stream.js index a2532cf2..01718e2a 100644 --- a/web/js/stream.js +++ b/web/js/stream.js @@ -9,6 +9,7 @@ import {opts, settings} from 'settings'; const videoEl = document.getElementById('stream') const mirrorEl = document.getElementById('mirror-stream') +const playEl = document.getElementById('play-stream') const options = { volume: 0.5, @@ -24,20 +25,36 @@ const state = { h: 0, aspect: 4 / 3, fit: 'contain', - ready: false + ready: false, + autoplayWait: false } const mute = (mute) => (videoEl.muted = mute) +const onPlay = () => { + state.ready = true + videoEl.poster = '' + resize(state.w, state.h, state.aspect, state.fit) + useCustomScreen(options.mirrorMode === 'mirror') +} + const play = () => { - videoEl.play() - .then(() => { - state.ready = true - videoEl.poster = '' - resize(state.w, state.h, state.aspect, state.fit) - useCustomScreen(options.mirrorMode === 'mirror') + const promise = videoEl.play() + + if (promise === undefined) { + log.error('oh no, the video is not a promise!') + return + } + + promise + .then(onPlay) + .catch(error => { + if (error.name === 'NotAllowedError') { + showPlayButton() + } else { + log.error('Playback fail', error) + } }) - .catch(error => log.error('Can\'t autoplay', error)) } const toggle = (show) => state.screen.toggleAttribute('hidden', show === undefined ? show : !show) @@ -51,6 +68,19 @@ const resize = (w, h, aspect, fit) => { fit !== undefined && (state.screen.style['object-fit'] = fit) } +const showPlayButton = () => { + state.autoplayWait = true + toggle() + playEl.removeAttribute('hidden') +} + +playEl.addEventListener('click', () => { + playEl.setAttribute('hidden', "") + state.autoplayWait = false + play() + toggle() +}) + // Track resize even when the underlying media stream changes its video size videoEl.addEventListener('resize', () => { recalculateSize() @@ -189,6 +219,7 @@ export const stream = { }, }, play, + showPlayButton, toggle, hasDisplay: true, init, From 56e3ce328e98e51661fbb360a16b4461dc51de3d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 30 Nov 2024 21:35:40 +0300 Subject: [PATCH 283/361] Update Go to 1.23.3 --- Dockerfile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Dockerfile b/Dockerfile index 73ff0e27..f00b2ac3 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:oracular AS build0 -ARG GO=1.23.1 +ARG GO=1.23.3 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ From 9caf45af7865586ce1db48c748096385e6ef375b Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 1 Dec 2024 18:20:54 +0300 Subject: [PATCH 284/361] Reset fail timer on success --- pkg/network/retry.go | 13 +++---------- pkg/worker/worker.go | 2 +- 2 files changed, 4 insertions(+), 11 deletions(-) diff --git a/pkg/network/retry.go b/pkg/network/retry.go index 0498b7db..9fb706dc 100644 --- a/pkg/network/retry.go +++ b/pkg/network/retry.go @@ -13,14 +13,7 @@ func NewRetry() Retry { return Retry{t: retry} } -func (r *Retry) Fail() *Retry { r.fail = true; time.Sleep(r.t); return r } -func (r *Retry) Failed() bool { return r.fail } -func (r *Retry) Multiply(x int) { r.t *= time.Duration(x) } -func (r *Retry) SuccessCheck() { - if r.fail { - return - } - r.t = retry - r.fail = false -} +func (r *Retry) Fail() *Retry { r.fail = true; time.Sleep(r.t); return r } +func (r *Retry) Multiply(x int) { r.t *= time.Duration(x) } +func (r *Retry) Success() { r.t = retry; r.fail = false } func (r *Retry) Time() time.Duration { return r.t } diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 505a55d2..00a358aa 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -126,7 +126,7 @@ func (w *Worker) Start(done chan struct{}) { w.cord.SendLibrary(w) w.cord.SendPrevSessions(w) <-wait - retry.SuccessCheck() + retry.Success() } } }() From 5a42dc985704f5199ae989bfc5593ed2ec2cfbea Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 1 Dec 2024 20:26:29 +0300 Subject: [PATCH 285/361] Fail x2 on no coordinator connection --- pkg/worker/worker.go | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 00a358aa..f98b2e97 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -115,8 +115,7 @@ func (w *Worker) Start(done chan struct{}) { default: cord, err := newCoordinatorConnection(remoteAddr, w.conf.Worker, w.address, w.log) if err != nil { - w.log.Warn().Err(err).Msgf("no connection: %v. Retrying in %v", remoteAddr, retry.Time()) - retry.Fail() + onRetryFail(err) continue } cord.SetErrorHandler(onRetryFail) From 713478224549c4df04048c83950c0f328394b171 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 3 Dec 2024 00:34:43 +0300 Subject: [PATCH 286/361] Enable frame duplication for Mupen64 --- pkg/config/config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index fdcba87b..48d78ed3 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -271,7 +271,7 @@ emulator: "mupen64plus-EnableEnhancedTextureStorage": True "mupen64plus-EnableFBEmulation": True "mupen64plus-EnableLegacyBlending": True - "mupen64plus-FrameDuping": False + "mupen64plus-FrameDuping": True "mupen64plus-MaxTxCacheSize": 8000 "mupen64plus-ThreadedRenderer": False "mupen64plus-cpucore": dynamic_recompiler From 954bb23bb8d1f743281a8589d7b01307694a2aa7 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 3 Dec 2024 00:38:15 +0300 Subject: [PATCH 287/361] Add Reset with 0 key --- pkg/api/api.go | 3 +++ pkg/api/worker.go | 6 +++++- pkg/coordinator/user.go | 6 ++++++ pkg/coordinator/userhandlers.go | 7 +++++++ pkg/coordinator/workerapi.go | 4 ++++ pkg/worker/caged/libretro/frontend.go | 2 ++ pkg/worker/caged/libretro/nanoarch/nanoarch.c | 4 ++++ pkg/worker/caged/libretro/nanoarch/nanoarch.go | 6 ++++++ pkg/worker/caged/libretro/nanoarch/nanoarch.h | 1 + pkg/worker/coordinator.go | 6 ++++++ pkg/worker/coordinatorhandlers.go | 8 ++++++++ web/js/api.js | 2 ++ web/js/app.js | 3 +++ web/js/input/keyboard.js | 3 ++- web/js/input/keys.js | 1 + 15 files changed, 60 insertions(+), 2 deletions(-) diff --git a/pkg/api/api.go b/pkg/api/api.go index 3c33e1e7..2deeb44a 100644 --- a/pkg/api/api.go +++ b/pkg/api/api.go @@ -81,6 +81,7 @@ const ( RecordGame PT = 110 GetWorkerList PT = 111 ErrNoFreeSlots PT = 112 + ResetGame PT = 113 RegisterRoom PT = 201 CloseRoom PT = 202 IceCandidate = WebrtcIce @@ -120,6 +121,8 @@ func (p PT) String() string { return "GetWorkerList" case ErrNoFreeSlots: return "NoFreeSlots" + case ResetGame: + return "ResetGame" case RegisterRoom: return "RegisterRoom" case CloseRoom: diff --git a/pkg/api/worker.go b/pkg/api/worker.go index 5031afab..189daf66 100644 --- a/pkg/api/worker.go +++ b/pkg/api/worker.go @@ -12,7 +12,11 @@ type ( LoadGameRequest[T Id] struct { StatefulRoom[T] } - LoadGameResponse string + LoadGameResponse string + ResetGameRequest[T Id] struct { + StatefulRoom[T] + } + ResetGameResponse string SaveGameRequest[T Id] struct { StatefulRoom[T] } diff --git a/pkg/coordinator/user.go b/pkg/coordinator/user.go index 47156171..a6865d75 100644 --- a/pkg/coordinator/user.go +++ b/pkg/coordinator/user.go @@ -83,6 +83,12 @@ func (u *User) HandleRequests(info HasServerInfo, conf config.CoordinatorConfig) return api.ErrMalformed } u.HandleChangePlayer(*rq) + case api.ResetGame: + rq := api.Unwrap[api.ResetGameRequest[com.Uid]](payload) + if rq == nil { + return api.ErrMalformed + } + u.HandleResetGame(*rq) case api.RecordGame: if !conf.Recording.Enabled { return api.ErrForbidden diff --git a/pkg/coordinator/userhandlers.go b/pkg/coordinator/userhandlers.go index 61c3f494..811ce332 100644 --- a/pkg/coordinator/userhandlers.go +++ b/pkg/coordinator/userhandlers.go @@ -50,6 +50,13 @@ func (u *User) HandleQuitGame(rq api.GameQuitRequest[com.Uid]) { } } +func (u *User) HandleResetGame(rq api.ResetGameRequest[com.Uid]) { + if rq.Room.Rid != u.w.RoomId { + return + } + u.w.ResetGame(u.Id()) +} + func (u *User) HandleSaveGame() error { resp, err := u.w.SaveGame(u.Id()) if err != nil { diff --git a/pkg/coordinator/workerapi.go b/pkg/coordinator/workerapi.go index 05ead1d9..7a1ccf51 100644 --- a/pkg/coordinator/workerapi.go +++ b/pkg/coordinator/workerapi.go @@ -48,6 +48,10 @@ func (w *Worker) ChangePlayer(id com.Uid, index int) (*api.ChangePlayerResponse, w.Send(api.ChangePlayer, api.ChangePlayerRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId), Index: index})) } +func (w *Worker) ResetGame(id com.Uid) { + w.Notify(api.ResetGame, api.ResetGameRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId)}) +} + func (w *Worker) RecordGame(id com.Uid, rec bool, recUser string) (*api.RecordGameResponse, error) { return api.UnwrapChecked[api.RecordGameResponse]( w.Send(api.RecordGame, api.RecordGameRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId), Active: rec, User: recUser})) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 057d7e21..341038a4 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -47,6 +47,7 @@ type Emulator interface { Input(player int, device byte, data []byte) // Scale returns set video scale factor Scale() float64 + Reset() } type Frontend struct { @@ -307,6 +308,7 @@ func (f *Frontend) HashPath() string { return f.storage.GetSavePath func (f *Frontend) IsPortrait() bool { return f.nano.IsPortrait() } func (f *Frontend) KbMouseSupport() bool { return f.nano.KbMouseSupport() } func (f *Frontend) PixFormat() uint32 { return f.nano.Video.PixFmt.C } +func (f *Frontend) Reset() { f.mu.Lock(); defer f.mu.Unlock(); f.nano.Reset() } func (f *Frontend) RestoreGameState() error { return f.Load() } func (f *Frontend) Rotation() uint { return f.nano.Rot } func (f *Frontend) SRAMPath() string { return f.storage.GetSRAMPath() } diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.c b/pkg/worker/caged/libretro/nanoarch/nanoarch.c index 4c46963b..2bbd1883 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.c +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.c @@ -90,6 +90,10 @@ void bridge_retro_unload_game(void *f) { ((void (*)(void)) f)(); } +void bridge_retro_reset(void *f) { + ((void (*)(void)) f)(); +} + void bridge_retro_run(void *f) { ((void (*)(void)) f)(); } diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 4db0dcea..9d8447a0 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -230,6 +230,7 @@ func (n *Nanoarch) CoreLoad(meta Metadata) { retroSetInputState = loadFunction(coreLib, "retro_set_input_state") retroSetAudioSample = loadFunction(coreLib, "retro_set_audio_sample") retroSetAudioSampleBatch = loadFunction(coreLib, "retro_set_audio_sample_batch") + retroReset = loadFunction(coreLib, "retro_reset") retroRun = loadFunction(coreLib, "retro_run") retroLoadGame = loadFunction(coreLib, "retro_load_game") retroUnloadGame = loadFunction(coreLib, "retro_unload_game") @@ -396,6 +397,10 @@ func (n *Nanoarch) Shutdown() { C.free(unsafe.Pointer(n.cSystemDirectory)) } +func (n *Nanoarch) Reset() { + C.bridge_retro_reset(retroReset) +} + func (n *Nanoarch) Run() { if n.LibCo { C.same_thread(retroRun) @@ -595,6 +600,7 @@ var ( coreLib unsafe.Pointer retroInit unsafe.Pointer retroLoadGame unsafe.Pointer + retroReset unsafe.Pointer retroRun unsafe.Pointer retroSetAudioSample unsafe.Pointer retroSetAudioSampleBatch unsafe.Pointer diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.h b/pkg/worker/caged/libretro/nanoarch/nanoarch.h index 66103643..c1e09462 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.h +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.h @@ -15,6 +15,7 @@ void bridge_retro_deinit(void *f); void bridge_retro_get_system_av_info(void *f, struct retro_system_av_info *si); void bridge_retro_get_system_info(void *f, struct retro_system_info *si); void bridge_retro_init(void *f); +void bridge_retro_reset(void *f); void bridge_retro_run(void *f); void bridge_retro_set_audio_sample(void *f, void *callback); void bridge_retro_set_audio_sample_batch(void *f, void *callback); diff --git a/pkg/worker/coordinator.go b/pkg/worker/coordinator.go index 1dd4c7ef..07963577 100644 --- a/pkg/worker/coordinator.go +++ b/pkg/worker/coordinator.go @@ -126,6 +126,12 @@ func (c *coordinator) HandleRequests(w *Worker) chan struct{} { } else { out = c.HandleChangePlayer(*dat, w) } + case api.ResetGame: + dat := api.Unwrap[api.ResetGameRequest[com.Uid]](x.Payload) + if dat == nil { + return api.ErrMalformed + } + c.HandleResetGame(*dat, w) case api.RecordGame: if dat := api.Unwrap[api.RecordGameRequest[com.Uid]](x.Payload); dat == nil { err, out = api.ErrMalformed, api.EmptyPacket diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index db0b5ad0..97cb2784 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -234,6 +234,14 @@ func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) } } +func (c *coordinator) HandleResetGame(rq api.ResetGameRequest[com.Uid], w *Worker) api.Out { + if r := w.router.FindRoom(rq.Rid); r != nil { + room.WithEmulator(r.App()).Reset() + return api.OkPacket + } + return api.ErrPacket +} + func (c *coordinator) HandleSaveGame(rq api.SaveGameRequest[com.Uid], w *Worker) api.Out { r := w.router.FindRoom(rq.Rid) if r == nil { diff --git a/web/js/api.js b/web/js/api.js index 736328ee..906342b0 100644 --- a/web/js/api.js +++ b/web/js/api.js @@ -15,6 +15,7 @@ const endpoints = { GAME_RECORDING: 110, GET_WORKER_LIST: 111, GAME_ERROR_NO_FREE_SLOTS: 112, + GAME_RESET: 113, APP_VIDEO_CHANGE: 150, } @@ -319,6 +320,7 @@ export const api = { } }, load: () => packet(endpoints.GAME_LOAD), + reset: (roomId) => packet(endpoints.GAME_RESET, {room_id: roomId}), save: () => packet(endpoints.GAME_SAVE), setPlayerIndex: (i) => packet(endpoints.GAME_SET_PLAYER_INDEX, i), start: (game, roomId, record, recordUser, player) => packet(endpoints.GAME_START, { diff --git a/web/js/app.js b/web/js/app.js index ad5bb6c6..01327be3 100644 --- a/web/js/app.js +++ b/web/js/app.js @@ -437,6 +437,9 @@ const app = { room.reset(); window.location = window.location.pathname; break; + case KEY.RESET: + api.game.reset(room.id) + break; case KEY.STATS: stats.toggle(); break; diff --git a/web/js/input/keyboard.js b/web/js/input/keyboard.js index b29b61bf..4c26e9db 100644 --- a/web/js/input/keyboard.js +++ b/web/js/input/keyboard.js @@ -45,7 +45,8 @@ const defaultMap = Object.freeze({ KeyH: KEY.HELP, Backslash: KEY.STATS, Digit9: KEY.SETTINGS, - KeyT: KEY.DTOGGLE + KeyT: KEY.DTOGGLE, + Digit0: KEY.RESET, }); let keyMap = {}; diff --git a/web/js/input/keys.js b/web/js/input/keys.js index 6f94c2ff..4406823e 100644 --- a/web/js/input/keys.js +++ b/web/js/input/keys.js @@ -29,4 +29,5 @@ export const KEY = { L3: 'l3', R3: 'r3', REC: 'rec', + RESET: 'reset', } From a7acebc5d0ccce454329e988729d13ca93720c6e Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 4 Dec 2024 22:09:51 +0300 Subject: [PATCH 288/361] Try YUV without the mem pool --- pkg/encoder/encoder.go | 2 +- pkg/encoder/yuv/yuv.go | 20 ++++++++++++-------- 2 files changed, 13 insertions(+), 9 deletions(-) diff --git a/pkg/encoder/encoder.go b/pkg/encoder/encoder.go index 550f75d1..0372c2c5 100644 --- a/pkg/encoder/encoder.go +++ b/pkg/encoder/encoder.go @@ -80,7 +80,7 @@ func (v *Video) Encode(frame InFrame) OutFrame { } yCbCr := v.y.Process(yuv.RawFrame(frame), v.rot, v.pf) - defer v.y.Put(&yCbCr) + //defer v.y.Put(&yCbCr) if bytes := v.codec.Encode(yCbCr); len(bytes) > 0 { return bytes } diff --git a/pkg/encoder/yuv/yuv.go b/pkg/encoder/yuv/yuv.go index 25d591d1..69bc89c8 100644 --- a/pkg/encoder/yuv/yuv.go +++ b/pkg/encoder/yuv/yuv.go @@ -8,10 +8,12 @@ import ( ) type Conv struct { - w, h int - sw, sh int - scale float64 - pool sync.Pool + w, h int + sw, sh int + scale float64 + pool sync.Pool + frame []byte + frameSc []byte } type RawFrame struct { @@ -35,7 +37,9 @@ func NewYuvConv(w, h int, scale float64) Conv { bufSize := int(float64(sw) * float64(sh) * 1.5) return Conv{ w: w, h: h, sw: sw, sh: sh, scale: scale, - pool: sync.Pool{New: func() any { b := make([]byte, bufSize); return &b }}, + pool: sync.Pool{New: func() any { b := make([]byte, bufSize); return &b }}, + frame: make([]byte, bufSize), + frameSc: make([]byte, bufSize), } } @@ -52,13 +56,13 @@ func (c *Conv) Process(frame RawFrame, rot uint, pf PixFmt) []byte { stride = frame.Stride >> 1 } - buf := *c.pool.Get().(*[]byte) + buf := c.frame //*c.pool.Get().(*[]byte) libyuv.Y420(frame.Data, buf, frame.W, frame.H, stride, dx, dy, rot, uint32(pf), cx, cy) if c.scale > 1 { - dstBuf := *c.pool.Get().(*[]byte) + dstBuf := c.frameSc //*c.pool.Get().(*[]byte) libyuv.Y420Scale(buf, dstBuf, dx, dy, c.sw, c.sh) - c.pool.Put(&buf) + //c.pool.Put(&buf) return dstBuf } return buf From 8fa53f4e32de9228cae06d1b930dbfb56e3120bb Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 4 Dec 2024 22:16:58 +0300 Subject: [PATCH 289/361] Disable macos --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index e866f76d..c5b62044 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -18,7 +18,7 @@ jobs: build: strategy: matrix: - os: [ ubuntu-latest, macos-12, windows-latest ] + os: [ ubuntu-latest, windows-latest ] runs-on: ${{ matrix.os }} steps: - uses: actions/checkout@v4 From db32479c4e1b7bcdc58c57c3ca03819c45638ce6 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 5 Dec 2024 01:10:16 +0300 Subject: [PATCH 290/361] Destroy rooms when the coordinator was lost --- pkg/worker/worker.go | 1 + 1 file changed, 1 insertion(+) diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index f98b2e97..28c29b60 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -113,6 +113,7 @@ func (w *Worker) Start(done chan struct{}) { case <-done: return default: + w.Reset() cord, err := newCoordinatorConnection(remoteAddr, w.conf.Worker, w.address, w.log) if err != nil { onRetryFail(err) From 5649d4410a85285830d7a00d8303dbf34946c6ec Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 5 Dec 2024 01:11:02 +0300 Subject: [PATCH 291/361] Remove pools from YUV conv --- pkg/encoder/yuv/yuv.go | 43 +++++++++++++++++++++++------------------- 1 file changed, 24 insertions(+), 19 deletions(-) diff --git a/pkg/encoder/yuv/yuv.go b/pkg/encoder/yuv/yuv.go index 69bc89c8..4718c7c1 100644 --- a/pkg/encoder/yuv/yuv.go +++ b/pkg/encoder/yuv/yuv.go @@ -2,7 +2,6 @@ package yuv import ( "image" - "sync" "github.com/giongto35/cloud-game/v3/pkg/encoder/yuv/libyuv" ) @@ -11,7 +10,6 @@ type Conv struct { w, h int sw, sh int scale float64 - pool sync.Pool frame []byte frameSc []byte } @@ -33,42 +31,49 @@ func NewYuvConv(w, h int, scale float64) Conv { if scale < 1 { scale = 1 } + sw, sh := round(w, scale), round(h, scale) - bufSize := int(float64(sw) * float64(sh) * 1.5) - return Conv{ - w: w, h: h, sw: sw, sh: sh, scale: scale, - pool: sync.Pool{New: func() any { b := make([]byte, bufSize); return &b }}, - frame: make([]byte, bufSize), - frameSc: make([]byte, bufSize), + conv := Conv{w: w, h: h, sw: sw, sh: sh, scale: scale} + bufSize := int(float64(w) * float64(h) * 1.5) + + if scale == 1 { + conv.frame = make([]byte, bufSize) + } else { + bufSizeSc := int(float64(sw) * float64(sh) * 1.5) + // [original frame][scaled frame ] + frames := make([]byte, bufSize+bufSizeSc) + conv.frame = frames[:bufSize] + conv.frameSc = frames[bufSize:] } + + return conv } // Process converts an image to YUV I420 format inside the internal buffer. func (c *Conv) Process(frame RawFrame, rot uint, pf PixFmt) []byte { - dx, dy := c.w, c.h // dest cx, cy := c.w, c.h // crop if rot == 90 || rot == 270 { cx, cy = cy, cx } - stride := frame.Stride >> 2 - if pf == PixFmt(libyuv.FourccRgbp) || pf == PixFmt(libyuv.FourccRgb0) { + var stride int + switch pf { + case PixFmt(libyuv.FourccRgbp), PixFmt(libyuv.FourccRgb0): stride = frame.Stride >> 1 + default: + stride = frame.Stride >> 2 } - buf := c.frame //*c.pool.Get().(*[]byte) - libyuv.Y420(frame.Data, buf, frame.W, frame.H, stride, dx, dy, rot, uint32(pf), cx, cy) + libyuv.Y420(frame.Data, c.frame, frame.W, frame.H, stride, c.w, c.h, rot, uint32(pf), cx, cy) if c.scale > 1 { - dstBuf := c.frameSc //*c.pool.Get().(*[]byte) - libyuv.Y420Scale(buf, dstBuf, dx, dy, c.sw, c.sh) - //c.pool.Put(&buf) - return dstBuf + libyuv.Y420Scale(c.frame, c.frameSc, c.w, c.h, c.sw, c.sh) + return c.frameSc } - return buf + + return c.frame } -func (c *Conv) Put(x *[]byte) { c.pool.Put(x) } func (c *Conv) Version() string { return libyuv.Version() } func round(x int, scale float64) int { return (int(float64(x)*scale) + 1) & ^1 } From 297ec9005c3774eb1c48ec613464c05a0f2a28f9 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 5 Dec 2024 01:35:48 +0300 Subject: [PATCH 292/361] Display video scaling info --- web/js/app.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/js/app.js b/web/js/app.js index 01327be3..3d58dc89 100644 --- a/web/js/app.js +++ b/web/js/app.js @@ -588,7 +588,7 @@ stats.modules = [ { mui: stats.mui('', '', false, () => ''), init() { - sub(APP_VIDEO_CHANGED, (payload) => (this.val = `${payload.w}x${payload.h}`)) + sub(APP_VIDEO_CHANGED, ({s = 1, w, h}) => (this.val = `${w * s}x${h * s}`)) }, }, { From d77d69a3310d013863588b6fa8603aafdbeabc51 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 5 Dec 2024 13:50:39 +0300 Subject: [PATCH 293/361] Remove pool from the audio stretcher --- pkg/worker/media/media.go | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 3b844a02..3d8d6ab8 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -32,7 +32,7 @@ type ( var ( encoderOnce = sync.Once{} opusCoder *opus.Encoder - audioPool = sync.Pool{New: func() any { b := make([]int16, sampleBufLen); return &b }} + buf = make([]int16, sampleBufLen) ) func newBuffer(srcLen int) buffer { return buffer{s: make(samples, srcLen)} } @@ -86,7 +86,7 @@ func frame(hz int, frame int) int { return hz * frame / 1000 * 2 } // stretch does a simple stretching of audio samples. // something like: [1,2,3,4,5,6] -> [1,2,x,x,3,4,x,x,5,6,x,x] -> [1,2,1,2,3,4,3,4,5,6,5,6] func (s samples) stretch(size int) []int16 { - out := (*audioPool.Get().(*[]int16))[:size] + out := buf[:size] n := len(s) ratio := float32(size) / float32(n) sPtr := unsafe.Pointer(&s[0]) @@ -181,7 +181,6 @@ func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSize int) error { func (wmp *WebrtcMediaPipe) encodeAudio(pcm samples) { data, err := wmp.Audio().Encode(pcm) - audioPool.Put((*[]int16)(&pcm)) if err != nil { wmp.log.Error().Err(err).Msgf("opus encode fail") return From 6bb82b22042251e136a8f96359df4e25a122198d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 6 Dec 2024 15:27:18 +0300 Subject: [PATCH 294/361] Allow 2.5ms Opus frame --- pkg/config/worker.go | 2 +- pkg/worker/media/media.go | 9 ++++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/pkg/config/worker.go b/pkg/config/worker.go index 9e865672..1a476b05 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -51,7 +51,7 @@ type Encoder struct { } type Audio struct { - Frame int + Frame float32 } type Video struct { diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 3d8d6ab8..3c8c8713 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -2,6 +2,7 @@ package media import ( "fmt" + "math" "sync" "time" "unsafe" @@ -81,7 +82,9 @@ func DefaultOpus() (*opus.Encoder, error) { } // frame calculates an audio stereo frame size, i.e. 48k*frame/1000*2 -func frame(hz int, frame int) int { return hz * frame / 1000 * 2 } +func frame(hz int, frame float32) int { + return int(math.Round(float64(hz) * float64(frame) / 1000 * 2)) +} // stretch does a simple stretching of audio samples. // something like: [1,2,3,4,5,6] -> [1,2,x,x,3,4,x,x,5,6,x,x] -> [1,2,1,2,3,4,3,4,5,6,5,6] @@ -114,7 +117,7 @@ type WebrtcMediaPipe struct { vConf config.Video AudioSrcHz int - AudioFrame int + AudioFrame float32 VideoW, VideoH int VideoScale float64 @@ -162,7 +165,7 @@ func (wmp *WebrtcMediaPipe) Init() error { return nil } -func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSize int) error { +func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSize float32) error { au, err := DefaultOpus() if err != nil { return fmt.Errorf("opus fail: %w", err) From f54089e072d75b4be6a458e54f3c693c0176459d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 7 Dec 2024 00:47:27 +0300 Subject: [PATCH 295/361] Stretch samples a bit better with the GBA's 32768Hz --- pkg/worker/media/media.go | 3 ++- pkg/worker/media/media_test.go | 11 +++++++---- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 3c8c8713..ed356308 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -82,8 +82,9 @@ func DefaultOpus() (*opus.Encoder, error) { } // frame calculates an audio stereo frame size, i.e. 48k*frame/1000*2 +// with round(x / 2) * 2 for the closest even number func frame(hz int, frame float32) int { - return int(math.Round(float64(hz) * float64(frame) / 1000 * 2)) + return int(math.Round(float64(hz)*float64(frame)/1000/2) * 2 * 2) } // stretch does a simple stretching of audio samples. diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 756688de..ab27f7fa 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -192,7 +192,7 @@ func TestBufferWrite(t *testing.T) { buf.write(samplesOf(w.sample, w.len), func(s samples) { lastResult = s }) } if !reflect.DeepEqual(test.expect, lastResult) { - t.Errorf("not expted buffer, %v != %v", lastResult, test.expect) + t.Errorf("not expted buffer, %v != %v, %v", lastResult, test.expect, buf.s) } } } @@ -217,17 +217,20 @@ func samplesOf(v int16, len int) (s samples) { return } -func Test_frame(t *testing.T) { +func TestFrame(t *testing.T) { type args struct { hz int - frame int + frame float32 } tests := []struct { name string args args want int }{ - {name: "mGBA", args: args{hz: 32768, frame: 10}, want: 654}, + {name: "mGBA", args: args{hz: 32768, frame: 10}, want: 656}, + {name: "mGBA", args: args{hz: 32768, frame: 5}, want: 328}, + {name: "mGBA", args: args{hz: 32768, frame: 2.5}, want: 164}, + {name: "nes", args: args{hz: 48000, frame: 2.5}, want: 240}, } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { From ed3b195b26fea2a736a1ec38a4e01db6c9a5edba Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Thu, 12 Dec 2024 21:13:43 +0300 Subject: [PATCH 296/361] Dynamic audio buf * Ugly audio buf * Use dynamic Opus frames with config --- pkg/config/config.yaml | 5 ++ pkg/config/loader_test.go | 13 +++- pkg/config/worker.go | 2 +- pkg/worker/coordinatorhandlers.go | 2 +- pkg/worker/media/buffer.go | 119 ++++++++++++++++++++++++++++++ pkg/worker/media/buffer_test.go | 77 +++++++++++++++++++ pkg/worker/media/media.go | 105 ++++++-------------------- pkg/worker/media/media_test.go | 64 ---------------- pkg/worker/room/room_test.go | 2 +- 9 files changed, 235 insertions(+), 154 deletions(-) create mode 100644 pkg/worker/media/buffer.go create mode 100644 pkg/worker/media/buffer_test.go diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 48d78ed3..9c1ee1aa 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -300,7 +300,12 @@ encoder: # audio frame duration needed for WebRTC (Opus) # most of the emulators have ~1400 samples per a video frame, # so we keep the frame buffer roughly half of that size or 2 RTC packets per frame + # (deprecated) due to frames frame: 10 + # dynamic frames for Opus encoder + frames: + - 10 + - 5 video: # h264, vpx (vp8) or vp9 codec: h264 diff --git a/pkg/config/loader_test.go b/pkg/config/loader_test.go index 355f19a4..08e17dd3 100644 --- a/pkg/config/loader_test.go +++ b/pkg/config/loader_test.go @@ -9,8 +9,10 @@ import ( func TestConfigEnv(t *testing.T) { var out WorkerConfig - _ = os.Setenv("CLOUD_GAME_ENCODER_AUDIO_FRAME", "33") - defer func() { _ = os.Unsetenv("CLOUD_GAME_ENCODER_AUDIO_FRAME") }() + _ = os.Setenv("CLOUD_GAME_ENCODER_AUDIO_FRAMES[0]", "10") + _ = os.Setenv("CLOUD_GAME_ENCODER_AUDIO_FRAMES[1]", "5") + defer func() { _ = os.Unsetenv("CLOUD_GAME_ENCODER_AUDIO_FRAMES[0]") }() + defer func() { _ = os.Unsetenv("CLOUD_GAME_ENCODER_AUDIO_FRAMES[1]") }() _ = os.Setenv("CLOUD_GAME_EMULATOR_LIBRETRO_CORES_LIST_PCSX_OPTIONS__PCSX_REARMED_DRC", "x") defer func() { @@ -22,8 +24,11 @@ func TestConfigEnv(t *testing.T) { t.Fatal(err) } - if out.Encoder.Audio.Frame != 33 { - t.Errorf("%v is not 33", out.Encoder.Audio.Frame) + for i, x := range []float32{10, 5} { + if out.Encoder.Audio.Frames[i] != x { + t.Errorf("%v is not [10, 5]", out.Encoder.Audio.Frames) + t.Failed() + } } v := out.Emulator.Libretro.Cores.List["pcsx"].Options["pcsx_rearmed_drc"] diff --git a/pkg/config/worker.go b/pkg/config/worker.go index 1a476b05..5a509b0c 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -51,7 +51,7 @@ type Encoder struct { } type Audio struct { - Frame float32 + Frames []float32 } type Video struct { diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 97cb2784..536c6ed6 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -168,7 +168,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke } m.AudioSrcHz = app.AudioSampleRate() - m.AudioFrame = w.conf.Encoder.Audio.Frame + m.AudioFrames = w.conf.Encoder.Audio.Frames m.VideoW, m.VideoH = app.ViewportSize() m.VideoScale = app.Scale() diff --git a/pkg/worker/media/buffer.go b/pkg/worker/media/buffer.go new file mode 100644 index 00000000..bba28959 --- /dev/null +++ b/pkg/worker/media/buffer.go @@ -0,0 +1,119 @@ +package media + +import ( + "errors" + "math" + "unsafe" +) + +// buffer is a simple non-concurrent safe buffer for audio samples. +type buffer struct { + stretch bool + frameHz []int + + raw samples + buckets []Bucket + cur *Bucket +} + +type Bucket struct { + mem samples + ms float32 + lv int + dst int +} + +func newBuffer(frames []float32, hz int) (*buffer, error) { + if hz < 2000 { + return nil, errors.New("hz should be > than 2000") + } + + buf := buffer{} + + // preallocate continuous array + s := 0 + for _, f := range frames { + s += frame(hz, f) + } + buf.raw = make(samples, s) + + next := 0 + for _, f := range frames { + s := frame(hz, f) + buf.buckets = append(buf.buckets, Bucket{ + mem: buf.raw[next : next+s], + ms: f, + }) + next += s + } + buf.cur = &buf.buckets[len(buf.buckets)-1] + return &buf, nil +} + +func (b *buffer) choose(l int) { + for _, bb := range b.buckets { + if l >= len(bb.mem) { + b.cur = &bb + break + } + } +} + +func (b *buffer) resample(hz int) { + b.stretch = true + for i := range b.buckets { + b.buckets[i].dst = frame(hz, float32(b.buckets[i].ms)) + } +} + +// write fills the buffer until it's full and then passes the gathered data into a callback. +// +// There are two cases to consider: +// 1. Underflow, when the length of the written data is less than the buffer's available space. +// 2. Overflow, when the length exceeds the current available buffer space. +// +// We overwrite any previous values in the buffer and move the internal write pointer +// by the length of the written data. +// In the first case, we won't call the callback, but it will be called every time +// when the internal buffer overflows until all samples are read. +func (b *buffer) write(s samples, onFull func(samples, float32)) (r int) { + for r < len(s) { + buf := b.cur + w := copy(buf.mem[buf.lv:], s[r:]) + r += w + buf.lv += w + if buf.lv == len(buf.mem) { + if b.stretch { + onFull(buf.mem.stretch(buf.dst), buf.ms) + } else { + onFull(buf.mem, buf.ms) + } + b.choose(len(s) - r) + b.cur.lv = 0 + } + } + return +} + +// frame calculates an audio stereo frame size, i.e. 48k*frame/1000*2 +// with round(x / 2) * 2 for the closest even number +func frame(hz int, frame float32) int { + return int(math.Round(float64(hz)*float64(frame)/1000/2) * 2 * 2) +} + +// stretch does a simple stretching of audio samples. +// something like: [1,2,3,4,5,6] -> [1,2,x,x,3,4,x,x,5,6,x,x] -> [1,2,1,2,3,4,3,4,5,6,5,6] +func (s samples) stretch(size int) []int16 { + out := buf[:size] + n := len(s) + ratio := float32(size) / float32(n) + sPtr := unsafe.Pointer(&s[0]) + for i, l, r := 0, 0, 0; i < n; i += 2 { + l, r = r, int(float32((i+2)>>1)*ratio)<<1 // index in src * ratio -> approximated index in dst *2 due to int16 + for j := l; j < r; j += 2 { + *(*int32)(unsafe.Pointer(&out[j])) = *(*int32)(sPtr) // out[j] = s[i]; out[j+1] = s[i+1] + } + sPtr = unsafe.Add(sPtr, uintptr(4)) + } + return out +} diff --git a/pkg/worker/media/buffer_test.go b/pkg/worker/media/buffer_test.go new file mode 100644 index 00000000..29f2fc6a --- /dev/null +++ b/pkg/worker/media/buffer_test.go @@ -0,0 +1,77 @@ +package media + +import ( + "reflect" + "testing" +) + +type bufWrite struct { + sample int16 + len int +} + +func TestBufferWrite(t *testing.T) { + tests := []struct { + bufLen int + writes []bufWrite + expect samples + }{ + { + bufLen: 2000, + writes: []bufWrite{ + {sample: 1, len: 10}, + {sample: 2, len: 20}, + {sample: 3, len: 30}, + }, + expect: samples{3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3}, + }, + { + bufLen: 2000, + writes: []bufWrite{ + {sample: 1, len: 3}, + {sample: 2, len: 18}, + {sample: 3, len: 2}, + }, + expect: samples{2, 3, 3, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, + }, + } + + for _, test := range tests { + var lastResult samples + buf, err := newBuffer([]float32{10, 5}, test.bufLen) + if err != nil { + t.Fatalf("oof, %v", err) + } + for _, w := range test.writes { + buf.write(samplesOf(w.sample, w.len), + func(s samples, ms float32) { lastResult = s }, + ) + } + if !reflect.DeepEqual(test.expect, lastResult) { + t.Errorf("not expted buffer, %v != %v, %v", lastResult, test.expect, len(buf.cur.mem)) + } + } +} + +func BenchmarkBufferWrite(b *testing.B) { + fn := func(_ samples, _ float32) {} + l := 2000 + buf, err := newBuffer([]float32{10}, l) + if err != nil { + b.Fatalf("oof: %v", err) + } + samples1 := samplesOf(1, l/2) + samples2 := samplesOf(2, l*2) + for i := 0; i < b.N; i++ { + buf.write(samples1, fn) + buf.write(samples2, fn) + } +} + +func samplesOf(v int16, len int) (s samples) { + s = make(samples, len) + for i := range s { + s[i] = v + } + return +} diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index ed356308..bece8a09 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -2,16 +2,13 @@ package media import ( "fmt" - "math" - "sync" - "time" - "unsafe" - "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/encoder" "github.com/giongto35/cloud-game/v3/pkg/encoder/opus" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + "sync" + "time" ) const ( @@ -19,16 +16,7 @@ const ( sampleBufLen = 1024 * 4 ) -// buffer is a simple non-concurrent safe ring buffer for audio samples. -type ( - buffer struct { - s samples - wi int - dst int - stretch bool - } - samples []int16 -) +type samples []int16 var ( encoderOnce = sync.Once{} @@ -36,39 +24,6 @@ var ( buf = make([]int16, sampleBufLen) ) -func newBuffer(srcLen int) buffer { return buffer{s: make(samples, srcLen)} } - -// enableStretch adds a simple stretching of buffer to a desired size before -// the onFull callback call. -func (b *buffer) enableStretch(l int) { b.stretch = true; b.dst = l } - -// write fills the buffer until it's full and then passes the gathered data into a callback. -// -// There are two cases to consider: -// 1. Underflow, when the length of the written data is less than the buffer's available space. -// 2. Overflow, when the length exceeds the current available buffer space. -// -// We overwrite any previous values in the buffer and move the internal write pointer -// by the length of the written data. -// In the first case, we won't call the callback, but it will be called every time -// when the internal buffer overflows until all samples are read. -func (b *buffer) write(s samples, onFull func(samples)) (r int) { - for r < len(s) { - w := copy(b.s[b.wi:], s[r:]) - r += w - b.wi += w - if b.wi == len(b.s) { - b.wi = 0 - if b.stretch { - onFull(b.s.stretch(b.dst)) - } else { - onFull(b.s) - } - } - } - return -} - func DefaultOpus() (*opus.Encoder, error) { var err error encoderOnce.Do(func() { opusCoder, err = opus.NewEncoder(audioHz) }) @@ -81,34 +36,11 @@ func DefaultOpus() (*opus.Encoder, error) { return opusCoder, nil } -// frame calculates an audio stereo frame size, i.e. 48k*frame/1000*2 -// with round(x / 2) * 2 for the closest even number -func frame(hz int, frame float32) int { - return int(math.Round(float64(hz)*float64(frame)/1000/2) * 2 * 2) -} - -// stretch does a simple stretching of audio samples. -// something like: [1,2,3,4,5,6] -> [1,2,x,x,3,4,x,x,5,6,x,x] -> [1,2,1,2,3,4,3,4,5,6,5,6] -func (s samples) stretch(size int) []int16 { - out := buf[:size] - n := len(s) - ratio := float32(size) / float32(n) - sPtr := unsafe.Pointer(&s[0]) - for i, l, r := 0, 0, 0; i < n; i += 2 { - l, r = r, int(float32((i+2)>>1)*ratio)<<1 // index in src * ratio -> approximated index in dst *2 due to int16 - for j := l; j < r; j += 2 { - *(*int32)(unsafe.Pointer(&out[j])) = *(*int32)(sPtr) // out[j] = s[i]; out[j+1] = s[i+1] - } - sPtr = unsafe.Add(sPtr, uintptr(4)) - } - return out -} - type WebrtcMediaPipe struct { a *opus.Encoder v *encoder.Video - onAudio func([]byte) - audioBuf buffer + onAudio func([]byte, float32) + audioBuf *buffer log *logger.Logger mua sync.RWMutex @@ -118,7 +50,7 @@ type WebrtcMediaPipe struct { vConf config.Video AudioSrcHz int - AudioFrame float32 + AudioFrames []float32 VideoW, VideoH int VideoScale float64 @@ -135,8 +67,9 @@ func NewWebRtcMediaPipe(ac config.Audio, vc config.Video, log *logger.Logger) *W } func (wmp *WebrtcMediaPipe) SetAudioCb(cb func([]byte, int32)) { - fr := int32(time.Duration(wmp.AudioFrame) * time.Millisecond) - wmp.onAudio = func(bytes []byte) { cb(bytes, fr) } + wmp.onAudio = func(bytes []byte, ms float32) { + cb(bytes, int32(time.Duration(ms)*time.Millisecond)) + } } func (wmp *WebrtcMediaPipe) Destroy() { v := wmp.Video() @@ -144,10 +77,12 @@ func (wmp *WebrtcMediaPipe) Destroy() { v.Stop() } } -func (wmp *WebrtcMediaPipe) PushAudio(audio []int16) { wmp.audioBuf.write(audio, wmp.encodeAudio) } +func (wmp *WebrtcMediaPipe) PushAudio(audio []int16) { + wmp.audioBuf.write(audio, wmp.encodeAudio) +} func (wmp *WebrtcMediaPipe) Init() error { - if err := wmp.initAudio(wmp.AudioSrcHz, wmp.AudioFrame); err != nil { + if err := wmp.initAudio(wmp.AudioSrcHz, wmp.AudioFrames); err != nil { return err } if err := wmp.initVideo(wmp.VideoW, wmp.VideoH, wmp.VideoScale, wmp.vConf); err != nil { @@ -166,30 +101,34 @@ func (wmp *WebrtcMediaPipe) Init() error { return nil } -func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSize float32) error { +func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSizes []float32) error { au, err := DefaultOpus() if err != nil { return fmt.Errorf("opus fail: %w", err) } wmp.log.Debug().Msgf("Opus: %v", au.GetInfo()) wmp.SetAudio(au) - buf := newBuffer(frame(srcHz, frameSize)) + buf, err := newBuffer(frameSizes, srcHz) + if err != nil { + return err + } + wmp.log.Debug().Msgf("Opus frames (ms): %v", frameSizes) dstHz, _ := au.SampleRate() if srcHz != dstHz { - buf.enableStretch(frame(dstHz, frameSize)) + buf.resample(dstHz) wmp.log.Debug().Msgf("Resample %vHz -> %vHz", srcHz, dstHz) } wmp.audioBuf = buf return nil } -func (wmp *WebrtcMediaPipe) encodeAudio(pcm samples) { +func (wmp *WebrtcMediaPipe) encodeAudio(pcm samples, ms float32) { data, err := wmp.Audio().Encode(pcm) if err != nil { wmp.log.Error().Err(err).Msgf("opus encode fail") return } - wmp.onAudio(data) + wmp.onAudio(data, ms) } func (wmp *WebrtcMediaPipe) initVideo(w, h int, scale float64, conf config.Video) (err error) { diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index ab27f7fa..4b9a431b 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -3,7 +3,6 @@ package media import ( "image" "math/rand/v2" - "reflect" "testing" "github.com/giongto35/cloud-game/v3/pkg/config" @@ -154,69 +153,6 @@ func gen(l int) []int16 { return nums } -type bufWrite struct { - sample int16 - len int -} - -func TestBufferWrite(t *testing.T) { - tests := []struct { - bufLen int - writes []bufWrite - expect samples - }{ - { - bufLen: 20, - writes: []bufWrite{ - {sample: 1, len: 10}, - {sample: 2, len: 20}, - {sample: 3, len: 30}, - }, - expect: samples{3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3}, - }, - { - bufLen: 11, - writes: []bufWrite{ - {sample: 1, len: 3}, - {sample: 2, len: 18}, - {sample: 3, len: 2}, - }, - expect: samples{3, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3}, - }, - } - - for _, test := range tests { - var lastResult samples - buf := newBuffer(test.bufLen) - for _, w := range test.writes { - buf.write(samplesOf(w.sample, w.len), func(s samples) { lastResult = s }) - } - if !reflect.DeepEqual(test.expect, lastResult) { - t.Errorf("not expted buffer, %v != %v, %v", lastResult, test.expect, buf.s) - } - } -} - -func BenchmarkBufferWrite(b *testing.B) { - fn := func(_ samples) {} - l := 1920 - buf := newBuffer(l) - samples1 := samplesOf(1, l/2) - samples2 := samplesOf(2, l*2) - for i := 0; i < b.N; i++ { - buf.write(samples1, fn) - buf.write(samples2, fn) - } -} - -func samplesOf(v int16, len int) (s samples) { - s = make(samples, len) - for i := range s { - s[i] = v - } - return -} - func TestFrame(t *testing.T) { type args struct { hz int diff --git a/pkg/worker/room/room_test.go b/pkg/worker/room/room_test.go index a33e4d82..9a4bdd73 100644 --- a/pkg/worker/room/room_test.go +++ b/pkg/worker/room/room_test.go @@ -229,7 +229,7 @@ func room(cfg conf) testRoom { m := media.NewWebRtcMediaPipe(conf.Encoder.Audio, conf.Encoder.Video, l) m.AudioSrcHz = emu.AudioSampleRate() - m.AudioFrame = conf.Encoder.Audio.Frame + m.AudioFrames = conf.Encoder.Audio.Frames m.VideoW, m.VideoH = emu.ViewportSize() m.VideoScale = emu.Scale() if err := m.Init(); err != nil { From 89ae98b035e34ab6aa8c4efbe1e65f2233697fb2 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 13 Dec 2024 18:57:25 +0300 Subject: [PATCH 297/361] Why do we need samples In an ideal scenario, the emulator generates a video frame and an audio chunk with its internal frame rate. For example, if the emulator runs a game at 60 FPS, it will produce 16 ms worth of audio and a video frame with each tick (or call of the run function). Then we need to send all this data to the user's browser, which becomes tricky with WebRTC audio. The WebRTC standard supports only Opus-encoded audio for high-quality sound. The encoder and decoder (the audio player in the browser) have a limitation: they can only operate on fixed audio frames or predefined chunks of audio, which are 5, 10, 20, 40, or 60 ms in length. Due to this limitation, we have to wait at least two ticks until the first whole audio chunk can be packed into predefined frames. If we have 16 ms of audio and one fixed buffer, we send 10 ms right away and have to wait for 4 ms to add to the remaining 6 ms. This will lead to a constant 6 ms delay between audio and video. To mitigate this issue, we can set the smallest frame size as a buffer, i.e., 5 ms. This will decrease the latency to 1 ms, but we will send 3 packets of data in this manner for 16 ms. A slightly better way is to create several buffers and dynamically select the next buffer so that the audio fits optimally, minimizing the number of network packets sent to users. This frames thing essentially accomplishes that. In the options, we can select multiple (or one) Opus buffers to store audio and choose from. They should be defined from the largest to the smallest. And that's it. --- pkg/worker/media/buffer.go | 25 +++++++++++++++---------- pkg/worker/media/media.go | 5 +++-- 2 files changed, 18 insertions(+), 12 deletions(-) diff --git a/pkg/worker/media/buffer.go b/pkg/worker/media/buffer.go index bba28959..e80a7c82 100644 --- a/pkg/worker/media/buffer.go +++ b/pkg/worker/media/buffer.go @@ -12,14 +12,14 @@ type buffer struct { frameHz []int raw samples - buckets []Bucket - cur *Bucket + buckets []bucket + cur *bucket } -type Bucket struct { +type bucket struct { mem samples ms float32 - lv int + p int dst int } @@ -37,10 +37,14 @@ func newBuffer(frames []float32, hz int) (*buffer, error) { } buf.raw = make(samples, s) + if len(buf.raw) == 0 { + return nil, errors.New("seems those params are bad and the buffer is 0") + } + next := 0 for _, f := range frames { s := frame(hz, f) - buf.buckets = append(buf.buckets, Bucket{ + buf.buckets = append(buf.buckets, bucket{ mem: buf.raw[next : next+s], ms: f, }) @@ -62,7 +66,7 @@ func (b *buffer) choose(l int) { func (b *buffer) resample(hz int) { b.stretch = true for i := range b.buckets { - b.buckets[i].dst = frame(hz, float32(b.buckets[i].ms)) + b.buckets[i].dst = frame(hz, b.buckets[i].ms) } } @@ -76,20 +80,21 @@ func (b *buffer) resample(hz int) { // by the length of the written data. // In the first case, we won't call the callback, but it will be called every time // when the internal buffer overflows until all samples are read. +// It will choose between multiple internal buffers to fit remaining samples. func (b *buffer) write(s samples, onFull func(samples, float32)) (r int) { for r < len(s) { buf := b.cur - w := copy(buf.mem[buf.lv:], s[r:]) + w := copy(buf.mem[buf.p:], s[r:]) r += w - buf.lv += w - if buf.lv == len(buf.mem) { + buf.p += w + if buf.p == len(buf.mem) { if b.stretch { onFull(buf.mem.stretch(buf.dst), buf.ms) } else { onFull(buf.mem, buf.ms) } b.choose(len(s) - r) - b.cur.lv = 0 + b.cur.p = 0 } } return diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index bece8a09..b08ec692 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -2,13 +2,14 @@ package media import ( "fmt" + "sync" + "time" + "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/encoder" "github.com/giongto35/cloud-game/v3/pkg/encoder/opus" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" - "sync" - "time" ) const ( From 82aebf66473dd6ed43026addc420e1cd374a9b01 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 14 Dec 2024 14:14:56 +0300 Subject: [PATCH 298/361] Fix Package 'libgl1-mesa-glx' has no installation candidate --- .github/workflows/build.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index c5b62044..81225ca7 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -36,7 +36,7 @@ jobs: sudo apt-get -qq install -y \ make pkg-config \ libvpx-dev libx264-dev libopus-dev libyuv-dev libjpeg-turbo8-dev \ - libsdl2-dev libgl1-mesa-glx + libsdl2-dev libgl1 libglx-mesa0 make build xvfb-run --auto-servernum make test verify-cores From 600243c87d1e118b017b04d854d732458bc9bd68 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 16 Dec 2024 13:48:34 +0300 Subject: [PATCH 299/361] Update dependencies --- go.mod | 22 +++++++++++----------- go.sum | 47 ++++++++++++++++++++++++----------------------- 2 files changed, 35 insertions(+), 34 deletions(-) diff --git a/go.mod b/go.mod index ccef851d..09c07fd3 100644 --- a/go.mod +++ b/go.mod @@ -6,20 +6,20 @@ require ( github.com/VictoriaMetrics/metrics v1.35.1 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.8.0 - github.com/goccy/go-json v0.10.3 + github.com/goccy/go-json v0.10.4 github.com/gofrs/flock v0.12.1 github.com/gorilla/websocket v1.5.3 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.1.2 - github.com/minio/minio-go/v7 v7.0.81 - github.com/pion/ice/v4 v4.0.2 + github.com/minio/minio-go/v7 v7.0.82 + github.com/pion/ice/v4 v4.0.3 github.com/pion/interceptor v0.1.37 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.2 + github.com/pion/webrtc/v4 v4.0.6 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.33.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.29.0 + golang.org/x/crypto v0.31.0 golang.org/x/image v0.19.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -36,13 +36,13 @@ require ( github.com/minio/md5-simd v1.1.2 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect - github.com/pion/datachannel v1.5.9 // indirect + github.com/pion/datachannel v1.5.10 // indirect github.com/pion/dtls/v3 v3.0.4 // indirect github.com/pion/mdns/v2 v2.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect - github.com/pion/rtcp v1.2.14 // indirect + github.com/pion/rtcp v1.2.15 // indirect github.com/pion/rtp v1.8.9 // indirect - github.com/pion/sctp v1.8.34 // indirect + github.com/pion/sctp v1.8.35 // indirect github.com/pion/sdp/v3 v3.0.9 // indirect github.com/pion/srtp/v3 v3.0.4 // indirect github.com/pion/stun/v3 v3.0.0 // indirect @@ -52,7 +52,7 @@ require ( github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.31.0 // indirect - golang.org/x/sys v0.27.0 // indirect - golang.org/x/text v0.20.0 // indirect + golang.org/x/net v0.32.0 // indirect + golang.org/x/sys v0.28.0 // indirect + golang.org/x/text v0.21.0 // indirect ) diff --git a/go.sum b/go.sum index e56b4db7..f170316e 100644 --- a/go.sum +++ b/go.sum @@ -14,8 +14,8 @@ github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A= github.com/go-ini/ini v1.67.0/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8= github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIxtHqx8aGss= github.com/go-viper/mapstructure/v2 v2.2.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM= -github.com/goccy/go-json v0.10.3 h1:KZ5WoDbxAIgm2HNbYckL0se1fHD6rz5j4ywS6ebzDqA= -github.com/goccy/go-json v0.10.3/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M= +github.com/goccy/go-json v0.10.4 h1:JSwxQzIqKfmFX1swYPpUThQZp/Ka4wzJdK0LWVytLPM= +github.com/goccy/go-json v0.10.4/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M= github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= github.com/gofrs/flock v0.12.1 h1:MTLVXXHf8ekldpJk3AKicLij9MdwOWkZ+a/jHHZby9E= github.com/gofrs/flock v0.12.1/go.mod h1:9zxTsyu5xtJ9DK+1tFZyibEV7y3uwDxPPfbxeeHCoD0= @@ -44,18 +44,18 @@ github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWE github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.81 h1:SzhMN0TQ6T/xSBu6Nvw3M5M8voM+Ht8RH3hE8S7zxaA= -github.com/minio/minio-go/v7 v7.0.81/go.mod h1:84gmIilaX4zcvAWWzJ5Z1WI5axN+hAbM5w25xf8xvC0= +github.com/minio/minio-go/v7 v7.0.82 h1:tWfICLhmp2aFPXL8Tli0XDTHj2VB/fNf0PC1f/i1gRo= +github.com/minio/minio-go/v7 v7.0.82/go.mod h1:84gmIilaX4zcvAWWzJ5Z1WI5axN+hAbM5w25xf8xvC0= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= -github.com/pion/datachannel v1.5.9 h1:LpIWAOYPyDrXtU+BW7X0Yt/vGtYxtXQ8ql7dFfYUVZA= -github.com/pion/datachannel v1.5.9/go.mod h1:kDUuk4CU4Uxp82NH4LQZbISULkX/HtzKa4P7ldf9izE= +github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk4o= +github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= github.com/pion/dtls/v3 v3.0.4 h1:44CZekewMzfrn9pmGrj5BNnTMDCFwr+6sLH+cCuLM7U= github.com/pion/dtls/v3 v3.0.4/go.mod h1:R373CsjxWqNPf6MEkfdy3aSe9niZvL/JaKlGeFphtMg= -github.com/pion/ice/v4 v4.0.2 h1:1JhBRX8iQLi0+TfcavTjPjI6GO41MFn4CeTBX+Y9h5s= -github.com/pion/ice/v4 v4.0.2/go.mod h1:DCdqyzgtsDNYN6/3U8044j3U7qsJ9KFJC92VnOWHvXg= +github.com/pion/ice/v4 v4.0.3 h1:9s5rI1WKzF5DRqhJ+Id8bls/8PzM7mau0mj1WZb4IXE= +github.com/pion/ice/v4 v4.0.3/go.mod h1:VfHy0beAZ5loDT7BmJ2LtMtC4dbawIkkkejHPRZNB3Y= github.com/pion/interceptor v0.1.37 h1:aRA8Zpab/wE7/c0O3fh1PqY0AJI3fCSEM5lRWJVorwI= github.com/pion/interceptor v0.1.37/go.mod h1:JzxbJ4umVTlZAf+/utHzNesY8tmRkM2lVmkS82TTj8Y= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= @@ -64,12 +64,12 @@ github.com/pion/mdns/v2 v2.0.7 h1:c9kM8ewCgjslaAmicYMFQIde2H9/lrZpjBkN8VwoVtM= github.com/pion/mdns/v2 v2.0.7/go.mod h1:vAdSYNAT0Jy3Ru0zl2YiW3Rm/fJCwIeM0nToenfOJKA= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= -github.com/pion/rtcp v1.2.14 h1:KCkGV3vJ+4DAJmvP0vaQShsb0xkRfWkO540Gy102KyE= -github.com/pion/rtcp v1.2.14/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9L4= +github.com/pion/rtcp v1.2.15 h1:LZQi2JbdipLOj4eBjK4wlVoQWfrZbh3Q6eHtWtJBZBo= +github.com/pion/rtcp v1.2.15/go.mod h1:jlGuAjHMEXwMUHK78RgX0UmEJFV4zUKOFHR7OP+D3D0= github.com/pion/rtp v1.8.9 h1:E2HX740TZKaqdcPmf4pw6ZZuG8u5RlMMt+l3dxeu6Wk= github.com/pion/rtp v1.8.9/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= -github.com/pion/sctp v1.8.34 h1:rCuD3m53i0oGxCSp7FLQKvqVx0Nf5AUAHhMRXTTQjBc= -github.com/pion/sctp v1.8.34/go.mod h1:yWkCClkXlzVW7BXfI2PjrUGBwUI0CjXJBkhLt+sdo4U= +github.com/pion/sctp v1.8.35 h1:qwtKvNK1Wc5tHMIYgTDJhfZk7vATGVHhXbUDfHbYwzA= +github.com/pion/sctp v1.8.35/go.mod h1:EcXP8zCYVTRy3W9xtOF7wJm1L1aXfKRQzaM33SjQlzg= github.com/pion/sdp/v3 v3.0.9 h1:pX++dCHoHUwq43kuwf3PyJfHlwIj4hXA7Vrifiq0IJY= github.com/pion/sdp/v3 v3.0.9/go.mod h1:B5xmvENq5IXJimIO4zfp6LAe1fD9N+kFv+V/1lOdz8M= github.com/pion/srtp/v3 v3.0.4 h1:2Z6vDVxzrX3UHEgrUyIGM4rRouoC7v+NiF1IHtp9B5M= @@ -80,8 +80,8 @@ github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1 github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= github.com/pion/turn/v4 v4.0.0 h1:qxplo3Rxa9Yg1xXDxxH8xaqcyGUtbHYw4QSCvmFWvhM= github.com/pion/turn/v4 v4.0.0/go.mod h1:MuPDkm15nYSklKpN8vWJ9W2M0PlyQZqYt1McGuxG7mA= -github.com/pion/webrtc/v4 v4.0.2 h1:fBwm5/hqSUybrCWl0DDBSTDrpbkcgkqpeLmXw9CsBQA= -github.com/pion/webrtc/v4 v4.0.2/go.mod h1:moylBT2A4dNoEaYBCdV1nThM3TLwRHzWszIG+eSPaqQ= +github.com/pion/webrtc/v4 v4.0.6 h1:OfxfGeZGhneUDnZEoebLGDkzwjowSJ0avbOu2xaIUeM= +github.com/pion/webrtc/v4 v4.0.6/go.mod h1:j7oMHYvjl7lESJ/nYiE4d2URyjFbAo3uqJ6Xse6hbSg= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -99,8 +99,9 @@ github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/ github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= -github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg= github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= +github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA= +github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= @@ -109,19 +110,19 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.29.0 h1:L5SG1JTTXupVV3n6sUqMTeWbjAyfPwoda2DLX8J8FrQ= -golang.org/x/crypto v0.29.0/go.mod h1:+F4F4N5hv6v38hfeYwTdx20oUvLLc+QfrE9Ax9HtgRg= +golang.org/x/crypto v0.31.0 h1:ihbySMvVjLAeSH1IbfcRTkD/iNscyz8rGzjF/E5hV6U= +golang.org/x/crypto v0.31.0/go.mod h1:kDsLvtWBEx7MV9tJOj9bnXsPbxwJQ6csT/x4KIN4Ssk= golang.org/x/image v0.19.0 h1:D9FX4QWkLfkeqaC62SonffIIuYdOk/UE2XKUBgRIBIQ= golang.org/x/image v0.19.0/go.mod h1:y0zrRqlQRWQ5PXaYCOMLTW2fpsxZ8Qh9I/ohnInJEys= -golang.org/x/net v0.31.0 h1:68CPQngjLL0r2AlUKiSxtQFKvzRVbnzLwMUn5SzcLHo= -golang.org/x/net v0.31.0/go.mod h1:P4fl1q7dY2hnZFxEk4pPSkDHF+QqjitcnDjUQyMM+pM= +golang.org/x/net v0.32.0 h1:ZqPmj8Kzc+Y6e0+skZsuACbx+wzMgo5MQsJh9Qd6aYI= +golang.org/x/net v0.32.0/go.mod h1:CwU0IoeOlnQQWJ6ioyFrfRuomB8GKF6KbYXZVyeXNfs= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.27.0 h1:wBqf8DvsY9Y/2P8gAfPDEYNuS30J4lPHJxXSb/nJZ+s= -golang.org/x/sys v0.27.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= -golang.org/x/text v0.20.0 h1:gK/Kv2otX8gz+wn7Rmb3vT96ZwuoxnQlY+HlJVj7Qug= -golang.org/x/text v0.20.0/go.mod h1:D4IsuqiFMhST5bX19pQ9ikHC2GsaKyk/oF+pn3ducp4= +golang.org/x/sys v0.28.0 h1:Fksou7UEQUWlKvIdsqzJmUmCX3cZuD2+P3XyyzwMhlA= +golang.org/x/sys v0.28.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo= +golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= From 4aaeda3fbb2deab822d714c5fa883333fdf289fc Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 16 Dec 2024 23:28:14 +0300 Subject: [PATCH 300/361] Move some RETRO_ENVIRONMENT vars into C --- pkg/worker/caged/libretro/nanoarch/nanoarch.c | 35 ++++++++++++++++--- .../caged/libretro/nanoarch/nanoarch.go | 29 ++------------- pkg/worker/caged/libretro/nanoarch/nanoarch.h | 1 - 3 files changed, 33 insertions(+), 32 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.c b/pkg/worker/caged/libretro/nanoarch/nanoarch.c index 2bbd1883..cb474d98 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.c +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.c @@ -4,6 +4,8 @@ #include #include +#define RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB (3 | 0x800000) + int initialized = 0; typedef struct { @@ -127,16 +129,41 @@ static bool clear_all_thread_waits_cb(unsigned v, void *data) { return true; } -void bridge_clear_all_thread_waits_cb(void *data) { - *(retro_environment_t *)data = clear_all_thread_waits_cb; -} - void bridge_retro_keyboard_callback(void *cb, bool down, unsigned keycode, uint32_t character, uint16_t keyModifiers) { (*(retro_keyboard_event_t *) cb)(down, keycode, character, keyModifiers); } bool core_environment_cgo(unsigned cmd, void *data) { bool coreEnvironment(unsigned, void *); + + switch (cmd) + { + case RETRO_ENVIRONMENT_GET_VARIABLE_UPDATE: + return false; + break; + case RETRO_ENVIRONMENT_GET_AUDIO_VIDEO_ENABLE: + return false; + break; + case RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB: + *(retro_environment_t *)data = clear_all_thread_waits_cb; + return true; + break; + case RETRO_ENVIRONMENT_GET_INPUT_MAX_USERS: + *(unsigned *)data = 4; + core_log_cgo(RETRO_LOG_DEBUG, "Set max users: %d\n", 4); + return true; + break; + case RETRO_ENVIRONMENT_GET_INPUT_BITMASKS: + return false; + case RETRO_ENVIRONMENT_SHUTDOWN: + return false; + break; + case RETRO_ENVIRONMENT_GET_SAVESTATE_CONTEXT: + if (data != NULL) *(int *)data = RETRO_SAVESTATE_CONTEXT_NORMAL; + return true; + break; + } + return coreEnvironment(cmd, data); } diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 9d8447a0..40b3c231 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -23,8 +23,6 @@ import ( #include "libretro.h" #include "nanoarch.h" #include - -#define RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB (3 | 0x800000) */ import "C" @@ -771,13 +769,8 @@ func coreGetProcAddress(sym *C.char) C.retro_proc_address_t { //export coreEnvironment func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { - // spammy - switch cmd { - case C.RETRO_ENVIRONMENT_GET_VARIABLE_UPDATE: - return false - case C.RETRO_ENVIRONMENT_GET_AUDIO_VIDEO_ENABLE: - return false - } + + // see core_environment_cgo switch cmd { case C.RETRO_ENVIRONMENT_SET_SYSTEM_AV_INFO: @@ -829,9 +822,6 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { return true } return false - case C.RETRO_ENVIRONMENT_SHUTDOWN: - //window.SetShouldClose(true) - return false case C.RETRO_ENVIRONMENT_GET_VARIABLE: if Nan0.options == nil { return false @@ -884,25 +874,10 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { //Nan0.log.Debug().Msgf("%v", cInfo.String()) } return true - case C.RETRO_ENVIRONMENT_GET_INPUT_MAX_USERS: - *(*C.unsigned)(data) = C.unsigned(4) - Nan0.log.Debug().Msgf("Set max users: %v", 4) - return true case C.RETRO_ENVIRONMENT_SET_KEYBOARD_CALLBACK: Nan0.log.Debug().Msgf("Keyboard event callback was set") Nan0.keyboardCb = (*C.struct_retro_keyboard_callback)(data) return true - case C.RETRO_ENVIRONMENT_GET_INPUT_BITMASKS: - Nan0.log.Debug().Msgf("Set input bitmasks: false") - return false - case C.RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB: - C.bridge_clear_all_thread_waits_cb(data) - return true - case C.RETRO_ENVIRONMENT_GET_SAVESTATE_CONTEXT: - if ctx := (*C.int)(data); ctx != nil { - *ctx = C.RETRO_SAVESTATE_CONTEXT_NORMAL - } - return true } return false } diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.h b/pkg/worker/caged/libretro/nanoarch/nanoarch.h index c1e09462..1ad85f08 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.h +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.h @@ -23,7 +23,6 @@ void bridge_retro_set_controller_port_device(void *f, unsigned port, unsigned de void bridge_retro_set_input_poll(void *f, void *callback); void bridge_retro_set_input_state(void *f, void *callback); void bridge_retro_set_video_refresh(void *f, void *callback); -void bridge_clear_all_thread_waits_cb(void *f); void bridge_retro_keyboard_callback(void *f, bool down, unsigned keycode, uint32_t character, uint16_t keyModifiers); bool core_environment_cgo(unsigned cmd, void *data); From 535e725618a99ca2953f19bc23c24fd1619014b8 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 19 Dec 2024 21:40:14 +0300 Subject: [PATCH 301/361] Panic when dlib functions are missing --- pkg/worker/caged/libretro/nanoarch/loader.go | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/pkg/worker/caged/libretro/nanoarch/loader.go b/pkg/worker/caged/libretro/nanoarch/loader.go index 274a1a8d..d7d0c662 100644 --- a/pkg/worker/caged/libretro/nanoarch/loader.go +++ b/pkg/worker/caged/libretro/nanoarch/loader.go @@ -19,7 +19,11 @@ import "C" func loadFunction(handle unsafe.Pointer, name string) unsafe.Pointer { cs := C.CString(name) defer C.free(unsafe.Pointer(cs)) - return C.dlsym(handle, cs) + ptr := C.dlsym(handle, cs) + if ptr == nil { + panic("lib function not found: " + name) + } + return ptr } func loadLib(filepath string) (handle unsafe.Pointer, err error) { From f78bcf3e4b50aec52b09ebc278972f43b85c436d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 20 Dec 2024 01:32:20 +0300 Subject: [PATCH 302/361] Allow config for the remote Libretro core repos --- pkg/config/config.yaml | 26 ++++++++ pkg/config/emulator.go | 39 +++++++++-- pkg/worker/caged/libretro/frontend.go | 9 +++ pkg/worker/caged/libretro/frontend_test.go | 8 +++ pkg/worker/caged/libretro/manager/http.go | 24 ++++--- .../caged/libretro/manager/repository.go | 65 +++++++++++++++++++ .../caged/libretro/manager/repository_test.go | 61 +++++++++++++++++ .../caged/libretro/nanoarch/nanoarch.go | 18 ++--- pkg/worker/caged/libretro/repo/arch/arch.go | 39 ----------- .../libretro/repo/buildbot/repository.go | 34 ---------- .../libretro/repo/buildbot/repository_test.go | 55 ---------------- .../caged/libretro/repo/github/repository.go | 18 ----- .../libretro/repo/github/repository_test.go | 55 ---------------- .../caged/libretro/repo/raw/repository.go | 14 ---- pkg/worker/caged/libretro/repo/repository.go | 36 ---------- 15 files changed, 219 insertions(+), 282 deletions(-) create mode 100644 pkg/worker/caged/libretro/manager/repository.go create mode 100644 pkg/worker/caged/libretro/manager/repository_test.go delete mode 100644 pkg/worker/caged/libretro/repo/arch/arch.go delete mode 100644 pkg/worker/caged/libretro/repo/buildbot/repository.go delete mode 100644 pkg/worker/caged/libretro/repo/buildbot/repository_test.go delete mode 100644 pkg/worker/caged/libretro/repo/github/repository.go delete mode 100644 pkg/worker/caged/libretro/repo/github/repository_test.go delete mode 100644 pkg/worker/caged/libretro/repo/raw/repository.go delete mode 100644 pkg/worker/caged/libretro/repo/repository.go diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 9c1ee1aa..33eb0b2a 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -160,6 +160,32 @@ emulator: sync: true # external cross-process mutex lock extLock: "{user}/.cr/cloud-game.lock" + map: + darwin: + amd64: + arch: x86_64 + ext: .dylib + os: osx + vendor: apple + arm64: + arch: arm64 + ext: .dylib + os: osx + vendor: apple + linux: + amd64: + arch: x86_64 + ext: .so + os: linux + arm: + arch: armv7-neon-hf + ext: .so + os: linux + windows: + amd64: + arch: x86_64 + ext: .dll + os: windows main: type: buildbot url: https://buildbot.libretro.com/nightly diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index 21c5b2ad..d3daca3e 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -1,8 +1,10 @@ package config import ( + "errors" "path" "path/filepath" + "runtime" "strings" ) @@ -19,12 +21,7 @@ type LibretroConfig struct { Paths struct { Libs string } - Repo struct { - Sync bool - ExtLock string - Main LibretroRepoConfig - Secondary LibretroRepoConfig - } + Repo LibretroRemoteRepo List map[string]LibretroCoreConfig } DebounceMs int @@ -33,12 +30,42 @@ type LibretroConfig struct { LogLevel int } +type LibretroRemoteRepo struct { + Sync bool + ExtLock string + Map map[string]map[string]LibretroRepoMapInfo + Main LibretroRepoConfig + Secondary LibretroRepoConfig +} + +// LibretroRepoMapInfo contains Libretro core lib platform info. +// And the cores are just C-compiled libraries. +// See: https://buildbot.libretro.com/nightly. +type LibretroRepoMapInfo struct { + Arch string // bottom: x86_64, x86, ... + Ext string // platform dependent library file extension (dot-prefixed) + Os string // middle: windows, ios, ... + Vendor string // top level: apple, nintendo, ... +} + type LibretroRepoConfig struct { Type string Url string Compression string } +// Guess tries to map OS + CPU architecture to the corresponding remote URL path. +// See: https://gist.github.com/asukakenji/f15ba7e588ac42795f421b48b8aede63. +func (lrp LibretroRemoteRepo) Guess() (LibretroRepoMapInfo, error) { + if os, ok := lrp.Map[runtime.GOOS]; ok { + if arch, ok2 := os[runtime.GOARCH]; ok2 { + return arch, nil + } + } + return LibretroRepoMapInfo{}, + errors.New("core mapping not found for " + runtime.GOOS + ":" + runtime.GOARCH) +} + type LibretroCoreConfig struct { AltRepo bool AutoGlContext bool // hack: keep it here to pass it down the emulator diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 341038a4..c3666e98 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -142,6 +142,14 @@ func NewFrontend(conf config.Emulator, log *logger.Logger) (*Frontend, error) { func (f *Frontend) LoadCore(emu string) { conf := f.conf.GetLibretroCoreConfig(emu) + + libExt := "" + if ar, err := f.conf.Libretro.Cores.Repo.Guess(); err == nil { + libExt = ar.Ext + } else { + f.log.Warn().Err(err).Msg("system arch guesser failed") + } + meta := nanoarch.Metadata{ AutoGlContext: conf.AutoGlContext, FrameDup: f.conf.Libretro.Dup, @@ -155,6 +163,7 @@ func (f *Frontend) LoadCore(emu string) { UsesLibCo: conf.UsesLibCo, CoreAspectRatio: conf.CoreAspectRatio, KbMouseSupport: conf.KbMouseSupport, + LibExt: libExt, } f.mu.Lock() f.SaveStateFs = conf.SaveStateFs diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index e4c4105c..f2b108ee 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -26,6 +26,7 @@ type TestFrontend struct { *Frontend corePath string + coreExt string gamePath string system string } @@ -78,6 +79,11 @@ func EmulatorMock(room string, system string) *TestFrontend { nano := nanoarch.NewNano(conf.Emulator.LocalPath) nano.SetLogger(l2) + arch, err := conf.Emulator.Libretro.Cores.Repo.Guess() + if err != nil { + panic(err) + } + // an emu emu := &TestFrontend{ Frontend: &Frontend{ @@ -92,6 +98,7 @@ func EmulatorMock(room string, system string) *TestFrontend { SaveOnClose: false, }, corePath: expand(conf.Emulator.GetLibretroCoreConfig(system).Lib), + coreExt: arch.Ext, gamePath: expand(conf.Library.BasePath), system: system, } @@ -133,6 +140,7 @@ func (emu *TestFrontend) loadRom(game string) { Options4rom: conf.Options4rom, UsesLibCo: conf.UsesLibCo, CoreAspectRatio: conf.CoreAspectRatio, + LibExt: emu.coreExt, } emu.nano.CoreLoad(meta) diff --git a/pkg/worker/caged/libretro/manager/http.go b/pkg/worker/caged/libretro/manager/http.go index 308677a4..ff57a2de 100644 --- a/pkg/worker/caged/libretro/manager/http.go +++ b/pkg/worker/caged/libretro/manager/http.go @@ -4,16 +4,14 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" ) type Manager struct { BasicManager - arch arch.Info - repo repo.Repository - altRepo repo.Repository + arch ArchInfo + repo Repository + altRepo Repository client Downloader fmu *os.Flock log *logger.Logger @@ -29,24 +27,24 @@ func NewRemoteHttpManager(conf config.LibretroConfig, log *logger.Logger) Manage log.Error().Err(err).Msgf("couldn't make file lock") } - ar, err := arch.Guess() + arch, err := conf.Cores.Repo.Guess() if err != nil { log.Error().Err(err).Msg("couldn't get Libretro core file extension") } m := Manager{ BasicManager: BasicManager{Conf: conf}, - arch: ar, + arch: ArchInfo(arch), client: NewDefaultDownloader(log), fmu: flock, log: log, } if repoConf.Type != "" { - m.repo = repo.New(repoConf.Type, repoConf.Url, repoConf.Compression, "buildbot") + m.repo = NewRepo(repoConf.Type, repoConf.Url, repoConf.Compression, "buildbot") } if altRepoConf.Type != "" { - m.altRepo = repo.New(altRepoConf.Type, altRepoConf.Url, altRepoConf.Compression, "") + m.altRepo = NewRepo(altRepoConf.Type, altRepoConf.Url, altRepoConf.Compression, "") } return m @@ -81,7 +79,7 @@ func (m *Manager) Sync() error { } }() - installed, err := m.GetInstalled(m.arch.LibExt) + installed, err := m.GetInstalled(m.arch.Ext) if err != nil { return err } @@ -92,9 +90,9 @@ func (m *Manager) Sync() error { return nil } -func (m *Manager) getCoreUrls(names []string, repo repo.Repository) (urls []Download) { +func (m *Manager) getCoreUrls(names []string, repo Repository) (urls []Download) { for _, c := range names { - urls = append(urls, Download{Key: c, Address: repo.GetCoreUrl(c, m.arch)}) + urls = append(urls, Download{Key: c, Address: repo.CoreUrl(c, m.arch)}) } return } @@ -137,7 +135,7 @@ func (m *Manager) download(cores []config.CoreInfo) (failed []string) { return } -func (m *Manager) down(cores []string, repo repo.Repository) (failed []string) { +func (m *Manager) down(cores []string, repo Repository) (failed []string) { if len(cores) == 0 || repo == nil { return } diff --git a/pkg/worker/caged/libretro/manager/repository.go b/pkg/worker/caged/libretro/manager/repository.go new file mode 100644 index 00000000..3dbe0686 --- /dev/null +++ b/pkg/worker/caged/libretro/manager/repository.go @@ -0,0 +1,65 @@ +package manager + +import "strings" + +type ArchInfo struct { + Arch string + Ext string + Os string + Vendor string +} + +type Data struct { + Url string + Compression string +} + +type Repository interface { + CoreUrl(file string, info ArchInfo) (url string) +} + +// Repo defines a simple zip file containing all the cores that will be extracted as is. +type Repo struct { + Address string + Compression string +} + +func (r Repo) CoreUrl(_ string, _ ArchInfo) string { return r.Address } + +type Buildbot struct{ Repo } + +func (r Buildbot) CoreUrl(file string, info ArchInfo) string { + var sb strings.Builder + sb.WriteString(r.Address + "/") + if info.Vendor != "" { + sb.WriteString(info.Vendor + "/") + } + sb.WriteString(info.Os + "/" + info.Arch + "/latest/" + file + info.Ext) + if r.Compression != "" { + sb.WriteString("." + r.Compression) + } + return sb.String() +} + +type Github struct{ Buildbot } + +func (r Github) CoreUrl(file string, info ArchInfo) string { + return r.Buildbot.CoreUrl(file, info) + "?raw=true" +} + +func NewRepo(kind string, url string, compression string, defaultRepo string) Repository { + var repository Repository + switch kind { + case "buildbot": + repository = Buildbot{Repo{Address: url, Compression: compression}} + case "github": + repository = Github{Buildbot{Repo{Address: url, Compression: compression}}} + case "raw": + repository = Repo{Address: url, Compression: "zip"} + default: + if defaultRepo != "" { + repository = NewRepo(defaultRepo, url, compression, "") + } + } + return repository +} diff --git a/pkg/worker/caged/libretro/manager/repository_test.go b/pkg/worker/caged/libretro/manager/repository_test.go new file mode 100644 index 00000000..bff2c16a --- /dev/null +++ b/pkg/worker/caged/libretro/manager/repository_test.go @@ -0,0 +1,61 @@ +package manager + +import "testing" + +func TestCoreUrl(t *testing.T) { + testAddress := "https://test.me" + tests := []struct { + arch ArchInfo + compress string + f string + repo string + result string + }{ + { + arch: ArchInfo{Arch: "x86_64", Ext: ".so", Os: "linux"}, + f: "uber_core", + repo: "buildbot", + result: testAddress + "/" + "linux/x86_64/latest/uber_core.so", + }, + { + arch: ArchInfo{Arch: "x86_64", Ext: ".so", Os: "linux"}, + compress: "zip", + f: "uber_core", + repo: "buildbot", + result: testAddress + "/" + "linux/x86_64/latest/uber_core.so.zip", + }, + { + arch: ArchInfo{Arch: "x86_64", Ext: ".dylib", Os: "osx", Vendor: "apple"}, + f: "uber_core", + repo: "buildbot", + result: testAddress + "/" + "apple/osx/x86_64/latest/uber_core.dylib", + }, + { + arch: ArchInfo{Os: "linux", Arch: "x86_64", Ext: ".so"}, + f: "uber_core", + repo: "github", + result: testAddress + "/" + "linux/x86_64/latest/uber_core.so?raw=true", + }, + { + arch: ArchInfo{Os: "linux", Arch: "x86_64", Ext: ".so"}, + compress: "zip", + f: "uber_core", + repo: "github", + result: testAddress + "/" + "linux/x86_64/latest/uber_core.so.zip?raw=true", + }, + { + arch: ArchInfo{Os: "osx", Arch: "x86_64", Vendor: "apple", Ext: ".dylib"}, + f: "uber_core", + repo: "github", + result: testAddress + "/" + "apple/osx/x86_64/latest/uber_core.dylib?raw=true", + }, + } + + for _, test := range tests { + r := NewRepo(test.repo, testAddress, test.compress, "") + url := r.CoreUrl(test.f, test.arch) + if url != test.result { + t.Errorf("seems that expected link address is incorrect (%v) for file %s %+v", url, test.f, test.arch) + } + } +} diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 40b3c231..1748ec15 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -15,7 +15,6 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/graphics" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" "github.com/giongto35/cloud-game/v3/pkg/worker/thread" ) @@ -100,6 +99,7 @@ type Metadata struct { Hid map[int][]int CoreAspectRatio bool KbMouseSupport bool + LibExt string } type PixFmt struct { @@ -200,20 +200,14 @@ func (n *Nanoarch) CoreLoad(meta Metadata) { n.options = maps.Clone(meta.Options) n.options4rom = meta.Options4rom - filePath := meta.LibPath - if ar, err := arch.Guess(); err == nil { - filePath = filePath + ar.LibExt - } else { - n.log.Warn().Err(err).Msg("system arch guesser failed") - } - - coreLib, err = loadLib(filePath) + corePath := meta.LibPath + meta.LibExt + coreLib, err = loadLib(corePath) // fallback to sequential lib loader (first successfully loaded) if err != nil { - n.log.Error().Err(err).Msgf("load fail: %v", filePath) - coreLib, err = loadLibRollingRollingRolling(filePath) + n.log.Error().Err(err).Msgf("load fail: %v", corePath) + coreLib, err = loadLibRollingRollingRolling(corePath) if err != nil { - n.log.Fatal().Err(err).Msgf("core load: %s", filePath) + n.log.Fatal().Err(err).Msgf("core load: %s", corePath) } } diff --git a/pkg/worker/caged/libretro/repo/arch/arch.go b/pkg/worker/caged/libretro/repo/arch/arch.go deleted file mode 100644 index 16e5a88d..00000000 --- a/pkg/worker/caged/libretro/repo/arch/arch.go +++ /dev/null @@ -1,39 +0,0 @@ -package arch - -import ( - "errors" - "runtime" -) - -// See: https://gist.github.com/asukakenji/f15ba7e588ac42795f421b48b8aede63. -var libretroOsArchMap = map[string]Info{ - "linux:amd64": {Os: "linux", Arch: "x86_64", LibExt: ".so"}, - "linux:arm": {Os: "linux", Arch: "armv7-neon-hf", LibExt: ".so"}, - "windows:amd64": {Os: "windows", Arch: "x86_64", LibExt: ".dll"}, - "darwin:amd64": {Os: "osx", Arch: "x86_64", Vendor: "apple", LibExt: ".dylib"}, - "darwin:arm64": {Os: "osx", Arch: "arm64", Vendor: "apple", LibExt: ".dylib"}, -} - -// Info contains Libretro core lib platform info. -// And cores are just C-compiled libraries. -// See: https://buildbot.libretro.com/nightly. -type Info struct { - // bottom: x86_64, x86, ... - Arch string - // middle: windows, ios, ... - Os string - // top level: apple, nintendo, ... - Vendor string - - // platform dependent library file extension (dot-prefixed) - LibExt string -} - -func Guess() (Info, error) { - key := runtime.GOOS + ":" + runtime.GOARCH - if arch, ok := libretroOsArchMap[key]; ok { - return arch, nil - } else { - return Info{}, errors.New("core mapping not found for " + key) - } -} diff --git a/pkg/worker/caged/libretro/repo/buildbot/repository.go b/pkg/worker/caged/libretro/repo/buildbot/repository.go deleted file mode 100644 index 44bdcd1b..00000000 --- a/pkg/worker/caged/libretro/repo/buildbot/repository.go +++ /dev/null @@ -1,34 +0,0 @@ -package buildbot - -import ( - "strings" - - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/raw" -) - -type RepoBuildbot struct { - raw.Repo -} - -func NewBuildbotRepo(address string, compression string) RepoBuildbot { - return RepoBuildbot{ - Repo: raw.Repo{ - Address: address, - Compression: compression, - }, - } -} - -func (r RepoBuildbot) GetCoreUrl(file string, info arch.Info) string { - var sb strings.Builder - sb.WriteString(r.Address + "/") - if info.Vendor != "" { - sb.WriteString(info.Vendor + "/") - } - sb.WriteString(info.Os + "/" + info.Arch + "/latest/" + file + info.LibExt) - if r.Compression != "" { - sb.WriteString("." + r.Compression) - } - return sb.String() -} diff --git a/pkg/worker/caged/libretro/repo/buildbot/repository_test.go b/pkg/worker/caged/libretro/repo/buildbot/repository_test.go deleted file mode 100644 index 5aa007b9..00000000 --- a/pkg/worker/caged/libretro/repo/buildbot/repository_test.go +++ /dev/null @@ -1,55 +0,0 @@ -package buildbot - -import ( - "testing" - - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" -) - -func TestBuildbotRepo(t *testing.T) { - testAddress := "https://test.me" - tests := []struct { - file string - compression string - arch arch.Info - resultUrl string - }{ - { - file: "uber_core", - arch: arch.Info{ - Os: "linux", - Arch: "x86_64", - LibExt: ".so", - }, - resultUrl: testAddress + "/" + "linux/x86_64/latest/uber_core.so", - }, - { - file: "uber_core", - compression: "zip", - arch: arch.Info{ - Os: "linux", - Arch: "x86_64", - LibExt: ".so", - }, - resultUrl: testAddress + "/" + "linux/x86_64/latest/uber_core.so.zip", - }, - { - file: "uber_core", - arch: arch.Info{ - Os: "osx", - Arch: "x86_64", - Vendor: "apple", - LibExt: ".dylib", - }, - resultUrl: testAddress + "/" + "apple/osx/x86_64/latest/uber_core.dylib", - }, - } - - for _, test := range tests { - rep := NewBuildbotRepo(testAddress, test.compression) - url := rep.GetCoreUrl(test.file, test.arch) - if url != test.resultUrl { - t.Errorf("seems that expected link address is incorrect (%v) for file %s %+v", url, test.file, test.arch) - } - } -} diff --git a/pkg/worker/caged/libretro/repo/github/repository.go b/pkg/worker/caged/libretro/repo/github/repository.go deleted file mode 100644 index 532c02f0..00000000 --- a/pkg/worker/caged/libretro/repo/github/repository.go +++ /dev/null @@ -1,18 +0,0 @@ -package github - -import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/buildbot" -) - -type RepoGithub struct { - buildbot.RepoBuildbot -} - -func NewGithubRepo(address string, compression string) RepoGithub { - return RepoGithub{RepoBuildbot: buildbot.NewBuildbotRepo(address, compression)} -} - -func (r RepoGithub) GetCoreUrl(file string, info arch.Info) string { - return r.RepoBuildbot.GetCoreUrl(file, info) + "?raw=true" -} diff --git a/pkg/worker/caged/libretro/repo/github/repository_test.go b/pkg/worker/caged/libretro/repo/github/repository_test.go deleted file mode 100644 index cf3a4380..00000000 --- a/pkg/worker/caged/libretro/repo/github/repository_test.go +++ /dev/null @@ -1,55 +0,0 @@ -package github - -import ( - "testing" - - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" -) - -func TestBuildbotRepo(t *testing.T) { - testAddress := "https://test.me" - tests := []struct { - file string - compression string - arch arch.Info - resultUrl string - }{ - { - file: "uber_core", - arch: arch.Info{ - Os: "linux", - Arch: "x86_64", - LibExt: ".so", - }, - resultUrl: testAddress + "/" + "linux/x86_64/latest/uber_core.so?raw=true", - }, - { - file: "uber_core", - compression: "zip", - arch: arch.Info{ - Os: "linux", - Arch: "x86_64", - LibExt: ".so", - }, - resultUrl: testAddress + "/" + "linux/x86_64/latest/uber_core.so.zip?raw=true", - }, - { - file: "uber_core", - arch: arch.Info{ - Os: "osx", - Arch: "x86_64", - Vendor: "apple", - LibExt: ".dylib", - }, - resultUrl: testAddress + "/" + "apple/osx/x86_64/latest/uber_core.dylib?raw=true", - }, - } - - for _, test := range tests { - rep := NewGithubRepo(testAddress, test.compression) - url := rep.GetCoreUrl(test.file, test.arch) - if url != test.resultUrl { - t.Errorf("seems that expected link address is incorrect (%v) for file %s %+v", url, test.file, test.arch) - } - } -} diff --git a/pkg/worker/caged/libretro/repo/raw/repository.go b/pkg/worker/caged/libretro/repo/raw/repository.go deleted file mode 100644 index 33c9056a..00000000 --- a/pkg/worker/caged/libretro/repo/raw/repository.go +++ /dev/null @@ -1,14 +0,0 @@ -package raw - -import "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" - -type Repo struct { - Address string - Compression string -} - -// NewRawRepo defines a simple zip file containing -// all the cores that will be extracted as is. -func NewRawRepo(address string) Repo { return Repo{Address: address, Compression: "zip"} } - -func (r Repo) GetCoreUrl(_ string, _ arch.Info) string { return r.Address } diff --git a/pkg/worker/caged/libretro/repo/repository.go b/pkg/worker/caged/libretro/repo/repository.go deleted file mode 100644 index e2a99c1e..00000000 --- a/pkg/worker/caged/libretro/repo/repository.go +++ /dev/null @@ -1,36 +0,0 @@ -package repo - -import ( - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/arch" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/buildbot" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/github" - "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/repo/raw" -) - -type ( - Data struct { - Url string - Compression string - } - - Repository interface { - GetCoreUrl(file string, info arch.Info) (url string) - } -) - -func New(kind string, url string, compression string, defaultRepo string) Repository { - var repository Repository - switch kind { - case "raw": - repository = raw.NewRawRepo(url) - case "github": - repository = github.NewGithubRepo(url, compression) - case "buildbot": - repository = buildbot.NewBuildbotRepo(url, compression) - default: - if defaultRepo != "" { - repository = New(defaultRepo, url, compression, "") - } - } - return repository -} From 0c768bb3d6dd55decf4ba2ee90515c4748c70a62 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 21 Dec 2024 01:37:42 +0300 Subject: [PATCH 303/361] Add some notes on recording in regards to ffconcat --- pkg/worker/caged/libretro/recording.go | 13 +------------ pkg/worker/recorder/ffmpegmux.go | 15 +++++++++++++++ pkg/worker/recorder/recorder.go | 12 ++++++++++++ 3 files changed, 28 insertions(+), 12 deletions(-) diff --git a/pkg/worker/caged/libretro/recording.go b/pkg/worker/caged/libretro/recording.go index cc4cdcdd..64734536 100644 --- a/pkg/worker/caged/libretro/recording.go +++ b/pkg/worker/caged/libretro/recording.go @@ -15,17 +15,6 @@ type RecordingFrontend struct { } func WithRecording(fe Emulator, rec bool, user string, game string, conf config.Recording, log *logger.Logger) *RecordingFrontend { - - pix := "" - switch fe.PixFormat() { - case 0: - pix = "rgb1555" - case 1: - pix = "brga" - case 2: - pix = "rgb565" - } - rr := &RecordingFrontend{Emulator: fe, rec: recorder.NewRecording( recorder.Meta{UserName: user}, log, @@ -36,7 +25,6 @@ func WithRecording(fe Emulator, rec bool, user string, game string, conf config. Zip: conf.Zip, Vsync: true, Flip: fe.Flipped(), - Pix: pix, })} rr.ToggleRecording(rec, user) return rr @@ -70,6 +58,7 @@ func (r *RecordingFrontend) LoadGame(path string) error { } r.rec.SetFramerate(float64(r.Emulator.FPS())) r.rec.SetAudioFrequency(r.Emulator.AudioSampleRate()) + r.rec.SetPixFormat(r.Emulator.PixFormat()) return nil } diff --git a/pkg/worker/recorder/ffmpegmux.go b/pkg/worker/recorder/ffmpegmux.go index 37c9df6a..ba543551 100644 --- a/pkg/worker/recorder/ffmpegmux.go +++ b/pkg/worker/recorder/ffmpegmux.go @@ -17,6 +17,21 @@ const demuxFile = "input.txt" // // !to change // +// - can't read pix_fmt from ffconcat +// - maybe change raw output to yuv420? +// - frame durations and size can change dynamically +// - or maybe merge encoded streams +// +// new: +// +// ffmpeg -f image2 -framerate 59 -video_size 384x224 -pixel_format rgb565le \ +// -i "./f%07d__384x224__768.raw" \ +// -ac 2 -channel_layout stereo -i audio.wav -b:a 192K \ +// -c:v libx264 -pix_fmt yuv420p -crf 20 \ +// output.mp4 +// +// old: +// // ffmpeg -f concat -i input.txt \ // -ac 2 -channel_layout stereo -i audio.wav \ // -b:a 192K -crf 23 -vf fps=30 -pix_fmt yuv420p \ diff --git a/pkg/worker/recorder/recorder.go b/pkg/worker/recorder/recorder.go index 5c1bf904..8082ab50 100644 --- a/pkg/worker/recorder/recorder.go +++ b/pkg/worker/recorder/recorder.go @@ -165,6 +165,18 @@ func (r *Recording) Set(enable bool, user string) { func (r *Recording) SetFramerate(fps float64) { r.opts.Fps = fps } func (r *Recording) SetAudioFrequency(fq int) { r.opts.Frequency = fq } +func (r *Recording) SetPixFormat(fmt uint32) { + pix := "" + switch fmt { + case 0: + pix = "rgb1555" + case 1: + pix = "brga" + case 2: + pix = "rgb565le" + } + r.opts.Pix = pix +} func (r *Recording) Enabled() bool { r.Lock() From b02cd5c4f0118520696c1a0ccfe2f48fa2f15769 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 4 Jan 2025 10:41:51 +0300 Subject: [PATCH 304/361] It is time to update the copyright year --- web/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/index.html b/web/index.html index c6d7378d..4bd8c591 100644 --- a/web/index.html +++ b/web/index.html @@ -104,7 +104,7 @@
{{end}}
-
Cloudretro (ɔ) 2024 +
Cloudretro (ɔ) 2025 69ff8ae From 3dbf4f9b1970decac2546319bd034577edd25f4c Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 11 Jan 2025 16:53:52 +0300 Subject: [PATCH 305/361] Update dependencies --- go.mod | 16 ++++++++-------- go.sum | 31 ++++++++++++++++--------------- 2 files changed, 24 insertions(+), 23 deletions(-) diff --git a/go.mod b/go.mod index 09c07fd3..6f973d54 100644 --- a/go.mod +++ b/go.mod @@ -11,16 +11,16 @@ require ( github.com/gorilla/websocket v1.5.3 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.1.2 - github.com/minio/minio-go/v7 v7.0.82 + github.com/minio/minio-go/v7 v7.0.83 github.com/pion/ice/v4 v4.0.3 github.com/pion/interceptor v0.1.37 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.6 + github.com/pion/webrtc/v4 v4.0.7 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.33.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.31.0 - golang.org/x/image v0.19.0 + golang.org/x/crypto v0.32.0 + golang.org/x/image v0.23.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -31,7 +31,7 @@ require ( github.com/google/uuid v1.6.0 // indirect github.com/klauspost/compress v1.17.11 // indirect github.com/klauspost/cpuid/v2 v2.2.9 // indirect - github.com/mattn/go-colorable v0.1.13 // indirect + github.com/mattn/go-colorable v0.1.14 // indirect github.com/mattn/go-isatty v0.0.20 // indirect github.com/minio/md5-simd v1.1.2 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect @@ -41,7 +41,7 @@ require ( github.com/pion/mdns/v2 v2.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.15 // indirect - github.com/pion/rtp v1.8.9 // indirect + github.com/pion/rtp v1.8.10 // indirect github.com/pion/sctp v1.8.35 // indirect github.com/pion/sdp/v3 v3.0.9 // indirect github.com/pion/srtp/v3 v3.0.4 // indirect @@ -52,7 +52,7 @@ require ( github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.32.0 // indirect - golang.org/x/sys v0.28.0 // indirect + golang.org/x/net v0.34.0 // indirect + golang.org/x/sys v0.29.0 // indirect golang.org/x/text v0.21.0 // indirect ) diff --git a/go.sum b/go.sum index f170316e..631dd4f4 100644 --- a/go.sum +++ b/go.sum @@ -36,16 +36,17 @@ github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= -github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA= github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg= +github.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIE= +github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8= github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM= github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.82 h1:tWfICLhmp2aFPXL8Tli0XDTHj2VB/fNf0PC1f/i1gRo= -github.com/minio/minio-go/v7 v7.0.82/go.mod h1:84gmIilaX4zcvAWWzJ5Z1WI5axN+hAbM5w25xf8xvC0= +github.com/minio/minio-go/v7 v7.0.83 h1:W4Kokksvlz3OKf3OqIlzDNKd4MERlC2oN8YptwJ0+GA= +github.com/minio/minio-go/v7 v7.0.83/go.mod h1:57YXpvc5l3rjPdhqNrDsvVlY0qPI6UTk1bflAe+9doY= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= @@ -66,8 +67,8 @@ github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.15 h1:LZQi2JbdipLOj4eBjK4wlVoQWfrZbh3Q6eHtWtJBZBo= github.com/pion/rtcp v1.2.15/go.mod h1:jlGuAjHMEXwMUHK78RgX0UmEJFV4zUKOFHR7OP+D3D0= -github.com/pion/rtp v1.8.9 h1:E2HX740TZKaqdcPmf4pw6ZZuG8u5RlMMt+l3dxeu6Wk= -github.com/pion/rtp v1.8.9/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= +github.com/pion/rtp v1.8.10 h1:puphjdbjPB+L+NFaVuZ5h6bt1g5q4kFIoI+r5q/g0CU= +github.com/pion/rtp v1.8.10/go.mod h1:8uMBJj32Pa1wwx8Fuv/AsFhn8jsgw+3rUC2PfoBZ8p4= github.com/pion/sctp v1.8.35 h1:qwtKvNK1Wc5tHMIYgTDJhfZk7vATGVHhXbUDfHbYwzA= github.com/pion/sctp v1.8.35/go.mod h1:EcXP8zCYVTRy3W9xtOF7wJm1L1aXfKRQzaM33SjQlzg= github.com/pion/sdp/v3 v3.0.9 h1:pX++dCHoHUwq43kuwf3PyJfHlwIj4hXA7Vrifiq0IJY= @@ -80,8 +81,8 @@ github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1 github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= github.com/pion/turn/v4 v4.0.0 h1:qxplo3Rxa9Yg1xXDxxH8xaqcyGUtbHYw4QSCvmFWvhM= github.com/pion/turn/v4 v4.0.0/go.mod h1:MuPDkm15nYSklKpN8vWJ9W2M0PlyQZqYt1McGuxG7mA= -github.com/pion/webrtc/v4 v4.0.6 h1:OfxfGeZGhneUDnZEoebLGDkzwjowSJ0avbOu2xaIUeM= -github.com/pion/webrtc/v4 v4.0.6/go.mod h1:j7oMHYvjl7lESJ/nYiE4d2URyjFbAo3uqJ6Xse6hbSg= +github.com/pion/webrtc/v4 v4.0.7 h1:aeq78uVnFZd2umXW0O9A2VFQYuS7+BZxWetQvSp2jPo= +github.com/pion/webrtc/v4 v4.0.7/go.mod h1:oFVBBVSHU3vAEwSgnk3BuKCwAUwpDwQhko1EDwyZWbU= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -110,17 +111,17 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.31.0 h1:ihbySMvVjLAeSH1IbfcRTkD/iNscyz8rGzjF/E5hV6U= -golang.org/x/crypto v0.31.0/go.mod h1:kDsLvtWBEx7MV9tJOj9bnXsPbxwJQ6csT/x4KIN4Ssk= -golang.org/x/image v0.19.0 h1:D9FX4QWkLfkeqaC62SonffIIuYdOk/UE2XKUBgRIBIQ= -golang.org/x/image v0.19.0/go.mod h1:y0zrRqlQRWQ5PXaYCOMLTW2fpsxZ8Qh9I/ohnInJEys= -golang.org/x/net v0.32.0 h1:ZqPmj8Kzc+Y6e0+skZsuACbx+wzMgo5MQsJh9Qd6aYI= -golang.org/x/net v0.32.0/go.mod h1:CwU0IoeOlnQQWJ6ioyFrfRuomB8GKF6KbYXZVyeXNfs= +golang.org/x/crypto v0.32.0 h1:euUpcYgM8WcP71gNpTqQCn6rC2t6ULUPiOzfWaXVVfc= +golang.org/x/crypto v0.32.0/go.mod h1:ZnnJkOaASj8g0AjIduWNlq2NRxL0PlBrbKVyZ6V/Ugc= +golang.org/x/image v0.23.0 h1:HseQ7c2OpPKTPVzNjG5fwJsOTCiiwS4QdsYi5XU6H68= +golang.org/x/image v0.23.0/go.mod h1:wJJBTdLfCCf3tiHa1fNxpZmUI4mmoZvwMCPP0ddoNKY= +golang.org/x/net v0.34.0 h1:Mb7Mrk043xzHgnRM88suvJFwzVrRfHEHJEl5/71CKw0= +golang.org/x/net v0.34.0/go.mod h1:di0qlW3YNM5oh6GqDGQr92MyTozJPmybPK4Ev/Gm31k= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.28.0 h1:Fksou7UEQUWlKvIdsqzJmUmCX3cZuD2+P3XyyzwMhlA= -golang.org/x/sys v0.28.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.29.0 h1:TPYlXGxvx1MGTn2GiZDhnjPA9wZzZeGKHHmKhHYvgaU= +golang.org/x/sys v0.29.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo= golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= From ffb0abe4da136eebc66939125d24a28efda67c5e Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 18 Jan 2025 19:41:21 +0300 Subject: [PATCH 306/361] Update dependencies --- go.mod | 8 ++++---- go.sum | 26 ++++++++------------------ 2 files changed, 12 insertions(+), 22 deletions(-) diff --git a/go.mod b/go.mod index 6f973d54..2a5dd1b5 100644 --- a/go.mod +++ b/go.mod @@ -12,10 +12,10 @@ require ( github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.1.2 github.com/minio/minio-go/v7 v7.0.83 - github.com/pion/ice/v4 v4.0.3 + github.com/pion/ice/v4 v4.0.5 github.com/pion/interceptor v0.1.37 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.7 + github.com/pion/webrtc/v4 v4.0.8 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.33.0 github.com/veandco/go-sdl2 v0.4.40 @@ -41,9 +41,9 @@ require ( github.com/pion/mdns/v2 v2.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.15 // indirect - github.com/pion/rtp v1.8.10 // indirect + github.com/pion/rtp v1.8.11 // indirect github.com/pion/sctp v1.8.35 // indirect - github.com/pion/sdp/v3 v3.0.9 // indirect + github.com/pion/sdp/v3 v3.0.10 // indirect github.com/pion/srtp/v3 v3.0.4 // indirect github.com/pion/stun/v3 v3.0.0 // indirect github.com/pion/transport/v3 v3.0.7 // indirect diff --git a/go.sum b/go.sum index 631dd4f4..a8564760 100644 --- a/go.sum +++ b/go.sum @@ -3,7 +3,6 @@ github.com/VictoriaMetrics/metrics v1.35.1/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsK github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= -github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= @@ -55,8 +54,8 @@ github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= github.com/pion/dtls/v3 v3.0.4 h1:44CZekewMzfrn9pmGrj5BNnTMDCFwr+6sLH+cCuLM7U= github.com/pion/dtls/v3 v3.0.4/go.mod h1:R373CsjxWqNPf6MEkfdy3aSe9niZvL/JaKlGeFphtMg= -github.com/pion/ice/v4 v4.0.3 h1:9s5rI1WKzF5DRqhJ+Id8bls/8PzM7mau0mj1WZb4IXE= -github.com/pion/ice/v4 v4.0.3/go.mod h1:VfHy0beAZ5loDT7BmJ2LtMtC4dbawIkkkejHPRZNB3Y= +github.com/pion/ice/v4 v4.0.5 h1:6awVfa1jg9YsI9/Lep4TG/o3kwS1Oayr5b8xz50ibJ8= +github.com/pion/ice/v4 v4.0.5/go.mod h1:JJaoEIxUIlGDA9gaRZbwXYqI3j6VG/QchpjX+QmwN6A= github.com/pion/interceptor v0.1.37 h1:aRA8Zpab/wE7/c0O3fh1PqY0AJI3fCSEM5lRWJVorwI= github.com/pion/interceptor v0.1.37/go.mod h1:JzxbJ4umVTlZAf+/utHzNesY8tmRkM2lVmkS82TTj8Y= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= @@ -67,12 +66,12 @@ github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.15 h1:LZQi2JbdipLOj4eBjK4wlVoQWfrZbh3Q6eHtWtJBZBo= github.com/pion/rtcp v1.2.15/go.mod h1:jlGuAjHMEXwMUHK78RgX0UmEJFV4zUKOFHR7OP+D3D0= -github.com/pion/rtp v1.8.10 h1:puphjdbjPB+L+NFaVuZ5h6bt1g5q4kFIoI+r5q/g0CU= -github.com/pion/rtp v1.8.10/go.mod h1:8uMBJj32Pa1wwx8Fuv/AsFhn8jsgw+3rUC2PfoBZ8p4= +github.com/pion/rtp v1.8.11 h1:17xjnY5WO5hgO6SD3/NTIUPvSFw/PbLsIJyz1r1yNIk= +github.com/pion/rtp v1.8.11/go.mod h1:8uMBJj32Pa1wwx8Fuv/AsFhn8jsgw+3rUC2PfoBZ8p4= github.com/pion/sctp v1.8.35 h1:qwtKvNK1Wc5tHMIYgTDJhfZk7vATGVHhXbUDfHbYwzA= github.com/pion/sctp v1.8.35/go.mod h1:EcXP8zCYVTRy3W9xtOF7wJm1L1aXfKRQzaM33SjQlzg= -github.com/pion/sdp/v3 v3.0.9 h1:pX++dCHoHUwq43kuwf3PyJfHlwIj4hXA7Vrifiq0IJY= -github.com/pion/sdp/v3 v3.0.9/go.mod h1:B5xmvENq5IXJimIO4zfp6LAe1fD9N+kFv+V/1lOdz8M= +github.com/pion/sdp/v3 v3.0.10 h1:6MChLE/1xYB+CjumMw+gZ9ufp2DPApuVSnDT8t5MIgA= +github.com/pion/sdp/v3 v3.0.10/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= github.com/pion/srtp/v3 v3.0.4 h1:2Z6vDVxzrX3UHEgrUyIGM4rRouoC7v+NiF1IHtp9B5M= github.com/pion/srtp/v3 v3.0.4/go.mod h1:1Jx3FwDoxpRaTh1oRV8A/6G1BnFL+QI82eK4ms8EEJQ= github.com/pion/stun/v3 v3.0.0 h1:4h1gwhWLWuZWOJIJR9s2ferRO+W3zA/b6ijOI6mKzUw= @@ -81,8 +80,8 @@ github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1 github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= github.com/pion/turn/v4 v4.0.0 h1:qxplo3Rxa9Yg1xXDxxH8xaqcyGUtbHYw4QSCvmFWvhM= github.com/pion/turn/v4 v4.0.0/go.mod h1:MuPDkm15nYSklKpN8vWJ9W2M0PlyQZqYt1McGuxG7mA= -github.com/pion/webrtc/v4 v4.0.7 h1:aeq78uVnFZd2umXW0O9A2VFQYuS7+BZxWetQvSp2jPo= -github.com/pion/webrtc/v4 v4.0.7/go.mod h1:oFVBBVSHU3vAEwSgnk3BuKCwAUwpDwQhko1EDwyZWbU= +github.com/pion/webrtc/v4 v4.0.8 h1:T1ZmnT9qxIJIt4d8XoiMOBrTClGHDDXNg9e/fh018Qc= +github.com/pion/webrtc/v4 v4.0.8/go.mod h1:HHBeUVBAC+j4ZFnYhovEFStF02Arb1EyD4G7e7HBTJw= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -93,14 +92,6 @@ github.com/rs/xid v1.6.0 h1:fV591PaemRlL6JfRxGDEPl69wICngIQ3shQtzfy2gxU= github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0= github.com/rs/zerolog v1.33.0 h1:1cU2KZkvPxNyfgEmhHAz/1A9Bz+llsdYzklWFzgp0r8= github.com/rs/zerolog v1.33.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss= -github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= -github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= -github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= -github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA= -github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= -github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= -github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= -github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA= github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= @@ -127,6 +118,5 @@ golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= -gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= From 15ff2f3282867bffcbf90bdd5a60f493361da23f Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Wed, 12 Feb 2025 14:17:43 +0300 Subject: [PATCH 307/361] Update Go to 1.24.0 --- Dockerfile | 2 +- go.mod | 20 ++++++++++---------- go.sum | 40 ++++++++++++++++++++-------------------- 3 files changed, 31 insertions(+), 31 deletions(-) diff --git a/Dockerfile b/Dockerfile index f00b2ac3..8545a1b0 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:oracular AS build0 -ARG GO=1.23.3 +ARG GO=1.24.0 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ diff --git a/go.mod b/go.mod index 2a5dd1b5..68dfe632 100644 --- a/go.mod +++ b/go.mod @@ -3,23 +3,23 @@ module github.com/giongto35/cloud-game/v3 go 1.22 require ( - github.com/VictoriaMetrics/metrics v1.35.1 + github.com/VictoriaMetrics/metrics v1.35.2 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.8.0 - github.com/goccy/go-json v0.10.4 + github.com/goccy/go-json v0.10.5 github.com/gofrs/flock v0.12.1 github.com/gorilla/websocket v1.5.3 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.1.2 - github.com/minio/minio-go/v7 v7.0.83 - github.com/pion/ice/v4 v4.0.5 + github.com/minio/minio-go/v7 v7.0.85 + github.com/pion/ice/v4 v4.0.6 github.com/pion/interceptor v0.1.37 - github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.8 + github.com/pion/logging v0.2.3 + github.com/pion/webrtc/v4 v4.0.9 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.33.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.32.0 + golang.org/x/crypto v0.33.0 golang.org/x/image v0.23.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -52,7 +52,7 @@ require ( github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.34.0 // indirect - golang.org/x/sys v0.29.0 // indirect - golang.org/x/text v0.21.0 // indirect + golang.org/x/net v0.35.0 // indirect + golang.org/x/sys v0.30.0 // indirect + golang.org/x/text v0.22.0 // indirect ) diff --git a/go.sum b/go.sum index a8564760..19f6068e 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,5 @@ -github.com/VictoriaMetrics/metrics v1.35.1 h1:o84wtBKQbzLdDy14XeskkCZih6anG+veZ1SwJHFGwrU= -github.com/VictoriaMetrics/metrics v1.35.1/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= +github.com/VictoriaMetrics/metrics v1.35.2 h1:Bj6L6ExfnakZKYPpi7mGUnkJP4NGQz2v5wiChhXNyWQ= +github.com/VictoriaMetrics/metrics v1.35.2/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -13,8 +13,8 @@ github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A= github.com/go-ini/ini v1.67.0/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8= github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIxtHqx8aGss= github.com/go-viper/mapstructure/v2 v2.2.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM= -github.com/goccy/go-json v0.10.4 h1:JSwxQzIqKfmFX1swYPpUThQZp/Ka4wzJdK0LWVytLPM= -github.com/goccy/go-json v0.10.4/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M= +github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4= +github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M= github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= github.com/gofrs/flock v0.12.1 h1:MTLVXXHf8ekldpJk3AKicLij9MdwOWkZ+a/jHHZby9E= github.com/gofrs/flock v0.12.1/go.mod h1:9zxTsyu5xtJ9DK+1tFZyibEV7y3uwDxPPfbxeeHCoD0= @@ -44,8 +44,8 @@ github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWE github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.83 h1:W4Kokksvlz3OKf3OqIlzDNKd4MERlC2oN8YptwJ0+GA= -github.com/minio/minio-go/v7 v7.0.83/go.mod h1:57YXpvc5l3rjPdhqNrDsvVlY0qPI6UTk1bflAe+9doY= +github.com/minio/minio-go/v7 v7.0.85 h1:9psTLS/NTvC3MWoyjhjXpwcKoNbkongaCSF3PNpSuXo= +github.com/minio/minio-go/v7 v7.0.85/go.mod h1:57YXpvc5l3rjPdhqNrDsvVlY0qPI6UTk1bflAe+9doY= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= @@ -54,12 +54,12 @@ github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= github.com/pion/dtls/v3 v3.0.4 h1:44CZekewMzfrn9pmGrj5BNnTMDCFwr+6sLH+cCuLM7U= github.com/pion/dtls/v3 v3.0.4/go.mod h1:R373CsjxWqNPf6MEkfdy3aSe9niZvL/JaKlGeFphtMg= -github.com/pion/ice/v4 v4.0.5 h1:6awVfa1jg9YsI9/Lep4TG/o3kwS1Oayr5b8xz50ibJ8= -github.com/pion/ice/v4 v4.0.5/go.mod h1:JJaoEIxUIlGDA9gaRZbwXYqI3j6VG/QchpjX+QmwN6A= +github.com/pion/ice/v4 v4.0.6 h1:jmM9HwI9lfetQV/39uD0nY4y++XZNPhvzIPCb8EwxUM= +github.com/pion/ice/v4 v4.0.6/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= github.com/pion/interceptor v0.1.37 h1:aRA8Zpab/wE7/c0O3fh1PqY0AJI3fCSEM5lRWJVorwI= github.com/pion/interceptor v0.1.37/go.mod h1:JzxbJ4umVTlZAf+/utHzNesY8tmRkM2lVmkS82TTj8Y= -github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= -github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= +github.com/pion/logging v0.2.3 h1:gHuf0zpoh1GW67Nr6Gj4cv5Z9ZscU7g/EaoC/Ke/igI= +github.com/pion/logging v0.2.3/go.mod h1:z8YfknkquMe1csOrxK5kc+5/ZPAzMxbKLX5aXpbpC90= github.com/pion/mdns/v2 v2.0.7 h1:c9kM8ewCgjslaAmicYMFQIde2H9/lrZpjBkN8VwoVtM= github.com/pion/mdns/v2 v2.0.7/go.mod h1:vAdSYNAT0Jy3Ru0zl2YiW3Rm/fJCwIeM0nToenfOJKA= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= @@ -80,8 +80,8 @@ github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1 github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= github.com/pion/turn/v4 v4.0.0 h1:qxplo3Rxa9Yg1xXDxxH8xaqcyGUtbHYw4QSCvmFWvhM= github.com/pion/turn/v4 v4.0.0/go.mod h1:MuPDkm15nYSklKpN8vWJ9W2M0PlyQZqYt1McGuxG7mA= -github.com/pion/webrtc/v4 v4.0.8 h1:T1ZmnT9qxIJIt4d8XoiMOBrTClGHDDXNg9e/fh018Qc= -github.com/pion/webrtc/v4 v4.0.8/go.mod h1:HHBeUVBAC+j4ZFnYhovEFStF02Arb1EyD4G7e7HBTJw= +github.com/pion/webrtc/v4 v4.0.9 h1:PyOYMRKJgfy0dzPcYtFD/4oW9zaw3Ze3oZzzbj2LV9E= +github.com/pion/webrtc/v4 v4.0.9/go.mod h1:ViHLVaNpiuvaH8pdiuQxuA9awuE6KVzAXx3vVWilOck= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -102,19 +102,19 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.32.0 h1:euUpcYgM8WcP71gNpTqQCn6rC2t6ULUPiOzfWaXVVfc= -golang.org/x/crypto v0.32.0/go.mod h1:ZnnJkOaASj8g0AjIduWNlq2NRxL0PlBrbKVyZ6V/Ugc= +golang.org/x/crypto v0.33.0 h1:IOBPskki6Lysi0lo9qQvbxiQ+FvsCC/YWOecCHAixus= +golang.org/x/crypto v0.33.0/go.mod h1:bVdXmD7IV/4GdElGPozy6U7lWdRXA4qyRVGJV57uQ5M= golang.org/x/image v0.23.0 h1:HseQ7c2OpPKTPVzNjG5fwJsOTCiiwS4QdsYi5XU6H68= golang.org/x/image v0.23.0/go.mod h1:wJJBTdLfCCf3tiHa1fNxpZmUI4mmoZvwMCPP0ddoNKY= -golang.org/x/net v0.34.0 h1:Mb7Mrk043xzHgnRM88suvJFwzVrRfHEHJEl5/71CKw0= -golang.org/x/net v0.34.0/go.mod h1:di0qlW3YNM5oh6GqDGQr92MyTozJPmybPK4Ev/Gm31k= +golang.org/x/net v0.35.0 h1:T5GQRQb2y08kTAByq9L4/bz8cipCdA8FbRTXewonqY8= +golang.org/x/net v0.35.0/go.mod h1:EglIi67kWsHKlRzzVMUD93VMSWGFOMSZgxFjparz1Qk= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.29.0 h1:TPYlXGxvx1MGTn2GiZDhnjPA9wZzZeGKHHmKhHYvgaU= -golang.org/x/sys v0.29.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= -golang.org/x/text v0.21.0 h1:zyQAAkrwaneQ066sspRyJaG9VNi/YJ1NfzcGB3hZ/qo= -golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ= +golang.org/x/sys v0.30.0 h1:QjkSwP/36a20jFYWkSue1YwXzLmsV5Gfq7Eiy72C1uc= +golang.org/x/sys v0.30.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/text v0.22.0 h1:bofq7m3/HAFvbF51jz3Q9wLg3jkvSPuiZu/pD1XwgtM= +golang.org/x/text v0.22.0/go.mod h1:YRoo4H8PVmsu+E3Ou7cqLVH8oXWIHVoX0jqUWALQhfY= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= From a1506d0f31a9b10446a18de1bb66ec138db09d8b Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Thu, 13 Feb 2025 01:00:13 +0300 Subject: [PATCH 308/361] Add PGO with 1.24.0 --- cmd/worker/default.pgo | Bin 0 -> 50275 bytes go.mod | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) create mode 100644 cmd/worker/default.pgo diff --git a/cmd/worker/default.pgo b/cmd/worker/default.pgo new file mode 100644 index 0000000000000000000000000000000000000000..c659757c8a0ce417a264ff653257726397442835 GIT binary patch literal 50275 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 literal 0 HcmV?d00001 diff --git a/go.mod b/go.mod index 68dfe632..04e2ffd5 100644 --- a/go.mod +++ b/go.mod @@ -1,6 +1,6 @@ module github.com/giongto35/cloud-game/v3 -go 1.22 +go 1.24 require ( github.com/VictoriaMetrics/metrics v1.35.2 From 7c878b1ee3bb3de74592d48ba8dbd7bb5f2919ab Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 15 Mar 2025 11:21:28 +0300 Subject: [PATCH 309/361] Update dependencies --- Dockerfile | 2 +- go.mod | 29 ++++++++++++++------------- go.sum | 58 ++++++++++++++++++++++++++++-------------------------- 3 files changed, 46 insertions(+), 43 deletions(-) diff --git a/Dockerfile b/Dockerfile index 8545a1b0..1b34737c 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:oracular AS build0 -ARG GO=1.24.0 +ARG GO=1.24.1 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ diff --git a/go.mod b/go.mod index 04e2ffd5..3c220273 100644 --- a/go.mod +++ b/go.mod @@ -11,16 +11,16 @@ require ( github.com/gorilla/websocket v1.5.3 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.1.2 - github.com/minio/minio-go/v7 v7.0.85 - github.com/pion/ice/v4 v4.0.6 + github.com/minio/minio-go/v7 v7.0.88 + github.com/pion/ice/v4 v4.0.7 github.com/pion/interceptor v0.1.37 github.com/pion/logging v0.2.3 - github.com/pion/webrtc/v4 v4.0.9 + github.com/pion/webrtc/v4 v4.0.13 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.33.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.33.0 - golang.org/x/image v0.23.0 + golang.org/x/crypto v0.36.0 + golang.org/x/image v0.25.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -29,21 +29,22 @@ require ( github.com/go-ini/ini v1.67.0 // indirect github.com/go-viper/mapstructure/v2 v2.2.1 // indirect github.com/google/uuid v1.6.0 // indirect - github.com/klauspost/compress v1.17.11 // indirect - github.com/klauspost/cpuid/v2 v2.2.9 // indirect + github.com/klauspost/compress v1.18.0 // indirect + github.com/klauspost/cpuid/v2 v2.2.10 // indirect github.com/mattn/go-colorable v0.1.14 // indirect github.com/mattn/go-isatty v0.0.20 // indirect + github.com/minio/crc64nvme v1.0.1 // indirect github.com/minio/md5-simd v1.1.2 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/pion/datachannel v1.5.10 // indirect - github.com/pion/dtls/v3 v3.0.4 // indirect + github.com/pion/dtls/v3 v3.0.5 // indirect github.com/pion/mdns/v2 v2.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.15 // indirect - github.com/pion/rtp v1.8.11 // indirect - github.com/pion/sctp v1.8.35 // indirect - github.com/pion/sdp/v3 v3.0.10 // indirect + github.com/pion/rtp v1.8.13 // indirect + github.com/pion/sctp v1.8.37 // indirect + github.com/pion/sdp/v3 v3.0.11 // indirect github.com/pion/srtp/v3 v3.0.4 // indirect github.com/pion/stun/v3 v3.0.0 // indirect github.com/pion/transport/v3 v3.0.7 // indirect @@ -52,7 +53,7 @@ require ( github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.35.0 // indirect - golang.org/x/sys v0.30.0 // indirect - golang.org/x/text v0.22.0 // indirect + golang.org/x/net v0.37.0 // indirect + golang.org/x/sys v0.31.0 // indirect + golang.org/x/text v0.23.0 // indirect ) diff --git a/go.sum b/go.sum index 19f6068e..8f94cf6a 100644 --- a/go.sum +++ b/go.sum @@ -22,11 +22,11 @@ github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg= github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= -github.com/klauspost/compress v1.17.11 h1:In6xLpyWOi1+C7tXUUWv2ot1QvBjxevKAaI6IXrJmUc= -github.com/klauspost/compress v1.17.11/go.mod h1:pMDklpSncoRMuLFrf1W9Ss9KT+0rH90U12bZKk7uwG0= +github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo= +github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ= github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= -github.com/klauspost/cpuid/v2 v2.2.9 h1:66ze0taIn2H33fBvCkXuv9BmCwDfafmiIVpKV9kKGuY= -github.com/klauspost/cpuid/v2 v2.2.9/go.mod h1:rqkxqrZ1EhYM9G+hXH7YdowN5R5RGN6NK4QwQ3WMXF8= +github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE= +github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= github.com/knadh/koanf/maps v0.1.1 h1:G5TjmUh2D7G2YWf5SQQqSiHRJEjaicvU0KpypqB3NIs= github.com/knadh/koanf/maps v0.1.1/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= github.com/knadh/koanf/v2 v2.1.2 h1:I2rtLRqXRy1p01m/utEtpZSSA6dcJbgGVuE27kW2PzQ= @@ -42,20 +42,22 @@ github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/ github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/minio/crc64nvme v1.0.1 h1:DHQPrYPdqK7jQG/Ls5CTBZWeex/2FMS3G5XGkycuFrY= +github.com/minio/crc64nvme v1.0.1/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.85 h1:9psTLS/NTvC3MWoyjhjXpwcKoNbkongaCSF3PNpSuXo= -github.com/minio/minio-go/v7 v7.0.85/go.mod h1:57YXpvc5l3rjPdhqNrDsvVlY0qPI6UTk1bflAe+9doY= +github.com/minio/minio-go/v7 v7.0.88 h1:v8MoIJjwYxOkehp+eiLIuvXk87P2raUtoU5klrAAshs= +github.com/minio/minio-go/v7 v7.0.88/go.mod h1:33+O8h0tO7pCeCWwBVa07RhVVfB/3vS4kEX7rwYKmIg= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk4o= github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= -github.com/pion/dtls/v3 v3.0.4 h1:44CZekewMzfrn9pmGrj5BNnTMDCFwr+6sLH+cCuLM7U= -github.com/pion/dtls/v3 v3.0.4/go.mod h1:R373CsjxWqNPf6MEkfdy3aSe9niZvL/JaKlGeFphtMg= -github.com/pion/ice/v4 v4.0.6 h1:jmM9HwI9lfetQV/39uD0nY4y++XZNPhvzIPCb8EwxUM= -github.com/pion/ice/v4 v4.0.6/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= +github.com/pion/dtls/v3 v3.0.5 h1:OGWLu21/Wc5+H8R75F1BWvedH7H+nYUPFzJOew4k1iA= +github.com/pion/dtls/v3 v3.0.5/go.mod h1:JVCnfmbgq45QoU07AaxFbdjF2iomKzYouVNy+W5kqmY= +github.com/pion/ice/v4 v4.0.7 h1:mnwuT3n3RE/9va41/9QJqN5+Bhc0H/x/ZyiVlWMw35M= +github.com/pion/ice/v4 v4.0.7/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= github.com/pion/interceptor v0.1.37 h1:aRA8Zpab/wE7/c0O3fh1PqY0AJI3fCSEM5lRWJVorwI= github.com/pion/interceptor v0.1.37/go.mod h1:JzxbJ4umVTlZAf+/utHzNesY8tmRkM2lVmkS82TTj8Y= github.com/pion/logging v0.2.3 h1:gHuf0zpoh1GW67Nr6Gj4cv5Z9ZscU7g/EaoC/Ke/igI= @@ -66,12 +68,12 @@ github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.15 h1:LZQi2JbdipLOj4eBjK4wlVoQWfrZbh3Q6eHtWtJBZBo= github.com/pion/rtcp v1.2.15/go.mod h1:jlGuAjHMEXwMUHK78RgX0UmEJFV4zUKOFHR7OP+D3D0= -github.com/pion/rtp v1.8.11 h1:17xjnY5WO5hgO6SD3/NTIUPvSFw/PbLsIJyz1r1yNIk= -github.com/pion/rtp v1.8.11/go.mod h1:8uMBJj32Pa1wwx8Fuv/AsFhn8jsgw+3rUC2PfoBZ8p4= -github.com/pion/sctp v1.8.35 h1:qwtKvNK1Wc5tHMIYgTDJhfZk7vATGVHhXbUDfHbYwzA= -github.com/pion/sctp v1.8.35/go.mod h1:EcXP8zCYVTRy3W9xtOF7wJm1L1aXfKRQzaM33SjQlzg= -github.com/pion/sdp/v3 v3.0.10 h1:6MChLE/1xYB+CjumMw+gZ9ufp2DPApuVSnDT8t5MIgA= -github.com/pion/sdp/v3 v3.0.10/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= +github.com/pion/rtp v1.8.13 h1:8uSUPpjSL4OlwZI8Ygqu7+h2p9NPFB+yAZ461Xn5sNg= +github.com/pion/rtp v1.8.13/go.mod h1:8uMBJj32Pa1wwx8Fuv/AsFhn8jsgw+3rUC2PfoBZ8p4= +github.com/pion/sctp v1.8.37 h1:ZDmGPtRPX9mKCiVXtMbTWybFw3z/hVKAZgU81wcOrqs= +github.com/pion/sctp v1.8.37/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= +github.com/pion/sdp/v3 v3.0.11 h1:VhgVSopdsBKwhCFoyyPmT1fKMeV9nLMrEKxNOdy3IVI= +github.com/pion/sdp/v3 v3.0.11/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= github.com/pion/srtp/v3 v3.0.4 h1:2Z6vDVxzrX3UHEgrUyIGM4rRouoC7v+NiF1IHtp9B5M= github.com/pion/srtp/v3 v3.0.4/go.mod h1:1Jx3FwDoxpRaTh1oRV8A/6G1BnFL+QI82eK4ms8EEJQ= github.com/pion/stun/v3 v3.0.0 h1:4h1gwhWLWuZWOJIJR9s2ferRO+W3zA/b6ijOI6mKzUw= @@ -80,8 +82,8 @@ github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1 github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= github.com/pion/turn/v4 v4.0.0 h1:qxplo3Rxa9Yg1xXDxxH8xaqcyGUtbHYw4QSCvmFWvhM= github.com/pion/turn/v4 v4.0.0/go.mod h1:MuPDkm15nYSklKpN8vWJ9W2M0PlyQZqYt1McGuxG7mA= -github.com/pion/webrtc/v4 v4.0.9 h1:PyOYMRKJgfy0dzPcYtFD/4oW9zaw3Ze3oZzzbj2LV9E= -github.com/pion/webrtc/v4 v4.0.9/go.mod h1:ViHLVaNpiuvaH8pdiuQxuA9awuE6KVzAXx3vVWilOck= +github.com/pion/webrtc/v4 v4.0.13 h1:XuUaWTjRufsiGJRC+G71OgiSMe7tl7mQ0kkd4bAqIaQ= +github.com/pion/webrtc/v4 v4.0.13/go.mod h1:Fadzxm0CbY99YdCEfxrgiVr0L4jN1l8bf8DBkPPpJbs= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -102,19 +104,19 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.33.0 h1:IOBPskki6Lysi0lo9qQvbxiQ+FvsCC/YWOecCHAixus= -golang.org/x/crypto v0.33.0/go.mod h1:bVdXmD7IV/4GdElGPozy6U7lWdRXA4qyRVGJV57uQ5M= -golang.org/x/image v0.23.0 h1:HseQ7c2OpPKTPVzNjG5fwJsOTCiiwS4QdsYi5XU6H68= -golang.org/x/image v0.23.0/go.mod h1:wJJBTdLfCCf3tiHa1fNxpZmUI4mmoZvwMCPP0ddoNKY= -golang.org/x/net v0.35.0 h1:T5GQRQb2y08kTAByq9L4/bz8cipCdA8FbRTXewonqY8= -golang.org/x/net v0.35.0/go.mod h1:EglIi67kWsHKlRzzVMUD93VMSWGFOMSZgxFjparz1Qk= +golang.org/x/crypto v0.36.0 h1:AnAEvhDddvBdpY+uR+MyHmuZzzNqXSe/GvuDeob5L34= +golang.org/x/crypto v0.36.0/go.mod h1:Y4J0ReaxCR1IMaabaSMugxJES1EpwhBHhv2bDHklZvc= +golang.org/x/image v0.25.0 h1:Y6uW6rH1y5y/LK1J8BPWZtr6yZ7hrsy6hFrXjgsc2fQ= +golang.org/x/image v0.25.0/go.mod h1:tCAmOEGthTtkalusGp1g3xa2gke8J6c2N565dTyl9Rs= +golang.org/x/net v0.37.0 h1:1zLorHbz+LYj7MQlSf1+2tPIIgibq2eL5xkrGk6f+2c= +golang.org/x/net v0.37.0/go.mod h1:ivrbrMbzFq5J41QOQh0siUuly180yBYtLp+CKbEaFx8= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.30.0 h1:QjkSwP/36a20jFYWkSue1YwXzLmsV5Gfq7Eiy72C1uc= -golang.org/x/sys v0.30.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= -golang.org/x/text v0.22.0 h1:bofq7m3/HAFvbF51jz3Q9wLg3jkvSPuiZu/pD1XwgtM= -golang.org/x/text v0.22.0/go.mod h1:YRoo4H8PVmsu+E3Ou7cqLVH8oXWIHVoX0jqUWALQhfY= +golang.org/x/sys v0.31.0 h1:ioabZlmFYtWhL+TRYpcnNlLwhyxaM9kWTDEmfnprqik= +golang.org/x/sys v0.31.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= +golang.org/x/text v0.23.0 h1:D71I7dUrlY+VX0gQShAThNGHFxZ13dGLBHQLVl1mJlY= +golang.org/x/text v0.23.0/go.mod h1:/BLNzu4aZCJ1+kcD0DNRotWKage4q2rGVAg4o22unh4= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= From 3ac7a559df93559d3c88ebe79e9997a91c9f5652 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Thu, 17 Apr 2025 08:53:40 +0300 Subject: [PATCH 310/361] Skip YUV test It is broken on Windows --- pkg/encoder/yuv/yuv_test.go | 1 + 1 file changed, 1 insertion(+) diff --git a/pkg/encoder/yuv/yuv_test.go b/pkg/encoder/yuv/yuv_test.go index 75a61bc2..e4e74b30 100644 --- a/pkg/encoder/yuv/yuv_test.go +++ b/pkg/encoder/yuv/yuv_test.go @@ -18,6 +18,7 @@ import ( ) func TestYuvPredefined(t *testing.T) { + t.Skip("Skipped because on Windows some colors are different") im := []uint8{101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 101, 0, 106, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255, 18, 226, 78, 255} should := []byte{ 52, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, 142, From 410610349bfa55ab3c6a2f54f8e49a711bd22299 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Thu, 17 Apr 2025 08:56:47 +0300 Subject: [PATCH 311/361] Switch to UCRT toolchain in MSYS2 --- .github/workflows/build.yml | 22 ++++++++++++---------- README.md | 2 +- 2 files changed, 13 insertions(+), 11 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 81225ca7..66b0b414 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -50,19 +50,19 @@ jobs: - uses: msys2/setup-msys2@v2 if: matrix.os == 'windows-latest' with: - msystem: MINGW64 + msystem: ucrt64 path-type: inherit release: false install: > - mingw-w64-x86_64-gcc - mingw-w64-x86_64-pkgconf - mingw-w64-x86_64-dlfcn - mingw-w64-x86_64-libvpx - mingw-w64-x86_64-opus - mingw-w64-x86_64-libx264 - mingw-w64-x86_64-SDL2 - mingw-w64-x86_64-libyuv - mingw-w64-x86_64-libjpeg-turbo + mingw-w64-ucrt-x86_64-gcc + mingw-w64-ucrt-x86_64-pkgconf + mingw-w64-ucrt-x86_64-dlfcn + mingw-w64-ucrt-x86_64-libvpx + mingw-w64-ucrt-x86_64-opus + mingw-w64-ucrt-x86_64-libx264 + mingw-w64-ucrt-x86_64-SDL2 + mingw-w64-ucrt-x86_64-libyuv + mingw-w64-ucrt-x86_64-libjpeg-turbo - name: Windows if: matrix.os == 'windows-latest' @@ -71,6 +71,8 @@ jobs: MESA_GL_VERSION_OVERRIDE: 3.3COMPAT shell: msys2 {0} run: | + set MSYSTEM=UCRT64 + wget -q https://github.com/pal1000/mesa-dist-win/releases/download/$MESA_VERSION/mesa3d-$MESA_VERSION-release-msvc.7z "/c/Program Files/7-Zip/7z.exe" x mesa3d-$MESA_VERSION-release-msvc.7z -omesa echo -e " 1\r\n 9\r\n " >> commands diff --git a/README.md b/README.md index 24c5a405..1f357d4a 100644 --- a/README.md +++ b/README.md @@ -66,7 +66,7 @@ apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo # Windows (MSYS2) -pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,libx264,SDL2,libyuv,libjpeg-turbo} +pacman -Sy --noconfirm --needed git make mingw-w64-ucrt-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,libx264,SDL2,libyuv,libjpeg-turbo} ``` (You don't need to download libyuv on macOS) From debd4b23dfcf147dfa12160c87d7f33b51a84598 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Thu, 17 Apr 2025 08:57:32 +0300 Subject: [PATCH 312/361] Disable default static build It is broken with SDL2 on Windows --- Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Makefile b/Makefile index 70af44de..1fbe81de 100644 --- a/Makefile +++ b/Makefile @@ -4,7 +4,7 @@ ROOT = ${REPO_ROOT}/${PROJECT} CGO_CFLAGS='-g -O3' CGO_LDFLAGS='-g -O3' -GO_TAGS=static +GO_TAGS= .PHONY: clean test From a431b7050fca8b179cd1b6876c13c24c2447b08c Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Thu, 17 Apr 2025 08:58:50 +0300 Subject: [PATCH 313/361] Update dependencies --- Dockerfile | 2 +- go.mod | 26 +++++++++++++------------- go.sum | 26 ++++++++++++++++++++++++++ 3 files changed, 40 insertions(+), 14 deletions(-) diff --git a/Dockerfile b/Dockerfile index 1b34737c..94e61bc6 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:oracular AS build0 -ARG GO=1.24.1 +ARG GO=1.24.2 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ diff --git a/go.mod b/go.mod index 3c220273..88a4a581 100644 --- a/go.mod +++ b/go.mod @@ -5,21 +5,21 @@ go 1.24 require ( github.com/VictoriaMetrics/metrics v1.35.2 github.com/cavaliergopher/grab/v3 v3.0.1 - github.com/fsnotify/fsnotify v1.8.0 + github.com/fsnotify/fsnotify v1.9.0 github.com/goccy/go-json v0.10.5 github.com/gofrs/flock v0.12.1 github.com/gorilla/websocket v1.5.3 - github.com/knadh/koanf/maps v0.1.1 - github.com/knadh/koanf/v2 v2.1.2 - github.com/minio/minio-go/v7 v7.0.88 - github.com/pion/ice/v4 v4.0.7 + github.com/knadh/koanf/maps v0.1.2 + github.com/knadh/koanf/v2 v2.2.0 + github.com/minio/minio-go/v7 v7.0.90 + github.com/pion/ice/v4 v4.0.10 github.com/pion/interceptor v0.1.37 github.com/pion/logging v0.2.3 - github.com/pion/webrtc/v4 v4.0.13 + github.com/pion/webrtc/v4 v4.0.15 github.com/rs/xid v1.6.0 - github.com/rs/zerolog v1.33.0 + github.com/rs/zerolog v1.34.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.36.0 + golang.org/x/crypto v0.37.0 golang.org/x/image v0.25.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -38,12 +38,12 @@ require ( github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/pion/datachannel v1.5.10 // indirect - github.com/pion/dtls/v3 v3.0.5 // indirect + github.com/pion/dtls/v3 v3.0.6 // indirect github.com/pion/mdns/v2 v2.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.15 // indirect github.com/pion/rtp v1.8.13 // indirect - github.com/pion/sctp v1.8.37 // indirect + github.com/pion/sctp v1.8.38 // indirect github.com/pion/sdp/v3 v3.0.11 // indirect github.com/pion/srtp/v3 v3.0.4 // indirect github.com/pion/stun/v3 v3.0.0 // indirect @@ -53,7 +53,7 @@ require ( github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.37.0 // indirect - golang.org/x/sys v0.31.0 // indirect - golang.org/x/text v0.23.0 // indirect + golang.org/x/net v0.39.0 // indirect + golang.org/x/sys v0.32.0 // indirect + golang.org/x/text v0.24.0 // indirect ) diff --git a/go.sum b/go.sum index 8f94cf6a..e5b53776 100644 --- a/go.sum +++ b/go.sum @@ -9,6 +9,8 @@ github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkp github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto= github.com/fsnotify/fsnotify v1.8.0 h1:dAwr6QBTBZIkG8roQaJjGof0pp0EeF+tNV7YBP3F/8M= github.com/fsnotify/fsnotify v1.8.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0= +github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k= +github.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0= github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A= github.com/go-ini/ini v1.67.0/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8= github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIxtHqx8aGss= @@ -29,8 +31,12 @@ github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2 github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= github.com/knadh/koanf/maps v0.1.1 h1:G5TjmUh2D7G2YWf5SQQqSiHRJEjaicvU0KpypqB3NIs= github.com/knadh/koanf/maps v0.1.1/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= +github.com/knadh/koanf/maps v0.1.2 h1:RBfmAW5CnZT+PJ1CVc1QSJKf4Xu9kxfQgYVQSu8hpbo= +github.com/knadh/koanf/maps v0.1.2/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= github.com/knadh/koanf/v2 v2.1.2 h1:I2rtLRqXRy1p01m/utEtpZSSA6dcJbgGVuE27kW2PzQ= github.com/knadh/koanf/v2 v2.1.2/go.mod h1:Gphfaen0q1Fc1HTgJgSTC4oRX9R2R5ErYMZJy8fLJBo= +github.com/knadh/koanf/v2 v2.2.0 h1:FZFwd9bUjpb8DyCWARUBy5ovuhDs1lI87dOEn2K8UVU= +github.com/knadh/koanf/v2 v2.2.0/go.mod h1:PSFru3ufQgTsI7IF+95rf9s8XA1+aHxKuO/W+dPoHEY= github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= @@ -48,6 +54,8 @@ github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= github.com/minio/minio-go/v7 v7.0.88 h1:v8MoIJjwYxOkehp+eiLIuvXk87P2raUtoU5klrAAshs= github.com/minio/minio-go/v7 v7.0.88/go.mod h1:33+O8h0tO7pCeCWwBVa07RhVVfB/3vS4kEX7rwYKmIg= +github.com/minio/minio-go/v7 v7.0.90 h1:TmSj1083wtAD0kEYTx7a5pFsv3iRYMsOJ6A4crjA1lE= +github.com/minio/minio-go/v7 v7.0.90/go.mod h1:uvMUcGrpgeSAAI6+sD3818508nUyMULw94j2Nxku/Go= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= @@ -56,8 +64,12 @@ github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= github.com/pion/dtls/v3 v3.0.5 h1:OGWLu21/Wc5+H8R75F1BWvedH7H+nYUPFzJOew4k1iA= github.com/pion/dtls/v3 v3.0.5/go.mod h1:JVCnfmbgq45QoU07AaxFbdjF2iomKzYouVNy+W5kqmY= +github.com/pion/dtls/v3 v3.0.6 h1:7Hkd8WhAJNbRgq9RgdNh1aaWlZlGpYTzdqjy9x9sK2E= +github.com/pion/dtls/v3 v3.0.6/go.mod h1:iJxNQ3Uhn1NZWOMWlLxEEHAN5yX7GyPvvKw04v9bzYU= github.com/pion/ice/v4 v4.0.7 h1:mnwuT3n3RE/9va41/9QJqN5+Bhc0H/x/ZyiVlWMw35M= github.com/pion/ice/v4 v4.0.7/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= +github.com/pion/ice/v4 v4.0.10 h1:P59w1iauC/wPk9PdY8Vjl4fOFL5B+USq1+xbDcN6gT4= +github.com/pion/ice/v4 v4.0.10/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= github.com/pion/interceptor v0.1.37 h1:aRA8Zpab/wE7/c0O3fh1PqY0AJI3fCSEM5lRWJVorwI= github.com/pion/interceptor v0.1.37/go.mod h1:JzxbJ4umVTlZAf+/utHzNesY8tmRkM2lVmkS82TTj8Y= github.com/pion/logging v0.2.3 h1:gHuf0zpoh1GW67Nr6Gj4cv5Z9ZscU7g/EaoC/Ke/igI= @@ -72,6 +84,8 @@ github.com/pion/rtp v1.8.13 h1:8uSUPpjSL4OlwZI8Ygqu7+h2p9NPFB+yAZ461Xn5sNg= github.com/pion/rtp v1.8.13/go.mod h1:8uMBJj32Pa1wwx8Fuv/AsFhn8jsgw+3rUC2PfoBZ8p4= github.com/pion/sctp v1.8.37 h1:ZDmGPtRPX9mKCiVXtMbTWybFw3z/hVKAZgU81wcOrqs= github.com/pion/sctp v1.8.37/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= +github.com/pion/sctp v1.8.38 h1:rntHxO7CyH8jeqC/bkuirl2uJ+BqTp2uxhisi5AYPRQ= +github.com/pion/sctp v1.8.38/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= github.com/pion/sdp/v3 v3.0.11 h1:VhgVSopdsBKwhCFoyyPmT1fKMeV9nLMrEKxNOdy3IVI= github.com/pion/sdp/v3 v3.0.11/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= github.com/pion/srtp/v3 v3.0.4 h1:2Z6vDVxzrX3UHEgrUyIGM4rRouoC7v+NiF1IHtp9B5M= @@ -84,6 +98,8 @@ github.com/pion/turn/v4 v4.0.0 h1:qxplo3Rxa9Yg1xXDxxH8xaqcyGUtbHYw4QSCvmFWvhM= github.com/pion/turn/v4 v4.0.0/go.mod h1:MuPDkm15nYSklKpN8vWJ9W2M0PlyQZqYt1McGuxG7mA= github.com/pion/webrtc/v4 v4.0.13 h1:XuUaWTjRufsiGJRC+G71OgiSMe7tl7mQ0kkd4bAqIaQ= github.com/pion/webrtc/v4 v4.0.13/go.mod h1:Fadzxm0CbY99YdCEfxrgiVr0L4jN1l8bf8DBkPPpJbs= +github.com/pion/webrtc/v4 v4.0.15 h1:DWuBtTHBa9rQNqyhW+jptkq6r3zdGqr1OQ4pa2Q+Ey4= +github.com/pion/webrtc/v4 v4.0.15/go.mod h1:RXf6sJ8FUX+qwF4+AwB+A3c2Y6WpuATRTe4L/fTWNa4= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -94,6 +110,8 @@ github.com/rs/xid v1.6.0 h1:fV591PaemRlL6JfRxGDEPl69wICngIQ3shQtzfy2gxU= github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0= github.com/rs/zerolog v1.33.0 h1:1cU2KZkvPxNyfgEmhHAz/1A9Bz+llsdYzklWFzgp0r8= github.com/rs/zerolog v1.33.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss= +github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY= +github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ= github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA= github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= @@ -106,17 +124,25 @@ github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= golang.org/x/crypto v0.36.0 h1:AnAEvhDddvBdpY+uR+MyHmuZzzNqXSe/GvuDeob5L34= golang.org/x/crypto v0.36.0/go.mod h1:Y4J0ReaxCR1IMaabaSMugxJES1EpwhBHhv2bDHklZvc= +golang.org/x/crypto v0.37.0 h1:kJNSjF/Xp7kU0iB2Z+9viTPMW4EqqsrywMXLJOOsXSE= +golang.org/x/crypto v0.37.0/go.mod h1:vg+k43peMZ0pUMhYmVAWysMK35e6ioLh3wB8ZCAfbVc= golang.org/x/image v0.25.0 h1:Y6uW6rH1y5y/LK1J8BPWZtr6yZ7hrsy6hFrXjgsc2fQ= golang.org/x/image v0.25.0/go.mod h1:tCAmOEGthTtkalusGp1g3xa2gke8J6c2N565dTyl9Rs= golang.org/x/net v0.37.0 h1:1zLorHbz+LYj7MQlSf1+2tPIIgibq2eL5xkrGk6f+2c= golang.org/x/net v0.37.0/go.mod h1:ivrbrMbzFq5J41QOQh0siUuly180yBYtLp+CKbEaFx8= +golang.org/x/net v0.39.0 h1:ZCu7HMWDxpXpaiKdhzIfaltL9Lp31x/3fCP11bc6/fY= +golang.org/x/net v0.39.0/go.mod h1:X7NRbYVEA+ewNkCNyJ513WmMdQ3BineSwVtN2zD/d+E= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.31.0 h1:ioabZlmFYtWhL+TRYpcnNlLwhyxaM9kWTDEmfnprqik= golang.org/x/sys v0.31.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= +golang.org/x/sys v0.32.0 h1:s77OFDvIQeibCmezSnk/q6iAfkdiQaJi4VzroCFrN20= +golang.org/x/sys v0.32.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= golang.org/x/text v0.23.0 h1:D71I7dUrlY+VX0gQShAThNGHFxZ13dGLBHQLVl1mJlY= golang.org/x/text v0.23.0/go.mod h1:/BLNzu4aZCJ1+kcD0DNRotWKage4q2rGVAg4o22unh4= +golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0= +golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= From ddfc9249ecee3daa61525fcf68db2c707a98e7b4 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 2 May 2025 10:06:23 +0300 Subject: [PATCH 314/361] Fix some user slot race conditions In cases where HasSlot() and Reserve() operations are delayed, multiple users may incorrectly be granted a slot due to race conditions. --- pkg/coordinator/hub.go | 9 +- pkg/coordinator/user.go | 5 +- pkg/coordinator/worker.go | 40 ++++++- pkg/coordinator/worker_test.go | 193 +++++++++++++++++++++++++++++++++ 4 files changed, 240 insertions(+), 7 deletions(-) create mode 100644 pkg/coordinator/worker_test.go diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index 8b33b00d..f4a1398c 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -68,7 +68,14 @@ func (h *Hub) handleUserConnection() http.HandlerFunc { h.log.Info().Msg("no free workers") return } - user.Bind(worker) + + bound := user.Bind(worker) + if !bound { + user.Notify(api.ErrNoFreeSlots, "") + h.log.Info().Msg("no free slots") + return + } + h.users.Add(user) apps := worker.AppNames() diff --git a/pkg/coordinator/user.go b/pkg/coordinator/user.go index a6865d75..5d1e7ed5 100644 --- a/pkg/coordinator/user.go +++ b/pkg/coordinator/user.go @@ -28,9 +28,10 @@ func NewUser(sock *com.Connection, log *logger.Logger) *User { } } -func (u *User) Bind(w *Worker) { +func (u *User) Bind(w *Worker) bool { u.w = w - u.w.Reserve() + + return u.w.TryReserve() } func (u *User) Disconnect() { diff --git a/pkg/coordinator/worker.go b/pkg/coordinator/worker.go index a00ad226..f4b2b2d0 100644 --- a/pkg/coordinator/worker.go +++ b/pkg/coordinator/worker.go @@ -135,6 +135,11 @@ func (w *Worker) AppNames() []api.GameInfo { } func (w *Worker) AddSession(id string) { + // sessions can be uninitialized until the coordinator pushes them to the worker + if w.Sessions == nil { + return + } + w.Sessions[id] = struct{}{} } @@ -159,13 +164,40 @@ type slotted int32 // there are no players in the room (worker). func (s *slotted) HasSlot() bool { return atomic.LoadInt32((*int32)(s)) == 0 } -// Reserve increments user counter of the worker. -func (s *slotted) Reserve() { atomic.AddInt32((*int32)(s), 1) } +// TryReserve reserves the slot only when it's free. +func (s *slotted) TryReserve() bool { + for { + current := atomic.LoadInt32((*int32)(s)) + if current != 0 { + return false + } + if atomic.CompareAndSwapInt32((*int32)(s), 0, 1) { + return true + } + } +} // UnReserve decrements user counter of the worker. func (s *slotted) UnReserve() { - if atomic.AddInt32((*int32)(s), -1) < 0 { - atomic.StoreInt32((*int32)(s), 0) + for { + current := atomic.LoadInt32((*int32)(s)) + if current <= 0 { + // reset to zero + if current < 0 { + if atomic.CompareAndSwapInt32((*int32)(s), current, 0) { + return + } + continue + } + + return + } + + // Regular decrement for positive values + newVal := current - 1 + if atomic.CompareAndSwapInt32((*int32)(s), current, newVal) { + return + } } } diff --git a/pkg/coordinator/worker_test.go b/pkg/coordinator/worker_test.go new file mode 100644 index 00000000..a08b8b71 --- /dev/null +++ b/pkg/coordinator/worker_test.go @@ -0,0 +1,193 @@ +package coordinator + +import ( + "sync" + "sync/atomic" + "testing" +) + +func TestSlotted(t *testing.T) { + t.Run("UnReserve", func(t *testing.T) { + t.Run("BasicDecrement", testUnReserveBasic) + t.Run("PreventUnderflow", testUnReserveUnderflow) + t.Run("ConcurrentDecrement", testUnReserveConcurrent) + }) + + t.Run("TryReserve", func(t *testing.T) { + t.Run("SuccessWhenZero", testTryReserveSuccess) + t.Run("FailWhenNonZero", testTryReserveFailure) + t.Run("ConcurrentReservations", testTryReserveConcurrent) + }) + + t.Run("Integration", func(t *testing.T) { + t.Run("ReserveUnreserveFlow", testReserveUnreserveFlow) + t.Run("FreeSlots", testFreeSlots) + t.Run("HasSlot", testHasSlot) + }) +} + +func testUnReserveBasic(t *testing.T) { + t.Parallel() + var s slotted + + // Initial state + if atomic.LoadInt32((*int32)(&s)) != 0 { + t.Fatal("initial state not zero") + } + + // Test normal decrement + s.TryReserve() // 0 -> 1 + s.UnReserve() + if atomic.LoadInt32((*int32)(&s)) != 0 { + t.Error("failed to decrement to zero") + } + + // Test multiple decrements + s.TryReserve() // 0 -> 1 + s.TryReserve() // 1 -> 2 + s.UnReserve() + s.UnReserve() + if atomic.LoadInt32((*int32)(&s)) != 0 { + t.Error("failed to decrement multiple times") + } +} + +func testUnReserveUnderflow(t *testing.T) { + t.Parallel() + var s slotted + + t.Run("PreventNewUnderflow", func(t *testing.T) { + s.UnReserve() // Start at 0 + if atomic.LoadInt32((*int32)(&s)) != 0 { + t.Error("should remain at 0 when unreserving from 0") + } + }) + + t.Run("FixExistingNegative", func(t *testing.T) { + atomic.StoreInt32((*int32)(&s), -5) + s.UnReserve() + if current := atomic.LoadInt32((*int32)(&s)); current != 0 { + t.Errorf("should fix negative value to 0, got %d", current) + } + }) +} + +func testUnReserveConcurrent(t *testing.T) { + t.Parallel() + + var s slotted + const workers = 100 + var wg sync.WaitGroup + + atomic.StoreInt32((*int32)(&s), int32(workers)) + wg.Add(workers) + + for i := 0; i < workers; i++ { + go func() { + defer wg.Done() + s.UnReserve() + }() + } + + wg.Wait() + + if current := atomic.LoadInt32((*int32)(&s)); current != 0 { + t.Errorf("unexpected final value: %d (want 0)", current) + } +} + +func testTryReserveSuccess(t *testing.T) { + t.Parallel() + var s slotted + + if !s.TryReserve() { + t.Error("should succeed when zero") + } + if atomic.LoadInt32((*int32)(&s)) != 1 { + t.Error("failed to increment") + } +} + +func testTryReserveFailure(t *testing.T) { + t.Parallel() + var s slotted + + atomic.StoreInt32((*int32)(&s), 1) + if s.TryReserve() { + t.Error("should fail when non-zero") + } +} + +func testTryReserveConcurrent(t *testing.T) { + t.Parallel() + var s slotted + const workers = 100 + var success int32 + var wg sync.WaitGroup + + wg.Add(workers) + for i := 0; i < workers; i++ { + go func() { + defer wg.Done() + if s.TryReserve() { + atomic.AddInt32(&success, 1) + } + }() + } + + wg.Wait() + + if success != 1 { + t.Errorf("unexpected success count: %d (want 1)", success) + } + if atomic.LoadInt32((*int32)(&s)) != 1 { + t.Error("counter not properly incremented") + } +} + +func testReserveUnreserveFlow(t *testing.T) { + t.Parallel() + var s slotted + + // Successful reservation + if !s.TryReserve() { + t.Fatal("failed initial reservation") + } + + // Second reservation should fail + if s.TryReserve() { + t.Error("unexpected successful second reservation") + } + + // Unreserve and try again + s.UnReserve() + if !s.TryReserve() { + t.Error("failed reservation after unreserve") + } +} + +func testFreeSlots(t *testing.T) { + t.Parallel() + var s slotted + + // Set to arbitrary value + atomic.StoreInt32((*int32)(&s), 5) + s.FreeSlots() + if atomic.LoadInt32((*int32)(&s)) != 0 { + t.Error("FreeSlots failed to reset counter") + } +} + +func testHasSlot(t *testing.T) { + t.Parallel() + var s slotted + + if !s.HasSlot() { + t.Error("should have slot when zero") + } + + s.TryReserve() + if s.HasSlot() { + t.Error("shouldn't have slot when reserved") + } +} From 9d4256306ee5894b9817e5c203768b7db597a5d0 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 2 May 2025 10:34:22 +0300 Subject: [PATCH 315/361] Add missing C function header for Go debugger --- pkg/encoder/yuv/libyuv/libyuv.go | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/pkg/encoder/yuv/libyuv/libyuv.go b/pkg/encoder/yuv/libyuv/libyuv.go index bf7bbd66..0848c095 100644 --- a/pkg/encoder/yuv/libyuv/libyuv.go +++ b/pkg/encoder/yuv/libyuv/libyuv.go @@ -58,6 +58,20 @@ LIBYUV_API int ARGBToI420(const uint8_t* src_argb, int src_stride_argb, uint8_t* dst_y, int dst_stride_y, uint8_t* dst_u, int dst_stride_u, uint8_t* dst_v, int dst_stride_v, int width, int height); + +void ConvertToI420Custom(const uint8_t* sample, + uint8_t* dst_y, + int dst_stride_y, + uint8_t* dst_u, + int dst_stride_u, + uint8_t* dst_v, + int dst_stride_v, + int src_width, + int src_height, + int crop_width, + int crop_height, + uint32_t fourcc); + #ifdef __cplusplus namespace libyuv { extern "C" { From 37a4a8099658d549c314c819cce55721946a6885 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 3 May 2025 15:55:26 +0300 Subject: [PATCH 316/361] Use the save state size before each save/load call --- pkg/worker/caged/libretro/frontend_test.go | 23 +++++++----- .../caged/libretro/nanoarch/nanoarch.go | 36 ++++++++++++------- 2 files changed, 38 insertions(+), 21 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index f2b108ee..fda0ecbe 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -48,6 +48,7 @@ var ( alwa = game{system: "nes", rom: "nes/Alwa's Awakening (Demo).nes"} sushi = game{system: "gba", rom: "gba/Sushi The Cat.gba"} angua = game{system: "gba", rom: "gba/anguna.gba"} + rogue = game{system: "dos", rom: "dos/rogue.zip"} ) // TestMain runs all tests in the main thread in macOS. @@ -176,6 +177,13 @@ func (emu *TestFrontend) dumpState() (cur string, prev string) { return } +func (emu *TestFrontend) save() ([]byte, error) { + emu.mu.Lock() + defer emu.mu.Unlock() + + return nanoarch.SaveState() +} + func BenchmarkEmulators(b *testing.B) { log.SetOutput(io.Discard) os.Stdout, _ = os.Open(os.DevNull) @@ -204,6 +212,7 @@ func TestSavePersistence(t *testing.T) { tests := []testRun{ {system: sushi.system, rom: sushi.rom, frames: 100}, {system: angua.system, rom: angua.rom, frames: 100}, + {system: rogue.system, rom: rogue.rom, frames: 200}, } for _, test := range tests { @@ -215,14 +224,12 @@ func TestSavePersistence(t *testing.T) { test.frames-- } - _, _ = front.dumpState() - if err := front.Save(); err != nil { - t.Error(err) - } - - hash1, hash2 := front.dumpState() - if hash1 != hash2 { - t.Errorf("%v != %v", hash1, hash2) + for range 10 { + v, _ := front.save() + if v == nil || len(v) == 0 { + t.Errorf("couldn't persist the state") + t.Fail() + } } front.Shutdown() diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 1748ec15..1aca8506 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -495,32 +495,42 @@ const ( // SaveState returns emulator internal state. func SaveState() (State, error) { - data := make([]byte, uint(Nan0.serializeSize)) + size := C.bridge_retro_serialize_size(retroSerializeSize) + data := make([]byte, uint(size)) rez := false + if Nan0.LibCo && !Nan0.hackSkipSameThreadSave { - rez = *(*bool)(C.same_thread_with_args2(retroSerialize, C.int(CallSerialize), unsafe.Pointer(&data[0]), unsafe.Pointer(&Nan0.serializeSize))) + rez = *(*bool)(C.same_thread_with_args2(retroSerialize, C.int(CallSerialize), unsafe.Pointer(&data[0]), unsafe.Pointer(&size))) } else { - rez = bool(C.bridge_retro_serialize(retroSerialize, unsafe.Pointer(&data[0]), Nan0.serializeSize)) + rez = bool(C.bridge_retro_serialize(retroSerialize, unsafe.Pointer(&data[0]), size)) } + if !rez { return nil, errors.New("retro_serialize failed") } + return data, nil } // RestoreSaveState restores emulator internal state. func RestoreSaveState(st State) error { - if len(st) > 0 { - rez := false - if Nan0.LibCo { - rez = *(*bool)(C.same_thread_with_args2(retroUnserialize, C.int(CallUnserialize), unsafe.Pointer(&st[0]), unsafe.Pointer(&Nan0.serializeSize))) - } else { - rez = bool(C.bridge_retro_unserialize(retroUnserialize, unsafe.Pointer(&st[0]), Nan0.serializeSize)) - } - if !rez { - return errors.New("retro_unserialize failed") - } + if len(st) <= 0 { + return errors.New("empty load state") } + + size := C.bridge_retro_serialize_size(retroSerializeSize) + rez := false + + if Nan0.LibCo { + rez = *(*bool)(C.same_thread_with_args2(retroUnserialize, C.int(CallUnserialize), unsafe.Pointer(&st[0]), unsafe.Pointer(&size))) + } else { + rez = bool(C.bridge_retro_unserialize(retroUnserialize, unsafe.Pointer(&st[0]), size)) + } + + if !rez { + return errors.New("retro_unserialize failed") + } + return nil } From 83056bbf4f82354018c6226a5e3f7938f03bb5c0 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 3 May 2025 15:57:41 +0300 Subject: [PATCH 317/361] Update dependencies --- go.mod | 12 ++++++------ go.sum | 51 ++++++++++++--------------------------------------- 2 files changed, 18 insertions(+), 45 deletions(-) diff --git a/go.mod b/go.mod index 88a4a581..4df5c637 100644 --- a/go.mod +++ b/go.mod @@ -3,7 +3,7 @@ module github.com/giongto35/cloud-game/v3 go 1.24 require ( - github.com/VictoriaMetrics/metrics v1.35.2 + github.com/VictoriaMetrics/metrics v1.35.4 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.9.0 github.com/goccy/go-json v0.10.5 @@ -11,11 +11,11 @@ require ( github.com/gorilla/websocket v1.5.3 github.com/knadh/koanf/maps v0.1.2 github.com/knadh/koanf/v2 v2.2.0 - github.com/minio/minio-go/v7 v7.0.90 + github.com/minio/minio-go/v7 v7.0.91 github.com/pion/ice/v4 v4.0.10 github.com/pion/interceptor v0.1.37 github.com/pion/logging v0.2.3 - github.com/pion/webrtc/v4 v4.0.15 + github.com/pion/webrtc/v4 v4.1.0 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.34.0 github.com/veandco/go-sdl2 v0.4.40 @@ -42,13 +42,13 @@ require ( github.com/pion/mdns/v2 v2.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.15 // indirect - github.com/pion/rtp v1.8.13 // indirect - github.com/pion/sctp v1.8.38 // indirect + github.com/pion/rtp v1.8.15 // indirect + github.com/pion/sctp v1.8.39 // indirect github.com/pion/sdp/v3 v3.0.11 // indirect github.com/pion/srtp/v3 v3.0.4 // indirect github.com/pion/stun/v3 v3.0.0 // indirect github.com/pion/transport/v3 v3.0.7 // indirect - github.com/pion/turn/v4 v4.0.0 // indirect + github.com/pion/turn/v4 v4.0.1 // indirect github.com/rogpeppe/go-internal v1.12.0 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect diff --git a/go.sum b/go.sum index e5b53776..6ebe2c6d 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,5 @@ -github.com/VictoriaMetrics/metrics v1.35.2 h1:Bj6L6ExfnakZKYPpi7mGUnkJP4NGQz2v5wiChhXNyWQ= -github.com/VictoriaMetrics/metrics v1.35.2/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= +github.com/VictoriaMetrics/metrics v1.35.4 h1:GhZ17bHYkujpSzGaH459F7huTLNJ7z90ZXsOXjhHx/8= +github.com/VictoriaMetrics/metrics v1.35.4/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -7,8 +7,6 @@ github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto= -github.com/fsnotify/fsnotify v1.8.0 h1:dAwr6QBTBZIkG8roQaJjGof0pp0EeF+tNV7YBP3F/8M= -github.com/fsnotify/fsnotify v1.8.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0= github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k= github.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0= github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A= @@ -29,12 +27,8 @@ github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYW github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE= github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= -github.com/knadh/koanf/maps v0.1.1 h1:G5TjmUh2D7G2YWf5SQQqSiHRJEjaicvU0KpypqB3NIs= -github.com/knadh/koanf/maps v0.1.1/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= github.com/knadh/koanf/maps v0.1.2 h1:RBfmAW5CnZT+PJ1CVc1QSJKf4Xu9kxfQgYVQSu8hpbo= github.com/knadh/koanf/maps v0.1.2/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= -github.com/knadh/koanf/v2 v2.1.2 h1:I2rtLRqXRy1p01m/utEtpZSSA6dcJbgGVuE27kW2PzQ= -github.com/knadh/koanf/v2 v2.1.2/go.mod h1:Gphfaen0q1Fc1HTgJgSTC4oRX9R2R5ErYMZJy8fLJBo= github.com/knadh/koanf/v2 v2.2.0 h1:FZFwd9bUjpb8DyCWARUBy5ovuhDs1lI87dOEn2K8UVU= github.com/knadh/koanf/v2 v2.2.0/go.mod h1:PSFru3ufQgTsI7IF+95rf9s8XA1+aHxKuO/W+dPoHEY= github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= @@ -52,22 +46,16 @@ github.com/minio/crc64nvme v1.0.1 h1:DHQPrYPdqK7jQG/Ls5CTBZWeex/2FMS3G5XGkycuFrY github.com/minio/crc64nvme v1.0.1/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.88 h1:v8MoIJjwYxOkehp+eiLIuvXk87P2raUtoU5klrAAshs= -github.com/minio/minio-go/v7 v7.0.88/go.mod h1:33+O8h0tO7pCeCWwBVa07RhVVfB/3vS4kEX7rwYKmIg= -github.com/minio/minio-go/v7 v7.0.90 h1:TmSj1083wtAD0kEYTx7a5pFsv3iRYMsOJ6A4crjA1lE= -github.com/minio/minio-go/v7 v7.0.90/go.mod h1:uvMUcGrpgeSAAI6+sD3818508nUyMULw94j2Nxku/Go= +github.com/minio/minio-go/v7 v7.0.91 h1:tWLZnEfo3OZl5PoXQwcwTAPNNrjyWwOh6cbZitW5JQc= +github.com/minio/minio-go/v7 v7.0.91/go.mod h1:uvMUcGrpgeSAAI6+sD3818508nUyMULw94j2Nxku/Go= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk4o= github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= -github.com/pion/dtls/v3 v3.0.5 h1:OGWLu21/Wc5+H8R75F1BWvedH7H+nYUPFzJOew4k1iA= -github.com/pion/dtls/v3 v3.0.5/go.mod h1:JVCnfmbgq45QoU07AaxFbdjF2iomKzYouVNy+W5kqmY= github.com/pion/dtls/v3 v3.0.6 h1:7Hkd8WhAJNbRgq9RgdNh1aaWlZlGpYTzdqjy9x9sK2E= github.com/pion/dtls/v3 v3.0.6/go.mod h1:iJxNQ3Uhn1NZWOMWlLxEEHAN5yX7GyPvvKw04v9bzYU= -github.com/pion/ice/v4 v4.0.7 h1:mnwuT3n3RE/9va41/9QJqN5+Bhc0H/x/ZyiVlWMw35M= -github.com/pion/ice/v4 v4.0.7/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= github.com/pion/ice/v4 v4.0.10 h1:P59w1iauC/wPk9PdY8Vjl4fOFL5B+USq1+xbDcN6gT4= github.com/pion/ice/v4 v4.0.10/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= github.com/pion/interceptor v0.1.37 h1:aRA8Zpab/wE7/c0O3fh1PqY0AJI3fCSEM5lRWJVorwI= @@ -80,12 +68,10 @@ github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.15 h1:LZQi2JbdipLOj4eBjK4wlVoQWfrZbh3Q6eHtWtJBZBo= github.com/pion/rtcp v1.2.15/go.mod h1:jlGuAjHMEXwMUHK78RgX0UmEJFV4zUKOFHR7OP+D3D0= -github.com/pion/rtp v1.8.13 h1:8uSUPpjSL4OlwZI8Ygqu7+h2p9NPFB+yAZ461Xn5sNg= -github.com/pion/rtp v1.8.13/go.mod h1:8uMBJj32Pa1wwx8Fuv/AsFhn8jsgw+3rUC2PfoBZ8p4= -github.com/pion/sctp v1.8.37 h1:ZDmGPtRPX9mKCiVXtMbTWybFw3z/hVKAZgU81wcOrqs= -github.com/pion/sctp v1.8.37/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= -github.com/pion/sctp v1.8.38 h1:rntHxO7CyH8jeqC/bkuirl2uJ+BqTp2uxhisi5AYPRQ= -github.com/pion/sctp v1.8.38/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= +github.com/pion/rtp v1.8.15 h1:MuhuGn1cxpVCPLNY1lI7F1tQ8Spntpgf12ob+pOYT8s= +github.com/pion/rtp v1.8.15/go.mod h1:bAu2UFKScgzyFqvUKmbvzSdPr+NGbZtv6UB2hesqXBk= +github.com/pion/sctp v1.8.39 h1:PJma40vRHa3UTO3C4MyeJDQ+KIobVYRZQZ0Nt7SjQnE= +github.com/pion/sctp v1.8.39/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= github.com/pion/sdp/v3 v3.0.11 h1:VhgVSopdsBKwhCFoyyPmT1fKMeV9nLMrEKxNOdy3IVI= github.com/pion/sdp/v3 v3.0.11/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= github.com/pion/srtp/v3 v3.0.4 h1:2Z6vDVxzrX3UHEgrUyIGM4rRouoC7v+NiF1IHtp9B5M= @@ -94,22 +80,17 @@ github.com/pion/stun/v3 v3.0.0 h1:4h1gwhWLWuZWOJIJR9s2ferRO+W3zA/b6ijOI6mKzUw= github.com/pion/stun/v3 v3.0.0/go.mod h1:HvCN8txt8mwi4FBvS3EmDghW6aQJ24T+y+1TKjB5jyU= github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1o0= github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= -github.com/pion/turn/v4 v4.0.0 h1:qxplo3Rxa9Yg1xXDxxH8xaqcyGUtbHYw4QSCvmFWvhM= -github.com/pion/turn/v4 v4.0.0/go.mod h1:MuPDkm15nYSklKpN8vWJ9W2M0PlyQZqYt1McGuxG7mA= -github.com/pion/webrtc/v4 v4.0.13 h1:XuUaWTjRufsiGJRC+G71OgiSMe7tl7mQ0kkd4bAqIaQ= -github.com/pion/webrtc/v4 v4.0.13/go.mod h1:Fadzxm0CbY99YdCEfxrgiVr0L4jN1l8bf8DBkPPpJbs= -github.com/pion/webrtc/v4 v4.0.15 h1:DWuBtTHBa9rQNqyhW+jptkq6r3zdGqr1OQ4pa2Q+Ey4= -github.com/pion/webrtc/v4 v4.0.15/go.mod h1:RXf6sJ8FUX+qwF4+AwB+A3c2Y6WpuATRTe4L/fTWNa4= +github.com/pion/turn/v4 v4.0.1 h1:01UTBhYToe8PDC8piB++i66q1mmctfhhoeguaFqB84c= +github.com/pion/turn/v4 v4.0.1/go.mod h1:pMMKP/ieNAG/fN5cZiN4SDuyKsXtNTr0ccN7IToA1zs= +github.com/pion/webrtc/v4 v4.1.0 h1:yq/p0G5nKGbHISf0YKNA8Yk+kmijbblBvuSLwaJ4QYg= +github.com/pion/webrtc/v4 v4.1.0/go.mod h1:cgEGkcpxGkT6Di2ClBYO5lP9mFXbCfEOrkYUpjjCQO4= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/rogpeppe/go-internal v1.12.0 h1:exVL4IDcn6na9z1rAb56Vxr+CgyK3nn3O+epU5NdKM8= github.com/rogpeppe/go-internal v1.12.0/go.mod h1:E+RYuTGaKKdloAfM02xzb0FW3Paa99yedzYV+kq4uf4= -github.com/rs/xid v1.5.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg= github.com/rs/xid v1.6.0 h1:fV591PaemRlL6JfRxGDEPl69wICngIQ3shQtzfy2gxU= github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0= -github.com/rs/zerolog v1.33.0 h1:1cU2KZkvPxNyfgEmhHAz/1A9Bz+llsdYzklWFzgp0r8= -github.com/rs/zerolog v1.33.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss= github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY= github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ= github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA= @@ -122,25 +103,17 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.36.0 h1:AnAEvhDddvBdpY+uR+MyHmuZzzNqXSe/GvuDeob5L34= -golang.org/x/crypto v0.36.0/go.mod h1:Y4J0ReaxCR1IMaabaSMugxJES1EpwhBHhv2bDHklZvc= golang.org/x/crypto v0.37.0 h1:kJNSjF/Xp7kU0iB2Z+9viTPMW4EqqsrywMXLJOOsXSE= golang.org/x/crypto v0.37.0/go.mod h1:vg+k43peMZ0pUMhYmVAWysMK35e6ioLh3wB8ZCAfbVc= golang.org/x/image v0.25.0 h1:Y6uW6rH1y5y/LK1J8BPWZtr6yZ7hrsy6hFrXjgsc2fQ= golang.org/x/image v0.25.0/go.mod h1:tCAmOEGthTtkalusGp1g3xa2gke8J6c2N565dTyl9Rs= -golang.org/x/net v0.37.0 h1:1zLorHbz+LYj7MQlSf1+2tPIIgibq2eL5xkrGk6f+2c= -golang.org/x/net v0.37.0/go.mod h1:ivrbrMbzFq5J41QOQh0siUuly180yBYtLp+CKbEaFx8= golang.org/x/net v0.39.0 h1:ZCu7HMWDxpXpaiKdhzIfaltL9Lp31x/3fCP11bc6/fY= golang.org/x/net v0.39.0/go.mod h1:X7NRbYVEA+ewNkCNyJ513WmMdQ3BineSwVtN2zD/d+E= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.31.0 h1:ioabZlmFYtWhL+TRYpcnNlLwhyxaM9kWTDEmfnprqik= -golang.org/x/sys v0.31.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= golang.org/x/sys v0.32.0 h1:s77OFDvIQeibCmezSnk/q6iAfkdiQaJi4VzroCFrN20= golang.org/x/sys v0.32.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= -golang.org/x/text v0.23.0 h1:D71I7dUrlY+VX0gQShAThNGHFxZ13dGLBHQLVl1mJlY= -golang.org/x/text v0.23.0/go.mod h1:/BLNzu4aZCJ1+kcD0DNRotWKage4q2rGVAg4o22unh4= golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0= golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= From 36da07f277a0880db82e8d1ec7a81a97133c3c20 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 3 May 2025 16:34:18 +0300 Subject: [PATCH 318/361] Use the actual state size when loading ROMs --- pkg/worker/caged/libretro/nanoarch/nanoarch.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 1aca8506..1f32af3a 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -518,7 +518,7 @@ func RestoreSaveState(st State) error { return errors.New("empty load state") } - size := C.bridge_retro_serialize_size(retroSerializeSize) + size := C.size_t(len(st)) rez := false if Nan0.LibCo { From 817a19c757c08b240da34633f143b14b8e9beda7 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 16 May 2025 12:15:37 +0300 Subject: [PATCH 319/361] Fix the circle-pad's roundness --- web/css/main.css | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/web/css/main.css b/web/css/main.css index e01eb372..4b95690d 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -100,7 +100,7 @@ body { #circle-pad { display: block; - width: 70px; + width: 69px; height: 70px; position: absolute; background-size: contain; From 02210f1f8d4015821533a12f7eebd9d9e5425659 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 18 May 2025 12:46:32 +0300 Subject: [PATCH 320/361] Remove unnecessary C bridge functions --- pkg/worker/caged/libretro/nanoarch/nanoarch.c | 52 ++++--------------- .../caged/libretro/nanoarch/nanoarch.go | 52 ++++++++----------- pkg/worker/caged/libretro/nanoarch/nanoarch.h | 12 ++--- 3 files changed, 35 insertions(+), 81 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.c b/pkg/worker/caged/libretro/nanoarch/nanoarch.c index cb474d98..6290150c 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.c +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.c @@ -36,14 +36,12 @@ void core_log_cgo(enum retro_log_level level, const char *fmt, ...) { coreLog(level, msg); } -void bridge_retro_init(void *f) { - core_log_cgo(RETRO_LOG_DEBUG, "Initialization...\n"); +void bridge_call(void *f) { ((void (*)(void)) f)(); } -void bridge_retro_deinit(void *f) { - core_log_cgo(RETRO_LOG_DEBUG, "Deinitialiazation...\n"); - ((void (*)(void)) f)(); +void bridge_set_callback(void *f, void *callback) { + ((void (*)(void *))f)(callback); } unsigned bridge_retro_api_version(void *f) { @@ -62,44 +60,14 @@ bool bridge_retro_set_environment(void *f, void *callback) { return ((bool (*)(retro_environment_t)) f)((retro_environment_t) callback); } -void bridge_retro_set_video_refresh(void *f, void *callback) { - ((bool (*)(retro_video_refresh_t)) f)((retro_video_refresh_t) callback); -} - -void bridge_retro_set_input_poll(void *f, void *callback) { - ((bool (*)(retro_input_poll_t)) f)((retro_input_poll_t) callback); -} - void bridge_retro_set_input_state(void *f, void *callback) { - ((bool (*)(retro_input_state_t)) f)((retro_input_state_t) callback); -} - -void bridge_retro_set_audio_sample(void *f, void *callback) { - ((bool (*)(retro_audio_sample_t)) f)((retro_audio_sample_t) callback); -} - -void bridge_retro_set_audio_sample_batch(void *f, void *callback) { - ((bool (*)(retro_audio_sample_batch_t)) f)((retro_audio_sample_batch_t) callback); + ((int16_t (*)(retro_input_state_t)) f)((retro_input_state_t) callback); } bool bridge_retro_load_game(void *f, struct retro_game_info *gi) { - core_log_cgo(RETRO_LOG_DEBUG, "Loading the game...\n"); return ((bool (*)(struct retro_game_info *)) f)(gi); } -void bridge_retro_unload_game(void *f) { - core_log_cgo(RETRO_LOG_DEBUG, "Unloading the game...\n"); - ((void (*)(void)) f)(); -} - -void bridge_retro_reset(void *f) { - ((void (*)(void)) f)(); -} - -void bridge_retro_run(void *f) { - ((void (*)(void)) f)(); -} - size_t bridge_retro_get_memory_size(void *f, unsigned id) { return ((size_t (*)(unsigned)) f)(id); } @@ -173,8 +141,6 @@ void core_video_refresh_cgo(void *data, unsigned width, unsigned height, size_t } void core_input_poll_cgo() { - void coreInputPoll(); - coreInputPoll(); } int16_t core_input_state_cgo(unsigned port, unsigned device, unsigned index, unsigned id) { @@ -182,16 +148,16 @@ int16_t core_input_state_cgo(unsigned port, unsigned device, unsigned index, uns return coreInputState(port, device, index, id); } -void core_audio_sample_cgo(int16_t left, int16_t right) { - void coreAudioSample(int16_t, int16_t); - coreAudioSample(left, right); -} - size_t core_audio_sample_batch_cgo(const int16_t *data, size_t frames) { size_t coreAudioSampleBatch(const int16_t *, size_t); return coreAudioSampleBatch(data, frames); } +void core_audio_sample_cgo(int16_t left, int16_t right) { + int16_t frame[2] = { left, right }; + core_audio_sample_batch_cgo(frame, 1); +} + uintptr_t core_get_current_framebuffer_cgo() { uintptr_t coreGetCurrentFramebuffer(); return coreGetCurrentFramebuffer(); diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 1f32af3a..fd12ef14 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -49,8 +49,9 @@ type Nanoarch struct { serializeSize C.size_t Stopped atomic.Bool sys struct { - av C.struct_retro_system_av_info - i C.struct_retro_system_info + av C.struct_retro_system_av_info + i C.struct_retro_system_info + api C.unsigned } tickTime int64 cSaveDirectory *C.char @@ -213,7 +214,7 @@ func (n *Nanoarch) CoreLoad(meta Metadata) { retroInit = loadFunction(coreLib, "retro_init") retroDeinit = loadFunction(coreLib, "retro_deinit") - //retroAPIVersion = loadFunction(coreLib, "retro_api_version") + retroAPIVersion = loadFunction(coreLib, "retro_api_version") retroGetSystemInfo = loadFunction(coreLib, "retro_get_system_info") retroGetSystemAVInfo = loadFunction(coreLib, "retro_get_system_av_info") retroSetEnvironment = loadFunction(coreLib, "retro_set_environment") @@ -234,22 +235,24 @@ func (n *Nanoarch) CoreLoad(meta Metadata) { retroGetMemoryData = loadFunction(coreLib, "retro_get_memory_data") C.bridge_retro_set_environment(retroSetEnvironment, C.core_environment_cgo) - C.bridge_retro_set_video_refresh(retroSetVideoRefresh, C.core_video_refresh_cgo) - C.bridge_retro_set_input_poll(retroSetInputPoll, C.core_input_poll_cgo) C.bridge_retro_set_input_state(retroSetInputState, C.core_input_state_cgo) - C.bridge_retro_set_audio_sample(retroSetAudioSample, C.core_audio_sample_cgo) - C.bridge_retro_set_audio_sample_batch(retroSetAudioSampleBatch, C.core_audio_sample_batch_cgo) + C.bridge_set_callback(retroSetVideoRefresh, C.core_video_refresh_cgo) + C.bridge_set_callback(retroSetInputPoll, C.core_input_poll_cgo) + C.bridge_set_callback(retroSetAudioSample, C.core_audio_sample_cgo) + C.bridge_set_callback(retroSetAudioSampleBatch, C.core_audio_sample_batch_cgo) if n.LibCo { C.same_thread(retroInit) } else { - C.bridge_retro_init(retroInit) + C.bridge_call(retroInit) } + n.sys.api = C.bridge_retro_api_version(retroAPIVersion) C.bridge_retro_get_system_info(retroGetSystemInfo, &n.sys.i) - n.log.Debug().Msgf("System >>> %v (%v) [%v] nfp: %v", + n.log.Info().Msgf("System >>> %v (%v) [%v] nfp: %v, api: %v", C.GoString(n.sys.i.library_name), C.GoString(n.sys.i.library_version), - C.GoString(n.sys.i.valid_extensions), bool(n.sys.i.need_fullpath)) + C.GoString(n.sys.i.valid_extensions), bool(n.sys.i.need_fullpath), + uint(n.sys.api)) } func (n *Nanoarch) LoadGame(path string) error { @@ -367,8 +370,8 @@ func (n *Nanoarch) Shutdown() { } }) } - C.bridge_retro_unload_game(retroUnloadGame) - C.bridge_retro_deinit(retroDeinit) + C.bridge_call(retroUnloadGame) + C.bridge_call(retroDeinit) if n.Video.gl.enabled { thread.Main(func() { deinitVideo() @@ -390,7 +393,7 @@ func (n *Nanoarch) Shutdown() { } func (n *Nanoarch) Reset() { - C.bridge_retro_reset(retroReset) + C.bridge_call(retroReset) } func (n *Nanoarch) Run() { @@ -404,7 +407,7 @@ func (n *Nanoarch) Run() { n.log.Error().Err(err).Msg("ctx bind fail") } } - C.bridge_retro_run(retroRun) + C.bridge_call(retroRun) if n.Video.gl.enabled { runtime.UnlockOSThread() } @@ -553,19 +556,19 @@ func RestoreSaveRAM(st State) { } } -// getMemorySize returns memory region size. -func getMemorySize(id C.uint) uint { +// memorySize returns memory region size. +func memorySize(id C.uint) uint { return uint(C.bridge_retro_get_memory_size(retroGetMemorySize, id)) } -// getMemoryData returns a pointer to memory data. -func getMemoryData(id C.uint) unsafe.Pointer { +// memoryData returns a pointer to memory data. +func memoryData(id C.uint) unsafe.Pointer { return C.bridge_retro_get_memory_data(retroGetMemoryData, id) } // ptSaveRam return SRAM memory pointer if core supports it or nil. func ptSaveRAM() *mem { - ptr, size := getMemoryData(C.RETRO_MEMORY_SAVE_RAM), getMemorySize(C.RETRO_MEMORY_SAVE_RAM) + ptr, size := memoryData(C.RETRO_MEMORY_SAVE_RAM), memorySize(C.RETRO_MEMORY_SAVE_RAM) if ptr == nil || size == 0 { return nil } @@ -595,7 +598,7 @@ func (m Metadata) HasHack(h string) bool { } var ( - //retroAPIVersion unsafe.Pointer + retroAPIVersion unsafe.Pointer retroDeinit unsafe.Pointer retroGetSystemAVInfo unsafe.Pointer retroGetSystemInfo unsafe.Pointer @@ -669,9 +672,6 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { Nan0.Handlers.OnVideo(data_, int32(dt), FrameInfo{W: width, H: height, Stride: packed}) } -//export coreInputPoll -func coreInputPoll() {} - //export coreInputState func coreInputState(port C.unsigned, device C.unsigned, index C.unsigned, id C.unsigned) C.int16_t { //Nan0.log.Debug().Msgf("%v %v %v %v", port, device, index, id) @@ -725,12 +725,6 @@ func coreInputState(port C.unsigned, device C.unsigned, index C.unsigned, id C.u return Released } -//export coreAudioSample -func coreAudioSample(l, r C.int16_t) { - frame := []C.int16_t{l, r} - coreAudioSampleBatch(unsafe.Pointer(&frame), 1) -} - //export coreAudioSampleBatch func coreAudioSampleBatch(data unsafe.Pointer, frames C.size_t) C.size_t { if Nan0.Stopped.Load() { diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.h b/pkg/worker/caged/libretro/nanoarch/nanoarch.h index 1ad85f08..d8e09265 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.h +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.h @@ -1,8 +1,10 @@ #ifndef FRONTEND_H__ #define FRONTEND_H__ +void bridge_call(void *f); +void bridge_set_callback(void *f, void *callback); + bool bridge_retro_load_game(void *f, struct retro_game_info *gi); -void bridge_retro_unload_game(void *f); bool bridge_retro_serialize(void *f, void *data, size_t size); size_t bridge_retro_serialize_size(void *f); bool bridge_retro_unserialize(void *f, void *data, size_t size); @@ -11,18 +13,10 @@ unsigned bridge_retro_api_version(void *f); size_t bridge_retro_get_memory_size(void *f, unsigned id); void *bridge_retro_get_memory_data(void *f, unsigned id); void bridge_context_reset(retro_hw_context_reset_t f); -void bridge_retro_deinit(void *f); void bridge_retro_get_system_av_info(void *f, struct retro_system_av_info *si); void bridge_retro_get_system_info(void *f, struct retro_system_info *si); -void bridge_retro_init(void *f); -void bridge_retro_reset(void *f); -void bridge_retro_run(void *f); -void bridge_retro_set_audio_sample(void *f, void *callback); -void bridge_retro_set_audio_sample_batch(void *f, void *callback); void bridge_retro_set_controller_port_device(void *f, unsigned port, unsigned device); -void bridge_retro_set_input_poll(void *f, void *callback); void bridge_retro_set_input_state(void *f, void *callback); -void bridge_retro_set_video_refresh(void *f, void *callback); void bridge_retro_keyboard_callback(void *f, bool down, unsigned keycode, uint32_t character, uint16_t keyModifiers); bool core_environment_cgo(unsigned cmd, void *data); From 8083ba086b1137734980e7aabcb3eaa1745b64ca Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Wed, 28 May 2025 08:19:02 +0300 Subject: [PATCH 321/361] Use /usr/bin/env in the shebang line of shell scripts to ensure portability --- scripts/mkdirs.sh | 2 +- scripts/version.sh | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/scripts/mkdirs.sh b/scripts/mkdirs.sh index 93e975b1..2ddfb767 100755 --- a/scripts/mkdirs.sh +++ b/scripts/mkdirs.sh @@ -1,4 +1,4 @@ -#!/bin/sh +#!/usr/bin/env sh app="$1" diff --git a/scripts/version.sh b/scripts/version.sh index 8a33daa6..3e273791 100755 --- a/scripts/version.sh +++ b/scripts/version.sh @@ -1,4 +1,4 @@ -#!/bin/sh +#!/usr/bin/env sh file="$1" version="$2" From d8eed66a1da8e72c0ab662484bf97b2eb82164f0 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Wed, 28 May 2025 15:30:51 +0300 Subject: [PATCH 322/361] Update dependencies --- go.mod | 32 +++++++++++++------------ go.sum | 76 +++++++++++++++++++++++++++++++++++++++------------------- 2 files changed, 69 insertions(+), 39 deletions(-) diff --git a/go.mod b/go.mod index 4df5c637..0ef958d6 100644 --- a/go.mod +++ b/go.mod @@ -3,23 +3,23 @@ module github.com/giongto35/cloud-game/v3 go 1.24 require ( - github.com/VictoriaMetrics/metrics v1.35.4 + github.com/VictoriaMetrics/metrics v1.38.0 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.9.0 github.com/goccy/go-json v0.10.5 github.com/gofrs/flock v0.12.1 github.com/gorilla/websocket v1.5.3 github.com/knadh/koanf/maps v0.1.2 - github.com/knadh/koanf/v2 v2.2.0 - github.com/minio/minio-go/v7 v7.0.91 + github.com/knadh/koanf/v2 v2.2.1 + github.com/minio/minio-go/v7 v7.0.94 github.com/pion/ice/v4 v4.0.10 - github.com/pion/interceptor v0.1.37 + github.com/pion/interceptor v0.1.40 github.com/pion/logging v0.2.3 - github.com/pion/webrtc/v4 v4.1.0 + github.com/pion/webrtc/v4 v4.1.2 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.34.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.37.0 + golang.org/x/crypto v0.39.0 golang.org/x/image v0.25.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -27,33 +27,35 @@ require ( require ( github.com/dustin/go-humanize v1.0.1 // indirect github.com/go-ini/ini v1.67.0 // indirect - github.com/go-viper/mapstructure/v2 v2.2.1 // indirect + github.com/go-viper/mapstructure/v2 v2.3.0 // indirect github.com/google/uuid v1.6.0 // indirect github.com/klauspost/compress v1.18.0 // indirect github.com/klauspost/cpuid/v2 v2.2.10 // indirect github.com/mattn/go-colorable v0.1.14 // indirect github.com/mattn/go-isatty v0.0.20 // indirect - github.com/minio/crc64nvme v1.0.1 // indirect + github.com/minio/crc64nvme v1.0.2 // indirect github.com/minio/md5-simd v1.1.2 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect + github.com/philhofer/fwd v1.1.3-0.20240916144458-20a13a1f6b7c // indirect github.com/pion/datachannel v1.5.10 // indirect github.com/pion/dtls/v3 v3.0.6 // indirect github.com/pion/mdns/v2 v2.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.15 // indirect - github.com/pion/rtp v1.8.15 // indirect + github.com/pion/rtp v1.8.19 // indirect github.com/pion/sctp v1.8.39 // indirect - github.com/pion/sdp/v3 v3.0.11 // indirect - github.com/pion/srtp/v3 v3.0.4 // indirect + github.com/pion/sdp/v3 v3.0.14 // indirect + github.com/pion/srtp/v3 v3.0.6 // indirect github.com/pion/stun/v3 v3.0.0 // indirect github.com/pion/transport/v3 v3.0.7 // indirect - github.com/pion/turn/v4 v4.0.1 // indirect + github.com/pion/turn/v4 v4.0.2 // indirect github.com/rogpeppe/go-internal v1.12.0 // indirect + github.com/tinylib/msgp v1.3.0 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.39.0 // indirect - golang.org/x/sys v0.32.0 // indirect - golang.org/x/text v0.24.0 // indirect + golang.org/x/net v0.41.0 // indirect + golang.org/x/sys v0.33.0 // indirect + golang.org/x/text v0.26.0 // indirect ) diff --git a/go.sum b/go.sum index 6ebe2c6d..5ca2900f 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,7 @@ -github.com/VictoriaMetrics/metrics v1.35.4 h1:GhZ17bHYkujpSzGaH459F7huTLNJ7z90ZXsOXjhHx/8= -github.com/VictoriaMetrics/metrics v1.35.4/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= +github.com/VictoriaMetrics/metrics v1.37.0 h1:u5Yr+HFofQyn7kgmmkufgkX0nEA6G1oEyK2eaKsVaUM= +github.com/VictoriaMetrics/metrics v1.37.0/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= +github.com/VictoriaMetrics/metrics v1.38.0 h1:1d0dRgVH8Nnu8dKMfisKefPC3q7gqf3/odyO0quAvyA= +github.com/VictoriaMetrics/metrics v1.38.0/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -13,6 +15,8 @@ github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A= github.com/go-ini/ini v1.67.0/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8= github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIxtHqx8aGss= github.com/go-viper/mapstructure/v2 v2.2.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM= +github.com/go-viper/mapstructure/v2 v2.3.0 h1:27XbWsHIqhbdR5TIC911OfYvgSaW93HM+dX7970Q7jk= +github.com/go-viper/mapstructure/v2 v2.3.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM= github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4= github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M= github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= @@ -31,6 +35,8 @@ github.com/knadh/koanf/maps v0.1.2 h1:RBfmAW5CnZT+PJ1CVc1QSJKf4Xu9kxfQgYVQSu8hpb github.com/knadh/koanf/maps v0.1.2/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= github.com/knadh/koanf/v2 v2.2.0 h1:FZFwd9bUjpb8DyCWARUBy5ovuhDs1lI87dOEn2K8UVU= github.com/knadh/koanf/v2 v2.2.0/go.mod h1:PSFru3ufQgTsI7IF+95rf9s8XA1+aHxKuO/W+dPoHEY= +github.com/knadh/koanf/v2 v2.2.1 h1:jaleChtw85y3UdBnI0wCqcg1sj1gPoz6D3caGNHtrNE= +github.com/knadh/koanf/v2 v2.2.1/go.mod h1:PSFru3ufQgTsI7IF+95rf9s8XA1+aHxKuO/W+dPoHEY= github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= @@ -42,24 +48,30 @@ github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/ github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= -github.com/minio/crc64nvme v1.0.1 h1:DHQPrYPdqK7jQG/Ls5CTBZWeex/2FMS3G5XGkycuFrY= -github.com/minio/crc64nvme v1.0.1/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= +github.com/minio/crc64nvme v1.0.2 h1:6uO1UxGAD+kwqWWp7mBFsi5gAse66C4NXO8cmcVculg= +github.com/minio/crc64nvme v1.0.2/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.91 h1:tWLZnEfo3OZl5PoXQwcwTAPNNrjyWwOh6cbZitW5JQc= -github.com/minio/minio-go/v7 v7.0.91/go.mod h1:uvMUcGrpgeSAAI6+sD3818508nUyMULw94j2Nxku/Go= +github.com/minio/minio-go/v7 v7.0.92 h1:jpBFWyRS3p8P/9tsRc+NuvqoFi7qAmTCFPoRFmobbVw= +github.com/minio/minio-go/v7 v7.0.92/go.mod h1:vTIc8DNcnAZIhyFsk8EB90AbPjj3j68aWIEQCiPj7d0= +github.com/minio/minio-go/v7 v7.0.94 h1:1ZoksIKPyaSt64AVOyaQvhDOgVC3MfZsWM6mZXRUGtM= +github.com/minio/minio-go/v7 v7.0.94/go.mod h1:71t2CqDt3ThzESgZUlU1rBN54mksGGlkLcFgguDnnAc= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= +github.com/philhofer/fwd v1.1.3-0.20240916144458-20a13a1f6b7c h1:dAMKvw0MlJT1GshSTtih8C2gDs04w8dReiOGXrGLNoY= +github.com/philhofer/fwd v1.1.3-0.20240916144458-20a13a1f6b7c/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM= github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk4o= github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= github.com/pion/dtls/v3 v3.0.6 h1:7Hkd8WhAJNbRgq9RgdNh1aaWlZlGpYTzdqjy9x9sK2E= github.com/pion/dtls/v3 v3.0.6/go.mod h1:iJxNQ3Uhn1NZWOMWlLxEEHAN5yX7GyPvvKw04v9bzYU= github.com/pion/ice/v4 v4.0.10 h1:P59w1iauC/wPk9PdY8Vjl4fOFL5B+USq1+xbDcN6gT4= github.com/pion/ice/v4 v4.0.10/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= -github.com/pion/interceptor v0.1.37 h1:aRA8Zpab/wE7/c0O3fh1PqY0AJI3fCSEM5lRWJVorwI= -github.com/pion/interceptor v0.1.37/go.mod h1:JzxbJ4umVTlZAf+/utHzNesY8tmRkM2lVmkS82TTj8Y= +github.com/pion/interceptor v0.1.38 h1:Mgt3XIIq47uR5vcLLahfRucE6tFPjxHak+z5ZZFEzLU= +github.com/pion/interceptor v0.1.38/go.mod h1:HS9X+Ue5LDE6q2C2tuvOuO83XkBdJFgn6MBDtfoJX4Q= +github.com/pion/interceptor v0.1.40 h1:e0BjnPcGpr2CFQgKhrQisBU7V3GXK6wrfYrGYaU6Jq4= +github.com/pion/interceptor v0.1.40/go.mod h1:Z6kqH7M/FYirg3frjGJ21VLSRJGBXB/KqaTIrdqnOic= github.com/pion/logging v0.2.3 h1:gHuf0zpoh1GW67Nr6Gj4cv5Z9ZscU7g/EaoC/Ke/igI= github.com/pion/logging v0.2.3/go.mod h1:z8YfknkquMe1csOrxK5kc+5/ZPAzMxbKLX5aXpbpC90= github.com/pion/mdns/v2 v2.0.7 h1:c9kM8ewCgjslaAmicYMFQIde2H9/lrZpjBkN8VwoVtM= @@ -68,22 +80,30 @@ github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.15 h1:LZQi2JbdipLOj4eBjK4wlVoQWfrZbh3Q6eHtWtJBZBo= github.com/pion/rtcp v1.2.15/go.mod h1:jlGuAjHMEXwMUHK78RgX0UmEJFV4zUKOFHR7OP+D3D0= -github.com/pion/rtp v1.8.15 h1:MuhuGn1cxpVCPLNY1lI7F1tQ8Spntpgf12ob+pOYT8s= -github.com/pion/rtp v1.8.15/go.mod h1:bAu2UFKScgzyFqvUKmbvzSdPr+NGbZtv6UB2hesqXBk= +github.com/pion/rtp v1.8.16 h1:0mpfguLyN9HCpPIXcoOho4BkMsz5eB1Yjvf+obI5cEQ= +github.com/pion/rtp v1.8.16/go.mod h1:bAu2UFKScgzyFqvUKmbvzSdPr+NGbZtv6UB2hesqXBk= +github.com/pion/rtp v1.8.19 h1:jhdO/3XhL/aKm/wARFVmvTfq0lC/CvN1xwYKmduly3c= +github.com/pion/rtp v1.8.19/go.mod h1:bAu2UFKScgzyFqvUKmbvzSdPr+NGbZtv6UB2hesqXBk= github.com/pion/sctp v1.8.39 h1:PJma40vRHa3UTO3C4MyeJDQ+KIobVYRZQZ0Nt7SjQnE= github.com/pion/sctp v1.8.39/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= -github.com/pion/sdp/v3 v3.0.11 h1:VhgVSopdsBKwhCFoyyPmT1fKMeV9nLMrEKxNOdy3IVI= -github.com/pion/sdp/v3 v3.0.11/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= +github.com/pion/sdp/v3 v3.0.13 h1:uN3SS2b+QDZnWXgdr69SM8KB4EbcnPnPf2Laxhty/l4= +github.com/pion/sdp/v3 v3.0.13/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= +github.com/pion/sdp/v3 v3.0.14 h1:1h7gBr9FhOWH5GjWWY5lcw/U85MtdcibTyt/o6RxRUI= +github.com/pion/sdp/v3 v3.0.14/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= github.com/pion/srtp/v3 v3.0.4 h1:2Z6vDVxzrX3UHEgrUyIGM4rRouoC7v+NiF1IHtp9B5M= github.com/pion/srtp/v3 v3.0.4/go.mod h1:1Jx3FwDoxpRaTh1oRV8A/6G1BnFL+QI82eK4ms8EEJQ= +github.com/pion/srtp/v3 v3.0.6 h1:E2gyj1f5X10sB/qILUGIkL4C2CqK269Xq167PbGCc/4= +github.com/pion/srtp/v3 v3.0.6/go.mod h1:BxvziG3v/armJHAaJ87euvkhHqWe9I7iiOy50K2QkhY= github.com/pion/stun/v3 v3.0.0 h1:4h1gwhWLWuZWOJIJR9s2ferRO+W3zA/b6ijOI6mKzUw= github.com/pion/stun/v3 v3.0.0/go.mod h1:HvCN8txt8mwi4FBvS3EmDghW6aQJ24T+y+1TKjB5jyU= github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1o0= github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= -github.com/pion/turn/v4 v4.0.1 h1:01UTBhYToe8PDC8piB++i66q1mmctfhhoeguaFqB84c= -github.com/pion/turn/v4 v4.0.1/go.mod h1:pMMKP/ieNAG/fN5cZiN4SDuyKsXtNTr0ccN7IToA1zs= -github.com/pion/webrtc/v4 v4.1.0 h1:yq/p0G5nKGbHISf0YKNA8Yk+kmijbblBvuSLwaJ4QYg= -github.com/pion/webrtc/v4 v4.1.0/go.mod h1:cgEGkcpxGkT6Di2ClBYO5lP9mFXbCfEOrkYUpjjCQO4= +github.com/pion/turn/v4 v4.0.2 h1:ZqgQ3+MjP32ug30xAbD6Mn+/K4Sxi3SdNOTFf+7mpps= +github.com/pion/turn/v4 v4.0.2/go.mod h1:pMMKP/ieNAG/fN5cZiN4SDuyKsXtNTr0ccN7IToA1zs= +github.com/pion/webrtc/v4 v4.1.1 h1:PMFPtLg1kpD2pVtun+LGUzA3k54JdFl87WO0Z1+HKug= +github.com/pion/webrtc/v4 v4.1.1/go.mod h1:cgEGkcpxGkT6Di2ClBYO5lP9mFXbCfEOrkYUpjjCQO4= +github.com/pion/webrtc/v4 v4.1.2 h1:mpuUo/EJ1zMNKGE79fAdYNFZBX790KE7kQQpLMjjR54= +github.com/pion/webrtc/v4 v4.1.2/go.mod h1:xsCXiNAmMEjIdFxAYU0MbB3RwRieJsegSB2JZsGN+8U= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -95,6 +115,8 @@ github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY= github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ= github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA= github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= +github.com/tinylib/msgp v1.3.0 h1:ULuf7GPooDaIlbyvgAxBV/FI7ynli6LZ1/nVUNu+0ww= +github.com/tinylib/msgp v1.3.0/go.mod h1:ykjzy2wzgrlvpDCRc4LA8UXy6D8bzMSuAF3WD57Gok0= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= @@ -103,19 +125,25 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.37.0 h1:kJNSjF/Xp7kU0iB2Z+9viTPMW4EqqsrywMXLJOOsXSE= -golang.org/x/crypto v0.37.0/go.mod h1:vg+k43peMZ0pUMhYmVAWysMK35e6ioLh3wB8ZCAfbVc= +golang.org/x/crypto v0.38.0 h1:jt+WWG8IZlBnVbomuhg2Mdq0+BBQaHbtqHEFEigjUV8= +golang.org/x/crypto v0.38.0/go.mod h1:MvrbAqul58NNYPKnOra203SB9vpuZW0e+RRZV+Ggqjw= +golang.org/x/crypto v0.39.0 h1:SHs+kF4LP+f+p14esP5jAoDpHU8Gu/v9lFRK6IT5imM= +golang.org/x/crypto v0.39.0/go.mod h1:L+Xg3Wf6HoL4Bn4238Z6ft6KfEpN0tJGo53AAPC632U= golang.org/x/image v0.25.0 h1:Y6uW6rH1y5y/LK1J8BPWZtr6yZ7hrsy6hFrXjgsc2fQ= golang.org/x/image v0.25.0/go.mod h1:tCAmOEGthTtkalusGp1g3xa2gke8J6c2N565dTyl9Rs= -golang.org/x/net v0.39.0 h1:ZCu7HMWDxpXpaiKdhzIfaltL9Lp31x/3fCP11bc6/fY= -golang.org/x/net v0.39.0/go.mod h1:X7NRbYVEA+ewNkCNyJ513WmMdQ3BineSwVtN2zD/d+E= +golang.org/x/net v0.40.0 h1:79Xs7wF06Gbdcg4kdCCIQArK11Z1hr5POQ6+fIYHNuY= +golang.org/x/net v0.40.0/go.mod h1:y0hY0exeL2Pku80/zKK7tpntoX23cqL3Oa6njdgRtds= +golang.org/x/net v0.41.0 h1:vBTly1HeNPEn3wtREYfy4GZ/NECgw2Cnl+nK6Nz3uvw= +golang.org/x/net v0.41.0/go.mod h1:B/K4NNqkfmg07DQYrbwvSluqCJOOXwUjeb/5lOisjbA= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.32.0 h1:s77OFDvIQeibCmezSnk/q6iAfkdiQaJi4VzroCFrN20= -golang.org/x/sys v0.32.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= -golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0= -golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU= +golang.org/x/sys v0.33.0 h1:q3i8TbbEz+JRD9ywIRlyRAQbM0qF7hu24q3teo2hbuw= +golang.org/x/sys v0.33.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= +golang.org/x/text v0.25.0 h1:qVyWApTSYLk/drJRO5mDlNYskwQznZmkpV2c8q9zls4= +golang.org/x/text v0.25.0/go.mod h1:WEdwpYrmk1qmdHvhkSTNPm3app7v4rsT8F2UD6+VHIA= +golang.org/x/text v0.26.0 h1:P42AVeLghgTYr4+xUnTRKDMqpar+PtX7KWuNQL21L8M= +golang.org/x/text v0.26.0/go.mod h1:QK15LZJUUQVJxhz7wXgxSy/CJaTFjd0G+YLonydOVQA= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= From 42b003db6293f8d9b832dd1312b661e1f9218cca Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 20 Jun 2025 18:12:47 +0300 Subject: [PATCH 323/361] Verifies during startup if the system can run the emulator This check can be disabled with the emulator.failFast = false config option. Right now it checks SDL2 video context creation. --- pkg/config/config.yaml | 3 +++ pkg/config/emulator.go | 1 + pkg/worker/caged/libretro/caged.go | 8 ++++++++ pkg/worker/caged/libretro/frontend.go | 5 +++++ pkg/worker/caged/libretro/graphics/sdl.go | 9 +++++++++ pkg/worker/caged/libretro/nanoarch/nanoarch.go | 1 + 6 files changed, 27 insertions(+) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 33eb0b2a..1a1d2803 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -137,6 +137,9 @@ emulator: # path for storing emulator generated files localPath: "./libretro" + # checks if the system supports running an emulator at startup + failFast: true + libretro: # use zip compression for emulator save states saveCompression: true diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index d3daca3e..013225f7 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -9,6 +9,7 @@ import ( ) type Emulator struct { + FailFast bool Threads int Storage string LocalPath string diff --git a/pkg/worker/caged/libretro/caged.go b/pkg/worker/caged/libretro/caged.go index 8c06776b..3d21db11 100644 --- a/pkg/worker/caged/libretro/caged.go +++ b/pkg/worker/caged/libretro/caged.go @@ -31,6 +31,13 @@ func (c *Caged) Init() error { if err := manager.CheckCores(c.conf.Emulator, c.log); err != nil { c.log.Warn().Err(err).Msgf("a Libretro cores sync fail") } + + if c.conf.Emulator.FailFast { + if err := c.IsSupported(); err != nil { + return err + } + } + return nil } @@ -92,3 +99,4 @@ func (c *Caged) Start() { go c.Emulator.Start() } func (c *Caged) SetSaveOnClose(v bool) { c.base.SaveOnClose = v } func (c *Caged) SetSessionId(name string) { c.base.SetSessionId(name) } func (c *Caged) Close() { c.Emulator.Close() } +func (c *Caged) IsSupported() error { return c.base.IsSupported() } diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index c3666e98..8d0a73ac 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -13,6 +13,7 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/logger" "github.com/giongto35/cloud-game/v3/pkg/os" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" + "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/graphics" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/nanoarch" ) @@ -422,6 +423,10 @@ func (f *Frontend) Load() error { return nil } +func (f *Frontend) IsSupported() error { + return graphics.TryInit() +} + func (f *Frontend) autosave(periodSec int) { f.log.Info().Msgf("Autosave every [%vs]", periodSec) ticker := time.NewTicker(time.Duration(periodSec) * time.Second) diff --git a/pkg/worker/caged/libretro/graphics/sdl.go b/pkg/worker/caged/libretro/graphics/sdl.go index d0df2c1d..7c25efbd 100644 --- a/pkg/worker/caged/libretro/graphics/sdl.go +++ b/pkg/worker/caged/libretro/graphics/sdl.go @@ -76,6 +76,15 @@ func NewSDLContext(cfg Config, log *logger.Logger) (*SDL, error) { return &display, nil } +// TryInit check weather SDL context can be created on the system. +func TryInit() error { + if err := sdl.Init(sdl.INIT_VIDEO); err != nil { + return fmt.Errorf("SDL init fail: %w", err) + } + sdl.Quit() + return nil +} + // Deinit destroys SDL/OpenGL context. // Uses main thread lock (see thread/mainthread). func (s *SDL) Deinit() error { diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index fd12ef14..e26ee07d 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -414,6 +414,7 @@ func (n *Nanoarch) Run() { } } +func (n *Nanoarch) IsSupported() error { return graphics.TryInit() } func (n *Nanoarch) IsGL() bool { return n.Video.gl.enabled } func (n *Nanoarch) IsStopped() bool { return n.Stopped.Load() } func (n *Nanoarch) InputRetropad(port int, data []byte) { n.retropad.Input(port, data) } From e03fbadcaa422e2e30af57022ae51ce50b9eb67c Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 8 Aug 2025 19:41:17 +0300 Subject: [PATCH 324/361] Update dependencies go: upgraded github.com/VictoriaMetrics/metrics v1.38.0 => v1.39.1 go: upgraded github.com/go-viper/mapstructure/v2 v2.3.0 => v2.4.0 go: upgraded github.com/klauspost/cpuid/v2 v2.2.10 => v2.3.0 go: upgraded github.com/knadh/koanf/v2 v2.2.1 => v2.2.2 go: upgraded github.com/minio/crc64nvme v1.0.2 => v1.1.0 go: upgraded github.com/minio/minio-go/v7 v7.0.94 => v7.0.95 go: upgraded github.com/philhofer/fwd v1.1.3-0.20240916144458-20a13a1f6b7c => v1.2.0 go: upgraded github.com/pion/logging v0.2.3 => v0.2.4 go: upgraded github.com/pion/rtp v1.8.19 => v1.8.21 go: upgraded github.com/pion/sdp/v3 v3.0.14 => v3.0.15 go: upgraded github.com/pion/turn/v4 v4.0.2 => v4.1.0 go: upgraded github.com/pion/webrtc/v4 v4.1.2 => v4.1.3 go: upgraded golang.org/x/crypto v0.39.0 => v0.41.0 go: upgraded golang.org/x/net v0.41.0 => v0.43.0 go: upgraded golang.org/x/sys v0.33.0 => v0.35.0 go: upgraded golang.org/x/text v0.26.0 => v0.28.0 --- go.mod | 34 +++++++++++----------- go.sum | 90 ++++++++++++++++++++++------------------------------------ 2 files changed, 51 insertions(+), 73 deletions(-) diff --git a/go.mod b/go.mod index 0ef958d6..3428336f 100644 --- a/go.mod +++ b/go.mod @@ -3,59 +3,59 @@ module github.com/giongto35/cloud-game/v3 go 1.24 require ( - github.com/VictoriaMetrics/metrics v1.38.0 + github.com/VictoriaMetrics/metrics v1.39.1 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.9.0 github.com/goccy/go-json v0.10.5 github.com/gofrs/flock v0.12.1 github.com/gorilla/websocket v1.5.3 github.com/knadh/koanf/maps v0.1.2 - github.com/knadh/koanf/v2 v2.2.1 - github.com/minio/minio-go/v7 v7.0.94 + github.com/knadh/koanf/v2 v2.2.2 + github.com/minio/minio-go/v7 v7.0.95 github.com/pion/ice/v4 v4.0.10 github.com/pion/interceptor v0.1.40 - github.com/pion/logging v0.2.3 - github.com/pion/webrtc/v4 v4.1.2 + github.com/pion/logging v0.2.4 + github.com/pion/webrtc/v4 v4.1.3 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.34.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.39.0 - golang.org/x/image v0.25.0 + golang.org/x/crypto v0.41.0 + golang.org/x/image v0.30.0 gopkg.in/yaml.v3 v3.0.1 ) require ( github.com/dustin/go-humanize v1.0.1 // indirect github.com/go-ini/ini v1.67.0 // indirect - github.com/go-viper/mapstructure/v2 v2.3.0 // indirect + github.com/go-viper/mapstructure/v2 v2.4.0 // indirect github.com/google/uuid v1.6.0 // indirect github.com/klauspost/compress v1.18.0 // indirect - github.com/klauspost/cpuid/v2 v2.2.10 // indirect + github.com/klauspost/cpuid/v2 v2.3.0 // indirect github.com/mattn/go-colorable v0.1.14 // indirect github.com/mattn/go-isatty v0.0.20 // indirect - github.com/minio/crc64nvme v1.0.2 // indirect + github.com/minio/crc64nvme v1.1.0 // indirect github.com/minio/md5-simd v1.1.2 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect - github.com/philhofer/fwd v1.1.3-0.20240916144458-20a13a1f6b7c // indirect + github.com/philhofer/fwd v1.2.0 // indirect github.com/pion/datachannel v1.5.10 // indirect github.com/pion/dtls/v3 v3.0.6 // indirect github.com/pion/mdns/v2 v2.0.7 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.15 // indirect - github.com/pion/rtp v1.8.19 // indirect + github.com/pion/rtp v1.8.21 // indirect github.com/pion/sctp v1.8.39 // indirect - github.com/pion/sdp/v3 v3.0.14 // indirect + github.com/pion/sdp/v3 v3.0.15 // indirect github.com/pion/srtp/v3 v3.0.6 // indirect github.com/pion/stun/v3 v3.0.0 // indirect github.com/pion/transport/v3 v3.0.7 // indirect - github.com/pion/turn/v4 v4.0.2 // indirect + github.com/pion/turn/v4 v4.1.0 // indirect github.com/rogpeppe/go-internal v1.12.0 // indirect github.com/tinylib/msgp v1.3.0 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.41.0 // indirect - golang.org/x/sys v0.33.0 // indirect - golang.org/x/text v0.26.0 // indirect + golang.org/x/net v0.43.0 // indirect + golang.org/x/sys v0.35.0 // indirect + golang.org/x/text v0.28.0 // indirect ) diff --git a/go.sum b/go.sum index 5ca2900f..1ab980c2 100644 --- a/go.sum +++ b/go.sum @@ -1,7 +1,5 @@ -github.com/VictoriaMetrics/metrics v1.37.0 h1:u5Yr+HFofQyn7kgmmkufgkX0nEA6G1oEyK2eaKsVaUM= -github.com/VictoriaMetrics/metrics v1.37.0/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= -github.com/VictoriaMetrics/metrics v1.38.0 h1:1d0dRgVH8Nnu8dKMfisKefPC3q7gqf3/odyO0quAvyA= -github.com/VictoriaMetrics/metrics v1.38.0/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= +github.com/VictoriaMetrics/metrics v1.39.1 h1:AT7jz7oSpAK9phDl5O5Tmy06nXnnzALwqVnf4ros3Ow= +github.com/VictoriaMetrics/metrics v1.39.1/go.mod h1:XE4uudAAIRaJE614Tl5HMrtoEU6+GDZO4QTnNSsZRuA= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -13,10 +11,8 @@ github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S github.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0= github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A= github.com/go-ini/ini v1.67.0/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8= -github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIxtHqx8aGss= -github.com/go-viper/mapstructure/v2 v2.2.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM= -github.com/go-viper/mapstructure/v2 v2.3.0 h1:27XbWsHIqhbdR5TIC911OfYvgSaW93HM+dX7970Q7jk= -github.com/go-viper/mapstructure/v2 v2.3.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM= +github.com/go-viper/mapstructure/v2 v2.4.0 h1:EBsztssimR/CONLSZZ04E8qAkxNYq4Qp9LvH92wZUgs= +github.com/go-viper/mapstructure/v2 v2.4.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM= github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4= github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M= github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= @@ -29,14 +25,12 @@ github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/ad github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo= github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ= github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= -github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE= -github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= +github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y= +github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= github.com/knadh/koanf/maps v0.1.2 h1:RBfmAW5CnZT+PJ1CVc1QSJKf4Xu9kxfQgYVQSu8hpbo= github.com/knadh/koanf/maps v0.1.2/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= -github.com/knadh/koanf/v2 v2.2.0 h1:FZFwd9bUjpb8DyCWARUBy5ovuhDs1lI87dOEn2K8UVU= -github.com/knadh/koanf/v2 v2.2.0/go.mod h1:PSFru3ufQgTsI7IF+95rf9s8XA1+aHxKuO/W+dPoHEY= -github.com/knadh/koanf/v2 v2.2.1 h1:jaleChtw85y3UdBnI0wCqcg1sj1gPoz6D3caGNHtrNE= -github.com/knadh/koanf/v2 v2.2.1/go.mod h1:PSFru3ufQgTsI7IF+95rf9s8XA1+aHxKuO/W+dPoHEY= +github.com/knadh/koanf/v2 v2.2.2 h1:ghbduIkpFui3L587wavneC9e3WIliCgiCgdxYO/wd7A= +github.com/knadh/koanf/v2 v2.2.2/go.mod h1:abWQc0cBXLSF/PSOMCB/SK+T13NXDsPvOksbpi5e/9Q= github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= @@ -48,62 +42,50 @@ github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/ github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= -github.com/minio/crc64nvme v1.0.2 h1:6uO1UxGAD+kwqWWp7mBFsi5gAse66C4NXO8cmcVculg= -github.com/minio/crc64nvme v1.0.2/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= +github.com/minio/crc64nvme v1.1.0 h1:e/tAguZ+4cw32D+IO/8GSf5UVr9y+3eJcxZI2WOO/7Q= +github.com/minio/crc64nvme v1.1.0/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.92 h1:jpBFWyRS3p8P/9tsRc+NuvqoFi7qAmTCFPoRFmobbVw= -github.com/minio/minio-go/v7 v7.0.92/go.mod h1:vTIc8DNcnAZIhyFsk8EB90AbPjj3j68aWIEQCiPj7d0= -github.com/minio/minio-go/v7 v7.0.94 h1:1ZoksIKPyaSt64AVOyaQvhDOgVC3MfZsWM6mZXRUGtM= -github.com/minio/minio-go/v7 v7.0.94/go.mod h1:71t2CqDt3ThzESgZUlU1rBN54mksGGlkLcFgguDnnAc= +github.com/minio/minio-go/v7 v7.0.95 h1:ywOUPg+PebTMTzn9VDsoFJy32ZuARN9zhB+K3IYEvYU= +github.com/minio/minio-go/v7 v7.0.95/go.mod h1:wOOX3uxS334vImCNRVyIDdXX9OsXDm89ToynKgqUKlo= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= -github.com/philhofer/fwd v1.1.3-0.20240916144458-20a13a1f6b7c h1:dAMKvw0MlJT1GshSTtih8C2gDs04w8dReiOGXrGLNoY= -github.com/philhofer/fwd v1.1.3-0.20240916144458-20a13a1f6b7c/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM= +github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM= +github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM= github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk4o= github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= github.com/pion/dtls/v3 v3.0.6 h1:7Hkd8WhAJNbRgq9RgdNh1aaWlZlGpYTzdqjy9x9sK2E= github.com/pion/dtls/v3 v3.0.6/go.mod h1:iJxNQ3Uhn1NZWOMWlLxEEHAN5yX7GyPvvKw04v9bzYU= github.com/pion/ice/v4 v4.0.10 h1:P59w1iauC/wPk9PdY8Vjl4fOFL5B+USq1+xbDcN6gT4= github.com/pion/ice/v4 v4.0.10/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= -github.com/pion/interceptor v0.1.38 h1:Mgt3XIIq47uR5vcLLahfRucE6tFPjxHak+z5ZZFEzLU= -github.com/pion/interceptor v0.1.38/go.mod h1:HS9X+Ue5LDE6q2C2tuvOuO83XkBdJFgn6MBDtfoJX4Q= github.com/pion/interceptor v0.1.40 h1:e0BjnPcGpr2CFQgKhrQisBU7V3GXK6wrfYrGYaU6Jq4= github.com/pion/interceptor v0.1.40/go.mod h1:Z6kqH7M/FYirg3frjGJ21VLSRJGBXB/KqaTIrdqnOic= -github.com/pion/logging v0.2.3 h1:gHuf0zpoh1GW67Nr6Gj4cv5Z9ZscU7g/EaoC/Ke/igI= -github.com/pion/logging v0.2.3/go.mod h1:z8YfknkquMe1csOrxK5kc+5/ZPAzMxbKLX5aXpbpC90= +github.com/pion/logging v0.2.4 h1:tTew+7cmQ+Mc1pTBLKH2puKsOvhm32dROumOZ655zB8= +github.com/pion/logging v0.2.4/go.mod h1:DffhXTKYdNZU+KtJ5pyQDjvOAh/GsNSyv1lbkFbe3so= github.com/pion/mdns/v2 v2.0.7 h1:c9kM8ewCgjslaAmicYMFQIde2H9/lrZpjBkN8VwoVtM= github.com/pion/mdns/v2 v2.0.7/go.mod h1:vAdSYNAT0Jy3Ru0zl2YiW3Rm/fJCwIeM0nToenfOJKA= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.15 h1:LZQi2JbdipLOj4eBjK4wlVoQWfrZbh3Q6eHtWtJBZBo= github.com/pion/rtcp v1.2.15/go.mod h1:jlGuAjHMEXwMUHK78RgX0UmEJFV4zUKOFHR7OP+D3D0= -github.com/pion/rtp v1.8.16 h1:0mpfguLyN9HCpPIXcoOho4BkMsz5eB1Yjvf+obI5cEQ= -github.com/pion/rtp v1.8.16/go.mod h1:bAu2UFKScgzyFqvUKmbvzSdPr+NGbZtv6UB2hesqXBk= -github.com/pion/rtp v1.8.19 h1:jhdO/3XhL/aKm/wARFVmvTfq0lC/CvN1xwYKmduly3c= -github.com/pion/rtp v1.8.19/go.mod h1:bAu2UFKScgzyFqvUKmbvzSdPr+NGbZtv6UB2hesqXBk= +github.com/pion/rtp v1.8.21 h1:3yrOwmZFyUpcIosNcWRpQaU+UXIJ6yxLuJ8Bx0mw37Y= +github.com/pion/rtp v1.8.21/go.mod h1:bAu2UFKScgzyFqvUKmbvzSdPr+NGbZtv6UB2hesqXBk= github.com/pion/sctp v1.8.39 h1:PJma40vRHa3UTO3C4MyeJDQ+KIobVYRZQZ0Nt7SjQnE= github.com/pion/sctp v1.8.39/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= -github.com/pion/sdp/v3 v3.0.13 h1:uN3SS2b+QDZnWXgdr69SM8KB4EbcnPnPf2Laxhty/l4= -github.com/pion/sdp/v3 v3.0.13/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= -github.com/pion/sdp/v3 v3.0.14 h1:1h7gBr9FhOWH5GjWWY5lcw/U85MtdcibTyt/o6RxRUI= -github.com/pion/sdp/v3 v3.0.14/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= -github.com/pion/srtp/v3 v3.0.4 h1:2Z6vDVxzrX3UHEgrUyIGM4rRouoC7v+NiF1IHtp9B5M= -github.com/pion/srtp/v3 v3.0.4/go.mod h1:1Jx3FwDoxpRaTh1oRV8A/6G1BnFL+QI82eK4ms8EEJQ= +github.com/pion/sdp/v3 v3.0.15 h1:F0I1zds+K/+37ZrzdADmx2Q44OFDOPRLhPnNTaUX9hk= +github.com/pion/sdp/v3 v3.0.15/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= github.com/pion/srtp/v3 v3.0.6 h1:E2gyj1f5X10sB/qILUGIkL4C2CqK269Xq167PbGCc/4= github.com/pion/srtp/v3 v3.0.6/go.mod h1:BxvziG3v/armJHAaJ87euvkhHqWe9I7iiOy50K2QkhY= github.com/pion/stun/v3 v3.0.0 h1:4h1gwhWLWuZWOJIJR9s2ferRO+W3zA/b6ijOI6mKzUw= github.com/pion/stun/v3 v3.0.0/go.mod h1:HvCN8txt8mwi4FBvS3EmDghW6aQJ24T+y+1TKjB5jyU= github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1o0= github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= -github.com/pion/turn/v4 v4.0.2 h1:ZqgQ3+MjP32ug30xAbD6Mn+/K4Sxi3SdNOTFf+7mpps= -github.com/pion/turn/v4 v4.0.2/go.mod h1:pMMKP/ieNAG/fN5cZiN4SDuyKsXtNTr0ccN7IToA1zs= -github.com/pion/webrtc/v4 v4.1.1 h1:PMFPtLg1kpD2pVtun+LGUzA3k54JdFl87WO0Z1+HKug= -github.com/pion/webrtc/v4 v4.1.1/go.mod h1:cgEGkcpxGkT6Di2ClBYO5lP9mFXbCfEOrkYUpjjCQO4= -github.com/pion/webrtc/v4 v4.1.2 h1:mpuUo/EJ1zMNKGE79fAdYNFZBX790KE7kQQpLMjjR54= -github.com/pion/webrtc/v4 v4.1.2/go.mod h1:xsCXiNAmMEjIdFxAYU0MbB3RwRieJsegSB2JZsGN+8U= +github.com/pion/turn/v4 v4.1.0 h1:+J56+aS8Bi6B4zij3ah6VvJpRuy8W8FtExR0OJPiTdM= +github.com/pion/turn/v4 v4.1.0/go.mod h1:2123tHk1O++vmjI5VSD0awT50NywDAq5A2NNNU4Jjs8= +github.com/pion/webrtc/v4 v4.1.3 h1:YZ67Boj9X/hk190jJZ8+HFGQ6DqSZ/fYP3sLAZv7c3c= +github.com/pion/webrtc/v4 v4.1.3/go.mod h1:rsq+zQ82ryfR9vbb0L1umPJ6Ogq7zm8mcn9fcGnxomM= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -125,25 +107,21 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.38.0 h1:jt+WWG8IZlBnVbomuhg2Mdq0+BBQaHbtqHEFEigjUV8= -golang.org/x/crypto v0.38.0/go.mod h1:MvrbAqul58NNYPKnOra203SB9vpuZW0e+RRZV+Ggqjw= -golang.org/x/crypto v0.39.0 h1:SHs+kF4LP+f+p14esP5jAoDpHU8Gu/v9lFRK6IT5imM= -golang.org/x/crypto v0.39.0/go.mod h1:L+Xg3Wf6HoL4Bn4238Z6ft6KfEpN0tJGo53AAPC632U= +golang.org/x/crypto v0.41.0 h1:WKYxWedPGCTVVl5+WHSSrOBT0O8lx32+zxmHxijgXp4= +golang.org/x/crypto v0.41.0/go.mod h1:pO5AFd7FA68rFak7rOAGVuygIISepHftHnr8dr6+sUc= golang.org/x/image v0.25.0 h1:Y6uW6rH1y5y/LK1J8BPWZtr6yZ7hrsy6hFrXjgsc2fQ= golang.org/x/image v0.25.0/go.mod h1:tCAmOEGthTtkalusGp1g3xa2gke8J6c2N565dTyl9Rs= -golang.org/x/net v0.40.0 h1:79Xs7wF06Gbdcg4kdCCIQArK11Z1hr5POQ6+fIYHNuY= -golang.org/x/net v0.40.0/go.mod h1:y0hY0exeL2Pku80/zKK7tpntoX23cqL3Oa6njdgRtds= -golang.org/x/net v0.41.0 h1:vBTly1HeNPEn3wtREYfy4GZ/NECgw2Cnl+nK6Nz3uvw= -golang.org/x/net v0.41.0/go.mod h1:B/K4NNqkfmg07DQYrbwvSluqCJOOXwUjeb/5lOisjbA= +golang.org/x/image v0.30.0 h1:jD5RhkmVAnjqaCUXfbGBrn3lpxbknfN9w2UhHHU+5B4= +golang.org/x/image v0.30.0/go.mod h1:SAEUTxCCMWSrJcCy/4HwavEsfZZJlYxeHLc6tTiAe/c= +golang.org/x/net v0.43.0 h1:lat02VYK2j4aLzMzecihNvTlJNQUq316m2Mr9rnM6YE= +golang.org/x/net v0.43.0/go.mod h1:vhO1fvI4dGsIjh73sWfUVjj3N7CA9WkKJNQm2svM6Jg= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.33.0 h1:q3i8TbbEz+JRD9ywIRlyRAQbM0qF7hu24q3teo2hbuw= -golang.org/x/sys v0.33.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= -golang.org/x/text v0.25.0 h1:qVyWApTSYLk/drJRO5mDlNYskwQznZmkpV2c8q9zls4= -golang.org/x/text v0.25.0/go.mod h1:WEdwpYrmk1qmdHvhkSTNPm3app7v4rsT8F2UD6+VHIA= -golang.org/x/text v0.26.0 h1:P42AVeLghgTYr4+xUnTRKDMqpar+PtX7KWuNQL21L8M= -golang.org/x/text v0.26.0/go.mod h1:QK15LZJUUQVJxhz7wXgxSy/CJaTFjd0G+YLonydOVQA= +golang.org/x/sys v0.35.0 h1:vz1N37gP5bs89s7He8XuIYXpyY0+QlsKmzipCbUtyxI= +golang.org/x/sys v0.35.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= +golang.org/x/text v0.28.0 h1:rhazDwis8INMIwQ4tpjLDzUhx6RlXqZNPEM0huQojng= +golang.org/x/text v0.28.0/go.mod h1:U8nCwOR8jO/marOQ0QbDiOngZVEBB7MAiitBuMjXiNU= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= From 6b0d7c0ce1803e082b98567864a607b6dce2dd05 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 15 Aug 2025 12:25:04 +0300 Subject: [PATCH 325/361] Update Go to 1.25.0 --- Dockerfile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Dockerfile b/Dockerfile index 94e61bc6..e196e457 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:oracular AS build0 -ARG GO=1.24.2 +ARG GO=1.25.0 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ From bbad4539b1ea8b841eecacafe471f65f2a058afa Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Thu, 20 Nov 2025 00:33:03 +0300 Subject: [PATCH 326/361] Update libretro.h --- pkg/worker/caged/libretro/nanoarch/libretro.h | 95 ++++++++++++------- 1 file changed, 63 insertions(+), 32 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/libretro.h b/pkg/worker/caged/libretro/nanoarch/libretro.h index 7e7b9505..c549976d 100644 --- a/pkg/worker/caged/libretro/nanoarch/libretro.h +++ b/pkg/worker/caged/libretro/nanoarch/libretro.h @@ -4,12 +4,12 @@ * @file libretro.h * @version 1 * @author libretro - * @copyright Copyright (C) 2010-2023 The RetroArch team + * @copyright Copyright (C) 2010-2024 The RetroArch team * * @paragraph LICENSE * The following license statement only applies to this libretro API header (libretro.h). * - * Copyright (C) 2010-2023 The RetroArch team + * Copyright (C) 2010-2024 The RetroArch team * * Permission is hereby granted, free of charge, * to any person obtaining a copy of this software and associated documentation files (the "Software"), @@ -219,7 +219,7 @@ extern "C" { #define RETRO_DEVICE_KEYBOARD 3 /** - * An abstraction around a light gun, simular to the PlayStation's Guncon. + * An abstraction around a light gun, similar to the PlayStation's Guncon. * * When provided as the \c device argument to \c retro_input_state_t, * the \c id argument denotes one of several possible inputs. @@ -272,7 +272,10 @@ extern "C" { * [-0x7fff, 0x7fff]: -0x7fff corresponds to the far left/top of the screen, * and 0x7fff corresponds to the far right/bottom of the screen. * The "screen" is here defined as area that is passed to the frontend and - * later displayed on the monitor. + * later displayed on the monitor. If the pointer is outside this screen, + * such as in the black surrounding areas when actual display is larger, + * edge position is reported. An explicit edge detection is also provided, + * that will return 1 if the pointer is near the screen edge or actually outside it. * * The frontend is free to scale/resize this screen as it sees fit, however, * (X, Y) = (-0x7fff, -0x7fff) will correspond to the top-left pixel of the @@ -406,7 +409,8 @@ extern "C" { /* Id values for LIGHTGUN. */ #define RETRO_DEVICE_ID_LIGHTGUN_SCREEN_X 13 /*Absolute Position*/ -#define RETRO_DEVICE_ID_LIGHTGUN_SCREEN_Y 14 /*Absolute*/ +#define RETRO_DEVICE_ID_LIGHTGUN_SCREEN_Y 14 /*Absolute Position*/ +/** Indicates if lightgun points off the screen or near the edge */ #define RETRO_DEVICE_ID_LIGHTGUN_IS_OFFSCREEN 15 /*Status Check*/ #define RETRO_DEVICE_ID_LIGHTGUN_TRIGGER 2 #define RETRO_DEVICE_ID_LIGHTGUN_RELOAD 16 /*Forced off-screen shot*/ @@ -421,17 +425,18 @@ extern "C" { #define RETRO_DEVICE_ID_LIGHTGUN_DPAD_RIGHT 12 /* deprecated */ #define RETRO_DEVICE_ID_LIGHTGUN_X 0 /*Relative Position*/ -#define RETRO_DEVICE_ID_LIGHTGUN_Y 1 /*Relative*/ -#define RETRO_DEVICE_ID_LIGHTGUN_CURSOR 3 /*Use Aux:A*/ -#define RETRO_DEVICE_ID_LIGHTGUN_TURBO 4 /*Use Aux:B*/ -#define RETRO_DEVICE_ID_LIGHTGUN_PAUSE 5 /*Use Start*/ +#define RETRO_DEVICE_ID_LIGHTGUN_Y 1 /*Relative Position*/ +#define RETRO_DEVICE_ID_LIGHTGUN_CURSOR 3 /*Use Aux:A instead*/ +#define RETRO_DEVICE_ID_LIGHTGUN_TURBO 4 /*Use Aux:B instead*/ +#define RETRO_DEVICE_ID_LIGHTGUN_PAUSE 5 /*Use Start instead*/ /* Id values for POINTER. */ -#define RETRO_DEVICE_ID_POINTER_X 0 -#define RETRO_DEVICE_ID_POINTER_Y 1 -#define RETRO_DEVICE_ID_POINTER_PRESSED 2 -#define RETRO_DEVICE_ID_POINTER_COUNT 3 - +#define RETRO_DEVICE_ID_POINTER_X 0 +#define RETRO_DEVICE_ID_POINTER_Y 1 +#define RETRO_DEVICE_ID_POINTER_PRESSED 2 +#define RETRO_DEVICE_ID_POINTER_COUNT 3 +/** Indicates if pointer is off the screen or near the edge */ +#define RETRO_DEVICE_ID_POINTER_IS_OFFSCREEN 15 /** @} */ /* Returned from retro_get_region(). */ @@ -479,6 +484,7 @@ enum retro_language RETRO_LANGUAGE_BELARUSIAN = 32, RETRO_LANGUAGE_GALICIAN = 33, RETRO_LANGUAGE_NORWEGIAN = 34, + RETRO_LANGUAGE_IRISH = 35, RETRO_LANGUAGE_LAST, /** Defined to ensure that sizeof(retro_language) == sizeof(int). Do not use. */ @@ -1094,7 +1100,7 @@ enum retro_mod * to write audio. The audio callbacks must be called from within the * notification callback. * The amount of audio data to write is up to the core. - * Generally, the audio callback will be called continously in a loop. + * Generally, the audio callback will be called continuously in a loop. * * A frontend may disable this callback in certain situations. * The core must be able to render audio with the "normal" interface. @@ -1332,7 +1338,7 @@ enum retro_mod *
  • Changing the emulated system's internal resolution, * within the limits defined by the existing values of \c max_width and \c max_height. * Use \c RETRO_ENVIRONMENT_SET_GEOMETRY instead, - * and adjust \c retro_get_system_av_info to account fo + * and adjust \c retro_get_system_av_info to account for * supported scale factors and screen layouts * when computing \c max_width and \c max_height. * Only use this environment call if \c max_width or \c max_height needs to increase. @@ -2556,6 +2562,31 @@ enum retro_mod */ #define RETRO_ENVIRONMENT_GET_PLAYLIST_DIRECTORY 79 +/** + * Returns the "file browser" start directory of the frontend. + * + * This directory can serve as a start directory for the core in case it + * provides an internal way of loading content. + * + * @param[out] data const char **. + * May be \c NULL. If so, no such directory is defined, and it's up to the + * implementation to find a suitable directory. + * @return \c true if the environment call is available. + */ +#define RETRO_ENVIRONMENT_GET_FILE_BROWSER_START_DIRECTORY 80 + +/** + * Returns the audio sample rate the frontend is targeting, in Hz. + * The intended use case is for the core to use the result to select an ideal sample rate. + * + * @param[out] data unsigned *. + * Pointer to the \c unsigned integer in which the frontend will store its target sample rate. + * Behavior is undefined if \c data is NULL. + * @return \c true if this environment call is available, + * regardless of the value returned in \c data. +*/ +#define RETRO_ENVIRONMENT_GET_TARGET_SAMPLE_RATE (81 | RETRO_ENVIRONMENT_EXPERIMENTAL) + /**@}*/ /** @@ -5161,14 +5192,14 @@ struct retro_hw_render_callback * character is the text character of the pressed key. (UTF-32). * key_modifiers is a set of RETROKMOD values or'ed together. * - * The pressed/keycode state can be indepedent of the character. + * The pressed/keycode state can be independent of the character. * It is also possible that multiple characters are generated from a * single keypress. * Keycode events should be treated separately from character events. * However, when possible, the frontend should try to synchronize these. * If only a character is posted, keycode should be RETROK_UNKNOWN. * - * Similarily if only a keycode event is generated with no corresponding + * Similarly if only a keycode event is generated with no corresponding * character, character should be 0. */ typedef void (RETRO_CALLCONV *retro_keyboard_event_t)(bool down, unsigned keycode, @@ -5347,14 +5378,14 @@ typedef bool (RETRO_CALLCONV *retro_set_initial_image_t)(unsigned index, const c * on the host's file system. * * @param index The index of the disk image to get the path of. - * @param path A buffer to store the path in. - * @param len The size of \c path, in bytes. + * @param s A buffer to store the path in. + * @param len The size of \c s, in bytes. * @return \c true if the disk image's location was successfully - * queried and copied into \c path, + * queried and copied into \c s, * \c false if the index is invalid * or the core couldn't locate the disk image. */ -typedef bool (RETRO_CALLCONV *retro_get_image_path_t)(unsigned index, char *path, size_t len); +typedef bool (RETRO_CALLCONV *retro_get_image_path_t)(unsigned index, char *s, size_t len); /** * Returns a friendly label for the given disk image. @@ -5370,12 +5401,12 @@ typedef bool (RETRO_CALLCONV *retro_get_image_path_t)(unsigned index, char *path * so that the frontend can provide better guidance to the player. * * @param index The index of the disk image to return a label for. - * @param label A buffer to store the resulting label in. - * @param len The length of \c label, in bytes. + * @param s A buffer to store the resulting label in. + * @param len The length of \c s, in bytes. * @return \c true if the disk image at \c index is valid - * and a label was copied into \c label. + * and a label was copied into \c s. */ -typedef bool (RETRO_CALLCONV *retro_get_image_label_t)(unsigned index, char *label, size_t len); +typedef bool (RETRO_CALLCONV *retro_get_image_label_t)(unsigned index, char *s, size_t len); /** * An interface that the frontend can use to exchange disks @@ -5719,7 +5750,7 @@ struct retro_message enum retro_message_target { /** - * Indicates that the frontent should display the given message + * Indicates that the frontend should display the given message * using all other targets defined by \c retro_message_target at once. */ RETRO_MESSAGE_TARGET_ALL = 0, @@ -5910,7 +5941,7 @@ struct retro_message_ext /** * The progress of an asynchronous task. * - * A value betwen 0 and 100 (inclusive) indicates the task's percentage, + * A value between 0 and 100 (inclusive) indicates the task's percentage, * and a value of -1 indicates a task of unknown completion. * * @note Since message type is a hint, a frontend may ignore progress values. @@ -7426,7 +7457,7 @@ typedef void (RETRO_CALLCONV *retro_audio_sample_t)(int16_t left, int16_t right) * is defined as a sample of left and right channels, interleaved. * For example: int16_t buf[4] = { l, r, l, r }; would be 2 frames. * - * @return The number of samples that were processed. + * @return The number of frames that were processed. * * @see retro_set_audio_sample_batch() * @see retro_set_audio_sample() @@ -7687,7 +7718,7 @@ RETRO_API size_t retro_serialize_size(void); * @see retro_serialize_size() * @see retro_unserialize() */ -RETRO_API bool retro_serialize(void *data, size_t size); +RETRO_API bool retro_serialize(void *data, size_t len); /** * Unserialize the given state data, and load it into the internal state. @@ -7696,7 +7727,7 @@ RETRO_API bool retro_serialize(void *data, size_t size); * * @see retro_serialize() */ -RETRO_API bool retro_unserialize(const void *data, size_t size); +RETRO_API bool retro_unserialize(const void *data, size_t len); /** * Reset all the active cheats to their default disabled state. @@ -7812,4 +7843,4 @@ RETRO_API size_t retro_get_memory_size(unsigned id); } #endif -#endif +#endif \ No newline at end of file From 3392251dda800d9eda86897df358882e307caa8a Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Thu, 20 Nov 2025 00:36:13 +0300 Subject: [PATCH 327/361] Update dependencies --- go.mod | 49 ++++++++++++++-------------- go.sum | 100 ++++++++++++++++++++++++++++----------------------------- 2 files changed, 75 insertions(+), 74 deletions(-) diff --git a/go.mod b/go.mod index 3428336f..d5ebd227 100644 --- a/go.mod +++ b/go.mod @@ -1,25 +1,25 @@ module github.com/giongto35/cloud-game/v3 -go 1.24 +go 1.25 require ( - github.com/VictoriaMetrics/metrics v1.39.1 + github.com/VictoriaMetrics/metrics v1.40.2 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.9.0 github.com/goccy/go-json v0.10.5 - github.com/gofrs/flock v0.12.1 + github.com/gofrs/flock v0.13.0 github.com/gorilla/websocket v1.5.3 github.com/knadh/koanf/maps v0.1.2 - github.com/knadh/koanf/v2 v2.2.2 - github.com/minio/minio-go/v7 v7.0.95 + github.com/knadh/koanf/v2 v2.3.0 + github.com/minio/minio-go/v7 v7.0.97 github.com/pion/ice/v4 v4.0.10 - github.com/pion/interceptor v0.1.40 + github.com/pion/interceptor v0.1.42 github.com/pion/logging v0.2.4 - github.com/pion/webrtc/v4 v4.1.3 + github.com/pion/webrtc/v4 v4.1.6 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.34.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.41.0 + golang.org/x/crypto v0.45.0 golang.org/x/image v0.30.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -29,33 +29,34 @@ require ( github.com/go-ini/ini v1.67.0 // indirect github.com/go-viper/mapstructure/v2 v2.4.0 // indirect github.com/google/uuid v1.6.0 // indirect - github.com/klauspost/compress v1.18.0 // indirect + github.com/klauspost/compress v1.18.1 // indirect github.com/klauspost/cpuid/v2 v2.3.0 // indirect + github.com/klauspost/crc32 v1.3.0 // indirect github.com/mattn/go-colorable v0.1.14 // indirect github.com/mattn/go-isatty v0.0.20 // indirect - github.com/minio/crc64nvme v1.1.0 // indirect + github.com/minio/crc64nvme v1.1.1 // indirect github.com/minio/md5-simd v1.1.2 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/philhofer/fwd v1.2.0 // indirect github.com/pion/datachannel v1.5.10 // indirect - github.com/pion/dtls/v3 v3.0.6 // indirect - github.com/pion/mdns/v2 v2.0.7 // indirect + github.com/pion/dtls/v3 v3.0.7 // indirect + github.com/pion/mdns/v2 v2.1.0 // indirect github.com/pion/randutil v0.1.0 // indirect - github.com/pion/rtcp v1.2.15 // indirect - github.com/pion/rtp v1.8.21 // indirect - github.com/pion/sctp v1.8.39 // indirect - github.com/pion/sdp/v3 v3.0.15 // indirect - github.com/pion/srtp/v3 v3.0.6 // indirect - github.com/pion/stun/v3 v3.0.0 // indirect - github.com/pion/transport/v3 v3.0.7 // indirect - github.com/pion/turn/v4 v4.1.0 // indirect + github.com/pion/rtcp v1.2.16 // indirect + github.com/pion/rtp v1.8.25 // indirect + github.com/pion/sctp v1.8.40 // indirect + github.com/pion/sdp/v3 v3.0.16 // indirect + github.com/pion/srtp/v3 v3.0.8 // indirect + github.com/pion/stun/v3 v3.0.1 // indirect + github.com/pion/transport/v3 v3.1.1 // indirect + github.com/pion/turn/v4 v4.1.3 // indirect github.com/rogpeppe/go-internal v1.12.0 // indirect - github.com/tinylib/msgp v1.3.0 // indirect + github.com/tinylib/msgp v1.5.0 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.43.0 // indirect - golang.org/x/sys v0.35.0 // indirect - golang.org/x/text v0.28.0 // indirect + golang.org/x/net v0.47.0 // indirect + golang.org/x/sys v0.38.0 // indirect + golang.org/x/text v0.31.0 // indirect ) diff --git a/go.sum b/go.sum index 1ab980c2..55499af2 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,5 @@ -github.com/VictoriaMetrics/metrics v1.39.1 h1:AT7jz7oSpAK9phDl5O5Tmy06nXnnzALwqVnf4ros3Ow= -github.com/VictoriaMetrics/metrics v1.39.1/go.mod h1:XE4uudAAIRaJE614Tl5HMrtoEU6+GDZO4QTnNSsZRuA= +github.com/VictoriaMetrics/metrics v1.40.2 h1:OVSjKcQEx6JAwGeu8/KQm9Su5qJ72TMEW4xYn5vw3Ac= +github.com/VictoriaMetrics/metrics v1.40.2/go.mod h1:XE4uudAAIRaJE614Tl5HMrtoEU6+GDZO4QTnNSsZRuA= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -16,21 +16,23 @@ github.com/go-viper/mapstructure/v2 v2.4.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlnd github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4= github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M= github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= -github.com/gofrs/flock v0.12.1 h1:MTLVXXHf8ekldpJk3AKicLij9MdwOWkZ+a/jHHZby9E= -github.com/gofrs/flock v0.12.1/go.mod h1:9zxTsyu5xtJ9DK+1tFZyibEV7y3uwDxPPfbxeeHCoD0= +github.com/gofrs/flock v0.13.0 h1:95JolYOvGMqeH31+FC7D2+uULf6mG61mEZ/A8dRYMzw= +github.com/gofrs/flock v0.13.0/go.mod h1:jxeyy9R1auM5S6JYDBhDt+E2TCo7DkratH4Pgi8P+Z0= github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg= github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= -github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo= -github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ= +github.com/klauspost/compress v1.18.1 h1:bcSGx7UbpBqMChDtsF28Lw6v/G94LPrrbMbdC3JH2co= +github.com/klauspost/compress v1.18.1/go.mod h1:ZQFFVG+MdnR0P+l6wpXgIL4NTtwiKIdBnrBd8Nrxr+0= github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y= github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= +github.com/klauspost/crc32 v1.3.0 h1:sSmTt3gUt81RP655XGZPElI0PelVTZ6YwCRnPSupoFM= +github.com/klauspost/crc32 v1.3.0/go.mod h1:D7kQaZhnkX/Y0tstFGf8VUzv2UofNGqCjnC3zdHB0Hw= github.com/knadh/koanf/maps v0.1.2 h1:RBfmAW5CnZT+PJ1CVc1QSJKf4Xu9kxfQgYVQSu8hpbo= github.com/knadh/koanf/maps v0.1.2/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= -github.com/knadh/koanf/v2 v2.2.2 h1:ghbduIkpFui3L587wavneC9e3WIliCgiCgdxYO/wd7A= -github.com/knadh/koanf/v2 v2.2.2/go.mod h1:abWQc0cBXLSF/PSOMCB/SK+T13NXDsPvOksbpi5e/9Q= +github.com/knadh/koanf/v2 v2.3.0 h1:Qg076dDRFHvqnKG97ZEsi9TAg2/nFTa9hCdcSa1lvlM= +github.com/knadh/koanf/v2 v2.3.0/go.mod h1:gRb40VRAbd4iJMYYD5IxZ6hfuopFcXBpc9bbQpZwo28= github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= @@ -42,12 +44,12 @@ github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/ github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= -github.com/minio/crc64nvme v1.1.0 h1:e/tAguZ+4cw32D+IO/8GSf5UVr9y+3eJcxZI2WOO/7Q= -github.com/minio/crc64nvme v1.1.0/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= +github.com/minio/crc64nvme v1.1.1 h1:8dwx/Pz49suywbO+auHCBpCtlW1OfpcLN7wYgVR6wAI= +github.com/minio/crc64nvme v1.1.1/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.95 h1:ywOUPg+PebTMTzn9VDsoFJy32ZuARN9zhB+K3IYEvYU= -github.com/minio/minio-go/v7 v7.0.95/go.mod h1:wOOX3uxS334vImCNRVyIDdXX9OsXDm89ToynKgqUKlo= +github.com/minio/minio-go/v7 v7.0.97 h1:lqhREPyfgHTB/ciX8k2r8k0D93WaFqxbJX36UZq5occ= +github.com/minio/minio-go/v7 v7.0.97/go.mod h1:re5VXuo0pwEtoNLsNuSr0RrLfT/MBtohwdaSmPPSRSk= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= @@ -56,36 +58,36 @@ github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM= github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM= github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk4o= github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= -github.com/pion/dtls/v3 v3.0.6 h1:7Hkd8WhAJNbRgq9RgdNh1aaWlZlGpYTzdqjy9x9sK2E= -github.com/pion/dtls/v3 v3.0.6/go.mod h1:iJxNQ3Uhn1NZWOMWlLxEEHAN5yX7GyPvvKw04v9bzYU= +github.com/pion/dtls/v3 v3.0.7 h1:bItXtTYYhZwkPFk4t1n3Kkf5TDrfj6+4wG+CZR8uI9Q= +github.com/pion/dtls/v3 v3.0.7/go.mod h1:uDlH5VPrgOQIw59irKYkMudSFprY9IEFCqz/eTz16f8= github.com/pion/ice/v4 v4.0.10 h1:P59w1iauC/wPk9PdY8Vjl4fOFL5B+USq1+xbDcN6gT4= github.com/pion/ice/v4 v4.0.10/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= -github.com/pion/interceptor v0.1.40 h1:e0BjnPcGpr2CFQgKhrQisBU7V3GXK6wrfYrGYaU6Jq4= -github.com/pion/interceptor v0.1.40/go.mod h1:Z6kqH7M/FYirg3frjGJ21VLSRJGBXB/KqaTIrdqnOic= +github.com/pion/interceptor v0.1.42 h1:0/4tvNtruXflBxLfApMVoMubUMik57VZ+94U0J7cmkQ= +github.com/pion/interceptor v0.1.42/go.mod h1:g6XYTChs9XyolIQFhRHOOUS+bGVGLRfgTCUzH29EfVU= github.com/pion/logging v0.2.4 h1:tTew+7cmQ+Mc1pTBLKH2puKsOvhm32dROumOZ655zB8= github.com/pion/logging v0.2.4/go.mod h1:DffhXTKYdNZU+KtJ5pyQDjvOAh/GsNSyv1lbkFbe3so= -github.com/pion/mdns/v2 v2.0.7 h1:c9kM8ewCgjslaAmicYMFQIde2H9/lrZpjBkN8VwoVtM= -github.com/pion/mdns/v2 v2.0.7/go.mod h1:vAdSYNAT0Jy3Ru0zl2YiW3Rm/fJCwIeM0nToenfOJKA= +github.com/pion/mdns/v2 v2.1.0 h1:3IJ9+Xio6tWYjhN6WwuY142P/1jA0D5ERaIqawg/fOY= +github.com/pion/mdns/v2 v2.1.0/go.mod h1:pcez23GdynwcfRU1977qKU0mDxSeucttSHbCSfFOd9A= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= -github.com/pion/rtcp v1.2.15 h1:LZQi2JbdipLOj4eBjK4wlVoQWfrZbh3Q6eHtWtJBZBo= -github.com/pion/rtcp v1.2.15/go.mod h1:jlGuAjHMEXwMUHK78RgX0UmEJFV4zUKOFHR7OP+D3D0= -github.com/pion/rtp v1.8.21 h1:3yrOwmZFyUpcIosNcWRpQaU+UXIJ6yxLuJ8Bx0mw37Y= -github.com/pion/rtp v1.8.21/go.mod h1:bAu2UFKScgzyFqvUKmbvzSdPr+NGbZtv6UB2hesqXBk= -github.com/pion/sctp v1.8.39 h1:PJma40vRHa3UTO3C4MyeJDQ+KIobVYRZQZ0Nt7SjQnE= -github.com/pion/sctp v1.8.39/go.mod h1:cNiLdchXra8fHQwmIoqw0MbLLMs+f7uQ+dGMG2gWebE= -github.com/pion/sdp/v3 v3.0.15 h1:F0I1zds+K/+37ZrzdADmx2Q44OFDOPRLhPnNTaUX9hk= -github.com/pion/sdp/v3 v3.0.15/go.mod h1:88GMahN5xnScv1hIMTqLdu/cOcUkj6a9ytbncwMCq2E= -github.com/pion/srtp/v3 v3.0.6 h1:E2gyj1f5X10sB/qILUGIkL4C2CqK269Xq167PbGCc/4= -github.com/pion/srtp/v3 v3.0.6/go.mod h1:BxvziG3v/armJHAaJ87euvkhHqWe9I7iiOy50K2QkhY= -github.com/pion/stun/v3 v3.0.0 h1:4h1gwhWLWuZWOJIJR9s2ferRO+W3zA/b6ijOI6mKzUw= -github.com/pion/stun/v3 v3.0.0/go.mod h1:HvCN8txt8mwi4FBvS3EmDghW6aQJ24T+y+1TKjB5jyU= -github.com/pion/transport/v3 v3.0.7 h1:iRbMH05BzSNwhILHoBoAPxoB9xQgOaJk+591KC9P1o0= -github.com/pion/transport/v3 v3.0.7/go.mod h1:YleKiTZ4vqNxVwh77Z0zytYi7rXHl7j6uPLGhhz9rwo= -github.com/pion/turn/v4 v4.1.0 h1:+J56+aS8Bi6B4zij3ah6VvJpRuy8W8FtExR0OJPiTdM= -github.com/pion/turn/v4 v4.1.0/go.mod h1:2123tHk1O++vmjI5VSD0awT50NywDAq5A2NNNU4Jjs8= -github.com/pion/webrtc/v4 v4.1.3 h1:YZ67Boj9X/hk190jJZ8+HFGQ6DqSZ/fYP3sLAZv7c3c= -github.com/pion/webrtc/v4 v4.1.3/go.mod h1:rsq+zQ82ryfR9vbb0L1umPJ6Ogq7zm8mcn9fcGnxomM= +github.com/pion/rtcp v1.2.16 h1:fk1B1dNW4hsI78XUCljZJlC4kZOPk67mNRuQ0fcEkSo= +github.com/pion/rtcp v1.2.16/go.mod h1:/as7VKfYbs5NIb4h6muQ35kQF/J0ZVNz2Z3xKoCBYOo= +github.com/pion/rtp v1.8.25 h1:b8+y44GNbwOJTYWuVan7SglX/hMlicVCAtL50ztyZHw= +github.com/pion/rtp v1.8.25/go.mod h1:rF5nS1GqbR7H/TCpKwylzeq6yDM+MM6k+On5EgeThEM= +github.com/pion/sctp v1.8.40 h1:bqbgWYOrUhsYItEnRObUYZuzvOMsVplS3oNgzedBlG8= +github.com/pion/sctp v1.8.40/go.mod h1:SPBBUENXE6ThkEksN5ZavfAhFYll+h+66ZiG6IZQuzo= +github.com/pion/sdp/v3 v3.0.16 h1:0dKzYO6gTAvuLaAKQkC02eCPjMIi4NuAr/ibAwrGDCo= +github.com/pion/sdp/v3 v3.0.16/go.mod h1:9tyKzznud3qiweZcD86kS0ff1pGYB3VX+Bcsmkx6IXo= +github.com/pion/srtp/v3 v3.0.8 h1:RjRrjcIeQsilPzxvdaElN0CpuQZdMvcl9VZ5UY9suUM= +github.com/pion/srtp/v3 v3.0.8/go.mod h1:2Sq6YnDH7/UDCvkSoHSDNDeyBcFgWL0sAVycVbAsXFg= +github.com/pion/stun/v3 v3.0.1 h1:jx1uUq6BdPihF0yF33Jj2mh+C9p0atY94IkdnW174kA= +github.com/pion/stun/v3 v3.0.1/go.mod h1:RHnvlKFg+qHgoKIqtQWMOJF52wsImCAf/Jh5GjX+4Tw= +github.com/pion/transport/v3 v3.1.1 h1:Tr684+fnnKlhPceU+ICdrw6KKkTms+5qHMgw6bIkYOM= +github.com/pion/transport/v3 v3.1.1/go.mod h1:+c2eewC5WJQHiAA46fkMMzoYZSuGzA/7E2FPrOYHctQ= +github.com/pion/turn/v4 v4.1.3 h1:jVNW0iR05AS94ysEtvzsrk3gKs9Zqxf6HmnsLfRvlzA= +github.com/pion/turn/v4 v4.1.3/go.mod h1:TD/eiBUf5f5LwXbCJa35T7dPtTpCHRJ9oJWmyPLVT3A= +github.com/pion/webrtc/v4 v4.1.6 h1:srHH2HwvCGwPba25EYJgUzgLqCQoXl1VCUnrGQMSzUw= +github.com/pion/webrtc/v4 v4.1.6/go.mod h1:wKecGRlkl3ox/As/MYghJL+b/cVXMEhoPMJWPuGQFhU= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -95,10 +97,10 @@ github.com/rs/xid v1.6.0 h1:fV591PaemRlL6JfRxGDEPl69wICngIQ3shQtzfy2gxU= github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0= github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY= github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ= -github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA= -github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= -github.com/tinylib/msgp v1.3.0 h1:ULuf7GPooDaIlbyvgAxBV/FI7ynli6LZ1/nVUNu+0ww= -github.com/tinylib/msgp v1.3.0/go.mod h1:ykjzy2wzgrlvpDCRc4LA8UXy6D8bzMSuAF3WD57Gok0= +github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U= +github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U= +github.com/tinylib/msgp v1.5.0 h1:GWnqAE54wmnlFazjq2+vgr736Akg58iiHImh+kPY2pc= +github.com/tinylib/msgp v1.5.0/go.mod h1:cvjFkb4RiC8qSBOPMGPSzSAx47nAsfhLVTCZZNuHv5o= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= @@ -107,21 +109,19 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.41.0 h1:WKYxWedPGCTVVl5+WHSSrOBT0O8lx32+zxmHxijgXp4= -golang.org/x/crypto v0.41.0/go.mod h1:pO5AFd7FA68rFak7rOAGVuygIISepHftHnr8dr6+sUc= -golang.org/x/image v0.25.0 h1:Y6uW6rH1y5y/LK1J8BPWZtr6yZ7hrsy6hFrXjgsc2fQ= -golang.org/x/image v0.25.0/go.mod h1:tCAmOEGthTtkalusGp1g3xa2gke8J6c2N565dTyl9Rs= +golang.org/x/crypto v0.45.0 h1:jMBrvKuj23MTlT0bQEOBcAE0mjg8mK9RXFhRH6nyF3Q= +golang.org/x/crypto v0.45.0/go.mod h1:XTGrrkGJve7CYK7J8PEww4aY7gM3qMCElcJQ8n8JdX4= golang.org/x/image v0.30.0 h1:jD5RhkmVAnjqaCUXfbGBrn3lpxbknfN9w2UhHHU+5B4= golang.org/x/image v0.30.0/go.mod h1:SAEUTxCCMWSrJcCy/4HwavEsfZZJlYxeHLc6tTiAe/c= -golang.org/x/net v0.43.0 h1:lat02VYK2j4aLzMzecihNvTlJNQUq316m2Mr9rnM6YE= -golang.org/x/net v0.43.0/go.mod h1:vhO1fvI4dGsIjh73sWfUVjj3N7CA9WkKJNQm2svM6Jg= +golang.org/x/net v0.47.0 h1:Mx+4dIFzqraBXUugkia1OOvlD6LemFo1ALMHjrXDOhY= +golang.org/x/net v0.47.0/go.mod h1:/jNxtkgq5yWUGYkaZGqo27cfGZ1c5Nen03aYrrKpVRU= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.35.0 h1:vz1N37gP5bs89s7He8XuIYXpyY0+QlsKmzipCbUtyxI= -golang.org/x/sys v0.35.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= -golang.org/x/text v0.28.0 h1:rhazDwis8INMIwQ4tpjLDzUhx6RlXqZNPEM0huQojng= -golang.org/x/text v0.28.0/go.mod h1:U8nCwOR8jO/marOQ0QbDiOngZVEBB7MAiitBuMjXiNU= +golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc= +golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks= +golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM= +golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= From 5c6406c1e791199438bd6cf59abda55378efa453 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 21 Nov 2025 20:13:27 +0300 Subject: [PATCH 328/361] Implemented a busy loop for the emulation ticker. This replaces the low-precision, OS-dependent time ticker with a CPU spin loop that performs continuous target frame time checks and corrections. --- pkg/worker/caged/libretro/frontend.go | 57 ++++++++++++++++++++++++--- 1 file changed, 52 insertions(+), 5 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 8d0a73ac..5fc05a61 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -283,20 +283,67 @@ func (f *Frontend) Start() { } } - ticker := time.NewTicker(time.Second / time.Duration(f.nano.VideoFramerate())) - defer ticker.Stop() - if f.conf.AutosaveSec > 0 { // !to sync both for loops, can crash if the emulator starts later go f.autosave(f.conf.AutosaveSec) } + // The main loop of Libretro + + // calculate the exact duration required for a frame (e.g., 16.666ms = 60 FPS) + targetFrameTime := time.Second / time.Duration(f.nano.VideoFramerate()) + + // stop sleeping and start spinning in the remaining 1ms + const spinThreshold = 1 * time.Millisecond + + // how many frames will be considered not normal + const lateFramesThreshold = 4 + + lastFrameStart := time.Now() + for { select { - case <-ticker.C: - f.Tick() case <-f.done: return + default: + // run one tick of the emulation + f.Tick() + + elapsed := time.Since(lastFrameStart) + sleepTime := targetFrameTime - elapsed + + if sleepTime > 0 { + // SLEEP + // if we have plenty of time, sleep to save CPU and + // wake up slightly before the target time + if sleepTime > spinThreshold { + time.Sleep(sleepTime - spinThreshold) + } + + // SPIN + // if we are close to the target, + // burn CPU and check the clock with ns resolution + for time.Since(lastFrameStart) < targetFrameTime { + // CPU burn! + } + } else { + // lagging behind the target framerate so we don't sleep + f.log.Debug().Msgf("[] Frame drop: %v", elapsed) + } + + // timer reset + // + // adding targetFrameTime to the previous start + // prevents drift, if one frame was late, + // we try to catch up in the next frame + lastFrameStart = lastFrameStart.Add(targetFrameTime) + + // if execution was paused or heavily delayed, + // reset lastFrameStart so we don't try to run + // a bunch of frames instantly to catch up + if time.Since(lastFrameStart) > targetFrameTime*lateFramesThreshold { + lastFrameStart = time.Now() + } } } } From efa7a1d7b54c5ffe74ed8cc085aa8e951501a0a1 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 21 Nov 2025 20:44:27 +0300 Subject: [PATCH 329/361] Update outdated Docker build --- Dockerfile | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Dockerfile b/Dockerfile index e196e457..b3da7099 100644 --- a/Dockerfile +++ b/Dockerfile @@ -2,7 +2,7 @@ ARG BUILD_PATH=/tmp/cloud-game ARG VERSION=master # base build stage -FROM ubuntu:oracular AS build0 +FROM ubuntu:plucky AS build0 ARG GO=1.25.0 ARG GO_DIST=go${GO}.linux-amd64.tar.gz @@ -21,7 +21,7 @@ RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ FROM build0 AS build_coordinator ARG BUILD_PATH ARG VERSION -ENV GIT_VERSION ${VERSION} +ENV GIT_VERSION=${VERSION} WORKDIR ${BUILD_PATH} @@ -41,7 +41,7 @@ RUN ${BUILD_PATH}/scripts/version.sh ./web/index.html ${VERSION} && \ FROM build0 AS build_worker ARG BUILD_PATH ARG VERSION -ENV GIT_VERSION ${VERSION} +ENV GIT_VERSION=${VERSION} WORKDIR ${BUILD_PATH} @@ -73,7 +73,7 @@ COPY --from=build_coordinator /usr/local/share/cloud-game /cloud-game # autocertbot (SSL) requires these on the first run COPY --from=build_coordinator /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ -FROM ubuntu:oracular AS worker +FROM ubuntu:plucky AS worker RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ curl \ From 3df6a24a0a97bfceaa7c3cedf5fa44e9c8e6bc7d Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 21 Nov 2025 22:35:33 +0300 Subject: [PATCH 330/361] Skip video frames when they are late --- pkg/worker/caged/libretro/frontend.go | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 5fc05a61..ff4b6432 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -4,6 +4,7 @@ import ( "errors" "fmt" "path/filepath" + "runtime" "strings" "sync" "time" @@ -64,6 +65,11 @@ type Frontend struct { th int // draw threads vw, vh int // out frame size + // directives + + // skipVideo used when new frame was too late + skipVideo bool + mu sync.Mutex mui sync.Mutex @@ -198,6 +204,10 @@ func (f *Frontend) handleAudio(audio unsafe.Pointer, samples int) { } func (f *Frontend) handleVideo(data []byte, delta int32, fi nanoarch.FrameInfo) { + if f.skipVideo { + return + } + fr, _ := videoPool.Get().(*app.Video) if fr == nil { fr = new(app.Video) @@ -258,6 +268,10 @@ func (f *Frontend) Start() { return } + // don't jump between threads + runtime.LockOSThread() + defer runtime.UnlockOSThread() + f.mui.Lock() f.done = make(chan struct{}) f.nano.LastFrameTime = time.Now().UnixNano() @@ -297,7 +311,7 @@ func (f *Frontend) Start() { const spinThreshold = 1 * time.Millisecond // how many frames will be considered not normal - const lateFramesThreshold = 4 + const lateFramesThreshold = 3 lastFrameStart := time.Now() @@ -326,9 +340,11 @@ func (f *Frontend) Start() { for time.Since(lastFrameStart) < targetFrameTime { // CPU burn! } + f.skipVideo = false } else { // lagging behind the target framerate so we don't sleep f.log.Debug().Msgf("[] Frame drop: %v", elapsed) + f.skipVideo = true } // timer reset From 76b376aef7e4431fa790dfec4b9479ef7248b4c0 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 22 Nov 2025 11:59:08 +0300 Subject: [PATCH 331/361] Add config option for skipping late video frames --- pkg/config/config.yaml | 3 +++ pkg/config/emulator.go | 13 +++++++------ pkg/worker/caged/libretro/frontend.go | 2 +- 3 files changed, 11 insertions(+), 7 deletions(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 1a1d2803..d34c55a8 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -140,6 +140,9 @@ emulator: # checks if the system supports running an emulator at startup failFast: true + # do not send late video frames + skipLateFrames: false + libretro: # use zip compression for emulator save states saveCompression: true diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index 013225f7..3f4f6190 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -9,12 +9,13 @@ import ( ) type Emulator struct { - FailFast bool - Threads int - Storage string - LocalPath string - Libretro LibretroConfig - AutosaveSec int + FailFast bool + Threads int + Storage string + LocalPath string + Libretro LibretroConfig + AutosaveSec int + SkipLateFrames bool } type LibretroConfig struct { diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index ff4b6432..033a2c91 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -204,7 +204,7 @@ func (f *Frontend) handleAudio(audio unsafe.Pointer, samples int) { } func (f *Frontend) handleVideo(data []byte, delta int32, fi nanoarch.FrameInfo) { - if f.skipVideo { + if f.conf.SkipLateFrames && f.skipVideo { return } From baaeaf43b1ee64488b9eed05d78aa3cae00833bf Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 22 Nov 2025 12:32:56 +0300 Subject: [PATCH 332/361] Add config option for logging dropped frames --- pkg/config/config.yaml | 3 +++ pkg/config/emulator.go | 15 ++++++++------- pkg/worker/caged/libretro/frontend.go | 5 ++++- 3 files changed, 15 insertions(+), 8 deletions(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index d34c55a8..7de1b43d 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -143,6 +143,9 @@ emulator: # do not send late video frames skipLateFrames: false + # log dropped frames (temp) + logDroppedFrames: false + libretro: # use zip compression for emulator save states saveCompression: true diff --git a/pkg/config/emulator.go b/pkg/config/emulator.go index 3f4f6190..6a0ad9bb 100644 --- a/pkg/config/emulator.go +++ b/pkg/config/emulator.go @@ -9,13 +9,14 @@ import ( ) type Emulator struct { - FailFast bool - Threads int - Storage string - LocalPath string - Libretro LibretroConfig - AutosaveSec int - SkipLateFrames bool + FailFast bool + Threads int + Storage string + LocalPath string + Libretro LibretroConfig + AutosaveSec int + SkipLateFrames bool + LogDroppedFrames bool } type LibretroConfig struct { diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 033a2c91..b3baecde 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -343,7 +343,10 @@ func (f *Frontend) Start() { f.skipVideo = false } else { // lagging behind the target framerate so we don't sleep - f.log.Debug().Msgf("[] Frame drop: %v", elapsed) + if f.conf.LogDroppedFrames { + // !to make some stats counter instead + f.log.Debug().Msgf("[] Frame drop: %v", elapsed) + } f.skipVideo = true } From 859d0c8f1ad39cdd8695a5507def9a8f56d233d7 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 22 Nov 2025 17:22:10 +0300 Subject: [PATCH 333/361] Add user input caching --- pkg/worker/caged/libretro/frontend.go | 60 +++++++++++++++++++++++++-- 1 file changed, 56 insertions(+), 4 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index b3baecde..1dd0eaae 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -70,6 +70,8 @@ type Frontend struct { // skipVideo used when new frame was too late skipVideo bool + inputs [maxPort]inputCache + mu sync.Mutex mui sync.Mutex @@ -81,6 +83,16 @@ type Frontend struct { type Device byte +type inputCache struct { + mu sync.Mutex + pad []byte + key []byte + mouse []byte + dirty uint8 // bitmask: 1=Pad, 2=Key, 4=Mouse +} + +const maxPort = 8 + const ( RetroPad = Device(nanoarch.RetroPad) Keyboard = Device(nanoarch.Keyboard) @@ -395,18 +407,58 @@ func (f *Frontend) SetAudioCb(cb func(app.Audio)) { f.onAudio = cb } func (f *Frontend) SetSessionId(name string) { f.storage.SetMainSaveName(name) } func (f *Frontend) SetDataCb(cb func([]byte)) { f.onData = cb } func (f *Frontend) SetVideoCb(ff func(app.Video)) { f.onVideo = ff } -func (f *Frontend) Tick() { f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } +func (f *Frontend) Tick() { f.syncInputs(); f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } func (f *Frontend) ViewportRecalculate() { f.mu.Lock(); f.vw, f.vh = f.ViewportCalc(); f.mu.Unlock() } func (f *Frontend) ViewportSize() (int, int) { return f.vw, f.vh } func (f *Frontend) Input(port int, device byte, data []byte) { + if port >= maxPort { + return + } + + c := &f.inputs[port] + + c.mu.Lock() + switch Device(device) { case RetroPad: - f.nano.InputRetropad(port, data) + c.pad = append(c.pad[:0], data...) + c.dirty |= 1 case Keyboard: - f.nano.InputKeyboard(port, data) + c.key = append(c.key[:0], data...) + c.dirty |= 2 case Mouse: - f.nano.InputMouse(port, data) + c.mouse = append(c.mouse[:0], data...) + c.dirty |= 4 + } + + c.mu.Unlock() +} + +func (f *Frontend) syncInputs() { + for i := 0; i < maxPort; i++ { + c := &f.inputs[i] + + c.mu.Lock() + if c.dirty == 0 { + c.mu.Unlock() + continue + } + + d := c.dirty + c.dirty = 0 + + if d&1 != 0 { + f.nano.InputRetropad(i, c.pad) + } + if d&2 != 0 { + f.nano.InputKeyboard(i, c.key) + } + if d&4 != 0 { + f.nano.InputMouse(i, c.mouse) + } + + c.mu.Unlock() } } From 09a0c9c3f2de9e85c23ba3075c019aa43f058ec4 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 22 Nov 2025 17:46:07 +0300 Subject: [PATCH 334/361] Revert "Add user input caching" This reverts commit 859d0c8f1ad39cdd8695a5507def9a8f56d233d7. --- pkg/worker/caged/libretro/frontend.go | 60 ++------------------------- 1 file changed, 4 insertions(+), 56 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 1dd0eaae..b3baecde 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -70,8 +70,6 @@ type Frontend struct { // skipVideo used when new frame was too late skipVideo bool - inputs [maxPort]inputCache - mu sync.Mutex mui sync.Mutex @@ -83,16 +81,6 @@ type Frontend struct { type Device byte -type inputCache struct { - mu sync.Mutex - pad []byte - key []byte - mouse []byte - dirty uint8 // bitmask: 1=Pad, 2=Key, 4=Mouse -} - -const maxPort = 8 - const ( RetroPad = Device(nanoarch.RetroPad) Keyboard = Device(nanoarch.Keyboard) @@ -407,58 +395,18 @@ func (f *Frontend) SetAudioCb(cb func(app.Audio)) { f.onAudio = cb } func (f *Frontend) SetSessionId(name string) { f.storage.SetMainSaveName(name) } func (f *Frontend) SetDataCb(cb func([]byte)) { f.onData = cb } func (f *Frontend) SetVideoCb(ff func(app.Video)) { f.onVideo = ff } -func (f *Frontend) Tick() { f.syncInputs(); f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } +func (f *Frontend) Tick() { f.mu.Lock(); f.nano.Run(); f.mu.Unlock() } func (f *Frontend) ViewportRecalculate() { f.mu.Lock(); f.vw, f.vh = f.ViewportCalc(); f.mu.Unlock() } func (f *Frontend) ViewportSize() (int, int) { return f.vw, f.vh } func (f *Frontend) Input(port int, device byte, data []byte) { - if port >= maxPort { - return - } - - c := &f.inputs[port] - - c.mu.Lock() - switch Device(device) { case RetroPad: - c.pad = append(c.pad[:0], data...) - c.dirty |= 1 + f.nano.InputRetropad(port, data) case Keyboard: - c.key = append(c.key[:0], data...) - c.dirty |= 2 + f.nano.InputKeyboard(port, data) case Mouse: - c.mouse = append(c.mouse[:0], data...) - c.dirty |= 4 - } - - c.mu.Unlock() -} - -func (f *Frontend) syncInputs() { - for i := 0; i < maxPort; i++ { - c := &f.inputs[i] - - c.mu.Lock() - if c.dirty == 0 { - c.mu.Unlock() - continue - } - - d := c.dirty - c.dirty = 0 - - if d&1 != 0 { - f.nano.InputRetropad(i, c.pad) - } - if d&2 != 0 { - f.nano.InputKeyboard(i, c.key) - } - if d&4 != 0 { - f.nano.InputMouse(i, c.mouse) - } - - c.mu.Unlock() + f.nano.InputMouse(port, data) } } From c05e42f5972fc6e2f0659f54b4315934fbf5d9dd Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 22 Nov 2025 21:20:16 +0300 Subject: [PATCH 335/361] Cleanup nanoarch.go --- pkg/worker/caged/libretro/nanoarch/nanoarch.go | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index e26ee07d..7c05d962 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -626,7 +626,6 @@ var ( //export coreVideoRefresh func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { if Nan0.Stopped.Load() { - Nan0.log.Warn().Msgf(">>> skip video") return } @@ -635,13 +634,12 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { // (and proper frame display time, for example: 1->1/60=16.6ms, 2->10ms, 3->23ms, 4->16.6ms) // this is useful only for cores with variable framerate, for the fixed framerate cores this adds stutter // !to find docs on Libretro refresh sync and frame times - t := time.Now().UnixNano() dt := Nan0.tickTime - // override frame rendering with dynamic frame times if Nan0.vfr { + t := time.Now().UnixNano() dt = t - Nan0.LastFrameTime + Nan0.LastFrameTime = t } - Nan0.LastFrameTime = t // when the core returns a duplicate frame if data == nil { @@ -651,8 +649,9 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { // calculate real frame width in pixels from packed data (realWidth >= width) // some cores or games output zero pitch, i.e. N64 Mupen + bpp := Nan0.Video.PixFmt.BPP if packed == 0 { - packed = width * Nan0.Video.PixFmt.BPP + packed = width * bpp } // calculate space for the video frame bytes := packed * height @@ -729,9 +728,6 @@ func coreInputState(port C.unsigned, device C.unsigned, index C.unsigned, id C.u //export coreAudioSampleBatch func coreAudioSampleBatch(data unsafe.Pointer, frames C.size_t) C.size_t { if Nan0.Stopped.Load() { - if Nan0.log.GetLevel() < logger.InfoLevel { - Nan0.log.Warn().Msgf(">>> skip %v audio frames", frames) - } return frames } Nan0.Handlers.OnAudio(data, int(frames)<<1) From 9191861cab22b70103df85e073429cd3e41bd822 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 22 Nov 2025 22:09:38 +0300 Subject: [PATCH 336/361] Use iterators in the custom map implementation --- pkg/com/map.go | 147 ++++++++++++++++++++++++++-------------- pkg/com/map_test.go | 8 ++- pkg/com/net.go | 4 +- pkg/coordinator/hub.go | 8 +-- pkg/worker/room/room.go | 23 +++++-- 5 files changed, 126 insertions(+), 64 deletions(-) diff --git a/pkg/com/map.go b/pkg/com/map.go index 6a4df33a..ce2c5cd5 100644 --- a/pkg/com/map.go +++ b/pkg/com/map.go @@ -2,6 +2,7 @@ package com import ( "fmt" + "iter" "sync" ) @@ -9,72 +10,118 @@ import ( // Keep in mind that the underlying map structure will grow indefinitely. type Map[K comparable, V any] struct { m map[K]V - mu sync.Mutex + mu sync.RWMutex } -func (m *Map[K, _]) Has(key K) bool { _, ok := m.Contains(key); return ok } -func (m *Map[_, _]) Len() int { m.mu.Lock(); defer m.mu.Unlock(); return len(m.m) } -func (m *Map[K, V]) Pop(key K) V { - m.mu.Lock() - v := m.m[key] - delete(m.m, key) - m.mu.Unlock() - return v +func (m *Map[K, _]) Len() int { + m.mu.RLock() + defer m.mu.RUnlock() + return len(m.m) } -func (m *Map[K, V]) Put(key K, v V) bool { - m.mu.Lock() + +func (m *Map[K, _]) Has(key K) bool { + m.mu.RLock() _, ok := m.m[key] - m.m[key] = v - m.mu.Unlock() + m.mu.RUnlock() return ok } -func (m *Map[K, _]) Remove(key K) { m.mu.Lock(); delete(m.m, key); m.mu.Unlock() } -func (m *Map[K, _]) RemoveL(key K) int { - m.mu.Lock() - delete(m.m, key) - k := len(m.m) - m.mu.Unlock() - return k -} -func (m *Map[K, V]) String() string { - m.mu.Lock() - s := fmt.Sprintf("%v", m.m) - m.mu.Unlock() - return s -} -// Contains returns the first value found and a boolean flag if its found or not. -func (m *Map[K, V]) Contains(key K) (v V, ok bool) { - m.mu.Lock() - defer m.mu.Unlock() - if vv, ok := m.m[key]; ok { - return vv, true - } - return v, false +// Get returns the value and exists flag (standard map comma-ok idiom). +func (m *Map[K, V]) Get(key K) (V, bool) { + m.mu.RLock() + defer m.mu.RUnlock() + val, ok := m.m[key] + return val, ok } func (m *Map[K, V]) Find(key K) V { - v, _ := m.Contains(key) + v, _ := m.Get(key) return v } -// FindBy searches the first key-value with the provided predicate function. -func (m *Map[K, V]) FindBy(fn func(v V) bool) (v V, ok bool) { - m.mu.Lock() - defer m.mu.Unlock() - for _, vv := range m.m { - if fn(vv) { - return vv, true - } - } - return v, false +func (m *Map[K, V]) String() string { + m.mu.RLock() + defer m.mu.RUnlock() + return fmt.Sprintf("%v", m.m) } -// ForEach processes every element with the provided callback function. -func (m *Map[K, V]) ForEach(fn func(v V)) { +// FindBy searches for the first value satisfying the predicate. +// Note: This holds a Read Lock during iteration. +func (m *Map[K, V]) FindBy(predicate func(v V) bool) (V, bool) { + m.mu.RLock() + defer m.mu.RUnlock() + for _, v := range m.m { + if predicate(v) { + return v, true + } + } + var zero V + return zero, false +} + +// Put sets the value and returns true if the key already existed. +func (m *Map[K, V]) Put(key K, v V) bool { m.mu.Lock() defer m.mu.Unlock() - for _, v := range m.m { - fn(v) + + if m.m == nil { + m.m = make(map[K]V) + } + + _, exists := m.m[key] + m.m[key] = v + return exists +} + +func (m *Map[K, V]) Remove(key K) { + m.mu.Lock() + delete(m.m, key) + m.mu.Unlock() +} + +// Pop returns the value and removes it from the map. +// Returns zero value if not found. +func (m *Map[K, V]) Pop(key K) V { + m.mu.Lock() + defer m.mu.Unlock() + + val, ok := m.m[key] + if ok { + delete(m.m, key) + } + return val +} + +// RemoveL removes the key and returns the new length of the map. +func (m *Map[K, _]) RemoveL(key K) int { + m.mu.Lock() + defer m.mu.Unlock() + delete(m.m, key) + return len(m.m) +} + +// Clear empties the map. +func (m *Map[K, V]) Clear() { + m.mu.Lock() + m.m = make(map[K]V) + m.mu.Unlock() +} + +// Values returns an iterator for values only. +// +// Usage: for k, v := range m.Values() { ... } +// +// Warning: This holds a Read Lock (RLock) during iteration. +// Do not call Put/Remove on this map inside the loop (Deadlock). +func (m *Map[K, V]) Values() iter.Seq[V] { + return func(yield func(V) bool) { + m.mu.RLock() + defer m.mu.RUnlock() + + for _, v := range m.m { + if !yield(v) { + return + } + } } } diff --git a/pkg/com/map_test.go b/pkg/com/map_test.go index 4ebe1005..15af76c4 100644 --- a/pkg/com/map_test.go +++ b/pkg/com/map_test.go @@ -17,11 +17,11 @@ func TestMap_Base(t *testing.T) { if !m.Has(k) { t.Errorf("should have the key %v, %v", k, m.m) } - v, ok := m.Contains(k) + v, ok := m.Get(k) if v != 0 && !ok { t.Errorf("should have the key %v and ok, %v %v", k, ok, m.m) } - _, ok = m.Contains(k + 1) + _, ok = m.Get(k + 1) if ok { t.Errorf("should not find anything, %v %v", ok, m.m) } @@ -31,7 +31,9 @@ func TestMap_Base(t *testing.T) { t.Errorf("should have the key %v and ok, %v %v", 1, ok, m.m) } sum := 0 - m.ForEach(func(v int) { sum += v }) + for v := range m.Values() { + sum += v + } if sum != 1 { t.Errorf("shoud have exact sum of 1, but have %v", sum) } diff --git a/pkg/com/net.go b/pkg/com/net.go index 558c8148..04ed7e54 100644 --- a/pkg/com/net.go +++ b/pkg/com/net.go @@ -170,10 +170,10 @@ func (t *RPC[_, _]) callTimeout() time.Duration { func (t *RPC[_, _]) Cleanup() { // drain cancels all what's left in the task queue. - t.calls.ForEach(func(task *request) { + for task := range t.calls.Values() { if task.err == nil { task.err = errCanceled } close(task.done) - }) + } } diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index f4a1398c..490747df 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -155,7 +155,7 @@ func (h *Hub) handleWorkerConnection() http.HandlerFunc { func (h *Hub) GetServerList() (r []api.Server) { debug := h.conf.Coordinator.Debug - h.workers.ForEach(func(w *Worker) { + for w := range h.workers.Values() { server := api.Server{ Addr: w.Addr, Id: w.Id(), @@ -170,7 +170,7 @@ func (h *Hub) GetServerList() (r []api.Server) { server.Room = w.RoomId } r = append(r, server) - }) + } return } @@ -240,11 +240,11 @@ func (h *Hub) findWorkerByRoom(id string, region string) *Worker { func (h *Hub) getAvailableWorkers(region string) []*Worker { var workers []*Worker - h.workers.ForEach(func(w *Worker) { + for w := range h.workers.Values() { if w.HasSlot() && w.In(region) { workers = append(workers, w) } - }) + } return workers } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index c52f091d..c2686bdc 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -1,6 +1,7 @@ package room import ( + "iter" "sync" "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" @@ -27,10 +28,10 @@ type SessionManager[T Session] interface { Add(T) bool Empty() bool Find(string) T - ForEach(func(T)) RemoveL(T) int // Reset used for proper cleanup of the resources if needed. Reset() + Values() iter.Seq[T] } type Session interface { @@ -65,13 +66,19 @@ func NewRoom[T Session](id string, app app.App, um SessionManager[T], media Medi func (r *Room[T]) InitAudio() { r.app.SetAudioCb(func(a app.Audio) { r.media.PushAudio(a.Data) }) - r.media.SetAudioCb(func(d []byte, l int32) { r.users.ForEach(func(u T) { u.SendAudio(d, l) }) }) + r.media.SetAudioCb(func(d []byte, l int32) { + for u := range r.users.Values() { + u.SendAudio(d, l) + } + }) } func (r *Room[T]) InitVideo() { r.app.SetVideoCb(func(v app.Video) { data := r.media.ProcessVideo(v) - r.users.ForEach(func(u T) { u.SendVideo(data, v.Duration) }) + for u := range r.users.Values() { + u.SendVideo(data, v.Duration) + } }) } @@ -81,7 +88,11 @@ func (r *Room[T]) Id() string { return r.id } func (r *Room[T]) SetApp(app app.App) { r.app = app } func (r *Room[T]) SetMedia(m MediaPipe) { r.media = m } func (r *Room[T]) StartApp() { r.app.Start() } -func (r *Room[T]) Send(data []byte) { r.users.ForEach(func(u T) { u.SendData(data) }) } +func (r *Room[T]) Send(data []byte) { + for u := range r.users.Values() { + u.SendData(data) + } +} func (r *Room[T]) Close() { if r == nil || r.closed { @@ -137,7 +148,9 @@ func (r *Router[T]) Reset() { r.room.Close() r.room = nil } - r.users.ForEach(func(u T) { u.Disconnect() }) + for u := range r.users.Values() { + u.Disconnect() + } r.users.Reset() r.mu.Unlock() } From 129690e90184caaf4e711b880b9518f552e6be09 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 22 Nov 2025 22:21:05 +0300 Subject: [PATCH 337/361] Fix map test --- pkg/worker/room/router_test.go | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/pkg/worker/room/router_test.go b/pkg/worker/room/router_test.go index f404073c..013f1e27 100644 --- a/pkg/worker/room/router_test.go +++ b/pkg/worker/room/router_test.go @@ -25,7 +25,9 @@ type lookMap struct { func (l *lookMap) Reset() { l.prev = com.NewNetMap[string, *tSession]() - l.Map.ForEach(func(s *tSession) { l.prev.Add(s) }) + for s := range l.Map.Values() { + l.prev.Add(s) + } l.NetMap.Reset() } @@ -59,7 +61,9 @@ func TestRouterReset(t *testing.T) { router.Reset() disconnected := true - u.prev.ForEach(func(u *tSession) { disconnected = disconnected && !u.connected }) + for u := range u.prev.Values() { + disconnected = disconnected && !u.connected + } if !disconnected { t.Errorf("not all users were disconnected, but should") } From 84ad0a4cace683ad0243e568224a59b24f34901e Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 13 Dec 2025 23:56:38 +0300 Subject: [PATCH 338/361] Add audio resampling option You can now select between linear interpolation and nearest-neighbor resampling algorithms. --- pkg/config/config.yaml | 3 + pkg/config/worker.go | 3 +- pkg/worker/media/buffer.go | 233 ++++++++++++++++++++++---------- pkg/worker/media/buffer_test.go | 10 +- pkg/worker/media/media.go | 8 +- pkg/worker/media/media_test.go | 6 +- 6 files changed, 178 insertions(+), 85 deletions(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 7de1b43d..275eea59 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -341,6 +341,9 @@ encoder: frames: - 10 - 5 + # linear (1) or nearest neighbour (0) audio resampler + # linear should sound slightly better + resampler: 1 video: # h264, vpx (vp8) or vp9 codec: h264 diff --git a/pkg/config/worker.go b/pkg/config/worker.go index 5a509b0c..014ce644 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -51,7 +51,8 @@ type Encoder struct { } type Audio struct { - Frames []float32 + Frames []float32 + Resampler int } type Video struct { diff --git a/pkg/worker/media/buffer.go b/pkg/worker/media/buffer.go index e80a7c82..836e1c53 100644 --- a/pkg/worker/media/buffer.go +++ b/pkg/worker/media/buffer.go @@ -1,19 +1,28 @@ package media -import ( - "errors" - "math" - "unsafe" +import "errors" + +type ResampleAlgo uint8 + +const ( + ResampleNearest ResampleAlgo = iota + ResampleLinear ) +// preallocated scratch buffer for resampling output +// size for max Opus frame: 60ms at 48kHz stereo = 48000 * 0.06 * 2 = 5760 samples +var stretchBuf = make(samples, 5760) + // buffer is a simple non-concurrent safe buffer for audio samples. type buffer struct { - stretch bool - frameHz []int + useResample bool + algo ResampleAlgo + srcHz int + + raw samples - raw samples buckets []bucket - cur *bucket + bi int } type bucket struct { @@ -25,100 +34,180 @@ type bucket struct { func newBuffer(frames []float32, hz int) (*buffer, error) { if hz < 2000 { - return nil, errors.New("hz should be > than 2000") + return nil, errors.New("hz should be > 2000") + } + if len(frames) == 0 { + return nil, errors.New("frames list is empty") } - buf := buffer{} + buf := buffer{srcHz: hz} - // preallocate continuous array - s := 0 + totalSize := 0 for _, f := range frames { - s += frame(hz, f) - } - buf.raw = make(samples, s) - - if len(buf.raw) == 0 { - return nil, errors.New("seems those params are bad and the buffer is 0") + totalSize += frameStereoSamples(hz, f) } - next := 0 + if totalSize == 0 { + return nil, errors.New("calculated buffer size is 0, check params") + } + + buf.raw = make(samples, totalSize) + + // map buckets to the raw continuous array + offset := 0 for _, f := range frames { - s := frame(hz, f) + size := frameStereoSamples(hz, f) buf.buckets = append(buf.buckets, bucket{ - mem: buf.raw[next : next+s], + mem: buf.raw[offset : offset+size], ms: f, }) - next += s + offset += size } - buf.cur = &buf.buckets[len(buf.buckets)-1] + + // start with the largest bucket (last one, assuming frames are sorted ascending) + buf.bi = len(buf.buckets) - 1 + return &buf, nil } -func (b *buffer) choose(l int) { - for _, bb := range b.buckets { - if l >= len(bb.mem) { - b.cur = &bb - break +// cur returns the current bucket pointer +func (b *buffer) cur() *bucket { return &b.buckets[b.bi] } + +// choose selects the best bucket for the remaining samples. +// It picks the largest bucket that can be completely filled. +// Buckets should be sorted by size ascending for this to work optimally. +func (b *buffer) choose(remaining int) { + // search from largest to smallest + for i := len(b.buckets) - 1; i >= 0; i-- { + if remaining >= len(b.buckets[i].mem) { + b.bi = i + return } } + // fall back to smallest bucket if remaining < all bucket sizes + b.bi = 0 } -func (b *buffer) resample(hz int) { - b.stretch = true +// resample enables resampling to target Hz with specified algorithm +func (b *buffer) resample(targetHz int, algo ResampleAlgo) { + b.useResample = true + b.algo = algo for i := range b.buckets { - b.buckets[i].dst = frame(hz, b.buckets[i].ms) + b.buckets[i].dst = frameStereoSamples(targetHz, b.buckets[i].ms) } } -// write fills the buffer until it's full and then passes the gathered data into a callback. -// -// There are two cases to consider: -// 1. Underflow, when the length of the written data is less than the buffer's available space. -// 2. Overflow, when the length exceeds the current available buffer space. -// -// We overwrite any previous values in the buffer and move the internal write pointer -// by the length of the written data. -// In the first case, we won't call the callback, but it will be called every time -// when the internal buffer overflows until all samples are read. -// It will choose between multiple internal buffers to fit remaining samples. -func (b *buffer) write(s samples, onFull func(samples, float32)) (r int) { - for r < len(s) { - buf := b.cur - w := copy(buf.mem[buf.p:], s[r:]) - r += w - buf.p += w - if buf.p == len(buf.mem) { - if b.stretch { - onFull(buf.mem.stretch(buf.dst), buf.ms) +// stretch applies the selected resampling algorithm +func (b *buffer) stretch(src samples, dstSize int) samples { + switch b.algo { + case ResampleNearest: + return stretchNearest(src, dstSize) + case ResampleLinear: + return stretchLinear(src, dstSize) + default: + return stretchLinear(src, dstSize) + } +} + +// write fills the buffer and calls onFull when a complete frame is ready. +// returns the number of samples consumed. +func (b *buffer) write(s samples, onFull func(samples, float32)) int { + read := 0 + for read < len(s) { + cur := b.cur() + + // copy all samples into current bucket + n := copy(cur.mem[cur.p:], s[read:]) + read += n + cur.p += n + + // bucket is full - emit frame + if cur.p == len(cur.mem) { + if b.useResample { + onFull(b.stretch(cur.mem, cur.dst), cur.ms) } else { - onFull(buf.mem, buf.ms) + onFull(cur.mem, cur.ms) } - b.choose(len(s) - r) - b.cur.p = 0 + + // select next bucket and reset write position + b.choose(len(s) - read) + b.cur().p = 0 } } - return + return read } -// frame calculates an audio stereo frame size, i.e. 48k*frame/1000*2 -// with round(x / 2) * 2 for the closest even number -func frame(hz int, frame float32) int { - return int(math.Round(float64(hz)*float64(frame)/1000/2) * 2 * 2) +// frameStereoSamples calculates stereo frame size in samples. +// e.g., 48000 Hz * 20ms = 960 samples/channel * 2 channels = 1920 total samples +func frameStereoSamples(hz int, ms float32) int { + samplesPerChannel := int(float32(hz)*ms/1000 + 0.5) // round to nearest + return samplesPerChannel * 2 // stereo } -// stretch does a simple stretching of audio samples. -// something like: [1,2,3,4,5,6] -> [1,2,x,x,3,4,x,x,5,6,x,x] -> [1,2,1,2,3,4,3,4,5,6,5,6] -func (s samples) stretch(size int) []int16 { - out := buf[:size] - n := len(s) - ratio := float32(size) / float32(n) - sPtr := unsafe.Pointer(&s[0]) - for i, l, r := 0, 0, 0; i < n; i += 2 { - l, r = r, int(float32((i+2)>>1)*ratio)<<1 // index in src * ratio -> approximated index in dst *2 due to int16 - for j := l; j < r; j += 2 { - *(*int32)(unsafe.Pointer(&out[j])) = *(*int32)(sPtr) // out[j] = s[i]; out[j+1] = s[i+1] - } - sPtr = unsafe.Add(sPtr, uintptr(4)) +// stretchLinear resamples stereo audio using linear interpolation. +func stretchLinear(src samples, dstSize int) samples { + srcLen := len(src) + if srcLen < 2 || dstSize < 2 { + return stretchBuf[:dstSize] } + + out := stretchBuf[:dstSize] + + srcPairs := srcLen / 2 + dstPairs := dstSize / 2 + + // Fixed-point ratio for precision (16.16 fixed point) + ratio := ((srcPairs - 1) << 16) / (dstPairs - 1) + + for i := 0; i < dstPairs; i++ { + // Calculate source position in fixed-point + pos := i * ratio + srcIdx := pos >> 16 + frac := pos & 0xFFFF + + dstIdx := i * 2 + + if srcIdx >= srcPairs-1 { + // Last sample - no interpolation + out[dstIdx] = src[srcLen-2] + out[dstIdx+1] = src[srcLen-1] + } else { + // Linear interpolation for both channels + srcBase := srcIdx * 2 + + // Left channel + l0 := int32(src[srcBase]) + l1 := int32(src[srcBase+2]) + out[dstIdx] = int16(l0 + ((l1-l0)*int32(frac))>>16) + + // Right channel + r0 := int32(src[srcBase+1]) + r1 := int32(src[srcBase+3]) + out[dstIdx+1] = int16(r0 + ((r1-r0)*int32(frac))>>16) + } + } + + return out +} + +// stretchNearest is a faster nearest-neighbor version if quality isn't critical +func stretchNearest(src samples, dstSize int) samples { + srcLen := len(src) + if srcLen < 2 || dstSize < 2 { + return stretchBuf[:dstSize] + } + + out := stretchBuf[:dstSize] + + srcPairs := srcLen / 2 + dstPairs := dstSize / 2 + + for i := 0; i < dstPairs; i++ { + srcIdx := (i * srcPairs / dstPairs) * 2 + dstIdx := i * 2 + out[dstIdx] = src[srcIdx] + out[dstIdx+1] = src[srcIdx+1] + } + return out } diff --git a/pkg/worker/media/buffer_test.go b/pkg/worker/media/buffer_test.go index 29f2fc6a..28a596ba 100644 --- a/pkg/worker/media/buffer_test.go +++ b/pkg/worker/media/buffer_test.go @@ -23,7 +23,11 @@ func TestBufferWrite(t *testing.T) { {sample: 2, len: 20}, {sample: 3, len: 30}, }, - expect: samples{3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3}, + expect: samples{ + 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + }, }, { bufLen: 2000, @@ -32,7 +36,7 @@ func TestBufferWrite(t *testing.T) { {sample: 2, len: 18}, {sample: 3, len: 2}, }, - expect: samples{2, 3, 3, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, + expect: samples{1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, }, } @@ -48,7 +52,7 @@ func TestBufferWrite(t *testing.T) { ) } if !reflect.DeepEqual(test.expect, lastResult) { - t.Errorf("not expted buffer, %v != %v, %v", lastResult, test.expect, len(buf.cur.mem)) + t.Errorf("not expted buffer, %v != %v, %v", lastResult, test.expect, len(buf.buckets)) } } } diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index b08ec692..0d1407d6 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -12,17 +12,13 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/worker/caged/app" ) -const ( - audioHz = 48000 - sampleBufLen = 1024 * 4 -) +const audioHz = 48000 type samples []int16 var ( encoderOnce = sync.Once{} opusCoder *opus.Encoder - buf = make([]int16, sampleBufLen) ) func DefaultOpus() (*opus.Encoder, error) { @@ -116,7 +112,7 @@ func (wmp *WebrtcMediaPipe) initAudio(srcHz int, frameSizes []float32) error { wmp.log.Debug().Msgf("Opus frames (ms): %v", frameSizes) dstHz, _ := au.SampleRate() if srcHz != dstHz { - buf.resample(dstHz) + buf.resample(dstHz, ResampleAlgo(wmp.aConf.Resampler)) wmp.log.Debug().Msgf("Resample %vHz -> %vHz", srcHz, dstHz) } wmp.audioBuf = buf diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 4b9a431b..f754e17e 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -126,7 +126,7 @@ func TestResampleStretch(t *testing.T) { } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { - rez2 := tt.args.pcm.stretch(tt.args.size) + rez2 := stretchNearest(tt.args.pcm, tt.args.size) if rez2[0] != tt.args.pcm[0] || rez2[1] != tt.args.pcm[1] || rez2[len(rez2)-1] != tt.args.pcm[len(tt.args.pcm)-1] || rez2[len(rez2)-2] != tt.args.pcm[len(tt.args.pcm)-2] { @@ -141,7 +141,7 @@ func BenchmarkResampler(b *testing.B) { pcm := samples(gen(1764)) size := 1920 for i := 0; i < b.N; i++ { - pcm.stretch(size) + stretchLinear(pcm, size) } } @@ -170,7 +170,7 @@ func TestFrame(t *testing.T) { } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { - if got := frame(tt.args.hz, tt.args.frame); got != tt.want { + if got := frameStereoSamples(tt.args.hz, tt.args.frame); got != tt.want { t.Errorf("frame() = %v, want %v", got, tt.want) } }) From 460c4660530cb816ddf4e1a5d2387e8561322dd2 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 13:18:34 +0300 Subject: [PATCH 339/361] Try atomic-based locks in the same thread execution loop instead of a bunch of mutexes. --- pkg/worker/caged/libretro/nanoarch/nanoarch.c | 315 +++++++++++------- .../caged/libretro/nanoarch/nanoarch.go | 10 +- 2 files changed, 196 insertions(+), 129 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.c b/pkg/worker/caged/libretro/nanoarch/nanoarch.c index 6290150c..23bf8543 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.c +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.c @@ -1,30 +1,44 @@ #include "libretro.h" + #include #include #include +#include #include +#include #define RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB (3 | 0x800000) -int initialized = 0; - -typedef struct { - int type; - void* fn; - void* arg1; - void* arg2; - void* result; -} call_def_t; - -call_def_t call; +// ============================================================================ +// Call types for same_thread operations +// ============================================================================ enum call_type { - CALL_VOID = -1, + CALL_VOID = 0, CALL_SERIALIZE = 1, CALL_UNSERIALIZE = 2, }; -void *same_thread_with_args(void *f, int type, ...); +// ============================================================================ +// Lock-free call structure +// ============================================================================ + +typedef struct { + atomic_int state; // 0=idle, 1=pending, 2=done + int type; + void *fn; + void *arg1; + size_t arg2; + bool result; +} lf_call_t; + +static lf_call_t lf_call = {0}; +static atomic_int thread_running = 0; +static pthread_t worker_thread; + +// ============================================================================ +// Logging +// ============================================================================ void core_log_cgo(enum retro_log_level level, const char *fmt, ...) { char msg[2048] = {0}; @@ -36,6 +50,10 @@ void core_log_cgo(enum retro_log_level level, const char *fmt, ...) { coreLog(level, msg); } +// ============================================================================ +// Bridge functions for calling libretro core +// ============================================================================ + void bridge_call(void *f) { ((void (*)(void)) f)(); } @@ -92,49 +110,55 @@ void bridge_retro_set_controller_port_device(void *f, unsigned port, unsigned de ((void (*)(unsigned, unsigned)) f)(port, device); } +void bridge_retro_keyboard_callback(void *cb, bool down, unsigned keycode, uint32_t character, uint16_t keyModifiers) { + (*(retro_keyboard_event_t *) cb)(down, keycode, character, keyModifiers); +} + +void bridge_context_reset(retro_hw_context_reset_t f) { + f(); +} + +// ============================================================================ +// Environment callback +// ============================================================================ + static bool clear_all_thread_waits_cb(unsigned v, void *data) { core_log_cgo(RETRO_LOG_DEBUG, "CLEAR_ALL_THREAD_WAITS_CB (%d)\n", v); return true; } -void bridge_retro_keyboard_callback(void *cb, bool down, unsigned keycode, uint32_t character, uint16_t keyModifiers) { - (*(retro_keyboard_event_t *) cb)(down, keycode, character, keyModifiers); -} - bool core_environment_cgo(unsigned cmd, void *data) { bool coreEnvironment(unsigned, void *); switch (cmd) { case RETRO_ENVIRONMENT_GET_VARIABLE_UPDATE: - return false; - break; + return false; case RETRO_ENVIRONMENT_GET_AUDIO_VIDEO_ENABLE: - return false; - break; + return false; case RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB: - *(retro_environment_t *)data = clear_all_thread_waits_cb; - return true; - break; + *(retro_environment_t *)data = clear_all_thread_waits_cb; + return true; case RETRO_ENVIRONMENT_GET_INPUT_MAX_USERS: - *(unsigned *)data = 4; - core_log_cgo(RETRO_LOG_DEBUG, "Set max users: %d\n", 4); - return true; - break; + *(unsigned *)data = 4; + core_log_cgo(RETRO_LOG_DEBUG, "Set max users: %d\n", 4); + return true; case RETRO_ENVIRONMENT_GET_INPUT_BITMASKS: - return false; + return false; case RETRO_ENVIRONMENT_SHUTDOWN: - return false; - break; + return false; case RETRO_ENVIRONMENT_GET_SAVESTATE_CONTEXT: - if (data != NULL) *(int *)data = RETRO_SAVESTATE_CONTEXT_NORMAL; - return true; - break; + if (data != NULL) *(int *)data = RETRO_SAVESTATE_CONTEXT_NORMAL; + return true; } return coreEnvironment(cmd, data); } +// ============================================================================ +// Core callbacks +// ============================================================================ + void core_video_refresh_cgo(void *data, unsigned width, unsigned height, size_t pitch) { void coreVideoRefresh(void *, unsigned, unsigned, size_t); coreVideoRefresh(data, width, height, pitch); @@ -168,9 +192,9 @@ retro_proc_address_t core_get_proc_address_cgo(const char *sym) { return coreGetProcAddress(sym); } -void bridge_context_reset(retro_hw_context_reset_t f) { - f(); -} +// ============================================================================ +// Video init/deinit +// ============================================================================ void init_video_cgo() { void initVideo(); @@ -182,106 +206,151 @@ void deinit_video_cgo() { deinitVideo(); } -typedef struct { - pthread_mutex_t m; - pthread_cond_t cond; -} mutex_t; +// ============================================================================ +// CPU pause hints for spin loops +// ============================================================================ -void mutex_init(mutex_t *m) { - pthread_mutex_init(&m->m, NULL); - pthread_cond_init(&m->cond, NULL); +static inline void cpu_relax(void) { +#if defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || defined(_M_IX86) + __asm__ volatile("pause" ::: "memory"); +#elif defined(__aarch64__) + __asm__ volatile("isb" ::: "memory"); +#elif defined(__arm__) + __asm__ volatile("yield" ::: "memory"); +#else + // Generic fallback - compiler barrier + __asm__ volatile("" ::: "memory"); +#endif } -void mutex_destroy(mutex_t *m) { - pthread_mutex_trylock(&m->m); - pthread_mutex_unlock(&m->m); - pthread_mutex_destroy(&m->m); - pthread_cond_signal(&m->cond); - pthread_cond_destroy(&m->cond); -} +// ============================================================================ +// Lock-free same_thread implementation. +// Needed due to C/Go stack grow issues (libco). +// ============================================================================ -void mutex_lock(mutex_t *m) { pthread_mutex_lock(&m->m); } -void mutex_wait(mutex_t *m) { pthread_cond_wait(&m->cond, &m->m); } -void mutex_unlock(mutex_t *m) { pthread_mutex_unlock(&m->m); } -void mutex_signal(mutex_t *m) { pthread_cond_signal(&m->cond); } +static void *run_loop_fast(void *unused) { + core_log_cgo(RETRO_LOG_DEBUG, "Worker thread started\n"); -static pthread_t thread; -mutex_t run_mutex, done_mutex; + while (atomic_load_explicit(&thread_running, memory_order_acquire)) { + // Check if there's a pending call + int state = atomic_load_explicit(&lf_call.state, memory_order_acquire); -void *run_loop(void *unused) { - core_log_cgo(RETRO_LOG_DEBUG, "UnLibCo run loop start\n"); - mutex_lock(&done_mutex); - mutex_lock(&run_mutex); - mutex_signal(&done_mutex); - mutex_unlock(&done_mutex); - while (initialized) { - mutex_wait(&run_mutex); - switch (call.type) { - case CALL_SERIALIZE: - case CALL_UNSERIALIZE: - *(bool*)call.result = ((bool (*)(void*, size_t))call.fn)(call.arg1, *(size_t*)call.arg2); - break; - default: - ((void (*)(void)) call.fn)(); + if (state == 1) { + // Execute the call + switch (lf_call.type) { + case CALL_SERIALIZE: + lf_call.result = ((bool (*)(void*, size_t))lf_call.fn)( + lf_call.arg1, lf_call.arg2); + break; + case CALL_UNSERIALIZE: + lf_call.result = ((bool (*)(void*, size_t))lf_call.fn)( + lf_call.arg1, lf_call.arg2); + break; + case CALL_VOID: + default: + ((void (*)(void))lf_call.fn)(); + break; + } + + // Mark as done + atomic_store_explicit(&lf_call.state, 2, memory_order_release); + } else { + // Spin with CPU hint to reduce power consumption + cpu_relax(); } - mutex_lock(&done_mutex); - mutex_signal(&done_mutex); - mutex_unlock(&done_mutex); } - mutex_destroy(&run_mutex); - mutex_destroy(&done_mutex); - pthread_detach(thread); - core_log_cgo(RETRO_LOG_DEBUG, "UnLibCo run loop stop\n"); - pthread_exit(NULL); + + core_log_cgo(RETRO_LOG_DEBUG, "Worker thread stopped\n"); + return NULL; } -void same_thread_stop() { - initialized = 0; -} - -void *same_thread_with_args(void *f, int type, ...) { - if (!initialized) { - initialized = 1; - mutex_init(&run_mutex); - mutex_init(&done_mutex); - mutex_lock(&done_mutex); - pthread_create(&thread, NULL, run_loop, NULL); - mutex_wait(&done_mutex); - mutex_unlock(&done_mutex); +// Initialize the worker thread if not already running +static void same_thread_ensure_init(void) { + int expected = 0; + if (atomic_compare_exchange_strong_explicit( + &thread_running, &expected, 1, + memory_order_acq_rel, memory_order_acquire)) { + // We won the race to initialize + atomic_store_explicit(&lf_call.state, 0, memory_order_release); + pthread_create(&worker_thread, NULL, run_loop_fast, NULL); + core_log_cgo(RETRO_LOG_DEBUG, "Worker thread initialized\n"); } - mutex_lock(&run_mutex); - mutex_lock(&done_mutex); +} - call.type = type; - call.fn = f; - - if (type != CALL_VOID) { - va_list args; - va_start(args, type); - switch (type) { - case CALL_SERIALIZE: - case CALL_UNSERIALIZE: - call.arg1 = va_arg(args, void*); - size_t size; - size = va_arg(args, size_t); - call.arg2 = &size; - bool result; - call.result = &result; - break; - } - va_end(args); +// Stop the worker thread +void same_thread_stop(void) { + if (atomic_load_explicit(&thread_running, memory_order_acquire)) { + atomic_store_explicit(&thread_running, 0, memory_order_release); + pthread_join(worker_thread, NULL); + core_log_cgo(RETRO_LOG_DEBUG, "Worker thread stopped\n"); } - mutex_signal(&run_mutex); - mutex_unlock(&run_mutex); - mutex_wait(&done_mutex); - mutex_unlock(&done_mutex); - return call.result; -} - -void *same_thread_with_args2(void *f, int type, void *arg1, void *arg2) { - return same_thread_with_args(f, type, arg1, arg2); } +// Execute a void function on the worker thread void same_thread(void *f) { - same_thread_with_args(f, CALL_VOID); + same_thread_ensure_init(); + + // Wait for any previous call to complete + while (atomic_load_explicit(&lf_call.state, memory_order_acquire) != 0) { + cpu_relax(); + } + + // Set up the call + lf_call.fn = f; + lf_call.type = CALL_VOID; + + // Signal that a call is pending + atomic_store_explicit(&lf_call.state, 1, memory_order_release); + + // Wait for completion + while (atomic_load_explicit(&lf_call.state, memory_order_acquire) != 2) { + cpu_relax(); + } + + // Reset to idle + atomic_store_explicit(&lf_call.state, 0, memory_order_release); } + +// Execute a serialize/unserialize function on the worker thread +// Returns pointer to the result (stored in lf_call.result) +bool same_thread_serialize(void *f, int type, void *data, size_t size) { + same_thread_ensure_init(); + + // Wait for any previous call to complete + while (atomic_load_explicit(&lf_call.state, memory_order_acquire) != 0) { + cpu_relax(); + } + + // Set up the call - store values directly, not pointers to locals! + lf_call.fn = f; + lf_call.type = type; + lf_call.arg1 = data; + lf_call.arg2 = size; + lf_call.result = false; + + // Signal that a call is pending + atomic_store_explicit(&lf_call.state, 1, memory_order_release); + + // Wait for completion + while (atomic_load_explicit(&lf_call.state, memory_order_acquire) != 2) { + cpu_relax(); + } + + // Get result before resetting + bool result = lf_call.result; + + // Reset to idle + atomic_store_explicit(&lf_call.state, 0, memory_order_release); + + return result; +} + +// Execute functions on the same thread. +void *same_thread_with_args2(void *f, int type, void *arg1, void *arg2) { + size_t size = *(size_t*)arg2; + + static _Thread_local bool result_storage; + result_storage = same_thread_serialize(f, type, arg1, size); + + return &result_storage; +} \ No newline at end of file diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 7c05d962..710e0aec 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -504,9 +504,8 @@ func SaveState() (State, error) { rez := false if Nan0.LibCo && !Nan0.hackSkipSameThreadSave { - rez = *(*bool)(C.same_thread_with_args2(retroSerialize, C.int(CallSerialize), unsafe.Pointer(&data[0]), unsafe.Pointer(&size))) - } else { - rez = bool(C.bridge_retro_serialize(retroSerialize, unsafe.Pointer(&data[0]), size)) + rez = *(*bool)(C.same_thread_with_args2(retroSerialize, C.int(CallSerialize), + unsafe.Pointer(&data[0]), unsafe.Pointer(&size))) } if !rez { @@ -526,9 +525,8 @@ func RestoreSaveState(st State) error { rez := false if Nan0.LibCo { - rez = *(*bool)(C.same_thread_with_args2(retroUnserialize, C.int(CallUnserialize), unsafe.Pointer(&st[0]), unsafe.Pointer(&size))) - } else { - rez = bool(C.bridge_retro_unserialize(retroUnserialize, unsafe.Pointer(&st[0]), size)) + rez = *(*bool)(C.same_thread_with_args2(retroUnserialize, C.int(CallUnserialize), + unsafe.Pointer(&st[0]), unsafe.Pointer(&size))) } if !rez { From f708fce1122f115c5e12f61d3c8790ba3313c09b Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 13:30:45 +0300 Subject: [PATCH 340/361] Revert "Try atomic-based locks in the same thread execution loop instead of a bunch of mutexes." This reverts commit 460c4660530cb816ddf4e1a5d2387e8561322dd2. --- pkg/worker/caged/libretro/nanoarch/nanoarch.c | 315 +++++++----------- .../caged/libretro/nanoarch/nanoarch.go | 10 +- 2 files changed, 129 insertions(+), 196 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.c b/pkg/worker/caged/libretro/nanoarch/nanoarch.c index 23bf8543..6290150c 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.c +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.c @@ -1,44 +1,30 @@ #include "libretro.h" - #include #include #include -#include #include -#include #define RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB (3 | 0x800000) -// ============================================================================ -// Call types for same_thread operations -// ============================================================================ +int initialized = 0; + +typedef struct { + int type; + void* fn; + void* arg1; + void* arg2; + void* result; +} call_def_t; + +call_def_t call; enum call_type { - CALL_VOID = 0, + CALL_VOID = -1, CALL_SERIALIZE = 1, CALL_UNSERIALIZE = 2, }; -// ============================================================================ -// Lock-free call structure -// ============================================================================ - -typedef struct { - atomic_int state; // 0=idle, 1=pending, 2=done - int type; - void *fn; - void *arg1; - size_t arg2; - bool result; -} lf_call_t; - -static lf_call_t lf_call = {0}; -static atomic_int thread_running = 0; -static pthread_t worker_thread; - -// ============================================================================ -// Logging -// ============================================================================ +void *same_thread_with_args(void *f, int type, ...); void core_log_cgo(enum retro_log_level level, const char *fmt, ...) { char msg[2048] = {0}; @@ -50,10 +36,6 @@ void core_log_cgo(enum retro_log_level level, const char *fmt, ...) { coreLog(level, msg); } -// ============================================================================ -// Bridge functions for calling libretro core -// ============================================================================ - void bridge_call(void *f) { ((void (*)(void)) f)(); } @@ -110,55 +92,49 @@ void bridge_retro_set_controller_port_device(void *f, unsigned port, unsigned de ((void (*)(unsigned, unsigned)) f)(port, device); } -void bridge_retro_keyboard_callback(void *cb, bool down, unsigned keycode, uint32_t character, uint16_t keyModifiers) { - (*(retro_keyboard_event_t *) cb)(down, keycode, character, keyModifiers); -} - -void bridge_context_reset(retro_hw_context_reset_t f) { - f(); -} - -// ============================================================================ -// Environment callback -// ============================================================================ - static bool clear_all_thread_waits_cb(unsigned v, void *data) { core_log_cgo(RETRO_LOG_DEBUG, "CLEAR_ALL_THREAD_WAITS_CB (%d)\n", v); return true; } +void bridge_retro_keyboard_callback(void *cb, bool down, unsigned keycode, uint32_t character, uint16_t keyModifiers) { + (*(retro_keyboard_event_t *) cb)(down, keycode, character, keyModifiers); +} + bool core_environment_cgo(unsigned cmd, void *data) { bool coreEnvironment(unsigned, void *); switch (cmd) { case RETRO_ENVIRONMENT_GET_VARIABLE_UPDATE: - return false; + return false; + break; case RETRO_ENVIRONMENT_GET_AUDIO_VIDEO_ENABLE: - return false; + return false; + break; case RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB: - *(retro_environment_t *)data = clear_all_thread_waits_cb; - return true; + *(retro_environment_t *)data = clear_all_thread_waits_cb; + return true; + break; case RETRO_ENVIRONMENT_GET_INPUT_MAX_USERS: - *(unsigned *)data = 4; - core_log_cgo(RETRO_LOG_DEBUG, "Set max users: %d\n", 4); - return true; + *(unsigned *)data = 4; + core_log_cgo(RETRO_LOG_DEBUG, "Set max users: %d\n", 4); + return true; + break; case RETRO_ENVIRONMENT_GET_INPUT_BITMASKS: - return false; + return false; case RETRO_ENVIRONMENT_SHUTDOWN: - return false; + return false; + break; case RETRO_ENVIRONMENT_GET_SAVESTATE_CONTEXT: - if (data != NULL) *(int *)data = RETRO_SAVESTATE_CONTEXT_NORMAL; - return true; + if (data != NULL) *(int *)data = RETRO_SAVESTATE_CONTEXT_NORMAL; + return true; + break; } return coreEnvironment(cmd, data); } -// ============================================================================ -// Core callbacks -// ============================================================================ - void core_video_refresh_cgo(void *data, unsigned width, unsigned height, size_t pitch) { void coreVideoRefresh(void *, unsigned, unsigned, size_t); coreVideoRefresh(data, width, height, pitch); @@ -192,9 +168,9 @@ retro_proc_address_t core_get_proc_address_cgo(const char *sym) { return coreGetProcAddress(sym); } -// ============================================================================ -// Video init/deinit -// ============================================================================ +void bridge_context_reset(retro_hw_context_reset_t f) { + f(); +} void init_video_cgo() { void initVideo(); @@ -206,151 +182,106 @@ void deinit_video_cgo() { deinitVideo(); } -// ============================================================================ -// CPU pause hints for spin loops -// ============================================================================ +typedef struct { + pthread_mutex_t m; + pthread_cond_t cond; +} mutex_t; -static inline void cpu_relax(void) { -#if defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || defined(_M_IX86) - __asm__ volatile("pause" ::: "memory"); -#elif defined(__aarch64__) - __asm__ volatile("isb" ::: "memory"); -#elif defined(__arm__) - __asm__ volatile("yield" ::: "memory"); -#else - // Generic fallback - compiler barrier - __asm__ volatile("" ::: "memory"); -#endif +void mutex_init(mutex_t *m) { + pthread_mutex_init(&m->m, NULL); + pthread_cond_init(&m->cond, NULL); } -// ============================================================================ -// Lock-free same_thread implementation. -// Needed due to C/Go stack grow issues (libco). -// ============================================================================ +void mutex_destroy(mutex_t *m) { + pthread_mutex_trylock(&m->m); + pthread_mutex_unlock(&m->m); + pthread_mutex_destroy(&m->m); + pthread_cond_signal(&m->cond); + pthread_cond_destroy(&m->cond); +} -static void *run_loop_fast(void *unused) { - core_log_cgo(RETRO_LOG_DEBUG, "Worker thread started\n"); +void mutex_lock(mutex_t *m) { pthread_mutex_lock(&m->m); } +void mutex_wait(mutex_t *m) { pthread_cond_wait(&m->cond, &m->m); } +void mutex_unlock(mutex_t *m) { pthread_mutex_unlock(&m->m); } +void mutex_signal(mutex_t *m) { pthread_cond_signal(&m->cond); } - while (atomic_load_explicit(&thread_running, memory_order_acquire)) { - // Check if there's a pending call - int state = atomic_load_explicit(&lf_call.state, memory_order_acquire); +static pthread_t thread; +mutex_t run_mutex, done_mutex; - if (state == 1) { - // Execute the call - switch (lf_call.type) { - case CALL_SERIALIZE: - lf_call.result = ((bool (*)(void*, size_t))lf_call.fn)( - lf_call.arg1, lf_call.arg2); - break; - case CALL_UNSERIALIZE: - lf_call.result = ((bool (*)(void*, size_t))lf_call.fn)( - lf_call.arg1, lf_call.arg2); - break; - case CALL_VOID: - default: - ((void (*)(void))lf_call.fn)(); - break; - } - - // Mark as done - atomic_store_explicit(&lf_call.state, 2, memory_order_release); - } else { - // Spin with CPU hint to reduce power consumption - cpu_relax(); +void *run_loop(void *unused) { + core_log_cgo(RETRO_LOG_DEBUG, "UnLibCo run loop start\n"); + mutex_lock(&done_mutex); + mutex_lock(&run_mutex); + mutex_signal(&done_mutex); + mutex_unlock(&done_mutex); + while (initialized) { + mutex_wait(&run_mutex); + switch (call.type) { + case CALL_SERIALIZE: + case CALL_UNSERIALIZE: + *(bool*)call.result = ((bool (*)(void*, size_t))call.fn)(call.arg1, *(size_t*)call.arg2); + break; + default: + ((void (*)(void)) call.fn)(); } + mutex_lock(&done_mutex); + mutex_signal(&done_mutex); + mutex_unlock(&done_mutex); } - - core_log_cgo(RETRO_LOG_DEBUG, "Worker thread stopped\n"); - return NULL; + mutex_destroy(&run_mutex); + mutex_destroy(&done_mutex); + pthread_detach(thread); + core_log_cgo(RETRO_LOG_DEBUG, "UnLibCo run loop stop\n"); + pthread_exit(NULL); } -// Initialize the worker thread if not already running -static void same_thread_ensure_init(void) { - int expected = 0; - if (atomic_compare_exchange_strong_explicit( - &thread_running, &expected, 1, - memory_order_acq_rel, memory_order_acquire)) { - // We won the race to initialize - atomic_store_explicit(&lf_call.state, 0, memory_order_release); - pthread_create(&worker_thread, NULL, run_loop_fast, NULL); - core_log_cgo(RETRO_LOG_DEBUG, "Worker thread initialized\n"); - } +void same_thread_stop() { + initialized = 0; } -// Stop the worker thread -void same_thread_stop(void) { - if (atomic_load_explicit(&thread_running, memory_order_acquire)) { - atomic_store_explicit(&thread_running, 0, memory_order_release); - pthread_join(worker_thread, NULL); - core_log_cgo(RETRO_LOG_DEBUG, "Worker thread stopped\n"); +void *same_thread_with_args(void *f, int type, ...) { + if (!initialized) { + initialized = 1; + mutex_init(&run_mutex); + mutex_init(&done_mutex); + mutex_lock(&done_mutex); + pthread_create(&thread, NULL, run_loop, NULL); + mutex_wait(&done_mutex); + mutex_unlock(&done_mutex); } + mutex_lock(&run_mutex); + mutex_lock(&done_mutex); + + call.type = type; + call.fn = f; + + if (type != CALL_VOID) { + va_list args; + va_start(args, type); + switch (type) { + case CALL_SERIALIZE: + case CALL_UNSERIALIZE: + call.arg1 = va_arg(args, void*); + size_t size; + size = va_arg(args, size_t); + call.arg2 = &size; + bool result; + call.result = &result; + break; + } + va_end(args); + } + mutex_signal(&run_mutex); + mutex_unlock(&run_mutex); + mutex_wait(&done_mutex); + mutex_unlock(&done_mutex); + return call.result; } -// Execute a void function on the worker thread -void same_thread(void *f) { - same_thread_ensure_init(); - - // Wait for any previous call to complete - while (atomic_load_explicit(&lf_call.state, memory_order_acquire) != 0) { - cpu_relax(); - } - - // Set up the call - lf_call.fn = f; - lf_call.type = CALL_VOID; - - // Signal that a call is pending - atomic_store_explicit(&lf_call.state, 1, memory_order_release); - - // Wait for completion - while (atomic_load_explicit(&lf_call.state, memory_order_acquire) != 2) { - cpu_relax(); - } - - // Reset to idle - atomic_store_explicit(&lf_call.state, 0, memory_order_release); -} - -// Execute a serialize/unserialize function on the worker thread -// Returns pointer to the result (stored in lf_call.result) -bool same_thread_serialize(void *f, int type, void *data, size_t size) { - same_thread_ensure_init(); - - // Wait for any previous call to complete - while (atomic_load_explicit(&lf_call.state, memory_order_acquire) != 0) { - cpu_relax(); - } - - // Set up the call - store values directly, not pointers to locals! - lf_call.fn = f; - lf_call.type = type; - lf_call.arg1 = data; - lf_call.arg2 = size; - lf_call.result = false; - - // Signal that a call is pending - atomic_store_explicit(&lf_call.state, 1, memory_order_release); - - // Wait for completion - while (atomic_load_explicit(&lf_call.state, memory_order_acquire) != 2) { - cpu_relax(); - } - - // Get result before resetting - bool result = lf_call.result; - - // Reset to idle - atomic_store_explicit(&lf_call.state, 0, memory_order_release); - - return result; -} - -// Execute functions on the same thread. void *same_thread_with_args2(void *f, int type, void *arg1, void *arg2) { - size_t size = *(size_t*)arg2; + return same_thread_with_args(f, type, arg1, arg2); +} - static _Thread_local bool result_storage; - result_storage = same_thread_serialize(f, type, arg1, size); - - return &result_storage; -} \ No newline at end of file +void same_thread(void *f) { + same_thread_with_args(f, CALL_VOID); +} diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 710e0aec..7c05d962 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -504,8 +504,9 @@ func SaveState() (State, error) { rez := false if Nan0.LibCo && !Nan0.hackSkipSameThreadSave { - rez = *(*bool)(C.same_thread_with_args2(retroSerialize, C.int(CallSerialize), - unsafe.Pointer(&data[0]), unsafe.Pointer(&size))) + rez = *(*bool)(C.same_thread_with_args2(retroSerialize, C.int(CallSerialize), unsafe.Pointer(&data[0]), unsafe.Pointer(&size))) + } else { + rez = bool(C.bridge_retro_serialize(retroSerialize, unsafe.Pointer(&data[0]), size)) } if !rez { @@ -525,8 +526,9 @@ func RestoreSaveState(st State) error { rez := false if Nan0.LibCo { - rez = *(*bool)(C.same_thread_with_args2(retroUnserialize, C.int(CallUnserialize), - unsafe.Pointer(&st[0]), unsafe.Pointer(&size))) + rez = *(*bool)(C.same_thread_with_args2(retroUnserialize, C.int(CallUnserialize), unsafe.Pointer(&st[0]), unsafe.Pointer(&size))) + } else { + rez = bool(C.bridge_retro_unserialize(retroUnserialize, unsafe.Pointer(&st[0]), size)) } if !rez { From 671e875f1298f7cf564b5cc53a64019246696be9 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 13:53:21 +0300 Subject: [PATCH 341/361] Add input cache for retropad, keyboard and mouse --- pkg/worker/caged/libretro/nanoarch/input.go | 43 ++++++- pkg/worker/caged/libretro/nanoarch/nanoarch.c | 119 ++++++++++++++++-- .../caged/libretro/nanoarch/nanoarch.go | 64 ++-------- 3 files changed, 163 insertions(+), 63 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/input.go b/pkg/worker/caged/libretro/nanoarch/input.go index 246988d4..e095bbd8 100644 --- a/pkg/worker/caged/libretro/nanoarch/input.go +++ b/pkg/worker/caged/libretro/nanoarch/input.go @@ -6,8 +6,16 @@ import ( "sync/atomic" ) -//#include -//#include "libretro.h" +/* +#include +#include "libretro.h" + +void input_cache_set_port(unsigned port, uint32_t buttons, + int16_t axis0, int16_t axis1, int16_t axis2, int16_t axis3); +void input_cache_set_keyboard_key(unsigned id, uint8_t pressed); +void input_cache_set_mouse(int16_t dx, int16_t dy, uint8_t buttons); +void input_cache_clear(void); +*/ import "C" const ( @@ -84,6 +92,19 @@ func (s *InputState) IsDpadTouched(port uint, axis uint) (shift C.int16_t) { return C.int16_t(atomic.LoadInt32(&s[port].axes[axis])) } +// SyncToCache syncs the entire input state to the C-side cache. +// Call this once before each Run() instead of having C call back into Go. +func (s *InputState) SyncToCache() { + for port := uint(0); port < maxPort; port++ { + buttons := atomic.LoadUint32(&s[port].keys) + axis0 := C.int16_t(atomic.LoadInt32(&s[port].axes[0])) + axis1 := C.int16_t(atomic.LoadInt32(&s[port].axes[1])) + axis2 := C.int16_t(atomic.LoadInt32(&s[port].axes[2])) + axis3 := C.int16_t(atomic.LoadInt32(&s[port].axes[3])) + C.input_cache_set_port(C.uint(port), C.uint32_t(buttons), axis0, axis1, axis2, axis3) + } +} + // SetKey sets keyboard state. // // 0 1 2 3 4 5 6 @@ -120,6 +141,15 @@ func (ks *KeyboardState) Pressed(key uint) C.int16_t { return Released } +// SyncToCache syncs keyboard state to the C-side cache. +func (ks *KeyboardState) SyncToCache() { + ks.mu.Lock() + defer ks.mu.Unlock() + for id, pressed := range ks.keys { + C.input_cache_set_keyboard_key(C.uint(id), C.uint8_t(pressed)) + } +} + // ShiftPos sets mouse relative position state. // // 0 1 2 3 @@ -148,3 +178,12 @@ func (ms *MouseState) Buttons() (l, r, m bool) { m = mbs&MouseMiddle != 0 return } + +// SyncToCache syncs mouse state to the C-side cache. +// This consumes the delta values (swaps to 0). +func (ms *MouseState) SyncToCache() { + dx := C.int16_t(ms.dx.Swap(0)) + dy := C.int16_t(ms.dy.Swap(0)) + buttons := C.uint8_t(ms.buttons.Load()) + C.input_cache_set_mouse(dx, dy, buttons) +} diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.c b/pkg/worker/caged/libretro/nanoarch/nanoarch.c index 6290150c..d9010539 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.c +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.c @@ -3,17 +3,18 @@ #include #include #include +#include #define RETRO_ENVIRONMENT_GET_CLEAR_ALL_THREAD_WAITS_CB (3 | 0x800000) int initialized = 0; typedef struct { - int type; - void* fn; - void* arg1; - void* arg2; - void* result; + int type; + void* fn; + void* arg1; + void* arg2; + void* result; } call_def_t; call_def_t call; @@ -26,6 +27,57 @@ enum call_type { void *same_thread_with_args(void *f, int type, ...); +// Input State Cache + +#define INPUT_MAX_PORTS 4 +#define INPUT_MAX_KEYS 512 + +typedef struct { + // Retropad: store raw button bitmask and analog axes per port + uint32_t buttons[INPUT_MAX_PORTS]; + int16_t analog[INPUT_MAX_PORTS][4]; // 4 axes per port + + // Keyboard + uint8_t keyboard[INPUT_MAX_KEYS]; + + // Mouse + int16_t mouse_x; + int16_t mouse_y; + uint8_t mouse_buttons; // bit 0=left, bit 1=right, bit 2=middle +} input_cache_t; + +static input_cache_t input_cache = {0}; + +// Update entire port state at once +void input_cache_set_port(unsigned port, uint32_t buttons, + int16_t axis0, int16_t axis1, int16_t axis2, int16_t axis3) { + if (port < INPUT_MAX_PORTS) { + input_cache.buttons[port] = buttons; + input_cache.analog[port][0] = axis0; + input_cache.analog[port][1] = axis1; + input_cache.analog[port][2] = axis2; + input_cache.analog[port][3] = axis3; + } +} + +// Keyboard update +void input_cache_set_keyboard_key(unsigned id, uint8_t pressed) { + if (id < INPUT_MAX_KEYS) { + input_cache.keyboard[id] = pressed; + } +} + +// Mouse update +void input_cache_set_mouse(int16_t dx, int16_t dy, uint8_t buttons) { + input_cache.mouse_x = dx; + input_cache.mouse_y = dy; + input_cache.mouse_buttons = buttons; +} + +void input_cache_clear(void) { + memset(&input_cache, 0, sizeof(input_cache)); +} + void core_log_cgo(enum retro_log_level level, const char *fmt, ...) { char msg[2048] = {0}; va_list va; @@ -144,8 +196,61 @@ void core_input_poll_cgo() { } int16_t core_input_state_cgo(unsigned port, unsigned device, unsigned index, unsigned id) { - int16_t coreInputState(unsigned, unsigned, unsigned, unsigned); - return coreInputState(port, device, index, id); + if (port >= INPUT_MAX_PORTS) { + return 0; + } + + switch (device) { + case RETRO_DEVICE_JOYPAD: + // Extract button bit from cached bitmask + return (int16_t)((input_cache.buttons[port] >> id) & 1); + + case RETRO_DEVICE_ANALOG: + switch (index) { + case RETRO_DEVICE_INDEX_ANALOG_LEFT: + // id: 0=X, 1=Y + if (id < 2) { + return input_cache.analog[port][id]; + } + break; + case RETRO_DEVICE_INDEX_ANALOG_RIGHT: + // id: 0=X, 1=Y -> stored in axes[2], axes[3] + if (id < 2) { + return input_cache.analog[port][2 + id]; + } + break; + } + break; + + case RETRO_DEVICE_KEYBOARD: + if (id < INPUT_MAX_KEYS) { + return input_cache.keyboard[id] ? 1 : 0; + } + break; + + case RETRO_DEVICE_MOUSE: + switch (id) { + case RETRO_DEVICE_ID_MOUSE_X: { + int16_t x = input_cache.mouse_x; + input_cache.mouse_x = 0; // Consume delta + return x; + } + case RETRO_DEVICE_ID_MOUSE_Y: { + int16_t y = input_cache.mouse_y; + input_cache.mouse_y = 0; // Consume delta + return y; + } + case RETRO_DEVICE_ID_MOUSE_LEFT: + return (input_cache.mouse_buttons & 0x01) ? 1 : 0; + case RETRO_DEVICE_ID_MOUSE_RIGHT: + return (input_cache.mouse_buttons & 0x02) ? 1 : 0; + case RETRO_DEVICE_ID_MOUSE_MIDDLE: + return (input_cache.mouse_buttons & 0x04) ? 1 : 0; + } + break; + } + + return 0; } size_t core_audio_sample_batch_cgo(const int16_t *data, size_t frames) { diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 7c05d962..e0be87fd 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -396,12 +396,21 @@ func (n *Nanoarch) Reset() { C.bridge_call(retroReset) } +func (n *Nanoarch) syncInputToCache() { + n.retropad.SyncToCache() + if n.keyboardCb != nil { + n.keyboard.SyncToCache() + } + n.mouse.SyncToCache() +} + func (n *Nanoarch) Run() { + n.syncInputToCache() + if n.LibCo { C.same_thread(retroRun) } else { if n.Video.gl.enabled { - // running inside a go routine, lock the thread to make sure the OpenGL context stays current runtime.LockOSThread() if err := n.sdlCtx.BindContext(); err != nil { n.log.Error().Err(err).Msg("ctx bind fail") @@ -672,59 +681,6 @@ func coreVideoRefresh(data unsafe.Pointer, width, height uint, packed uint) { Nan0.Handlers.OnVideo(data_, int32(dt), FrameInfo{W: width, H: height, Stride: packed}) } -//export coreInputState -func coreInputState(port C.unsigned, device C.unsigned, index C.unsigned, id C.unsigned) C.int16_t { - //Nan0.log.Debug().Msgf("%v %v %v %v", port, device, index, id) - - // something like PCSX-ReArmed has 8 ports - if port >= maxPort { - return Released - } - - switch device { - case C.RETRO_DEVICE_JOYPAD: - return Nan0.retropad.IsKeyPressed(uint(port), int(id)) - case C.RETRO_DEVICE_ANALOG: - switch index { - case C.RETRO_DEVICE_INDEX_ANALOG_LEFT: - return Nan0.retropad.IsDpadTouched(uint(port), uint(index*2+id)) - case C.RETRO_DEVICE_INDEX_ANALOG_RIGHT: - case C.RETRO_DEVICE_INDEX_ANALOG_BUTTON: - } - case C.RETRO_DEVICE_KEYBOARD: - return Nan0.keyboard.Pressed(uint(id)) - case C.RETRO_DEVICE_MOUSE: - switch id { - case C.RETRO_DEVICE_ID_MOUSE_X: - x := Nan0.mouse.PopX() - return x - case C.RETRO_DEVICE_ID_MOUSE_Y: - y := Nan0.mouse.PopY() - return y - case C.RETRO_DEVICE_ID_MOUSE_LEFT: - if l, _, _ := Nan0.mouse.Buttons(); l { - return Pressed - } - case C.RETRO_DEVICE_ID_MOUSE_RIGHT: - if _, r, _ := Nan0.mouse.Buttons(); r { - return Pressed - } - case C.RETRO_DEVICE_ID_MOUSE_WHEELUP: - case C.RETRO_DEVICE_ID_MOUSE_WHEELDOWN: - case C.RETRO_DEVICE_ID_MOUSE_MIDDLE: - if _, _, m := Nan0.mouse.Buttons(); m { - return Pressed - } - case C.RETRO_DEVICE_ID_MOUSE_HORIZ_WHEELUP: - case C.RETRO_DEVICE_ID_MOUSE_HORIZ_WHEELDOWN: - case C.RETRO_DEVICE_ID_MOUSE_BUTTON_4: - case C.RETRO_DEVICE_ID_MOUSE_BUTTON_5: - } - } - - return Released -} - //export coreAudioSampleBatch func coreAudioSampleBatch(data unsafe.Pointer, frames C.size_t) C.size_t { if Nan0.Stopped.Load() { From 9d54ea4c493cbddd0fbd777fef2abb413a99e404 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 16:24:35 +0300 Subject: [PATCH 342/361] Add and use Speex audio resampler --- Dockerfile | 1 + README.md | 6 +- go.mod | 29 ++--- go.sum | 30 +++++ pkg/config/config.yaml | 6 +- pkg/worker/media/buffer.go | 237 ++++++++++++++++--------------------- 6 files changed, 155 insertions(+), 154 deletions(-) diff --git a/Dockerfile b/Dockerfile index b3da7099..3b3f23c6 100644 --- a/Dockerfile +++ b/Dockerfile @@ -54,6 +54,7 @@ RUN apt-get -q update && apt-get -q install --no-install-recommends -y \ libyuv-dev \ libjpeg-turbo8-dev \ libx264-dev \ + libspeexdsp-dev \ pkg-config \ && rm -rf /var/lib/apt/lists/* diff --git a/README.md b/README.md index 1f357d4a..1054d2ab 100644 --- a/README.md +++ b/README.md @@ -60,13 +60,13 @@ a better sense of performance. ``` # Ubuntu / Windows (WSL2) -apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev libjpeg-turbo8-dev +apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev libjpeg-turbo8-dev libspeexdsp-dev # MacOS -brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo +brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo speexdsp # Windows (MSYS2) -pacman -Sy --noconfirm --needed git make mingw-w64-ucrt-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,libx264,SDL2,libyuv,libjpeg-turbo} +pacman -Sy --noconfirm --needed git make mingw-w64-ucrt-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,libx264,SDL2,libyuv,libjpeg-turbo,speexdsp} ``` (You don't need to download libyuv on macOS) diff --git a/go.mod b/go.mod index d5ebd227..67bdd591 100644 --- a/go.mod +++ b/go.mod @@ -4,6 +4,7 @@ go 1.25 require ( github.com/VictoriaMetrics/metrics v1.40.2 + github.com/aam335/speexdsp v0.0.0-20190116080032-198c2d2ba225 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.9.0 github.com/goccy/go-json v0.10.5 @@ -12,15 +13,15 @@ require ( github.com/knadh/koanf/maps v0.1.2 github.com/knadh/koanf/v2 v2.3.0 github.com/minio/minio-go/v7 v7.0.97 - github.com/pion/ice/v4 v4.0.10 + github.com/pion/ice/v4 v4.1.0 github.com/pion/interceptor v0.1.42 github.com/pion/logging v0.2.4 - github.com/pion/webrtc/v4 v4.1.6 + github.com/pion/webrtc/v4 v4.1.8 github.com/rs/xid v1.6.0 github.com/rs/zerolog v1.34.0 github.com/veandco/go-sdl2 v0.4.40 - golang.org/x/crypto v0.45.0 - golang.org/x/image v0.30.0 + golang.org/x/crypto v0.46.0 + golang.org/x/image v0.34.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -29,7 +30,7 @@ require ( github.com/go-ini/ini v1.67.0 // indirect github.com/go-viper/mapstructure/v2 v2.4.0 // indirect github.com/google/uuid v1.6.0 // indirect - github.com/klauspost/compress v1.18.1 // indirect + github.com/klauspost/compress v1.18.2 // indirect github.com/klauspost/cpuid/v2 v2.3.0 // indirect github.com/klauspost/crc32 v1.3.0 // indirect github.com/mattn/go-colorable v0.1.14 // indirect @@ -40,23 +41,23 @@ require ( github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/philhofer/fwd v1.2.0 // indirect github.com/pion/datachannel v1.5.10 // indirect - github.com/pion/dtls/v3 v3.0.7 // indirect + github.com/pion/dtls/v3 v3.0.9 // indirect github.com/pion/mdns/v2 v2.1.0 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.16 // indirect - github.com/pion/rtp v1.8.25 // indirect - github.com/pion/sctp v1.8.40 // indirect + github.com/pion/rtp v1.8.26 // indirect + github.com/pion/sctp v1.8.41 // indirect github.com/pion/sdp/v3 v3.0.16 // indirect - github.com/pion/srtp/v3 v3.0.8 // indirect - github.com/pion/stun/v3 v3.0.1 // indirect + github.com/pion/srtp/v3 v3.0.9 // indirect + github.com/pion/stun/v3 v3.0.2 // indirect github.com/pion/transport/v3 v3.1.1 // indirect github.com/pion/turn/v4 v4.1.3 // indirect github.com/rogpeppe/go-internal v1.12.0 // indirect - github.com/tinylib/msgp v1.5.0 // indirect + github.com/tinylib/msgp v1.6.1 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect github.com/wlynxg/anet v0.0.5 // indirect - golang.org/x/net v0.47.0 // indirect - golang.org/x/sys v0.38.0 // indirect - golang.org/x/text v0.31.0 // indirect + golang.org/x/net v0.48.0 // indirect + golang.org/x/sys v0.39.0 // indirect + golang.org/x/text v0.32.0 // indirect ) diff --git a/go.sum b/go.sum index 55499af2..a8bf22f5 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,7 @@ github.com/VictoriaMetrics/metrics v1.40.2 h1:OVSjKcQEx6JAwGeu8/KQm9Su5qJ72TMEW4xYn5vw3Ac= github.com/VictoriaMetrics/metrics v1.40.2/go.mod h1:XE4uudAAIRaJE614Tl5HMrtoEU6+GDZO4QTnNSsZRuA= +github.com/aam335/speexdsp v0.0.0-20190116080032-198c2d2ba225 h1:qZ9Sv2nmB9oFAZLdhsvjpBW4NyKexrSnCzjQJPfcaTU= +github.com/aam335/speexdsp v0.0.0-20190116080032-198c2d2ba225/go.mod h1:gui3wdg1cup88TpLbUDkl88CPrD+b9ICs886eDh2hOQ= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -24,6 +26,8 @@ github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aN github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= github.com/klauspost/compress v1.18.1 h1:bcSGx7UbpBqMChDtsF28Lw6v/G94LPrrbMbdC3JH2co= github.com/klauspost/compress v1.18.1/go.mod h1:ZQFFVG+MdnR0P+l6wpXgIL4NTtwiKIdBnrBd8Nrxr+0= +github.com/klauspost/compress v1.18.2 h1:iiPHWW0YrcFgpBYhsA6D1+fqHssJscY/Tm/y2Uqnapk= +github.com/klauspost/compress v1.18.2/go.mod h1:R0h/fSBs8DE4ENlcrlib3PsXS61voFxhIs2DeRhCvJ4= github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y= github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0= @@ -60,8 +64,12 @@ github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= github.com/pion/dtls/v3 v3.0.7 h1:bItXtTYYhZwkPFk4t1n3Kkf5TDrfj6+4wG+CZR8uI9Q= github.com/pion/dtls/v3 v3.0.7/go.mod h1:uDlH5VPrgOQIw59irKYkMudSFprY9IEFCqz/eTz16f8= +github.com/pion/dtls/v3 v3.0.9 h1:4AijfFRm8mAjd1gfdlB1wzJF3fjjR/VPIpJgkEtvYmM= +github.com/pion/dtls/v3 v3.0.9/go.mod h1:abApPjgadS/ra1wvUzHLc3o2HvoxppAh+NZkyApL4Os= github.com/pion/ice/v4 v4.0.10 h1:P59w1iauC/wPk9PdY8Vjl4fOFL5B+USq1+xbDcN6gT4= github.com/pion/ice/v4 v4.0.10/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= +github.com/pion/ice/v4 v4.1.0 h1:YlxIii2bTPWyC08/4hdmtYq4srbrY0T9xcTsTjldGqU= +github.com/pion/ice/v4 v4.1.0/go.mod h1:5gPbzYxqenvn05k7zKPIZFuSAufolygiy6P1U9HzvZ4= github.com/pion/interceptor v0.1.42 h1:0/4tvNtruXflBxLfApMVoMubUMik57VZ+94U0J7cmkQ= github.com/pion/interceptor v0.1.42/go.mod h1:g6XYTChs9XyolIQFhRHOOUS+bGVGLRfgTCUzH29EfVU= github.com/pion/logging v0.2.4 h1:tTew+7cmQ+Mc1pTBLKH2puKsOvhm32dROumOZ655zB8= @@ -74,20 +82,30 @@ github.com/pion/rtcp v1.2.16 h1:fk1B1dNW4hsI78XUCljZJlC4kZOPk67mNRuQ0fcEkSo= github.com/pion/rtcp v1.2.16/go.mod h1:/as7VKfYbs5NIb4h6muQ35kQF/J0ZVNz2Z3xKoCBYOo= github.com/pion/rtp v1.8.25 h1:b8+y44GNbwOJTYWuVan7SglX/hMlicVCAtL50ztyZHw= github.com/pion/rtp v1.8.25/go.mod h1:rF5nS1GqbR7H/TCpKwylzeq6yDM+MM6k+On5EgeThEM= +github.com/pion/rtp v1.8.26 h1:VB+ESQFQhBXFytD+Gk8cxB6dXeVf2WQzg4aORvAvAAc= +github.com/pion/rtp v1.8.26/go.mod h1:rF5nS1GqbR7H/TCpKwylzeq6yDM+MM6k+On5EgeThEM= github.com/pion/sctp v1.8.40 h1:bqbgWYOrUhsYItEnRObUYZuzvOMsVplS3oNgzedBlG8= github.com/pion/sctp v1.8.40/go.mod h1:SPBBUENXE6ThkEksN5ZavfAhFYll+h+66ZiG6IZQuzo= +github.com/pion/sctp v1.8.41 h1:20R4OHAno4Vky3/iE4xccInAScAa83X6nWUfyc65MIs= +github.com/pion/sctp v1.8.41/go.mod h1:2wO6HBycUH7iCssuGyc2e9+0giXVW0pyCv3ZuL8LiyY= github.com/pion/sdp/v3 v3.0.16 h1:0dKzYO6gTAvuLaAKQkC02eCPjMIi4NuAr/ibAwrGDCo= github.com/pion/sdp/v3 v3.0.16/go.mod h1:9tyKzznud3qiweZcD86kS0ff1pGYB3VX+Bcsmkx6IXo= github.com/pion/srtp/v3 v3.0.8 h1:RjRrjcIeQsilPzxvdaElN0CpuQZdMvcl9VZ5UY9suUM= github.com/pion/srtp/v3 v3.0.8/go.mod h1:2Sq6YnDH7/UDCvkSoHSDNDeyBcFgWL0sAVycVbAsXFg= +github.com/pion/srtp/v3 v3.0.9 h1:lRGF4G61xxj+m/YluB3ZnBpiALSri2lTzba0kGZMrQY= +github.com/pion/srtp/v3 v3.0.9/go.mod h1:E+AuWd7Ug2Fp5u38MKnhduvpVkveXJX6J4Lq4rxUYt8= github.com/pion/stun/v3 v3.0.1 h1:jx1uUq6BdPihF0yF33Jj2mh+C9p0atY94IkdnW174kA= github.com/pion/stun/v3 v3.0.1/go.mod h1:RHnvlKFg+qHgoKIqtQWMOJF52wsImCAf/Jh5GjX+4Tw= +github.com/pion/stun/v3 v3.0.2 h1:BJuGEN2oLrJisiNEJtUTJC4BGbzbfp37LizfqswblFU= +github.com/pion/stun/v3 v3.0.2/go.mod h1:JFJKfIWvt178MCF5H/YIgZ4VX3LYE77vca4b9HP60SA= github.com/pion/transport/v3 v3.1.1 h1:Tr684+fnnKlhPceU+ICdrw6KKkTms+5qHMgw6bIkYOM= github.com/pion/transport/v3 v3.1.1/go.mod h1:+c2eewC5WJQHiAA46fkMMzoYZSuGzA/7E2FPrOYHctQ= github.com/pion/turn/v4 v4.1.3 h1:jVNW0iR05AS94ysEtvzsrk3gKs9Zqxf6HmnsLfRvlzA= github.com/pion/turn/v4 v4.1.3/go.mod h1:TD/eiBUf5f5LwXbCJa35T7dPtTpCHRJ9oJWmyPLVT3A= github.com/pion/webrtc/v4 v4.1.6 h1:srHH2HwvCGwPba25EYJgUzgLqCQoXl1VCUnrGQMSzUw= github.com/pion/webrtc/v4 v4.1.6/go.mod h1:wKecGRlkl3ox/As/MYghJL+b/cVXMEhoPMJWPuGQFhU= +github.com/pion/webrtc/v4 v4.1.8 h1:ynkjfiURDQ1+8EcJsoa60yumHAmyeYjz08AaOuor+sk= +github.com/pion/webrtc/v4 v4.1.8/go.mod h1:KVaARG2RN0lZx0jc7AWTe38JpPv+1/KicOZ9jN52J/s= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -101,6 +119,8 @@ github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U= github.com/tinylib/msgp v1.5.0 h1:GWnqAE54wmnlFazjq2+vgr736Akg58iiHImh+kPY2pc= github.com/tinylib/msgp v1.5.0/go.mod h1:cvjFkb4RiC8qSBOPMGPSzSAx47nAsfhLVTCZZNuHv5o= +github.com/tinylib/msgp v1.6.1 h1:ESRv8eL3u+DNHUoSAAQRE50Hm162zqAnBoGv9PzScPY= +github.com/tinylib/msgp v1.6.1/go.mod h1:RSp0LW9oSxFut3KzESt5Voq4GVWyS+PSulT77roAqEA= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= @@ -111,17 +131,27 @@ github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= golang.org/x/crypto v0.45.0 h1:jMBrvKuj23MTlT0bQEOBcAE0mjg8mK9RXFhRH6nyF3Q= golang.org/x/crypto v0.45.0/go.mod h1:XTGrrkGJve7CYK7J8PEww4aY7gM3qMCElcJQ8n8JdX4= +golang.org/x/crypto v0.46.0 h1:cKRW/pmt1pKAfetfu+RCEvjvZkA9RimPbh7bhFjGVBU= +golang.org/x/crypto v0.46.0/go.mod h1:Evb/oLKmMraqjZ2iQTwDwvCtJkczlDuTmdJXoZVzqU0= golang.org/x/image v0.30.0 h1:jD5RhkmVAnjqaCUXfbGBrn3lpxbknfN9w2UhHHU+5B4= golang.org/x/image v0.30.0/go.mod h1:SAEUTxCCMWSrJcCy/4HwavEsfZZJlYxeHLc6tTiAe/c= +golang.org/x/image v0.34.0 h1:33gCkyw9hmwbZJeZkct8XyR11yH889EQt/QH4VmXMn8= +golang.org/x/image v0.34.0/go.mod h1:2RNFBZRB+vnwwFil8GkMdRvrJOFd1AzdZI6vOY+eJVU= golang.org/x/net v0.47.0 h1:Mx+4dIFzqraBXUugkia1OOvlD6LemFo1ALMHjrXDOhY= golang.org/x/net v0.47.0/go.mod h1:/jNxtkgq5yWUGYkaZGqo27cfGZ1c5Nen03aYrrKpVRU= +golang.org/x/net v0.48.0 h1:zyQRTTrjc33Lhh0fBgT/H3oZq9WuvRR5gPC70xpDiQU= +golang.org/x/net v0.48.0/go.mod h1:+ndRgGjkh8FGtu1w1FGbEC31if4VrNVMuKTgcAAnQRY= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc= golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks= +golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk= +golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks= golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM= golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM= +golang.org/x/text v0.32.0 h1:ZD01bjUt1FQ9WJ0ClOL5vxgxOI/sVCNgX1YtKwcY0mU= +golang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 275eea59..9b142aff 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -341,9 +341,9 @@ encoder: frames: - 10 - 5 - # linear (1) or nearest neighbour (0) audio resampler - # linear should sound slightly better - resampler: 1 + # speex (2), linear (1) or nearest neighbour (0) audio resampler + # linear should sound slightly better than 0 + resampler: 2 video: # h264, vpx (vp8) or vp9 codec: h264 diff --git a/pkg/worker/media/buffer.go b/pkg/worker/media/buffer.go index 836e1c53..223c0e43 100644 --- a/pkg/worker/media/buffer.go +++ b/pkg/worker/media/buffer.go @@ -1,28 +1,28 @@ package media -import "errors" +import ( + "errors" + + "github.com/aam335/speexdsp" +) type ResampleAlgo uint8 const ( ResampleNearest ResampleAlgo = iota ResampleLinear + ResampleSpeex ) -// preallocated scratch buffer for resampling output -// size for max Opus frame: 60ms at 48kHz stereo = 48000 * 0.06 * 2 = 5760 samples -var stretchBuf = make(samples, 5760) - -// buffer is a simple non-concurrent safe buffer for audio samples. type buffer struct { - useResample bool - algo ResampleAlgo - srcHz int - - raw samples - - buckets []bucket - bi int + raw samples + scratch samples + buckets []bucket + resampler *speexdsp.Resampler + srcHz int + dstHz int + bi int + algo ResampleAlgo } type bucket struct { @@ -33,181 +33,150 @@ type bucket struct { } func newBuffer(frames []float32, hz int) (*buffer, error) { - if hz < 2000 { - return nil, errors.New("hz should be > 2000") - } - if len(frames) == 0 { - return nil, errors.New("frames list is empty") + if hz < 2000 || len(frames) == 0 { + return nil, errors.New("invalid params") } - buf := buffer{srcHz: hz} - - totalSize := 0 + var totalSize int for _, f := range frames { - totalSize += frameStereoSamples(hz, f) + totalSize += stereoSamples(hz, f) } - if totalSize == 0 { - return nil, errors.New("calculated buffer size is 0, check params") + return nil, errors.New("zero buffer size") } - buf.raw = make(samples, totalSize) + buf := &buffer{ + raw: make(samples, totalSize), + scratch: make(samples, 5760), + srcHz: hz, + dstHz: hz, + } - // map buckets to the raw continuous array offset := 0 for _, f := range frames { - size := frameStereoSamples(hz, f) - buf.buckets = append(buf.buckets, bucket{ - mem: buf.raw[offset : offset+size], - ms: f, - }) + size := stereoSamples(hz, f) + buf.buckets = append(buf.buckets, bucket{mem: buf.raw[offset : offset+size], ms: f, dst: size}) offset += size } - - // start with the largest bucket (last one, assuming frames are sorted ascending) buf.bi = len(buf.buckets) - 1 - return &buf, nil + return buf, nil } -// cur returns the current bucket pointer -func (b *buffer) cur() *bucket { return &b.buckets[b.bi] } +func (b *buffer) close() { + if b.resampler != nil { + b.resampler.Destroy() + b.resampler = nil + } +} + +func (b *buffer) resample(targetHz int, algo ResampleAlgo) error { + b.algo = algo + b.dstHz = targetHz + + for i := range b.buckets { + b.buckets[i].dst = stereoSamples(targetHz, b.buckets[i].ms) + } + + if algo == ResampleSpeex { + var err error + if b.resampler, err = speexdsp.ResamplerInit(2, b.srcHz, targetHz, speexdsp.QualityDesktop); err != nil { + return err + } + } + return nil +} + +func (b *buffer) write(s samples, onFull func(samples, float32)) int { + read := 0 + for read < len(s) { + cur := &b.buckets[b.bi] + n := copy(cur.mem[cur.p:], s[read:]) + read += n + cur.p += n + + if cur.p == len(cur.mem) { + onFull(b.stretch(cur.mem, cur.dst), cur.ms) + b.choose(len(s) - read) + b.buckets[b.bi].p = 0 + } + } + return read +} -// choose selects the best bucket for the remaining samples. -// It picks the largest bucket that can be completely filled. -// Buckets should be sorted by size ascending for this to work optimally. func (b *buffer) choose(remaining int) { - // search from largest to smallest for i := len(b.buckets) - 1; i >= 0; i-- { if remaining >= len(b.buckets[i].mem) { b.bi = i return } } - // fall back to smallest bucket if remaining < all bucket sizes b.bi = 0 } -// resample enables resampling to target Hz with specified algorithm -func (b *buffer) resample(targetHz int, algo ResampleAlgo) { - b.useResample = true - b.algo = algo - for i := range b.buckets { - b.buckets[i].dst = frameStereoSamples(targetHz, b.buckets[i].ms) - } -} - -// stretch applies the selected resampling algorithm func (b *buffer) stretch(src samples, dstSize int) samples { switch b.algo { - case ResampleNearest: - return stretchNearest(src, dstSize) - case ResampleLinear: - return stretchLinear(src, dstSize) - default: - return stretchLinear(src, dstSize) - } -} - -// write fills the buffer and calls onFull when a complete frame is ready. -// returns the number of samples consumed. -func (b *buffer) write(s samples, onFull func(samples, float32)) int { - read := 0 - for read < len(s) { - cur := b.cur() - - // copy all samples into current bucket - n := copy(cur.mem[cur.p:], s[read:]) - read += n - cur.p += n - - // bucket is full - emit frame - if cur.p == len(cur.mem) { - if b.useResample { - onFull(b.stretch(cur.mem, cur.dst), cur.ms) - } else { - onFull(cur.mem, cur.ms) + case ResampleSpeex: + if b.resampler != nil { + if _, out, err := b.resampler.PocessIntInterleaved(src); err == nil { + if len(out) == dstSize { + return out + } + src = out // use speex output for linear correction } - - // select next bucket and reset write position - b.choose(len(s) - read) - b.cur().p = 0 } + fallthrough + case ResampleLinear: + return b.linear(src, dstSize) + case ResampleNearest: + return b.nearest(src, dstSize) + default: + return b.linear(src, dstSize) } - return read } -// frameStereoSamples calculates stereo frame size in samples. -// e.g., 48000 Hz * 20ms = 960 samples/channel * 2 channels = 1920 total samples -func frameStereoSamples(hz int, ms float32) int { - samplesPerChannel := int(float32(hz)*ms/1000 + 0.5) // round to nearest - return samplesPerChannel * 2 // stereo -} - -// stretchLinear resamples stereo audio using linear interpolation. -func stretchLinear(src samples, dstSize int) samples { +func (b *buffer) linear(src samples, dstSize int) samples { srcLen := len(src) if srcLen < 2 || dstSize < 2 { - return stretchBuf[:dstSize] + return b.scratch[:dstSize] } - out := stretchBuf[:dstSize] - - srcPairs := srcLen / 2 - dstPairs := dstSize / 2 - - // Fixed-point ratio for precision (16.16 fixed point) + out := b.scratch[:dstSize] + srcPairs, dstPairs := srcLen/2, dstSize/2 ratio := ((srcPairs - 1) << 16) / (dstPairs - 1) for i := 0; i < dstPairs; i++ { - // Calculate source position in fixed-point pos := i * ratio - srcIdx := pos >> 16 - frac := pos & 0xFFFF + idx, frac := (pos>>16)*2, pos&0xFFFF + di := i * 2 - dstIdx := i * 2 - - if srcIdx >= srcPairs-1 { - // Last sample - no interpolation - out[dstIdx] = src[srcLen-2] - out[dstIdx+1] = src[srcLen-1] + if idx >= srcLen-2 { + out[di], out[di+1] = src[srcLen-2], src[srcLen-1] } else { - // Linear interpolation for both channels - srcBase := srcIdx * 2 - - // Left channel - l0 := int32(src[srcBase]) - l1 := int32(src[srcBase+2]) - out[dstIdx] = int16(l0 + ((l1-l0)*int32(frac))>>16) - - // Right channel - r0 := int32(src[srcBase+1]) - r1 := int32(src[srcBase+3]) - out[dstIdx+1] = int16(r0 + ((r1-r0)*int32(frac))>>16) + out[di] = int16(int32(src[idx]) + ((int32(src[idx+2])-int32(src[idx]))*int32(frac))>>16) + out[di+1] = int16(int32(src[idx+1]) + ((int32(src[idx+3])-int32(src[idx+1]))*int32(frac))>>16) } } - return out } -// stretchNearest is a faster nearest-neighbor version if quality isn't critical -func stretchNearest(src samples, dstSize int) samples { +func (b *buffer) nearest(src samples, dstSize int) samples { srcLen := len(src) if srcLen < 2 || dstSize < 2 { - return stretchBuf[:dstSize] + return b.scratch[:dstSize] } - out := stretchBuf[:dstSize] - - srcPairs := srcLen / 2 - dstPairs := dstSize / 2 + out := b.scratch[:dstSize] + srcPairs, dstPairs := srcLen/2, dstSize/2 for i := 0; i < dstPairs; i++ { - srcIdx := (i * srcPairs / dstPairs) * 2 - dstIdx := i * 2 - out[dstIdx] = src[srcIdx] - out[dstIdx+1] = src[srcIdx+1] + si := (i * srcPairs / dstPairs) * 2 + di := i * 2 + out[di], out[di+1] = src[si], src[si+1] } - return out } + +func stereoSamples(hz int, ms float32) int { + return int(float32(hz)*ms/1000+0.5) * 2 +} From e2f3e005ef8c1f541e9d5f9574be4e40ed9d6b0e Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 16:31:13 +0300 Subject: [PATCH 343/361] Fix speex build libs --- .github/workflows/build.yml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 66b0b414..40fed385 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -36,7 +36,7 @@ jobs: sudo apt-get -qq install -y \ make pkg-config \ libvpx-dev libx264-dev libopus-dev libyuv-dev libjpeg-turbo8-dev \ - libsdl2-dev libgl1 libglx-mesa0 + libsdl2-dev libgl1 libglx-mesa0 libspeexdsp-dev make build xvfb-run --auto-servernum make test verify-cores @@ -44,7 +44,7 @@ jobs: - name: macOS if: matrix.os == 'macos-12' run: | - brew install libvpx x264 sdl2 + brew install libvpx x264 sdl2 speexdsp make build test verify-cores - uses: msys2/setup-msys2@v2 @@ -63,6 +63,7 @@ jobs: mingw-w64-ucrt-x86_64-SDL2 mingw-w64-ucrt-x86_64-libyuv mingw-w64-ucrt-x86_64-libjpeg-turbo + mingw-w64-ucrt-x86_64-speexdsp - name: Windows if: matrix.os == 'windows-latest' From 9feb7881082cbb5e08471b33099ff22b9d1e6df8 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 17:01:04 +0300 Subject: [PATCH 344/361] Make speexdsp statically linked --- go.mod | 1 - go.sum | 30 --------- pkg/worker/media/buffer.go | 10 +-- pkg/worker/media/speex.go | 97 ++++++++++++++++++++++++++++++ pkg/worker/media/speex_resampler.h | 59 ++++++++++++++++++ 5 files changed, 159 insertions(+), 38 deletions(-) create mode 100644 pkg/worker/media/speex.go create mode 100644 pkg/worker/media/speex_resampler.h diff --git a/go.mod b/go.mod index 67bdd591..7763a58c 100644 --- a/go.mod +++ b/go.mod @@ -4,7 +4,6 @@ go 1.25 require ( github.com/VictoriaMetrics/metrics v1.40.2 - github.com/aam335/speexdsp v0.0.0-20190116080032-198c2d2ba225 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.9.0 github.com/goccy/go-json v0.10.5 diff --git a/go.sum b/go.sum index a8bf22f5..b5ab82f5 100644 --- a/go.sum +++ b/go.sum @@ -1,7 +1,5 @@ github.com/VictoriaMetrics/metrics v1.40.2 h1:OVSjKcQEx6JAwGeu8/KQm9Su5qJ72TMEW4xYn5vw3Ac= github.com/VictoriaMetrics/metrics v1.40.2/go.mod h1:XE4uudAAIRaJE614Tl5HMrtoEU6+GDZO4QTnNSsZRuA= -github.com/aam335/speexdsp v0.0.0-20190116080032-198c2d2ba225 h1:qZ9Sv2nmB9oFAZLdhsvjpBW4NyKexrSnCzjQJPfcaTU= -github.com/aam335/speexdsp v0.0.0-20190116080032-198c2d2ba225/go.mod h1:gui3wdg1cup88TpLbUDkl88CPrD+b9ICs886eDh2hOQ= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -24,8 +22,6 @@ github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg= github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= -github.com/klauspost/compress v1.18.1 h1:bcSGx7UbpBqMChDtsF28Lw6v/G94LPrrbMbdC3JH2co= -github.com/klauspost/compress v1.18.1/go.mod h1:ZQFFVG+MdnR0P+l6wpXgIL4NTtwiKIdBnrBd8Nrxr+0= github.com/klauspost/compress v1.18.2 h1:iiPHWW0YrcFgpBYhsA6D1+fqHssJscY/Tm/y2Uqnapk= github.com/klauspost/compress v1.18.2/go.mod h1:R0h/fSBs8DE4ENlcrlib3PsXS61voFxhIs2DeRhCvJ4= github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= @@ -62,12 +58,8 @@ github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM= github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM= github.com/pion/datachannel v1.5.10 h1:ly0Q26K1i6ZkGf42W7D4hQYR90pZwzFOjTq5AuCKk4o= github.com/pion/datachannel v1.5.10/go.mod h1:p/jJfC9arb29W7WrxyKbepTU20CFgyx5oLo8Rs4Py/M= -github.com/pion/dtls/v3 v3.0.7 h1:bItXtTYYhZwkPFk4t1n3Kkf5TDrfj6+4wG+CZR8uI9Q= -github.com/pion/dtls/v3 v3.0.7/go.mod h1:uDlH5VPrgOQIw59irKYkMudSFprY9IEFCqz/eTz16f8= github.com/pion/dtls/v3 v3.0.9 h1:4AijfFRm8mAjd1gfdlB1wzJF3fjjR/VPIpJgkEtvYmM= github.com/pion/dtls/v3 v3.0.9/go.mod h1:abApPjgadS/ra1wvUzHLc3o2HvoxppAh+NZkyApL4Os= -github.com/pion/ice/v4 v4.0.10 h1:P59w1iauC/wPk9PdY8Vjl4fOFL5B+USq1+xbDcN6gT4= -github.com/pion/ice/v4 v4.0.10/go.mod h1:y3M18aPhIxLlcO/4dn9X8LzLLSma84cx6emMSu14FGw= github.com/pion/ice/v4 v4.1.0 h1:YlxIii2bTPWyC08/4hdmtYq4srbrY0T9xcTsTjldGqU= github.com/pion/ice/v4 v4.1.0/go.mod h1:5gPbzYxqenvn05k7zKPIZFuSAufolygiy6P1U9HzvZ4= github.com/pion/interceptor v0.1.42 h1:0/4tvNtruXflBxLfApMVoMubUMik57VZ+94U0J7cmkQ= @@ -80,30 +72,20 @@ github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.16 h1:fk1B1dNW4hsI78XUCljZJlC4kZOPk67mNRuQ0fcEkSo= github.com/pion/rtcp v1.2.16/go.mod h1:/as7VKfYbs5NIb4h6muQ35kQF/J0ZVNz2Z3xKoCBYOo= -github.com/pion/rtp v1.8.25 h1:b8+y44GNbwOJTYWuVan7SglX/hMlicVCAtL50ztyZHw= -github.com/pion/rtp v1.8.25/go.mod h1:rF5nS1GqbR7H/TCpKwylzeq6yDM+MM6k+On5EgeThEM= github.com/pion/rtp v1.8.26 h1:VB+ESQFQhBXFytD+Gk8cxB6dXeVf2WQzg4aORvAvAAc= github.com/pion/rtp v1.8.26/go.mod h1:rF5nS1GqbR7H/TCpKwylzeq6yDM+MM6k+On5EgeThEM= -github.com/pion/sctp v1.8.40 h1:bqbgWYOrUhsYItEnRObUYZuzvOMsVplS3oNgzedBlG8= -github.com/pion/sctp v1.8.40/go.mod h1:SPBBUENXE6ThkEksN5ZavfAhFYll+h+66ZiG6IZQuzo= github.com/pion/sctp v1.8.41 h1:20R4OHAno4Vky3/iE4xccInAScAa83X6nWUfyc65MIs= github.com/pion/sctp v1.8.41/go.mod h1:2wO6HBycUH7iCssuGyc2e9+0giXVW0pyCv3ZuL8LiyY= github.com/pion/sdp/v3 v3.0.16 h1:0dKzYO6gTAvuLaAKQkC02eCPjMIi4NuAr/ibAwrGDCo= github.com/pion/sdp/v3 v3.0.16/go.mod h1:9tyKzznud3qiweZcD86kS0ff1pGYB3VX+Bcsmkx6IXo= -github.com/pion/srtp/v3 v3.0.8 h1:RjRrjcIeQsilPzxvdaElN0CpuQZdMvcl9VZ5UY9suUM= -github.com/pion/srtp/v3 v3.0.8/go.mod h1:2Sq6YnDH7/UDCvkSoHSDNDeyBcFgWL0sAVycVbAsXFg= github.com/pion/srtp/v3 v3.0.9 h1:lRGF4G61xxj+m/YluB3ZnBpiALSri2lTzba0kGZMrQY= github.com/pion/srtp/v3 v3.0.9/go.mod h1:E+AuWd7Ug2Fp5u38MKnhduvpVkveXJX6J4Lq4rxUYt8= -github.com/pion/stun/v3 v3.0.1 h1:jx1uUq6BdPihF0yF33Jj2mh+C9p0atY94IkdnW174kA= -github.com/pion/stun/v3 v3.0.1/go.mod h1:RHnvlKFg+qHgoKIqtQWMOJF52wsImCAf/Jh5GjX+4Tw= github.com/pion/stun/v3 v3.0.2 h1:BJuGEN2oLrJisiNEJtUTJC4BGbzbfp37LizfqswblFU= github.com/pion/stun/v3 v3.0.2/go.mod h1:JFJKfIWvt178MCF5H/YIgZ4VX3LYE77vca4b9HP60SA= github.com/pion/transport/v3 v3.1.1 h1:Tr684+fnnKlhPceU+ICdrw6KKkTms+5qHMgw6bIkYOM= github.com/pion/transport/v3 v3.1.1/go.mod h1:+c2eewC5WJQHiAA46fkMMzoYZSuGzA/7E2FPrOYHctQ= github.com/pion/turn/v4 v4.1.3 h1:jVNW0iR05AS94ysEtvzsrk3gKs9Zqxf6HmnsLfRvlzA= github.com/pion/turn/v4 v4.1.3/go.mod h1:TD/eiBUf5f5LwXbCJa35T7dPtTpCHRJ9oJWmyPLVT3A= -github.com/pion/webrtc/v4 v4.1.6 h1:srHH2HwvCGwPba25EYJgUzgLqCQoXl1VCUnrGQMSzUw= -github.com/pion/webrtc/v4 v4.1.6/go.mod h1:wKecGRlkl3ox/As/MYghJL+b/cVXMEhoPMJWPuGQFhU= github.com/pion/webrtc/v4 v4.1.8 h1:ynkjfiURDQ1+8EcJsoa60yumHAmyeYjz08AaOuor+sk= github.com/pion/webrtc/v4 v4.1.8/go.mod h1:KVaARG2RN0lZx0jc7AWTe38JpPv+1/KicOZ9jN52J/s= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= @@ -117,8 +99,6 @@ github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY= github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ= github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U= github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U= -github.com/tinylib/msgp v1.5.0 h1:GWnqAE54wmnlFazjq2+vgr736Akg58iiHImh+kPY2pc= -github.com/tinylib/msgp v1.5.0/go.mod h1:cvjFkb4RiC8qSBOPMGPSzSAx47nAsfhLVTCZZNuHv5o= github.com/tinylib/msgp v1.6.1 h1:ESRv8eL3u+DNHUoSAAQRE50Hm162zqAnBoGv9PzScPY= github.com/tinylib/msgp v1.6.1/go.mod h1:RSp0LW9oSxFut3KzESt5Voq4GVWyS+PSulT77roAqEA= github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G8= @@ -129,27 +109,17 @@ github.com/veandco/go-sdl2 v0.4.40 h1:fZv6wC3zz1Xt167P09gazawnpa0KY5LM7JAvKpX9d/ github.com/veandco/go-sdl2 v0.4.40/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/wlynxg/anet v0.0.5 h1:J3VJGi1gvo0JwZ/P1/Yc/8p63SoW98B5dHkYDmpgvvU= github.com/wlynxg/anet v0.0.5/go.mod h1:eay5PRQr7fIVAMbTbchTnO9gG65Hg/uYGdc7mguHxoA= -golang.org/x/crypto v0.45.0 h1:jMBrvKuj23MTlT0bQEOBcAE0mjg8mK9RXFhRH6nyF3Q= -golang.org/x/crypto v0.45.0/go.mod h1:XTGrrkGJve7CYK7J8PEww4aY7gM3qMCElcJQ8n8JdX4= golang.org/x/crypto v0.46.0 h1:cKRW/pmt1pKAfetfu+RCEvjvZkA9RimPbh7bhFjGVBU= golang.org/x/crypto v0.46.0/go.mod h1:Evb/oLKmMraqjZ2iQTwDwvCtJkczlDuTmdJXoZVzqU0= -golang.org/x/image v0.30.0 h1:jD5RhkmVAnjqaCUXfbGBrn3lpxbknfN9w2UhHHU+5B4= -golang.org/x/image v0.30.0/go.mod h1:SAEUTxCCMWSrJcCy/4HwavEsfZZJlYxeHLc6tTiAe/c= golang.org/x/image v0.34.0 h1:33gCkyw9hmwbZJeZkct8XyR11yH889EQt/QH4VmXMn8= golang.org/x/image v0.34.0/go.mod h1:2RNFBZRB+vnwwFil8GkMdRvrJOFd1AzdZI6vOY+eJVU= -golang.org/x/net v0.47.0 h1:Mx+4dIFzqraBXUugkia1OOvlD6LemFo1ALMHjrXDOhY= -golang.org/x/net v0.47.0/go.mod h1:/jNxtkgq5yWUGYkaZGqo27cfGZ1c5Nen03aYrrKpVRU= golang.org/x/net v0.48.0 h1:zyQRTTrjc33Lhh0fBgT/H3oZq9WuvRR5gPC70xpDiQU= golang.org/x/net v0.48.0/go.mod h1:+ndRgGjkh8FGtu1w1FGbEC31if4VrNVMuKTgcAAnQRY= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.38.0 h1:3yZWxaJjBmCWXqhN1qh02AkOnCQ1poK6oF+a7xWL6Gc= -golang.org/x/sys v0.38.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks= golang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk= golang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks= -golang.org/x/text v0.31.0 h1:aC8ghyu4JhP8VojJ2lEHBnochRno1sgL6nEi9WGFGMM= -golang.org/x/text v0.31.0/go.mod h1:tKRAlv61yKIjGGHX/4tP1LTbc13YSec1pxVEWXzfoeM= golang.org/x/text v0.32.0 h1:ZD01bjUt1FQ9WJ0ClOL5vxgxOI/sVCNgX1YtKwcY0mU= golang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY= gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= diff --git a/pkg/worker/media/buffer.go b/pkg/worker/media/buffer.go index 223c0e43..7d528452 100644 --- a/pkg/worker/media/buffer.go +++ b/pkg/worker/media/buffer.go @@ -1,10 +1,6 @@ package media -import ( - "errors" - - "github.com/aam335/speexdsp" -) +import "errors" type ResampleAlgo uint8 @@ -18,7 +14,7 @@ type buffer struct { raw samples scratch samples buckets []bucket - resampler *speexdsp.Resampler + resampler *Resampler srcHz int dstHz int bi int @@ -80,7 +76,7 @@ func (b *buffer) resample(targetHz int, algo ResampleAlgo) error { if algo == ResampleSpeex { var err error - if b.resampler, err = speexdsp.ResamplerInit(2, b.srcHz, targetHz, speexdsp.QualityDesktop); err != nil { + if b.resampler, err = ResamplerInit(2, b.srcHz, targetHz, QualityDesktop); err != nil { return err } } diff --git a/pkg/worker/media/speex.go b/pkg/worker/media/speex.go new file mode 100644 index 00000000..3b4b18cd --- /dev/null +++ b/pkg/worker/media/speex.go @@ -0,0 +1,97 @@ +package media + +/* + #cgo pkg-config: speexdsp + #cgo st LDFLAGS: -l:libspeexdsp.a + + #include + #include "speex_resampler.h" +*/ +import "C" + +import "errors" + +type Resampler struct { + resampler *C.SpeexResamplerState + outBuff []int16 // one of these buffers used when typed data read + outBuffFloat []float32 + channels int + multiplier float32 +} + +// Quality +const ( + QualityMax = 10 + QualityMin = 0 + QualityDefault = 4 + QualityDesktop = 5 + QualityVoid = 3 +) + +// Errors +const ( + ErrorSuccess = iota + ErrorAllocFailed + ErrorBadState + ErrorInvalidArg + ErrorPtrOverlap + ErrorMaxError +) + +const ( + reserve = 1.1 +) + +// ResamplerInit Create a new resampler with integer input and output rates +// Resampling quality between 0 and 10, where 0 has poor quality +// and 10 has very high quality +func ResamplerInit(channels, inRate, outRate, quality int) (*Resampler, error) { + err := C.int(0) + r := &Resampler{channels: channels} + r.multiplier = float32(outRate) / float32(inRate) * 1.1 + r.resampler = C.speex_resampler_init(C.spx_uint32_t(channels), + C.spx_uint32_t(inRate), C.spx_uint32_t(outRate), C.int(quality), &err) + if r.resampler == nil { + return nil, StrError(int(err)) + } + return r, nil +} + +// Destroy a resampler +func (r *Resampler) Destroy() error { + if r.resampler != nil { + C.speex_resampler_destroy((*C.SpeexResamplerState)(r.resampler)) + return nil + } + return StrError(ErrorInvalidArg) +} + +// PocessIntInterleaved Resample an int slice interleaved +func (r *Resampler) PocessIntInterleaved(in []int16) (int, []int16, error) { + outBuffCap := int(float32(len(in)) * r.multiplier) + if outBuffCap > cap(r.outBuff) { + r.outBuff = make([]int16, int(float32(outBuffCap)*reserve)*4) + } + inLen := C.spx_uint32_t(len(in) / r.channels) + outLen := C.spx_uint32_t(len(r.outBuff) / r.channels) + res := C.speex_resampler_process_interleaved_int( + r.resampler, + (*C.spx_int16_t)(&in[0]), + &inLen, + (*C.spx_int16_t)(&r.outBuff[0]), + &outLen, + ) + if res != ErrorSuccess { + return 0, nil, StrError(ErrorInvalidArg) + } + return int(inLen) * r.channels, r.outBuff[:outLen*2], nil +} + +// StrError returns error message +func StrError(errorCode int) error { + cS := C.speex_resampler_strerror(C.int(errorCode)) + if cS == nil { + return nil + } + return errors.New(C.GoString(cS)) +} diff --git a/pkg/worker/media/speex_resampler.h b/pkg/worker/media/speex_resampler.h new file mode 100644 index 00000000..27d510f5 --- /dev/null +++ b/pkg/worker/media/speex_resampler.h @@ -0,0 +1,59 @@ +#ifndef SPEEX_RESAMPLER_H +#define SPEEX_RESAMPLER_H + +#define spx_int16_t short +#define spx_int32_t int +#define spx_uint16_t unsigned short +#define spx_uint32_t unsigned int + +#define SPEEX_RESAMPLER_QUALITY_MAX 10 +#define SPEEX_RESAMPLER_QUALITY_MIN 0 +#define SPEEX_RESAMPLER_QUALITY_DEFAULT 4 +#define SPEEX_RESAMPLER_QUALITY_VOIP 3 +#define SPEEX_RESAMPLER_QUALITY_DESKTOP 5 +enum { + RESAMPLER_ERR_SUCCESS = 0, + RESAMPLER_ERR_ALLOC_FAILED = 1, + RESAMPLER_ERR_BAD_STATE = 2, + RESAMPLER_ERR_INVALID_ARG = 3, + RESAMPLER_ERR_PTR_OVERLAP = 4, + + RESAMPLER_ERR_MAX_ERROR +}; +struct SpeexResamplerState_; +typedef struct SpeexResamplerState_ SpeexResamplerState; +/** Create a new resampler with integer input and output rates. + * @param nb_channels Number of channels to be processed + * @param in_rate Input sampling rate (integer number of Hz). + * @param out_rate Output sampling rate (integer number of Hz). + * @param quality Resampling quality between 0 and 10, where 0 has poor quality + * and 10 has very high quality. + * @return Newly created resampler state + * @retval NULL Error: not enough memory + */ +SpeexResamplerState *speex_resampler_init(spx_uint32_t nb_channels, + spx_uint32_t in_rate, + spx_uint32_t out_rate, + int quality, + int *err); +/** Destroy a resampler state. + * @param st Resampler state + */ +void speex_resampler_destroy(SpeexResamplerState *st); + +/** Resample an interleaved int array. The input and output buffers must *not* overlap. + * @param st Resampler state + * @param in Input buffer + * @param in_len Number of input samples in the input buffer. Returns the number + * of samples processed. This is all per-channel. + * @param out Output buffer + * @param out_len Size of the output buffer. Returns the number of samples written. + * This is all per-channel. + */ +int speex_resampler_process_interleaved_int(SpeexResamplerState *st, + const spx_int16_t *in, + spx_uint32_t *in_len, + spx_int16_t *out, + spx_uint32_t *out_len); +const char *speex_resampler_strerror(int err); +#endif \ No newline at end of file From 46a57990797077aa30b16915c4303513cbc74e46 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 18:54:06 +0300 Subject: [PATCH 345/361] Fix media tests --- pkg/worker/media/media_test.go | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index f754e17e..10152bf5 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -125,8 +125,9 @@ func TestResampleStretch(t *testing.T) { {name: "", args: args{pcm: gen(1764), size: 1920}, want: nil}, } for _, tt := range tests { + buf, _ := newBuffer([]float32{20}, 2000) t.Run(tt.name, func(t *testing.T) { - rez2 := stretchNearest(tt.args.pcm, tt.args.size) + rez2 := buf.nearest(tt.args.pcm, tt.args.size) if rez2[0] != tt.args.pcm[0] || rez2[1] != tt.args.pcm[1] || rez2[len(rez2)-1] != tt.args.pcm[len(tt.args.pcm)-1] || rez2[len(rez2)-2] != tt.args.pcm[len(tt.args.pcm)-2] { @@ -140,8 +141,9 @@ func TestResampleStretch(t *testing.T) { func BenchmarkResampler(b *testing.B) { pcm := samples(gen(1764)) size := 1920 + buf, _ := newBuffer([]float32{20}, 1000) for i := 0; i < b.N; i++ { - stretchLinear(pcm, size) + buf.linear(pcm, size) } } @@ -170,7 +172,7 @@ func TestFrame(t *testing.T) { } for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { - if got := frameStereoSamples(tt.args.hz, tt.args.frame); got != tt.want { + if got := stereoSamples(tt.args.hz, tt.args.frame); got != tt.want { t.Errorf("frame() = %v, want %v", got, tt.want) } }) From 7c8e74716d17c0ba760ee2c2618b6c38696a789d Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 22:14:55 +0300 Subject: [PATCH 346/361] Disable mGBA low-pass filter --- pkg/config/config.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 9b142aff..c6332696 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -260,8 +260,8 @@ emulator: lib: mgba_libretro roms: [ "gba", "gbc" ] options: - mgba_audio_low_pass_filter: enabled - mgba_audio_low_pass_range: 40 + mgba_audio_low_pass_filter: disabled + mgba_audio_low_pass_range: 50 pcsx: lib: pcsx_rearmed_libretro roms: [ "cue", "chd" ] From 1e4e5b3c65d015dc5d3ebbf640dcbd6db5fe7201 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 22:15:28 +0300 Subject: [PATCH 347/361] Clean media buffer --- pkg/worker/media/buffer.go | 176 +++++++++++++---------------- pkg/worker/media/buffer_test.go | 112 ++++++++++++------ pkg/worker/media/media_test.go | 6 +- pkg/worker/media/speex.go | 90 +++++++-------- pkg/worker/media/speex_resampler.h | 31 +++++ 5 files changed, 224 insertions(+), 191 deletions(-) diff --git a/pkg/worker/media/buffer.go b/pkg/worker/media/buffer.go index 7d528452..2228085f 100644 --- a/pkg/worker/media/buffer.go +++ b/pkg/worker/media/buffer.go @@ -1,6 +1,9 @@ package media -import "errors" +import ( + "errors" + "slices" +) type ResampleAlgo uint8 @@ -11,163 +14,138 @@ const ( ) type buffer struct { - raw samples - scratch samples - buckets []bucket + in, out samples + frames []float32 resampler *Resampler srcHz int dstHz int - bi int + fi int + p int algo ResampleAlgo } -type bucket struct { - mem samples - ms float32 - p int - dst int -} - func newBuffer(frames []float32, hz int) (*buffer, error) { if hz < 2000 || len(frames) == 0 { return nil, errors.New("invalid params") } - var totalSize int - for _, f := range frames { - totalSize += stereoSamples(hz, f) - } - if totalSize == 0 { - return nil, errors.New("zero buffer size") - } + // frames should be sorted ascending, largest last + frames = slices.Clone(frames) + slices.Sort(frames) - buf := &buffer{ - raw: make(samples, totalSize), - scratch: make(samples, 5760), - srcHz: hz, - dstHz: hz, - } + maxSize := stereoSamples(hz, frames[len(frames)-1]) - offset := 0 - for _, f := range frames { - size := stereoSamples(hz, f) - buf.buckets = append(buf.buckets, bucket{mem: buf.raw[offset : offset+size], ms: f, dst: size}) - offset += size - } - buf.bi = len(buf.buckets) - 1 - - return buf, nil + return &buffer{ + in: make(samples, maxSize), + out: make(samples, maxSize), + frames: frames, + srcHz: hz, + dstHz: hz, + fi: len(frames) - 1, // start with largest + }, nil } func (b *buffer) close() { if b.resampler != nil { b.resampler.Destroy() - b.resampler = nil } } func (b *buffer) resample(targetHz int, algo ResampleAlgo) error { - b.algo = algo - b.dstHz = targetHz - - for i := range b.buckets { - b.buckets[i].dst = stereoSamples(targetHz, b.buckets[i].ms) - } + b.algo, b.dstHz = algo, targetHz + b.out = make(samples, stereoSamples(targetHz, b.frames[len(b.frames)-1])) if algo == ResampleSpeex { var err error - if b.resampler, err = ResamplerInit(2, b.srcHz, targetHz, QualityDesktop); err != nil { - return err - } + b.resampler, err = NewResampler(2, b.srcHz, targetHz, QualityMax) + return err } return nil } -func (b *buffer) write(s samples, onFull func(samples, float32)) int { - read := 0 - for read < len(s) { - cur := &b.buckets[b.bi] - n := copy(cur.mem[cur.p:], s[read:]) - read += n - cur.p += n +func (b *buffer) write(s samples, onFull func(samples, float32)) { + for len(s) > 0 { + srcSize := stereoSamples(b.srcHz, b.frames[b.fi]) - if cur.p == len(cur.mem) { - onFull(b.stretch(cur.mem, cur.dst), cur.ms) - b.choose(len(s) - read) - b.buckets[b.bi].p = 0 + n := copy(b.in[b.p:srcSize], s) + if n == 0 { + // oof + break + } + + s = s[n:] + b.p += n + + if b.p >= srcSize { + onFull(b.stretch(srcSize), b.frames[b.fi]) + b.p = 0 + b.choose(len(s)) } } - return read + // Remaining samples stay in buffer, will be completed on next write } func (b *buffer) choose(remaining int) { - for i := len(b.buckets) - 1; i >= 0; i-- { - if remaining >= len(b.buckets[i].mem) { - b.bi = i + // Find the largest bucket that fits in remaining samples + for i := len(b.frames) - 1; i >= 0; i-- { + if remaining >= stereoSamples(b.srcHz, b.frames[i]) { + b.fi = i return } } - b.bi = 0 + // Nothing fits - use smallest and wait for more data + b.fi = 0 } -func (b *buffer) stretch(src samples, dstSize int) samples { +func (b *buffer) stretch(srcSize int) samples { + dstSize := stereoSamples(b.dstHz, b.frames[b.fi]) + src, out := b.in[:srcSize], b.out[:dstSize] + + if srcSize == dstSize { + return src + } + switch b.algo { case ResampleSpeex: - if b.resampler != nil { - if _, out, err := b.resampler.PocessIntInterleaved(src); err == nil { - if len(out) == dstSize { - return out - } - src = out // use speex output for linear correction - } + if n, _ := b.resampler.Process(src, out); n == dstSize { + return out } fallthrough case ResampleLinear: - return b.linear(src, dstSize) + return linear(src, out) case ResampleNearest: - return b.nearest(src, dstSize) - default: - return b.linear(src, dstSize) + return nearest(src, out) } + return src } -func (b *buffer) linear(src samples, dstSize int) samples { - srcLen := len(src) - if srcLen < 2 || dstSize < 2 { - return b.scratch[:dstSize] +func linear(src, out samples) samples { + sn, dn := len(src)/2, len(out)/2 + if sn < 2 || dn < 2 { + return out } - - out := b.scratch[:dstSize] - srcPairs, dstPairs := srcLen/2, dstSize/2 - ratio := ((srcPairs - 1) << 16) / (dstPairs - 1) - - for i := 0; i < dstPairs; i++ { + ratio := ((sn - 1) << 16) / (dn - 1) + for i := 0; i < dn; i++ { pos := i * ratio - idx, frac := (pos>>16)*2, pos&0xFFFF + si, frac := (pos>>16)*2, pos&0xFFFF di := i * 2 - - if idx >= srcLen-2 { - out[di], out[di+1] = src[srcLen-2], src[srcLen-1] + if si >= len(src)-2 { + out[di], out[di+1] = src[len(src)-2], src[len(src)-1] } else { - out[di] = int16(int32(src[idx]) + ((int32(src[idx+2])-int32(src[idx]))*int32(frac))>>16) - out[di+1] = int16(int32(src[idx+1]) + ((int32(src[idx+3])-int32(src[idx+1]))*int32(frac))>>16) + out[di] = int16(int32(src[si]) + ((int32(src[si+2])-int32(src[si]))*int32(frac))>>16) + out[di+1] = int16(int32(src[si+1]) + ((int32(src[si+3])-int32(src[si+1]))*int32(frac))>>16) } } return out } -func (b *buffer) nearest(src samples, dstSize int) samples { - srcLen := len(src) - if srcLen < 2 || dstSize < 2 { - return b.scratch[:dstSize] +func nearest(src, out samples) samples { + sn, dn := len(src)/2, len(out)/2 + if sn < 2 || dn < 2 { + return out } - - out := b.scratch[:dstSize] - srcPairs, dstPairs := srcLen/2, dstSize/2 - - for i := 0; i < dstPairs; i++ { - si := (i * srcPairs / dstPairs) * 2 - di := i * 2 + for i := 0; i < dn; i++ { + si, di := (i*sn/dn)*2, i*2 out[di], out[di+1] = src[si], src[si+1] } return out diff --git a/pkg/worker/media/buffer_test.go b/pkg/worker/media/buffer_test.go index 28a596ba..096b4ef9 100644 --- a/pkg/worker/media/buffer_test.go +++ b/pkg/worker/media/buffer_test.go @@ -11,71 +11,109 @@ type bufWrite struct { } func TestBufferWrite(t *testing.T) { + // At 2000Hz stereo: + // 5ms = 2000 * 0.005 * 2 = 20 samples + // 10ms = 2000 * 0.01 * 2 = 40 samples + tests := []struct { + frames []float32 bufLen int writes []bufWrite expect samples }{ { + frames: []float32{5, 10}, + bufLen: 2000, + writes: []bufWrite{ + {sample: 1, len: 20}, + {sample: 2, len: 40}, + {sample: 3, len: 60}, + }, + expect: samples(rep(1, 20).add(2, 40).add(3, 40).add(3, 20)), + }, + { + frames: []float32{5, 10}, + bufLen: 2000, + writes: []bufWrite{ + {sample: 1, len: 6}, + {sample: 2, len: 36}, + {sample: 3, len: 4}, + }, + expect: samples(rep(1, 6).add(2, 34)), + }, + { + frames: []float32{5, 10}, + bufLen: 2000, + writes: []bufWrite{ + {sample: 1, len: 40}, + }, + expect: samples(rep(1, 40)), + }, + { + frames: []float32{5, 10}, + bufLen: 2000, + writes: []bufWrite{ + {sample: 1, len: 100}, + }, + expect: samples(rep(1, 40).add(1, 40).add(1, 20)), + }, + { + frames: []float32{5}, bufLen: 2000, writes: []bufWrite{ {sample: 1, len: 10}, - {sample: 2, len: 20}, - {sample: 3, len: 30}, + {sample: 2, len: 15}, }, - expect: samples{ - 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3, 3, 3, - 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, - 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, - }, - }, - { - bufLen: 2000, - writes: []bufWrite{ - {sample: 1, len: 3}, - {sample: 2, len: 18}, - {sample: 3, len: 2}, - }, - expect: samples{1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, + expect: samples(rep(1, 10).add(2, 10)), }, } - for _, test := range tests { - var lastResult samples - buf, err := newBuffer([]float32{10, 5}, test.bufLen) + for i, test := range tests { + var results samples + buf, err := newBuffer(test.frames, test.bufLen) if err != nil { - t.Fatalf("oof, %v", err) + t.Fatalf("test %d: %v", i, err) } for _, w := range test.writes { - buf.write(samplesOf(w.sample, w.len), - func(s samples, ms float32) { lastResult = s }, - ) + buf.write(samplesOf(w.sample, w.len), func(s samples, ms float32) { + tmp := make(samples, len(s)) + copy(tmp, s) + results = append(results, tmp...) + }) } - if !reflect.DeepEqual(test.expect, lastResult) { - t.Errorf("not expted buffer, %v != %v, %v", lastResult, test.expect, len(buf.buckets)) + if !reflect.DeepEqual(test.expect, results) { + t.Errorf("test %d:\ngot %v (len=%d)\nwant %v (len=%d)", i, results, len(results), test.expect, len(test.expect)) } } } func BenchmarkBufferWrite(b *testing.B) { fn := func(_ samples, _ float32) {} - l := 2000 - buf, err := newBuffer([]float32{10}, l) - if err != nil { - b.Fatalf("oof: %v", err) - } - samples1 := samplesOf(1, l/2) - samples2 := samplesOf(2, l*2) + buf, _ := newBuffer([]float32{10}, 2000) + s1 := samplesOf(1, 1000) + s2 := samplesOf(2, 4000) for i := 0; i < b.N; i++ { - buf.write(samples1, fn) - buf.write(samples2, fn) + buf.write(s1, fn) + buf.write(s2, fn) } } -func samplesOf(v int16, len int) (s samples) { - s = make(samples, len) +// helpers + +func samplesOf(v int16, l int) samples { + s := make(samples, l) for i := range s { s[i] = v } - return + return s +} + +type builder samples + +func rep(v int16, n int) builder { + return builder(samplesOf(v, n)) +} + +func (b builder) add(v int16, n int) builder { + return append(b, samplesOf(v, n)...) } diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 10152bf5..64659427 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -125,9 +125,8 @@ func TestResampleStretch(t *testing.T) { {name: "", args: args{pcm: gen(1764), size: 1920}, want: nil}, } for _, tt := range tests { - buf, _ := newBuffer([]float32{20}, 2000) t.Run(tt.name, func(t *testing.T) { - rez2 := buf.nearest(tt.args.pcm, tt.args.size) + rez2 := nearest(tt.args.pcm, make(samples, tt.args.size)) if rez2[0] != tt.args.pcm[0] || rez2[1] != tt.args.pcm[1] || rez2[len(rez2)-1] != tt.args.pcm[len(tt.args.pcm)-1] || rez2[len(rez2)-2] != tt.args.pcm[len(tt.args.pcm)-2] { @@ -141,9 +140,8 @@ func TestResampleStretch(t *testing.T) { func BenchmarkResampler(b *testing.B) { pcm := samples(gen(1764)) size := 1920 - buf, _ := newBuffer([]float32{20}, 1000) for i := 0; i < b.N; i++ { - buf.linear(pcm, size) + linear(pcm, make(samples, size)) } } diff --git a/pkg/worker/media/speex.go b/pkg/worker/media/speex.go index 3b4b18cd..5f9fa591 100644 --- a/pkg/worker/media/speex.go +++ b/pkg/worker/media/speex.go @@ -12,86 +12,74 @@ import "C" import "errors" type Resampler struct { - resampler *C.SpeexResamplerState - outBuff []int16 // one of these buffers used when typed data read - outBuffFloat []float32 - channels int - multiplier float32 + resampler *C.SpeexResamplerState + channels int } -// Quality const ( QualityMax = 10 QualityMin = 0 QualityDefault = 4 QualityDesktop = 5 - QualityVoid = 3 + QualityVoIP = 3 ) -// Errors -const ( - ErrorSuccess = iota - ErrorAllocFailed - ErrorBadState - ErrorInvalidArg - ErrorPtrOverlap - ErrorMaxError -) - -const ( - reserve = 1.1 -) - -// ResamplerInit Create a new resampler with integer input and output rates -// Resampling quality between 0 and 10, where 0 has poor quality -// and 10 has very high quality -func ResamplerInit(channels, inRate, outRate, quality int) (*Resampler, error) { - err := C.int(0) +func NewResampler(channels, inRate, outRate, quality int) (*Resampler, error) { + var err C.int r := &Resampler{channels: channels} - r.multiplier = float32(outRate) / float32(inRate) * 1.1 - r.resampler = C.speex_resampler_init(C.spx_uint32_t(channels), - C.spx_uint32_t(inRate), C.spx_uint32_t(outRate), C.int(quality), &err) + + // Use fractional init for exact ratio + g := gcd(outRate, inRate) + r.resampler = C.speex_resampler_init_frac( + C.spx_uint32_t(channels), + C.spx_uint32_t(outRate/g), + C.spx_uint32_t(inRate/g), + C.spx_uint32_t(inRate), + C.spx_uint32_t(outRate), + C.int(quality), + &err, + ) if r.resampler == nil { - return nil, StrError(int(err)) + return nil, errors.New(C.GoString(C.speex_resampler_strerror(err))) } + + C.speex_resampler_skip_zeros(r.resampler) + return r, nil } -// Destroy a resampler -func (r *Resampler) Destroy() error { +func (r *Resampler) Destroy() { if r.resampler != nil { - C.speex_resampler_destroy((*C.SpeexResamplerState)(r.resampler)) - return nil + C.speex_resampler_destroy(r.resampler) + r.resampler = nil } - return StrError(ErrorInvalidArg) } -// PocessIntInterleaved Resample an int slice interleaved -func (r *Resampler) PocessIntInterleaved(in []int16) (int, []int16, error) { - outBuffCap := int(float32(len(in)) * r.multiplier) - if outBuffCap > cap(r.outBuff) { - r.outBuff = make([]int16, int(float32(outBuffCap)*reserve)*4) +func (r *Resampler) Process(in, out []int16) (int, error) { + if r.resampler == nil || len(in) < r.channels || len(out) < r.channels { + return 0, nil } + inLen := C.spx_uint32_t(len(in) / r.channels) - outLen := C.spx_uint32_t(len(r.outBuff) / r.channels) + outLen := C.spx_uint32_t(len(out) / r.channels) + res := C.speex_resampler_process_interleaved_int( r.resampler, (*C.spx_int16_t)(&in[0]), &inLen, - (*C.spx_int16_t)(&r.outBuff[0]), + (*C.spx_int16_t)(&out[0]), &outLen, ) - if res != ErrorSuccess { - return 0, nil, StrError(ErrorInvalidArg) + if res != 0 { + return 0, errors.New(C.GoString(C.speex_resampler_strerror(res))) } - return int(inLen) * r.channels, r.outBuff[:outLen*2], nil + + return int(outLen) * r.channels, nil } -// StrError returns error message -func StrError(errorCode int) error { - cS := C.speex_resampler_strerror(C.int(errorCode)) - if cS == nil { - return nil +func gcd(a, b int) int { + for b != 0 { + a, b = b, a%b } - return errors.New(C.GoString(cS)) + return a } diff --git a/pkg/worker/media/speex_resampler.h b/pkg/worker/media/speex_resampler.h index 27d510f5..88b03fd6 100644 --- a/pkg/worker/media/speex_resampler.h +++ b/pkg/worker/media/speex_resampler.h @@ -36,11 +36,42 @@ SpeexResamplerState *speex_resampler_init(spx_uint32_t nb_channels, spx_uint32_t out_rate, int quality, int *err); +/** Create a new resampler with fractional input/output rates. The sampling + * rate ratio is an arbitrary rational number with both the numerator and + * denominator being 32-bit integers. + * @param nb_channels Number of channels to be processed + * @param ratio_num Numerator of the sampling rate ratio + * @param ratio_den Denominator of the sampling rate ratio + * @param in_rate Input sampling rate rounded to the nearest integer (in Hz). + * @param out_rate Output sampling rate rounded to the nearest integer (in Hz). + * @param quality Resampling quality between 0 and 10, where 0 has poor quality + * and 10 has very high quality. + * @return Newly created resampler state + * @retval NULL Error: not enough memory + */ +SpeexResamplerState *speex_resampler_init_frac(spx_uint32_t nb_channels, + spx_uint32_t ratio_num, + spx_uint32_t ratio_den, + spx_uint32_t in_rate, + spx_uint32_t out_rate, + int quality, + int *err); /** Destroy a resampler state. * @param st Resampler state */ void speex_resampler_destroy(SpeexResamplerState *st); + +/** Make sure that the first samples to go out of the resamplers don't have + * leading zeros. This is only useful before starting to use a newly created + * resampler. It is recommended to use that when resampling an audio file, as + * it will generate a file with the same length. For real-time processing, + * it is probably easier not to use this call (so that the output duration + * is the same for the first frame). + * @param st Resampler state + */ +int speex_resampler_skip_zeros(SpeexResamplerState *st); + /** Resample an interleaved int array. The input and output buffers must *not* overlap. * @param st Resampler state * @param in Input buffer From 3178086dd75cb511af0e1f06c77d6000f46f9201 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 14 Dec 2025 22:29:27 +0300 Subject: [PATCH 348/361] Revert due to weird 32KHz mGBA issues (fix later) --- pkg/worker/media/buffer.go | 176 ++++++++++++++++------------- pkg/worker/media/buffer_test.go | 112 ++++++------------ pkg/worker/media/media_test.go | 6 +- pkg/worker/media/speex.go | 90 ++++++++------- pkg/worker/media/speex_resampler.h | 31 ----- 5 files changed, 191 insertions(+), 224 deletions(-) diff --git a/pkg/worker/media/buffer.go b/pkg/worker/media/buffer.go index 2228085f..57adeb90 100644 --- a/pkg/worker/media/buffer.go +++ b/pkg/worker/media/buffer.go @@ -1,9 +1,6 @@ package media -import ( - "errors" - "slices" -) +import "errors" type ResampleAlgo uint8 @@ -14,138 +11,163 @@ const ( ) type buffer struct { - in, out samples - frames []float32 + raw samples + scratch samples + buckets []bucket resampler *Resampler srcHz int dstHz int - fi int - p int + bi int algo ResampleAlgo } +type bucket struct { + mem samples + ms float32 + p int + dst int +} + func newBuffer(frames []float32, hz int) (*buffer, error) { if hz < 2000 || len(frames) == 0 { return nil, errors.New("invalid params") } - // frames should be sorted ascending, largest last - frames = slices.Clone(frames) - slices.Sort(frames) + var totalSize int + for _, f := range frames { + totalSize += stereoSamples(hz, f) + } + if totalSize == 0 { + return nil, errors.New("zero buffer size") + } - maxSize := stereoSamples(hz, frames[len(frames)-1]) + buf := &buffer{ + raw: make(samples, totalSize), + scratch: make(samples, 5760), + srcHz: hz, + dstHz: hz, + } - return &buffer{ - in: make(samples, maxSize), - out: make(samples, maxSize), - frames: frames, - srcHz: hz, - dstHz: hz, - fi: len(frames) - 1, // start with largest - }, nil + offset := 0 + for _, f := range frames { + size := stereoSamples(hz, f) + buf.buckets = append(buf.buckets, bucket{mem: buf.raw[offset : offset+size], ms: f, dst: size}) + offset += size + } + buf.bi = len(buf.buckets) - 1 + + return buf, nil } func (b *buffer) close() { if b.resampler != nil { b.resampler.Destroy() + b.resampler = nil } } func (b *buffer) resample(targetHz int, algo ResampleAlgo) error { - b.algo, b.dstHz = algo, targetHz - b.out = make(samples, stereoSamples(targetHz, b.frames[len(b.frames)-1])) + b.algo = algo + b.dstHz = targetHz + + for i := range b.buckets { + b.buckets[i].dst = stereoSamples(targetHz, b.buckets[i].ms) + } if algo == ResampleSpeex { var err error - b.resampler, err = NewResampler(2, b.srcHz, targetHz, QualityMax) - return err + if b.resampler, err = ResamplerInit(2, b.srcHz, targetHz, QualityMax); err != nil { + return err + } } return nil } -func (b *buffer) write(s samples, onFull func(samples, float32)) { - for len(s) > 0 { - srcSize := stereoSamples(b.srcHz, b.frames[b.fi]) +func (b *buffer) write(s samples, onFull func(samples, float32)) int { + read := 0 + for read < len(s) { + cur := &b.buckets[b.bi] + n := copy(cur.mem[cur.p:], s[read:]) + read += n + cur.p += n - n := copy(b.in[b.p:srcSize], s) - if n == 0 { - // oof - break - } - - s = s[n:] - b.p += n - - if b.p >= srcSize { - onFull(b.stretch(srcSize), b.frames[b.fi]) - b.p = 0 - b.choose(len(s)) + if cur.p == len(cur.mem) { + onFull(b.stretch(cur.mem, cur.dst), cur.ms) + b.choose(len(s) - read) + b.buckets[b.bi].p = 0 } } - // Remaining samples stay in buffer, will be completed on next write + return read } func (b *buffer) choose(remaining int) { - // Find the largest bucket that fits in remaining samples - for i := len(b.frames) - 1; i >= 0; i-- { - if remaining >= stereoSamples(b.srcHz, b.frames[i]) { - b.fi = i + for i := len(b.buckets) - 1; i >= 0; i-- { + if remaining >= len(b.buckets[i].mem) { + b.bi = i return } } - // Nothing fits - use smallest and wait for more data - b.fi = 0 + b.bi = 0 } -func (b *buffer) stretch(srcSize int) samples { - dstSize := stereoSamples(b.dstHz, b.frames[b.fi]) - src, out := b.in[:srcSize], b.out[:dstSize] - - if srcSize == dstSize { - return src - } - +func (b *buffer) stretch(src samples, dstSize int) samples { switch b.algo { case ResampleSpeex: - if n, _ := b.resampler.Process(src, out); n == dstSize { - return out + if b.resampler != nil { + if _, out, err := b.resampler.ProcessIntInterleaved(src); err == nil { + if len(out) == dstSize { + return out + } + src = out // use speex output for linear correction + } } fallthrough case ResampleLinear: - return linear(src, out) + return b.linear(src, dstSize) case ResampleNearest: - return nearest(src, out) + return b.nearest(src, dstSize) + default: + return b.linear(src, dstSize) } - return src } -func linear(src, out samples) samples { - sn, dn := len(src)/2, len(out)/2 - if sn < 2 || dn < 2 { - return out +func (b *buffer) linear(src samples, dstSize int) samples { + srcLen := len(src) + if srcLen < 2 || dstSize < 2 { + return b.scratch[:dstSize] } - ratio := ((sn - 1) << 16) / (dn - 1) - for i := 0; i < dn; i++ { + + out := b.scratch[:dstSize] + srcPairs, dstPairs := srcLen/2, dstSize/2 + ratio := ((srcPairs - 1) << 16) / (dstPairs - 1) + + for i := 0; i < dstPairs; i++ { pos := i * ratio - si, frac := (pos>>16)*2, pos&0xFFFF + idx, frac := (pos>>16)*2, pos&0xFFFF di := i * 2 - if si >= len(src)-2 { - out[di], out[di+1] = src[len(src)-2], src[len(src)-1] + + if idx >= srcLen-2 { + out[di], out[di+1] = src[srcLen-2], src[srcLen-1] } else { - out[di] = int16(int32(src[si]) + ((int32(src[si+2])-int32(src[si]))*int32(frac))>>16) - out[di+1] = int16(int32(src[si+1]) + ((int32(src[si+3])-int32(src[si+1]))*int32(frac))>>16) + out[di] = int16(int32(src[idx]) + ((int32(src[idx+2])-int32(src[idx]))*int32(frac))>>16) + out[di+1] = int16(int32(src[idx+1]) + ((int32(src[idx+3])-int32(src[idx+1]))*int32(frac))>>16) } } return out } -func nearest(src, out samples) samples { - sn, dn := len(src)/2, len(out)/2 - if sn < 2 || dn < 2 { - return out +func (b *buffer) nearest(src samples, dstSize int) samples { + srcLen := len(src) + if srcLen < 2 || dstSize < 2 { + return b.scratch[:dstSize] } - for i := 0; i < dn; i++ { - si, di := (i*sn/dn)*2, i*2 + + out := b.scratch[:dstSize] + srcPairs, dstPairs := srcLen/2, dstSize/2 + + for i := 0; i < dstPairs; i++ { + si := (i * srcPairs / dstPairs) * 2 + di := i * 2 out[di], out[di+1] = src[si], src[si+1] } return out diff --git a/pkg/worker/media/buffer_test.go b/pkg/worker/media/buffer_test.go index 096b4ef9..28a596ba 100644 --- a/pkg/worker/media/buffer_test.go +++ b/pkg/worker/media/buffer_test.go @@ -11,109 +11,71 @@ type bufWrite struct { } func TestBufferWrite(t *testing.T) { - // At 2000Hz stereo: - // 5ms = 2000 * 0.005 * 2 = 20 samples - // 10ms = 2000 * 0.01 * 2 = 40 samples - tests := []struct { - frames []float32 bufLen int writes []bufWrite expect samples }{ { - frames: []float32{5, 10}, - bufLen: 2000, - writes: []bufWrite{ - {sample: 1, len: 20}, - {sample: 2, len: 40}, - {sample: 3, len: 60}, - }, - expect: samples(rep(1, 20).add(2, 40).add(3, 40).add(3, 20)), - }, - { - frames: []float32{5, 10}, - bufLen: 2000, - writes: []bufWrite{ - {sample: 1, len: 6}, - {sample: 2, len: 36}, - {sample: 3, len: 4}, - }, - expect: samples(rep(1, 6).add(2, 34)), - }, - { - frames: []float32{5, 10}, - bufLen: 2000, - writes: []bufWrite{ - {sample: 1, len: 40}, - }, - expect: samples(rep(1, 40)), - }, - { - frames: []float32{5, 10}, - bufLen: 2000, - writes: []bufWrite{ - {sample: 1, len: 100}, - }, - expect: samples(rep(1, 40).add(1, 40).add(1, 20)), - }, - { - frames: []float32{5}, bufLen: 2000, writes: []bufWrite{ {sample: 1, len: 10}, - {sample: 2, len: 15}, + {sample: 2, len: 20}, + {sample: 3, len: 30}, }, - expect: samples(rep(1, 10).add(2, 10)), + expect: samples{ + 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + }, + }, + { + bufLen: 2000, + writes: []bufWrite{ + {sample: 1, len: 3}, + {sample: 2, len: 18}, + {sample: 3, len: 2}, + }, + expect: samples{1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, }, } - for i, test := range tests { - var results samples - buf, err := newBuffer(test.frames, test.bufLen) + for _, test := range tests { + var lastResult samples + buf, err := newBuffer([]float32{10, 5}, test.bufLen) if err != nil { - t.Fatalf("test %d: %v", i, err) + t.Fatalf("oof, %v", err) } for _, w := range test.writes { - buf.write(samplesOf(w.sample, w.len), func(s samples, ms float32) { - tmp := make(samples, len(s)) - copy(tmp, s) - results = append(results, tmp...) - }) + buf.write(samplesOf(w.sample, w.len), + func(s samples, ms float32) { lastResult = s }, + ) } - if !reflect.DeepEqual(test.expect, results) { - t.Errorf("test %d:\ngot %v (len=%d)\nwant %v (len=%d)", i, results, len(results), test.expect, len(test.expect)) + if !reflect.DeepEqual(test.expect, lastResult) { + t.Errorf("not expted buffer, %v != %v, %v", lastResult, test.expect, len(buf.buckets)) } } } func BenchmarkBufferWrite(b *testing.B) { fn := func(_ samples, _ float32) {} - buf, _ := newBuffer([]float32{10}, 2000) - s1 := samplesOf(1, 1000) - s2 := samplesOf(2, 4000) + l := 2000 + buf, err := newBuffer([]float32{10}, l) + if err != nil { + b.Fatalf("oof: %v", err) + } + samples1 := samplesOf(1, l/2) + samples2 := samplesOf(2, l*2) for i := 0; i < b.N; i++ { - buf.write(s1, fn) - buf.write(s2, fn) + buf.write(samples1, fn) + buf.write(samples2, fn) } } -// helpers - -func samplesOf(v int16, l int) samples { - s := make(samples, l) +func samplesOf(v int16, len int) (s samples) { + s = make(samples, len) for i := range s { s[i] = v } - return s -} - -type builder samples - -func rep(v int16, n int) builder { - return builder(samplesOf(v, n)) -} - -func (b builder) add(v int16, n int) builder { - return append(b, samplesOf(v, n)...) + return } diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 64659427..10152bf5 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -125,8 +125,9 @@ func TestResampleStretch(t *testing.T) { {name: "", args: args{pcm: gen(1764), size: 1920}, want: nil}, } for _, tt := range tests { + buf, _ := newBuffer([]float32{20}, 2000) t.Run(tt.name, func(t *testing.T) { - rez2 := nearest(tt.args.pcm, make(samples, tt.args.size)) + rez2 := buf.nearest(tt.args.pcm, tt.args.size) if rez2[0] != tt.args.pcm[0] || rez2[1] != tt.args.pcm[1] || rez2[len(rez2)-1] != tt.args.pcm[len(tt.args.pcm)-1] || rez2[len(rez2)-2] != tt.args.pcm[len(tt.args.pcm)-2] { @@ -140,8 +141,9 @@ func TestResampleStretch(t *testing.T) { func BenchmarkResampler(b *testing.B) { pcm := samples(gen(1764)) size := 1920 + buf, _ := newBuffer([]float32{20}, 1000) for i := 0; i < b.N; i++ { - linear(pcm, make(samples, size)) + buf.linear(pcm, size) } } diff --git a/pkg/worker/media/speex.go b/pkg/worker/media/speex.go index 5f9fa591..a306fd2b 100644 --- a/pkg/worker/media/speex.go +++ b/pkg/worker/media/speex.go @@ -12,74 +12,86 @@ import "C" import "errors" type Resampler struct { - resampler *C.SpeexResamplerState - channels int + resampler *C.SpeexResamplerState + outBuff []int16 // one of these buffers used when typed data read + outBuffFloat []float32 + channels int + multiplier float32 } +// Quality const ( QualityMax = 10 QualityMin = 0 QualityDefault = 4 QualityDesktop = 5 - QualityVoIP = 3 + QualityVoid = 3 ) -func NewResampler(channels, inRate, outRate, quality int) (*Resampler, error) { - var err C.int +// Errors +const ( + ErrorSuccess = iota + ErrorAllocFailed + ErrorBadState + ErrorInvalidArg + ErrorPtrOverlap + ErrorMaxError +) + +const ( + reserve = 1.1 +) + +// ResamplerInit Create a new resampler with integer input and output rates +// Resampling quality between 0 and 10, where 0 has poor quality +// and 10 has very high quality +func ResamplerInit(channels, inRate, outRate, quality int) (*Resampler, error) { + err := C.int(0) r := &Resampler{channels: channels} - - // Use fractional init for exact ratio - g := gcd(outRate, inRate) - r.resampler = C.speex_resampler_init_frac( - C.spx_uint32_t(channels), - C.spx_uint32_t(outRate/g), - C.spx_uint32_t(inRate/g), - C.spx_uint32_t(inRate), - C.spx_uint32_t(outRate), - C.int(quality), - &err, - ) + r.multiplier = float32(outRate) / float32(inRate) * 1.1 + r.resampler = C.speex_resampler_init(C.spx_uint32_t(channels), + C.spx_uint32_t(inRate), C.spx_uint32_t(outRate), C.int(quality), &err) if r.resampler == nil { - return nil, errors.New(C.GoString(C.speex_resampler_strerror(err))) + return nil, StrError(int(err)) } - - C.speex_resampler_skip_zeros(r.resampler) - return r, nil } -func (r *Resampler) Destroy() { +// Destroy a resampler +func (r *Resampler) Destroy() error { if r.resampler != nil { - C.speex_resampler_destroy(r.resampler) - r.resampler = nil + C.speex_resampler_destroy((*C.SpeexResamplerState)(r.resampler)) + return nil } + return StrError(ErrorInvalidArg) } -func (r *Resampler) Process(in, out []int16) (int, error) { - if r.resampler == nil || len(in) < r.channels || len(out) < r.channels { - return 0, nil +// ProcessIntInterleaved Resample an int slice interleaved +func (r *Resampler) ProcessIntInterleaved(in []int16) (int, []int16, error) { + outBuffCap := int(float32(len(in)) * r.multiplier) + if outBuffCap > cap(r.outBuff) { + r.outBuff = make([]int16, int(float32(outBuffCap)*reserve)*4) } - inLen := C.spx_uint32_t(len(in) / r.channels) - outLen := C.spx_uint32_t(len(out) / r.channels) - + outLen := C.spx_uint32_t(len(r.outBuff) / r.channels) res := C.speex_resampler_process_interleaved_int( r.resampler, (*C.spx_int16_t)(&in[0]), &inLen, - (*C.spx_int16_t)(&out[0]), + (*C.spx_int16_t)(&r.outBuff[0]), &outLen, ) - if res != 0 { - return 0, errors.New(C.GoString(C.speex_resampler_strerror(res))) + if res != ErrorSuccess { + return 0, nil, StrError(ErrorInvalidArg) } - - return int(outLen) * r.channels, nil + return int(inLen) * r.channels, r.outBuff[:outLen*2], nil } -func gcd(a, b int) int { - for b != 0 { - a, b = b, a%b +// StrError returns error message +func StrError(errorCode int) error { + cS := C.speex_resampler_strerror(C.int(errorCode)) + if cS == nil { + return nil } - return a + return errors.New(C.GoString(cS)) } diff --git a/pkg/worker/media/speex_resampler.h b/pkg/worker/media/speex_resampler.h index 88b03fd6..27d510f5 100644 --- a/pkg/worker/media/speex_resampler.h +++ b/pkg/worker/media/speex_resampler.h @@ -36,42 +36,11 @@ SpeexResamplerState *speex_resampler_init(spx_uint32_t nb_channels, spx_uint32_t out_rate, int quality, int *err); -/** Create a new resampler with fractional input/output rates. The sampling - * rate ratio is an arbitrary rational number with both the numerator and - * denominator being 32-bit integers. - * @param nb_channels Number of channels to be processed - * @param ratio_num Numerator of the sampling rate ratio - * @param ratio_den Denominator of the sampling rate ratio - * @param in_rate Input sampling rate rounded to the nearest integer (in Hz). - * @param out_rate Output sampling rate rounded to the nearest integer (in Hz). - * @param quality Resampling quality between 0 and 10, where 0 has poor quality - * and 10 has very high quality. - * @return Newly created resampler state - * @retval NULL Error: not enough memory - */ -SpeexResamplerState *speex_resampler_init_frac(spx_uint32_t nb_channels, - spx_uint32_t ratio_num, - spx_uint32_t ratio_den, - spx_uint32_t in_rate, - spx_uint32_t out_rate, - int quality, - int *err); /** Destroy a resampler state. * @param st Resampler state */ void speex_resampler_destroy(SpeexResamplerState *st); - -/** Make sure that the first samples to go out of the resamplers don't have - * leading zeros. This is only useful before starting to use a newly created - * resampler. It is recommended to use that when resampling an audio file, as - * it will generate a file with the same length. For real-time processing, - * it is probably easier not to use this call (so that the output duration - * is the same for the first frame). - * @param st Resampler state - */ -int speex_resampler_skip_zeros(SpeexResamplerState *st); - /** Resample an interleaved int array. The input and output buffers must *not* overlap. * @param st Resampler state * @param in Input buffer From b3ccea5f0eea2b23854c25d04165893542ac8dad Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Mon, 15 Dec 2025 15:41:51 +0300 Subject: [PATCH 349/361] Refactor media buffer Mostly cleanup. --- pkg/resampler/simple.go | 62 ++++ pkg/resampler/speex.go | 106 ++++++ .../media => resampler}/speex_resampler.h | 11 + pkg/worker/media/buffer.go | 165 ++++----- pkg/worker/media/buffer_test.go | 337 +++++++++++++++--- pkg/worker/media/media_test.go | 68 ---- pkg/worker/media/speex.go | 97 ----- 7 files changed, 531 insertions(+), 315 deletions(-) create mode 100644 pkg/resampler/simple.go create mode 100644 pkg/resampler/speex.go rename pkg/{worker/media => resampler}/speex_resampler.h (82%) delete mode 100644 pkg/worker/media/speex.go diff --git a/pkg/resampler/simple.go b/pkg/resampler/simple.go new file mode 100644 index 00000000..f2859a3e --- /dev/null +++ b/pkg/resampler/simple.go @@ -0,0 +1,62 @@ +package resampler + +func Linear(dst, src []int16) { + nSrc, nDst := len(src), len(dst) + if nSrc < 2 || nDst < 2 { + return + } + + srcPairs, dstPairs := nSrc>>1, nDst>>1 + + // replicate single pair input or output + if srcPairs == 1 || dstPairs == 1 { + for i := 0; i < dstPairs; i++ { + dst[i*2], dst[i*2+1] = src[0], src[1] + } + return + } + + ratio := ((srcPairs - 1) << 16) / (dstPairs - 1) + lastSrc := nSrc - 2 + + // interpolate all pairs except the last + for i, pos := 0, 0; i < dstPairs-1; i, pos = i+1, pos+ratio { + idx := (pos >> 16) << 1 + di := i << 1 + frac := int32(pos & 0xFFFF) + l0, r0 := int32(src[idx]), int32(src[idx+1]) + + // L = L0 + (L1-L0)*frac + dst[di] = int16(l0 + ((int32(src[idx+2])-l0)*frac)>>16) + // R = R0 + (R1-R0)*frac + dst[di+1] = int16(r0 + ((int32(src[idx+3])-r0)*frac)>>16) + } + + // last output pair = last input pair (avoids precision loss at the edge) + lastDst := (dstPairs - 1) << 1 + dst[lastDst], dst[lastDst+1] = src[lastSrc], src[lastSrc+1] +} + +func Nearest(dst, src []int16) { + nSrc, nDst := len(src), len(dst) + if nSrc < 2 || nDst < 2 { + return + } + + srcPairs, dstPairs := nSrc>>1, nDst>>1 + + if srcPairs == 1 || dstPairs == 1 { + for i := 0; i < dstPairs; i++ { + dst[i*2], dst[i*2+1] = src[0], src[1] + } + return + } + + ratio := (srcPairs << 16) / dstPairs + + for i, pos := 0, 0; i < dstPairs; i, pos = i+1, pos+ratio { + si := (pos >> 16) << 1 + di := i << 1 + dst[di], dst[di+1] = src[si], src[si+1] + } +} diff --git a/pkg/resampler/speex.go b/pkg/resampler/speex.go new file mode 100644 index 00000000..b62d2be1 --- /dev/null +++ b/pkg/resampler/speex.go @@ -0,0 +1,106 @@ +package resampler + +/* + #cgo pkg-config: speexdsp + #cgo st LDFLAGS: -l:libspeexdsp.a + + #include + #include "speex_resampler.h" +*/ +import "C" + +import ( + "errors" + "unsafe" +) + +// Quality +const ( + QualityMax = 10 + QualityMin = 0 + QualityDefault = 4 + QualityDesktop = 5 + QualityVoid = 3 +) + +// Errors +const ( + ErrorSuccess = iota + ErrorAllocFailed + ErrorBadState + ErrorInvalidArg + ErrorPtrOverlap + ErrorMaxError +) + +type Resampler struct { + resampler *C.SpeexResamplerState + channels int + inRate int + outRate int +} + +func Init(channels, inRate, outRate, quality int) (*Resampler, error) { + var err C.int + r := &Resampler{ + channels: channels, + inRate: inRate, + outRate: outRate, + } + + r.resampler = C.speex_resampler_init( + C.spx_uint32_t(channels), + C.spx_uint32_t(inRate), + C.spx_uint32_t(outRate), + C.int(quality), + &err, + ) + + if r.resampler == nil { + return nil, StrError(int(err)) + } + + C.speex_resampler_skip_zeros(r.resampler) + + return r, nil +} + +func (r *Resampler) Destroy() { + if r.resampler != nil { + C.speex_resampler_destroy(r.resampler) + r.resampler = nil + } +} + +// Process performs resampling. +// Returns written samples count and error if any. +func (r *Resampler) Process(out, in []int16) (int, error) { + if len(in) == 0 || len(out) == 0 { + return 0, nil + } + + inLen := C.spx_uint32_t(len(in) / r.channels) + outLen := C.spx_uint32_t(len(out) / r.channels) + + res := C.speex_resampler_process_interleaved_int( + r.resampler, + (*C.spx_int16_t)(unsafe.Pointer(&in[0])), + &inLen, + (*C.spx_int16_t)(unsafe.Pointer(&out[0])), + &outLen, + ) + + if res != ErrorSuccess { + return 0, StrError(int(res)) + } + + return int(outLen) * r.channels, nil +} + +func StrError(errorCode int) error { + cS := C.speex_resampler_strerror(C.int(errorCode)) + if cS == nil { + return nil + } + return errors.New(C.GoString(cS)) +} diff --git a/pkg/worker/media/speex_resampler.h b/pkg/resampler/speex_resampler.h similarity index 82% rename from pkg/worker/media/speex_resampler.h rename to pkg/resampler/speex_resampler.h index 27d510f5..9e046ed7 100644 --- a/pkg/worker/media/speex_resampler.h +++ b/pkg/resampler/speex_resampler.h @@ -41,6 +41,17 @@ SpeexResamplerState *speex_resampler_init(spx_uint32_t nb_channels, */ void speex_resampler_destroy(SpeexResamplerState *st); + +/** Make sure that the first samples to go out of the resamplers don't have + * leading zeros. This is only useful before starting to use a newly created + * resampler. It is recommended to use that when resampling an audio file, as + * it will generate a file with the same length. For real-time processing, + * it is probably easier not to use this call (so that the output duration + * is the same for the first frame). + * @param st Resampler state + */ +int speex_resampler_skip_zeros(SpeexResamplerState *st); + /** Resample an interleaved int array. The input and output buffers must *not* overlap. * @param st Resampler state * @param in Input buffer diff --git a/pkg/worker/media/buffer.go b/pkg/worker/media/buffer.go index 57adeb90..e13bb1f0 100644 --- a/pkg/worker/media/buffer.go +++ b/pkg/worker/media/buffer.go @@ -1,6 +1,10 @@ package media -import "errors" +import ( + "errors" + + "github.com/giongto35/cloud-game/v3/pkg/resampler" +) type ResampleAlgo uint8 @@ -11,14 +15,15 @@ const ( ) type buffer struct { - raw samples - scratch samples - buckets []bucket - resampler *Resampler - srcHz int - dstHz int - bi int - algo ResampleAlgo + raw samples + scratch samples + buckets []bucket + srcHz int + dstHz int + bi int + algo ResampleAlgo + + resampler *resampler.Resampler } type bucket struct { @@ -33,30 +38,31 @@ func newBuffer(frames []float32, hz int) (*buffer, error) { return nil, errors.New("invalid params") } - var totalSize int - for _, f := range frames { - totalSize += stereoSamples(hz, f) + buckets := make([]bucket, len(frames)) + var total int + for i, ms := range frames { + n := stereoSamples(hz, ms) + buckets[i] = bucket{ms: ms, dst: n} + total += n } - if totalSize == 0 { + if total == 0 { return nil, errors.New("zero buffer size") } - buf := &buffer{ - raw: make(samples, totalSize), + raw := make(samples, total) + for i, off := 0, 0; i < len(buckets); i++ { + buckets[i].mem = raw[off : off+buckets[i].dst] + off += buckets[i].dst + } + + return &buffer{ + raw: raw, scratch: make(samples, 5760), + buckets: buckets, srcHz: hz, dstHz: hz, - } - - offset := 0 - for _, f := range frames { - size := stereoSamples(hz, f) - buf.buckets = append(buf.buckets, bucket{mem: buf.raw[offset : offset+size], ms: f, dst: size}) - offset += size - } - buf.bi = len(buf.buckets) - 1 - - return buf, nil + bi: len(buckets) - 1, + }, nil } func (b *buffer) close() { @@ -66,43 +72,38 @@ func (b *buffer) close() { } } -func (b *buffer) resample(targetHz int, algo ResampleAlgo) error { - b.algo = algo - b.dstHz = targetHz - +func (b *buffer) resample(hz int, algo ResampleAlgo) error { + b.algo, b.dstHz = algo, hz for i := range b.buckets { - b.buckets[i].dst = stereoSamples(targetHz, b.buckets[i].ms) + b.buckets[i].dst = stereoSamples(hz, b.buckets[i].ms) } - if algo == ResampleSpeex { var err error - if b.resampler, err = ResamplerInit(2, b.srcHz, targetHz, QualityMax); err != nil { - return err - } + b.resampler, err = resampler.Init(2, b.srcHz, hz, resampler.QualityMax) + return err } return nil } func (b *buffer) write(s samples, onFull func(samples, float32)) int { - read := 0 - for read < len(s) { + n := len(s) + for i := 0; i < n; { cur := &b.buckets[b.bi] - n := copy(cur.mem[cur.p:], s[read:]) - read += n - cur.p += n - + c := copy(cur.mem[cur.p:], s[i:]) + i += c + cur.p += c if cur.p == len(cur.mem) { onFull(b.stretch(cur.mem, cur.dst), cur.ms) - b.choose(len(s) - read) + b.choose(n - i) b.buckets[b.bi].p = 0 } } - return read + return n } -func (b *buffer) choose(remaining int) { +func (b *buffer) choose(rem int) { for i := len(b.buckets) - 1; i >= 0; i-- { - if remaining >= len(b.buckets[i].mem) { + if rem >= len(b.buckets[i].mem) { b.bi = i return } @@ -110,65 +111,29 @@ func (b *buffer) choose(remaining int) { b.bi = 0 } -func (b *buffer) stretch(src samples, dstSize int) samples { - switch b.algo { - case ResampleSpeex: - if b.resampler != nil { - if _, out, err := b.resampler.ProcessIntInterleaved(src); err == nil { - if len(out) == dstSize { - return out - } - src = out // use speex output for linear correction +func (b *buffer) stretch(src samples, size int) samples { + if len(src) == size { + return src + } + + if cap(b.scratch) < size { + b.scratch = make(samples, size) + } + out := b.scratch[:size] + + if b.algo == ResampleSpeex && b.resampler != nil { + if n, _ := b.resampler.Process(out, src); n > 0 { + for i := n; i < size; i += 2 { + out[i], out[i+1] = out[n-2], out[n-1] } - } - fallthrough - case ResampleLinear: - return b.linear(src, dstSize) - case ResampleNearest: - return b.nearest(src, dstSize) - default: - return b.linear(src, dstSize) - } -} - -func (b *buffer) linear(src samples, dstSize int) samples { - srcLen := len(src) - if srcLen < 2 || dstSize < 2 { - return b.scratch[:dstSize] - } - - out := b.scratch[:dstSize] - srcPairs, dstPairs := srcLen/2, dstSize/2 - ratio := ((srcPairs - 1) << 16) / (dstPairs - 1) - - for i := 0; i < dstPairs; i++ { - pos := i * ratio - idx, frac := (pos>>16)*2, pos&0xFFFF - di := i * 2 - - if idx >= srcLen-2 { - out[di], out[di+1] = src[srcLen-2], src[srcLen-1] - } else { - out[di] = int16(int32(src[idx]) + ((int32(src[idx+2])-int32(src[idx]))*int32(frac))>>16) - out[di+1] = int16(int32(src[idx+1]) + ((int32(src[idx+3])-int32(src[idx+1]))*int32(frac))>>16) + return out } } - return out -} -func (b *buffer) nearest(src samples, dstSize int) samples { - srcLen := len(src) - if srcLen < 2 || dstSize < 2 { - return b.scratch[:dstSize] - } - - out := b.scratch[:dstSize] - srcPairs, dstPairs := srcLen/2, dstSize/2 - - for i := 0; i < dstPairs; i++ { - si := (i * srcPairs / dstPairs) * 2 - di := i * 2 - out[di], out[di+1] = src[si], src[si+1] + if b.algo == ResampleNearest { + resampler.Nearest(out, src) + } else { + resampler.Linear(out, src) } return out } diff --git a/pkg/worker/media/buffer_test.go b/pkg/worker/media/buffer_test.go index 28a596ba..a2be89d8 100644 --- a/pkg/worker/media/buffer_test.go +++ b/pkg/worker/media/buffer_test.go @@ -3,79 +3,316 @@ package media import ( "reflect" "testing" + + "github.com/giongto35/cloud-game/v3/pkg/resampler" ) -type bufWrite struct { - sample int16 - len int +func mustBuffer(t *testing.T, frames []float32, hz int) *buffer { + t.Helper() + buf, err := newBuffer(frames, hz) + if err != nil { + t.Fatalf("failed to create buffer: %v", err) + } + return buf +} + +func samplesOf(v int16, n int) samples { + s := make(samples, n) + for i := range s { + s[i] = v + } + return s +} + +func ramp(pairs int) samples { + s := make(samples, pairs*2) + for i := 0; i < pairs; i++ { + s[i*2], s[i*2+1] = int16(i), int16(i) + } + return s +} + +func TestNewBuffer(t *testing.T) { + tests := []struct { + name string + frames []float32 + hz int + wantErr bool + }{ + {"valid single", []float32{10}, 48000, false}, + {"valid multi", []float32{10, 20}, 48000, false}, + {"hz too low", []float32{10}, 1999, true}, + {"empty frames", []float32{}, 48000, true}, + {"nil frames", nil, 48000, true}, + } + + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + buf, err := newBuffer(tt.frames, tt.hz) + if (err != nil) != tt.wantErr { + t.Errorf("err = %v, wantErr %v", err, tt.wantErr) + } + if buf != nil { + buf.close() + } + }) + } +} + +func TestBufferBucketSizes(t *testing.T) { + buf := mustBuffer(t, []float32{10, 20}, 48000) + defer buf.close() + + if len(buf.buckets) != 2 { + t.Fatalf("got %d buckets, want 2", len(buf.buckets)) + } + if n := len(buf.buckets[0].mem); n != 960 { + t.Errorf("bucket[0] = %d, want 960", n) + } + if n := len(buf.buckets[1].mem); n != 1920 { + t.Errorf("bucket[1] = %d, want 1920", n) + } +} + +func TestBufferClose(t *testing.T) { + buf := mustBuffer(t, []float32{10}, 48000) + buf.close() + buf.close() // idempotent + if buf.resampler != nil { + t.Error("resampler should be nil after close") + } } func TestBufferWrite(t *testing.T) { tests := []struct { - bufLen int - writes []bufWrite - expect samples + name string + writes []struct { + v int16 + n int + } + want samples }{ { - bufLen: 2000, - writes: []bufWrite{ - {sample: 1, len: 10}, - {sample: 2, len: 20}, - {sample: 3, len: 30}, - }, - expect: samples{ - 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 3, 3, 3, - 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + name: "overflow triggers callback", + writes: []struct { + v int16 + n int + }{{1, 10}, {2, 20}, {3, 30}}, + want: samples{ + 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, + 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, 3, }, }, { - bufLen: 2000, - writes: []bufWrite{ - {sample: 1, len: 3}, - {sample: 2, len: 18}, - {sample: 3, len: 2}, - }, - expect: samples{1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, + name: "partial fill", + writes: []struct { + v int16 + n int + }{{1, 3}, {2, 18}, {3, 2}}, + want: samples{1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2}, }, } - for _, test := range tests { - var lastResult samples - buf, err := newBuffer([]float32{10, 5}, test.bufLen) - if err != nil { - t.Fatalf("oof, %v", err) + for _, tt := range tests { + t.Run(tt.name, func(t *testing.T) { + buf := mustBuffer(t, []float32{10, 5}, 2000) + defer buf.close() + + var got samples + for _, w := range tt.writes { + buf.write(samplesOf(w.v, w.n), func(s samples, _ float32) { got = s }) + } + if !reflect.DeepEqual(got, tt.want) { + t.Errorf("\ngot: %v\nwant: %v", got, tt.want) + } + }) + } +} + +func TestBufferWriteExact(t *testing.T) { + buf := mustBuffer(t, []float32{10}, 2000) // 40 samples + defer buf.close() + + calls := 0 + buf.write(samplesOf(1, 40), func(_ samples, ms float32) { + calls++ + if ms != 10 { + t.Errorf("ms = %v, want 10", ms) } - for _, w := range test.writes { - buf.write(samplesOf(w.sample, w.len), - func(s samples, ms float32) { lastResult = s }, - ) - } - if !reflect.DeepEqual(test.expect, lastResult) { - t.Errorf("not expted buffer, %v != %v, %v", lastResult, test.expect, len(buf.buckets)) + }) + if calls != 1 { + t.Errorf("calls = %d, want 1", calls) + } +} + +func TestBufferWriteReturn(t *testing.T) { + buf := mustBuffer(t, []float32{10}, 2000) + defer buf.close() + + if n := buf.write(samplesOf(1, 100), func(samples, float32) {}); n != 100 { + t.Errorf("return = %d, want 100", n) + } +} + +func TestBufferChoose(t *testing.T) { + buf := mustBuffer(t, []float32{20, 10, 5}, 48000) // 1920, 960, 480 + defer buf.close() + + tests := []struct{ rem, want int }{ + {10000, 2}, {500, 2}, {479, 0}, {0, 0}, + } + for _, tt := range tests { + buf.choose(tt.rem) + if buf.bi != tt.want { + t.Errorf("choose(%d) = %d, want %d", tt.rem, buf.bi, tt.want) } } } -func BenchmarkBufferWrite(b *testing.B) { - fn := func(_ samples, _ float32) {} - l := 2000 - buf, err := newBuffer([]float32{10}, l) - if err != nil { - b.Fatalf("oof: %v", err) +func TestStereoSamples(t *testing.T) { + tests := []struct { + hz int + ms float32 + want int + }{ + {16000, 5, 160}, + {32768, 10, 656}, + {32768, 2.5, 164}, + {32768, 5, 328}, + {44100, 10, 882}, + {48000, 10, 960}, + {48000, 2.5, 240}, } - samples1 := samplesOf(1, l/2) - samples2 := samplesOf(2, l*2) - for i := 0; i < b.N; i++ { - buf.write(samples1, fn) - buf.write(samples2, fn) + for _, tt := range tests { + if got := stereoSamples(tt.hz, tt.ms); got != tt.want { + t.Errorf("stereoSamples(%d, %.0f) = %d, want %d", tt.hz, tt.ms, got, tt.want) + } } } -func samplesOf(v int16, len int) (s samples) { - s = make(samples, len) - for i := range s { - s[i] = v +func TestStretchPassthrough(t *testing.T) { + buf := mustBuffer(t, []float32{10}, 48000) + defer buf.close() + + src := samples{1, 2, 3, 4} + if res := buf.stretch(src, 4); &res[0] != &src[0] { + t.Error("expected zero-copy when sizes match") } - return +} + +func TestLinear(t *testing.T) { + t.Run("interpolation", func(t *testing.T) { + out := make(samples, 8) + resampler.Linear(out, samples{0, 0, 100, 100}) + if out[2] <= 0 || out[2] >= 100 { + t.Errorf("middle value %d not interpolated", out[2]) + } + }) + + t.Run("sizes", func(t *testing.T) { + cases := []struct{ srcPairs, dstSize int }{ + {4, 16}, {8, 8}, {4, 8}, + } + for _, tc := range cases { + out := make(samples, tc.dstSize) + resampler.Linear(out, ramp(tc.srcPairs)) + if len(out) != tc.dstSize { + t.Errorf("len = %d, want %d", len(out), tc.dstSize) + } + } + }) +} + +func TestNearest(t *testing.T) { + tests := []struct { + src samples + want samples + }{ + {samples{10, 20, 30, 40}, samples{10, 20, 10, 20, 30, 40, 30, 40}}, + {samples{10, 20, 30, 40, 50, 60, 70, 80}, samples{10, 20, 50, 60}}, + } + for _, tt := range tests { + out := make(samples, len(tt.want)) + resampler.Nearest(out, tt.src) + if !reflect.DeepEqual(out, tt.want) { + t.Errorf("nearest(%v) = %v, want %v", tt.src, out, tt.want) + } + } +} + +func TestSpeex(t *testing.T) { + buf := mustBuffer(t, []float32{10}, 48000) + defer buf.close() + + if err := buf.resample(24000, ResampleSpeex); err != nil { + t.Fatal(err) + } + + t.Run("stretch", func(t *testing.T) { + res := buf.stretch(samplesOf(1000, 960), 480) + if len(res) != 480 { + t.Errorf("len = %d, want 480", len(res)) + } + for _, s := range res { + if s != 0 { + return + } + } + t.Error("output is silent") + }) + + t.Run("write", func(t *testing.T) { + calls := 0 + buf.write(samplesOf(5000, 960), func(s samples, ms float32) { + calls++ + if len(s) != 480 { + t.Errorf("len = %d, want 480", len(s)) + } + if ms != 10 { + t.Errorf("ms = %v, want 10", ms) + } + }) + if calls != 1 { + t.Errorf("calls = %d, want 1", calls) + } + }) +} + +func BenchmarkStretch(b *testing.B) { + src := samplesOf(1000, 1920) // 20ms @ 48kHz + + b.Run("speex", func(b *testing.B) { + buf, _ := newBuffer([]float32{20}, 48000) + defer buf.close() + _ = buf.resample(24000, ResampleSpeex) + + b.ResetTimer() + for i := 0; i < b.N; i++ { + buf.stretch(src, 960) + } + }) + + b.Run("linear", func(b *testing.B) { + buf, _ := newBuffer([]float32{20}, 48000) + defer buf.close() + _ = buf.resample(24000, ResampleLinear) + + b.ResetTimer() + for i := 0; i < b.N; i++ { + buf.stretch(src, 960) + } + }) + + b.Run("nearest", func(b *testing.B) { + buf, _ := newBuffer([]float32{20}, 48000) + defer buf.close() + _ = buf.resample(24000, ResampleNearest) + + b.ResetTimer() + for i := 0; i < b.N; i++ { + buf.stretch(src, 960) + } + }) } diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 10152bf5..3e264e80 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -110,71 +110,3 @@ func genTestImage(w, h int, seed float32) *image.RGBA { } return img } - -func TestResampleStretch(t *testing.T) { - type args struct { - pcm samples - size int - } - tests := []struct { - name string - args args - want []int16 - }{ - //1764:1920 - {name: "", args: args{pcm: gen(1764), size: 1920}, want: nil}, - } - for _, tt := range tests { - buf, _ := newBuffer([]float32{20}, 2000) - t.Run(tt.name, func(t *testing.T) { - rez2 := buf.nearest(tt.args.pcm, tt.args.size) - if rez2[0] != tt.args.pcm[0] || rez2[1] != tt.args.pcm[1] || - rez2[len(rez2)-1] != tt.args.pcm[len(tt.args.pcm)-1] || - rez2[len(rez2)-2] != tt.args.pcm[len(tt.args.pcm)-2] { - t.Logf("%v\n%v", tt.args.pcm, rez2) - t.Errorf("2nd is wrong (2)") - } - }) - } -} - -func BenchmarkResampler(b *testing.B) { - pcm := samples(gen(1764)) - size := 1920 - buf, _ := newBuffer([]float32{20}, 1000) - for i := 0; i < b.N; i++ { - buf.linear(pcm, size) - } -} - -func gen(l int) []int16 { - nums := make([]int16, l) - for i := range nums { - nums[i] = int16(rand.IntN(10)) - } - return nums -} - -func TestFrame(t *testing.T) { - type args struct { - hz int - frame float32 - } - tests := []struct { - name string - args args - want int - }{ - {name: "mGBA", args: args{hz: 32768, frame: 10}, want: 656}, - {name: "mGBA", args: args{hz: 32768, frame: 5}, want: 328}, - {name: "mGBA", args: args{hz: 32768, frame: 2.5}, want: 164}, - {name: "nes", args: args{hz: 48000, frame: 2.5}, want: 240}, - } - for _, tt := range tests { - t.Run(tt.name, func(t *testing.T) { - if got := stereoSamples(tt.args.hz, tt.args.frame); got != tt.want { - t.Errorf("frame() = %v, want %v", got, tt.want) - } - }) - } -} diff --git a/pkg/worker/media/speex.go b/pkg/worker/media/speex.go deleted file mode 100644 index a306fd2b..00000000 --- a/pkg/worker/media/speex.go +++ /dev/null @@ -1,97 +0,0 @@ -package media - -/* - #cgo pkg-config: speexdsp - #cgo st LDFLAGS: -l:libspeexdsp.a - - #include - #include "speex_resampler.h" -*/ -import "C" - -import "errors" - -type Resampler struct { - resampler *C.SpeexResamplerState - outBuff []int16 // one of these buffers used when typed data read - outBuffFloat []float32 - channels int - multiplier float32 -} - -// Quality -const ( - QualityMax = 10 - QualityMin = 0 - QualityDefault = 4 - QualityDesktop = 5 - QualityVoid = 3 -) - -// Errors -const ( - ErrorSuccess = iota - ErrorAllocFailed - ErrorBadState - ErrorInvalidArg - ErrorPtrOverlap - ErrorMaxError -) - -const ( - reserve = 1.1 -) - -// ResamplerInit Create a new resampler with integer input and output rates -// Resampling quality between 0 and 10, where 0 has poor quality -// and 10 has very high quality -func ResamplerInit(channels, inRate, outRate, quality int) (*Resampler, error) { - err := C.int(0) - r := &Resampler{channels: channels} - r.multiplier = float32(outRate) / float32(inRate) * 1.1 - r.resampler = C.speex_resampler_init(C.spx_uint32_t(channels), - C.spx_uint32_t(inRate), C.spx_uint32_t(outRate), C.int(quality), &err) - if r.resampler == nil { - return nil, StrError(int(err)) - } - return r, nil -} - -// Destroy a resampler -func (r *Resampler) Destroy() error { - if r.resampler != nil { - C.speex_resampler_destroy((*C.SpeexResamplerState)(r.resampler)) - return nil - } - return StrError(ErrorInvalidArg) -} - -// ProcessIntInterleaved Resample an int slice interleaved -func (r *Resampler) ProcessIntInterleaved(in []int16) (int, []int16, error) { - outBuffCap := int(float32(len(in)) * r.multiplier) - if outBuffCap > cap(r.outBuff) { - r.outBuff = make([]int16, int(float32(outBuffCap)*reserve)*4) - } - inLen := C.spx_uint32_t(len(in) / r.channels) - outLen := C.spx_uint32_t(len(r.outBuff) / r.channels) - res := C.speex_resampler_process_interleaved_int( - r.resampler, - (*C.spx_int16_t)(&in[0]), - &inLen, - (*C.spx_int16_t)(&r.outBuff[0]), - &outLen, - ) - if res != ErrorSuccess { - return 0, nil, StrError(ErrorInvalidArg) - } - return int(inLen) * r.channels, r.outBuff[:outLen*2], nil -} - -// StrError returns error message -func StrError(errorCode int) error { - cS := C.speex_resampler_strerror(C.int(errorCode)) - if cS == nil { - return nil - } - return errors.New(C.GoString(cS)) -} From d45daeab7aa810a3155ae0104ca6cdbe83ef15bc Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Mon, 15 Dec 2025 18:42:41 +0300 Subject: [PATCH 350/361] Tweak room join/creation logic --- pkg/coordinator/hub.go | 33 ++++++++++++-------- pkg/coordinator/user.go | 7 +++-- pkg/coordinator/userhandlers.go | 50 +++++++++++++++++++++++++++++++ pkg/coordinator/workerhandlers.go | 1 + 4 files changed, 75 insertions(+), 16 deletions(-) diff --git a/pkg/coordinator/hub.go b/pkg/coordinator/hub.go index 490747df..9e646ced 100644 --- a/pkg/coordinator/hub.go +++ b/pkg/coordinator/hub.go @@ -69,12 +69,10 @@ func (h *Hub) handleUserConnection() http.HandlerFunc { return } - bound := user.Bind(worker) - if !bound { - user.Notify(api.ErrNoFreeSlots, "") - h.log.Info().Msg("no free slots") - return - } + // Link the user to the selected worker. Slot reservation is handled later + // on game start; this keeps connections lightweight and lets deep-link + // joins share a worker without consuming its single game slot. + user.w = worker h.users.Add(user) @@ -178,12 +176,15 @@ func (h *Hub) GetServerList() (r []api.Server) { // various conditions. func (h *Hub) findWorkerFor(usr *User, q url.Values, log *logger.Logger) *Worker { log.Debug().Msg("Search available workers") - roomId := q.Get(api.RoomIdQueryParam) + roomIdRaw := q.Get(api.RoomIdQueryParam) + sessionId, deepRoomId := api.ExplodeDeepLink(roomIdRaw) + roomId := roomIdRaw + if deepRoomId != "" { + roomId = deepRoomId + } zone := q.Get(api.ZoneQueryParam) wid := q.Get(api.WorkerIdParam) - sessionId, _ := api.ExplodeDeepLink(roomId) - var worker *Worker if wid != "" { @@ -195,7 +196,7 @@ func (h *Hub) findWorkerFor(usr *User, q url.Values, log *logger.Logger) *Worker } } - if worker = h.findWorkerByRoom(roomId, zone); worker != nil { + if worker = h.findWorkerByRoom(roomIdRaw, roomId, zone); worker != nil { log.Debug().Str("room", roomId).Msg("An existing worker has been found") } else if worker = h.findWorkerByPreviousRoom(sessionId); worker != nil { log.Debug().Msgf("Worker %v with the previous room: %v is found", wid, roomId) @@ -228,13 +229,19 @@ func (h *Hub) findWorkerByPreviousRoom(id string) *Worker { return w } -func (h *Hub) findWorkerByRoom(id string, region string) *Worker { - if id == "" { +func (h *Hub) findWorkerByRoom(id string, deepId string, region string) *Worker { + if id == "" && deepId == "" { return nil } // if there is zone param, we need to ensure the worker in that zone, // if not we consider the room is missing - w, _ := h.workers.FindBy(func(w *Worker) bool { return w.RoomId == id && w.In(region) }) + w, _ := h.workers.FindBy(func(w *Worker) bool { + matchId := w.RoomId == id + if !matchId && deepId != "" { + matchId = w.RoomId == deepId + } + return matchId && w.In(region) + }) return w } diff --git a/pkg/coordinator/user.go b/pkg/coordinator/user.go index 5d1e7ed5..b9d87e7e 100644 --- a/pkg/coordinator/user.go +++ b/pkg/coordinator/user.go @@ -30,14 +30,15 @@ func NewUser(sock *com.Connection, log *logger.Logger) *User { func (u *User) Bind(w *Worker) bool { u.w = w - - return u.w.TryReserve() + // Binding only links the worker; slot reservation is handled lazily on + // game start to avoid blocking deep-link joins or parallel connections + // that haven't started a game yet. + return true } func (u *User) Disconnect() { u.Connection.Disconnect() if u.w != nil { - u.w.UnReserve() u.w.TerminateSession(u.Id()) } } diff --git a/pkg/coordinator/userhandlers.go b/pkg/coordinator/userhandlers.go index 811ce332..80d0dc6e 100644 --- a/pkg/coordinator/userhandlers.go +++ b/pkg/coordinator/userhandlers.go @@ -2,6 +2,7 @@ package coordinator import ( "sort" + "time" "github.com/giongto35/cloud-game/v3/pkg/api" "github.com/giongto35/cloud-game/v3/pkg/com" @@ -26,6 +27,55 @@ func (u *User) HandleWebrtcIceCandidate(rq api.WebrtcUserIceCandidate) { } func (u *User) HandleStartGame(rq api.GameStartUserRequest, conf config.CoordinatorConfig) { + // Worker slot / room gating: + // - If the worker is BUSY (no free slot), we must not create another room. + // * If the worker has already reported a room id, only allow requests + // for that same room (deep-link joins / reloads). + // * If the worker hasn't reported a room yet, deny any new StartGame to + // avoid racing concurrent room creation on the worker. + // * When the user is starting a NEW game (empty room id), we give the + // worker a short grace period to close the previous room and free the + // slot before rejecting with "no slots". + // - If the worker is FREE, reserve the slot lazily before starting the + // game; the room id (if any) comes from the request / worker. + + // Grace period: when there's no room id in the request (new game) but the + // worker still appears busy, wait a bit for the previous room to close. + if rq.RoomId == "" && !u.w.HasSlot() { + const waitTotal = 3 * time.Second + const step = 100 * time.Millisecond + waited := time.Duration(0) + for waited < waitTotal { + if u.w.HasSlot() { + break + } + time.Sleep(step) + waited += step + } + } + + busy := !u.w.HasSlot() + if busy { + if u.w.RoomId == "" { + u.Notify(api.ErrNoFreeSlots, "") + return + } + if rq.RoomId == "" { + // No room id but worker is busy -> assume user wants to continue + // the existing room instead of starting a parallel game. + rq.RoomId = u.w.RoomId + } else if rq.RoomId != u.w.RoomId { + u.Notify(api.ErrNoFreeSlots, "") + return + } + } else { + // Worker is free: try to reserve the single slot for this new room. + if !u.w.TryReserve() { + u.Notify(api.ErrNoFreeSlots, "") + return + } + } + startGameResp, err := u.w.StartGame(u.Id(), rq) if err != nil || startGameResp == nil { u.log.Error().Err(err).Msg("malformed game start response") diff --git a/pkg/coordinator/workerhandlers.go b/pkg/coordinator/workerhandlers.go index 5716b621..edd7e210 100644 --- a/pkg/coordinator/workerhandlers.go +++ b/pkg/coordinator/workerhandlers.go @@ -10,6 +10,7 @@ func (w *Worker) HandleRegisterRoom(rq api.RegisterRoomRequest) { w.RoomId = str func (w *Worker) HandleCloseRoom(rq api.CloseRoomRequest) { if string(rq) == w.RoomId { w.RoomId = "" + w.FreeSlots() } } From 7c91d200e4c3ee5e9d33bdfe09673a829396ef72 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Wed, 17 Dec 2025 23:12:50 +0300 Subject: [PATCH 351/361] Update Go version to 1.26rc1 --- Dockerfile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Dockerfile b/Dockerfile index 3b3f23c6..1cb760b2 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:plucky AS build0 -ARG GO=1.25.0 +ARG GO=1.26rc1 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ From c800dd4bf964818226b8fd8f76799285826fc2e8 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Mon, 22 Dec 2025 15:08:50 +0300 Subject: [PATCH 352/361] Fix with go fix --- pkg/coordinator/worker_test.go | 4 ++-- pkg/encoder/color/rgba/rgba.go | 4 ++-- pkg/encoder/h264/x264_test.go | 2 +- pkg/encoder/yuv/yuv_test.go | 10 +++++----- pkg/games/library_test.go | 2 +- pkg/resampler/simple.go | 4 ++-- pkg/worker/caged/libretro/frontend_test.go | 6 ++---- pkg/worker/caged/libretro/nanoarch/input_test.go | 2 +- pkg/worker/media/buffer_test.go | 2 +- pkg/worker/media/media_test.go | 6 +++--- pkg/worker/recorder/recorder_test.go | 6 +++--- 11 files changed, 23 insertions(+), 25 deletions(-) diff --git a/pkg/coordinator/worker_test.go b/pkg/coordinator/worker_test.go index a08b8b71..fe4f7a1a 100644 --- a/pkg/coordinator/worker_test.go +++ b/pkg/coordinator/worker_test.go @@ -82,7 +82,7 @@ func testUnReserveConcurrent(t *testing.T) { atomic.StoreInt32((*int32)(&s), int32(workers)) wg.Add(workers) - for i := 0; i < workers; i++ { + for range workers { go func() { defer wg.Done() s.UnReserve() @@ -126,7 +126,7 @@ func testTryReserveConcurrent(t *testing.T) { var wg sync.WaitGroup wg.Add(workers) - for i := 0; i < workers; i++ { + for range workers { go func() { defer wg.Done() if s.TryReserve() { diff --git a/pkg/encoder/color/rgba/rgba.go b/pkg/encoder/color/rgba/rgba.go index c37d6218..5bb2e9bc 100644 --- a/pkg/encoder/color/rgba/rgba.go +++ b/pkg/encoder/color/rgba/rgba.go @@ -9,12 +9,12 @@ func ToRGBA(img image.Image, flipped bool) *image.RGBA { bounds := img.Bounds() sw, sh := bounds.Dx(), bounds.Dy() dst := image.NewRGBA(image.Rect(0, 0, sw, sh)) - for y := 0; y < sh; y++ { + for y := range sh { yy := y if flipped { yy = sh - y } - for x := 0; x < sw; x++ { + for x := range sw { px := img.At(x, y) rgba := color.RGBAModel.Convert(px).(color.RGBA) dst.Set(x, yy, rgba) diff --git a/pkg/encoder/h264/x264_test.go b/pkg/encoder/h264/x264_test.go index 0fe1bb43..822e4cec 100644 --- a/pkg/encoder/h264/x264_test.go +++ b/pkg/encoder/h264/x264_test.go @@ -23,7 +23,7 @@ func Benchmark(b *testing.B) { return } data := make([]byte, int(float64(w)*float64(h)*1.5)) - for i := 0; i < b.N; i++ { + for b.Loop() { h264.Encode(data) } } diff --git a/pkg/encoder/yuv/yuv_test.go b/pkg/encoder/yuv/yuv_test.go index e4e74b30..4e0ebbf7 100644 --- a/pkg/encoder/yuv/yuv_test.go +++ b/pkg/encoder/yuv/yuv_test.go @@ -123,7 +123,7 @@ func TestYuvPredefined(t *testing.T) { t.Fatalf("different size a: %v, o: %v", len(a), len(should)) } - for i := 0; i < len(a); i++ { + for i := range a { if a[i] != should[i] { t.Fatalf("diff in %vth, %v != %v \n%v\n%v", i, a[i], should[i], im, should) } @@ -188,8 +188,8 @@ func BenchmarkYuv(b *testing.B) { func genFrame(w, h int, seed float32) RawFrame { img := image.NewRGBA(image.Rectangle{Max: image.Point{X: w, Y: h}}) - for x := 0; x < w; x++ { - for y := 0; y < h; y++ { + for x := range w { + for y := range h { col := color.RGBA{R: uint8(seed * 255), G: uint8(seed * 255), B: uint8(seed * 255), A: 0xff} img.Set(x, y, col) } @@ -217,9 +217,9 @@ func TestGen24bitFull(t *testing.T) { // radius = centerY //} - for y := 0; y < wh; y++ { + for y := range wh { dy := float64(y - centerY) - for x := 0; x < wh; x++ { + for x := range wh { dx := float64(x - centerX) dist := math.Sqrt(dx*dx + dy*dy) if dist <= float64(radius) { diff --git a/pkg/games/library_test.go b/pkg/games/library_test.go index dc85fbbf..28975647 100644 --- a/pkg/games/library_test.go +++ b/pkg/games/library_test.go @@ -117,7 +117,7 @@ func Benchmark(b *testing.B) { Supported: []string{"gba", "zip", "nes"}, }, config.Emulator{}, log) - for range b.N { + for b.Loop() { library.Scan() _ = library.GetAll() } diff --git a/pkg/resampler/simple.go b/pkg/resampler/simple.go index f2859a3e..39e509c0 100644 --- a/pkg/resampler/simple.go +++ b/pkg/resampler/simple.go @@ -10,7 +10,7 @@ func Linear(dst, src []int16) { // replicate single pair input or output if srcPairs == 1 || dstPairs == 1 { - for i := 0; i < dstPairs; i++ { + for i := range dstPairs { dst[i*2], dst[i*2+1] = src[0], src[1] } return @@ -46,7 +46,7 @@ func Nearest(dst, src []int16) { srcPairs, dstPairs := nSrc>>1, nDst>>1 if srcPairs == 1 || dstPairs == 1 { - for i := 0; i < dstPairs; i++ { + for i := range dstPairs { dst[i*2], dst[i*2+1] = src[0], src[1] } return diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index fda0ecbe..2cacd5a4 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -329,8 +329,7 @@ func TestStateConcurrency(t *testing.T) { qLock.Unlock() if lucky() && !lucky() { - ops.Add(1) - go func() { + ops.Go(func() { qLock.Lock() defer qLock.Unlock() @@ -344,8 +343,7 @@ func TestStateConcurrency(t *testing.T) { if snapshot1 != snapshot2 { t.Errorf("States are inconsistent %v != %v on tick %v\n", snapshot1, snapshot2, i+1) } - ops.Done() - }() + }) } } diff --git a/pkg/worker/caged/libretro/nanoarch/input_test.go b/pkg/worker/caged/libretro/nanoarch/input_test.go index 4921df59..042d108e 100644 --- a/pkg/worker/caged/libretro/nanoarch/input_test.go +++ b/pkg/worker/caged/libretro/nanoarch/input_test.go @@ -13,7 +13,7 @@ func TestConcurrentInput(t *testing.T) { events := 1000 wg.Add(2 * events) - for i := 0; i < events; i++ { + for range events { player := rand.Intn(maxPort) go func() { state.Input(player, []byte{0, 1}); wg.Done() }() go func() { state.IsKeyPressed(uint(player), 100); wg.Done() }() diff --git a/pkg/worker/media/buffer_test.go b/pkg/worker/media/buffer_test.go index a2be89d8..6c8d300a 100644 --- a/pkg/worker/media/buffer_test.go +++ b/pkg/worker/media/buffer_test.go @@ -26,7 +26,7 @@ func samplesOf(v int16, n int) samples { func ramp(pairs int) samples { s := make(samples, pairs*2) - for i := 0; i < pairs; i++ { + for i := range pairs { s[i*2], s[i*2+1] = int16(i), int16(i) } return s diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 3e264e80..a0fd9399 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -79,7 +79,7 @@ func run(w, h int, cod encoder.VideoCodec, count int, a *image.RGBA, b *image.RG b = genTestImage(w, h, rand.Float32()) } - for i := 0; i < count; i++ { + for i := range count { im := a if i%2 == 0 { im = b @@ -98,8 +98,8 @@ func run(w, h int, cod encoder.VideoCodec, count int, a *image.RGBA, b *image.RG func genTestImage(w, h int, seed float32) *image.RGBA { img := image.NewRGBA(image.Rectangle{Max: image.Point{X: w, Y: h}}) - for x := 0; x < w; x++ { - for y := 0; y < h; y++ { + for x := range w { + for y := range h { i := img.PixOffset(x, y) s := img.Pix[i : i+4 : i+4] s[0] = uint8(seed * 255) diff --git a/pkg/worker/recorder/recorder_test.go b/pkg/worker/recorder/recorder_test.go index fcfe1f57..d968cc34 100644 --- a/pkg/worker/recorder/recorder_test.go +++ b/pkg/worker/recorder/recorder_test.go @@ -46,7 +46,7 @@ func TestName(t *testing.T) { audioWg.Add(iterations) frame := genFrame(100, 100) - for i := 0; i < 222; i++ { + for range 222 { go func() { recorder.WriteVideo(Video{Frame: frame, Duration: 16 * time.Millisecond}) imgWg.Done() @@ -134,8 +134,8 @@ func benchmarkRecorder(w, h int, b *testing.B) { func genFrame(w, h int) Frame { img := image.NewRGBA(image.Rect(0, 0, w, h)) - for x := 0; x < w; x++ { - for y := 0; y < h; y++ { + for x := range w { + for y := range h { img.Set(x, y, randomColor()) } } From 94e13cb93bca6d993520b7b9f577c1af8da6420c Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Mon, 22 Dec 2025 15:37:04 +0300 Subject: [PATCH 353/361] Clean api --- pkg/api/api.go | 23 ++++++++++ pkg/coordinator/user.go | 53 ++++++----------------- pkg/coordinator/userapi.go | 8 +--- pkg/coordinator/worker.go | 62 +++++++++------------------ pkg/coordinator/workerapi.go | 30 ++++++------- pkg/worker/coordinator.go | 83 +++++++++--------------------------- 6 files changed, 91 insertions(+), 168 deletions(-) diff --git a/pkg/api/api.go b/pkg/api/api.go index 2deeb44a..93fedb17 100644 --- a/pkg/api/api.go +++ b/pkg/api/api.go @@ -39,6 +39,14 @@ type ( PT uint8 ) +func State[T Id](id T) Stateful[T] { + return Stateful[T]{Id: id} +} + +func StateRoom[T Id](id T, rid string) StatefulRoom[T] { + return StatefulRoom[T]{Stateful: State(id), Room: Room{Rid: rid}} +} + type In[I Id] struct { Id I `json:"id,omitempty"` T PT `json:"t"` @@ -157,6 +165,21 @@ var ( OkPacket = Out{Payload: "ok"} ) +func Do[I Id, T any](in In[I], fn func(T)) error { + if dat := Unwrap[T](in.Payload); dat != nil { + fn(*dat) + return nil + } + return ErrMalformed +} + +func DoE[I Id, T any](in In[I], fn func(T) error) error { + if dat := Unwrap[T](in.Payload); dat != nil { + return fn(*dat) + } + return ErrMalformed +} + func Unwrap[T any](data []byte) *T { out := new(T) if err := json.Unmarshal(data, out); err != nil { diff --git a/pkg/coordinator/user.go b/pkg/coordinator/user.go index b9d87e7e..2a4f1e98 100644 --- a/pkg/coordinator/user.go +++ b/pkg/coordinator/user.go @@ -44,67 +44,38 @@ func (u *User) Disconnect() { } func (u *User) HandleRequests(info HasServerInfo, conf config.CoordinatorConfig) chan struct{} { - return u.ProcessPackets(func(x api.In[com.Uid]) error { - payload := x.GetPayload() - switch x.GetType() { + return u.ProcessPackets(func(x api.In[com.Uid]) (err error) { + switch x.T { case api.WebrtcInit: if u.w != nil { u.HandleWebrtcInit() } case api.WebrtcAnswer: - rq := api.Unwrap[api.WebrtcAnswerUserRequest](payload) - if rq == nil { - return api.ErrMalformed - } - u.HandleWebrtcAnswer(*rq) + err = api.Do(x, u.HandleWebrtcAnswer) case api.WebrtcIce: - rq := api.Unwrap[api.WebrtcUserIceCandidate](payload) - if rq == nil { - return api.ErrMalformed - } - u.HandleWebrtcIceCandidate(*rq) + err = api.Do(x, u.HandleWebrtcIceCandidate) case api.StartGame: - rq := api.Unwrap[api.GameStartUserRequest](payload) - if rq == nil { - return api.ErrMalformed - } - u.HandleStartGame(*rq, conf) + err = api.Do(x, func(d api.GameStartUserRequest) { u.HandleStartGame(d, conf) }) case api.QuitGame: - rq := api.Unwrap[api.GameQuitRequest[com.Uid]](payload) - if rq == nil { - return api.ErrMalformed - } - u.HandleQuitGame(*rq) + err = api.Do(x, u.HandleQuitGame) case api.SaveGame: - return u.HandleSaveGame() + err = u.HandleSaveGame() case api.LoadGame: - return u.HandleLoadGame() + err = u.HandleLoadGame() case api.ChangePlayer: - rq := api.Unwrap[api.ChangePlayerUserRequest](payload) - if rq == nil { - return api.ErrMalformed - } - u.HandleChangePlayer(*rq) + err = api.Do(x, u.HandleChangePlayer) case api.ResetGame: - rq := api.Unwrap[api.ResetGameRequest[com.Uid]](payload) - if rq == nil { - return api.ErrMalformed - } - u.HandleResetGame(*rq) + err = api.Do(x, u.HandleResetGame) case api.RecordGame: if !conf.Recording.Enabled { return api.ErrForbidden } - rq := api.Unwrap[api.RecordGameRequest[com.Uid]](payload) - if rq == nil { - return api.ErrMalformed - } - u.HandleRecordGame(*rq) + err = api.Do(x, u.HandleRecordGame) case api.GetWorkerList: u.handleGetWorkerList(conf.Coordinator.Debug, info) default: u.log.Warn().Msgf("Unknown packet: %+v", x) } - return nil + return }) } diff --git a/pkg/coordinator/userapi.go b/pkg/coordinator/userapi.go index 047fe1d1..fd8b7235 100644 --- a/pkg/coordinator/userapi.go +++ b/pkg/coordinator/userapi.go @@ -10,15 +10,11 @@ import ( // CheckLatency sends a list of server addresses to the user // and waits get back this list with tested ping times for each server. func (u *User) CheckLatency(req api.CheckLatencyUserResponse) (api.CheckLatencyUserRequest, error) { - data, err := u.Send(api.CheckLatency, req) - if err != nil || data == nil { - return nil, err - } - dat := api.Unwrap[api.CheckLatencyUserRequest](data) + dat, err := api.UnwrapChecked[api.CheckLatencyUserRequest](u.Send(api.CheckLatency, req)) if dat == nil { return api.CheckLatencyUserRequest{}, err } - return *dat, err + return *dat, nil } // InitSession signals the user that the app is ready to go. diff --git a/pkg/coordinator/worker.go b/pkg/coordinator/worker.go index f4b2b2d0..e89d3dad 100644 --- a/pkg/coordinator/worker.go +++ b/pkg/coordinator/worker.go @@ -1,6 +1,7 @@ package coordinator import ( + "errors" "fmt" "sync/atomic" @@ -75,60 +76,35 @@ func NewWorker(sock *com.Connection, handshake api.ConnectionRequest[com.Uid], l } func (w *Worker) HandleRequests(users HasUserRegistry) chan struct{} { - return w.ProcessPackets(func(p api.In[com.Uid]) error { - payload := p.GetPayload() - switch p.GetType() { + return w.ProcessPackets(func(p api.In[com.Uid]) (err error) { + switch p.T { case api.RegisterRoom: - rq := api.Unwrap[api.RegisterRoomRequest](payload) - if rq == nil { - return api.ErrMalformed - } - w.log.Info().Msgf("set room [%v] = %v", w.Id(), *rq) - w.HandleRegisterRoom(*rq) + err = api.Do(p, func(d api.RegisterRoomRequest) { + w.log.Info().Msgf("set room [%v] = %v", w.Id(), d) + w.HandleRegisterRoom(d) + }) case api.CloseRoom: - rq := api.Unwrap[api.CloseRoomRequest](payload) - if rq == nil { - return api.ErrMalformed - } - w.HandleCloseRoom(*rq) + err = api.Do(p, w.HandleCloseRoom) case api.IceCandidate: - rq := api.Unwrap[api.WebrtcIceCandidateRequest[com.Uid]](payload) - if rq == nil { - return api.ErrMalformed - } - err := w.HandleIceCandidate(*rq, users) - if err != nil { - w.log.Error().Err(err).Send() - return api.ErrMalformed - } + err = api.DoE(p, func(d api.WebrtcIceCandidateRequest[com.Uid]) error { + return w.HandleIceCandidate(d, users) + }) case api.LibNewGameList: - inf := api.Unwrap[api.LibGameListInfo](payload) - if inf == nil { - return api.ErrMalformed - } - if err := w.HandleLibGameList(*inf); err != nil { - w.log.Error().Err(err).Send() - return api.ErrMalformed - } + err = api.DoE(p, w.HandleLibGameList) case api.PrevSessions: - sess := api.Unwrap[api.PrevSessionInfo](payload) - if sess == nil { - return api.ErrMalformed - } - if err := w.HandlePrevSessionList(*sess); err != nil { - w.log.Error().Err(err).Send() - return api.ErrMalformed - } + err = api.DoE(p, w.HandlePrevSessionList) default: w.log.Warn().Msgf("Unknown packet: %+v", p) } - return nil + if err != nil && !errors.Is(err, api.ErrMalformed) { + w.log.Error().Err(err).Send() + err = api.ErrMalformed + } + return }) } -func (w *Worker) SetLib(list []api.GameInfo) { - w.Lib = list -} +func (w *Worker) SetLib(list []api.GameInfo) { w.Lib = list } func (w *Worker) AppNames() []api.GameInfo { return w.Lib diff --git a/pkg/coordinator/workerapi.go b/pkg/coordinator/workerapi.go index 7a1ccf51..43205871 100644 --- a/pkg/coordinator/workerapi.go +++ b/pkg/coordinator/workerapi.go @@ -5,23 +5,27 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/com" ) +func (w *Worker) room(id com.Uid) api.StatefulRoom[com.Uid] { + return api.StateRoom(id, w.RoomId) +} + func (w *Worker) WebrtcInit(id com.Uid) (*api.WebrtcInitResponse, error) { return api.UnwrapChecked[api.WebrtcInitResponse]( - w.Send(api.WebrtcInit, api.WebrtcInitRequest[com.Uid]{Stateful: api.Stateful[com.Uid]{Id: id}})) + w.Send(api.WebrtcInit, api.WebrtcInitRequest[com.Uid]{Stateful: api.State(id)})) } func (w *Worker) WebrtcAnswer(id com.Uid, sdp string) { - w.Notify(api.WebrtcAnswer, api.WebrtcAnswerRequest[com.Uid]{Stateful: api.Stateful[com.Uid]{Id: id}, Sdp: sdp}) + w.Notify(api.WebrtcAnswer, api.WebrtcAnswerRequest[com.Uid]{Stateful: api.State(id), Sdp: sdp}) } func (w *Worker) WebrtcIceCandidate(id com.Uid, can string) { - w.Notify(api.WebrtcIce, api.WebrtcIceCandidateRequest[com.Uid]{Stateful: api.Stateful[com.Uid]{Id: id}, Candidate: can}) + w.Notify(api.WebrtcIce, api.WebrtcIceCandidateRequest[com.Uid]{Stateful: api.State(id), Candidate: can}) } func (w *Worker) StartGame(id com.Uid, req api.GameStartUserRequest) (*api.StartGameResponse, error) { return api.UnwrapChecked[api.StartGameResponse]( w.Send(api.StartGame, api.StartGameRequest[com.Uid]{ - StatefulRoom: StateRoom(id, req.RoomId), + StatefulRoom: api.StateRoom(id, req.RoomId), Game: req.GameName, PlayerIndex: req.PlayerIndex, Record: req.Record, @@ -30,37 +34,33 @@ func (w *Worker) StartGame(id com.Uid, req api.GameStartUserRequest) (*api.Start } func (w *Worker) QuitGame(id com.Uid) { - w.Notify(api.QuitGame, api.GameQuitRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId)}) + w.Notify(api.QuitGame, api.GameQuitRequest[com.Uid]{StatefulRoom: w.room(id)}) } func (w *Worker) SaveGame(id com.Uid) (*api.SaveGameResponse, error) { return api.UnwrapChecked[api.SaveGameResponse]( - w.Send(api.SaveGame, api.SaveGameRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId)})) + w.Send(api.SaveGame, api.SaveGameRequest[com.Uid]{StatefulRoom: w.room(id)})) } func (w *Worker) LoadGame(id com.Uid) (*api.LoadGameResponse, error) { return api.UnwrapChecked[api.LoadGameResponse]( - w.Send(api.LoadGame, api.LoadGameRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId)})) + w.Send(api.LoadGame, api.LoadGameRequest[com.Uid]{StatefulRoom: w.room(id)})) } func (w *Worker) ChangePlayer(id com.Uid, index int) (*api.ChangePlayerResponse, error) { return api.UnwrapChecked[api.ChangePlayerResponse]( - w.Send(api.ChangePlayer, api.ChangePlayerRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId), Index: index})) + w.Send(api.ChangePlayer, api.ChangePlayerRequest[com.Uid]{StatefulRoom: w.room(id), Index: index})) } func (w *Worker) ResetGame(id com.Uid) { - w.Notify(api.ResetGame, api.ResetGameRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId)}) + w.Notify(api.ResetGame, api.ResetGameRequest[com.Uid]{StatefulRoom: w.room(id)}) } func (w *Worker) RecordGame(id com.Uid, rec bool, recUser string) (*api.RecordGameResponse, error) { return api.UnwrapChecked[api.RecordGameResponse]( - w.Send(api.RecordGame, api.RecordGameRequest[com.Uid]{StatefulRoom: StateRoom(id, w.RoomId), Active: rec, User: recUser})) + w.Send(api.RecordGame, api.RecordGameRequest[com.Uid]{StatefulRoom: w.room(id), Active: rec, User: recUser})) } func (w *Worker) TerminateSession(id com.Uid) { - _, _ = w.Send(api.TerminateSession, api.TerminateSessionRequest[com.Uid]{Stateful: api.Stateful[com.Uid]{Id: id}}) -} - -func StateRoom[T api.Id](id T, rid string) api.StatefulRoom[T] { - return api.StatefulRoom[T]{Stateful: api.Stateful[T]{Id: id}, Room: api.Room{Rid: rid}} + _, _ = w.Send(api.TerminateSession, api.TerminateSessionRequest[com.Uid]{Stateful: api.State(id)}) } diff --git a/pkg/worker/coordinator.go b/pkg/worker/coordinator.go index 07963577..f56f84b4 100644 --- a/pkg/worker/coordinator.go +++ b/pkg/worker/coordinator.go @@ -67,84 +67,41 @@ func (c *coordinator) HandleRequests(w *Worker) chan struct{} { if err != nil { c.log.Panic().Err(err).Msg("WebRTC API creation has been failed") } - skipped := api.Out{} return c.ProcessPackets(func(x api.In[com.Uid]) (err error) { var out api.Out + switch x.T { case api.WebrtcInit: - if dat := api.Unwrap[api.WebrtcInitRequest[com.Uid]](x.Payload); dat == nil { - err, out = api.ErrMalformed, api.EmptyPacket - } else { - out = c.HandleWebrtcInit(*dat, w, ap) - } - case api.WebrtcAnswer: - dat := api.Unwrap[api.WebrtcAnswerRequest[com.Uid]](x.Payload) - if dat == nil { - return api.ErrMalformed - } - c.HandleWebrtcAnswer(*dat, w) - case api.WebrtcIce: - dat := api.Unwrap[api.WebrtcIceCandidateRequest[com.Uid]](x.Payload) - if dat == nil { - return api.ErrMalformed - } - c.HandleWebrtcIceCandidate(*dat, w) + err = api.Do(x, func(d api.WebrtcInitRequest[com.Uid]) { out = c.HandleWebrtcInit(d, w, ap) }) case api.StartGame: - if dat := api.Unwrap[api.StartGameRequest[com.Uid]](x.Payload); dat == nil { - err, out = api.ErrMalformed, api.EmptyPacket - } else { - out = c.HandleGameStart(*dat, w) - } - case api.TerminateSession: - dat := api.Unwrap[api.TerminateSessionRequest[com.Uid]](x.Payload) - if dat == nil { - return api.ErrMalformed - } - c.HandleTerminateSession(*dat, w) - case api.QuitGame: - dat := api.Unwrap[api.GameQuitRequest[com.Uid]](x.Payload) - if dat == nil { - return api.ErrMalformed - } - c.HandleQuitGame(*dat, w) + err = api.Do(x, func(d api.StartGameRequest[com.Uid]) { out = c.HandleGameStart(d, w) }) case api.SaveGame: - if dat := api.Unwrap[api.SaveGameRequest[com.Uid]](x.Payload); dat == nil { - err, out = api.ErrMalformed, api.EmptyPacket - } else { - out = c.HandleSaveGame(*dat, w) - } + err = api.Do(x, func(d api.SaveGameRequest[com.Uid]) { out = c.HandleSaveGame(d, w) }) case api.LoadGame: - if dat := api.Unwrap[api.LoadGameRequest[com.Uid]](x.Payload); dat == nil { - err, out = api.ErrMalformed, api.EmptyPacket - } else { - out = c.HandleLoadGame(*dat, w) - } + err = api.Do(x, func(d api.LoadGameRequest[com.Uid]) { out = c.HandleLoadGame(d, w) }) case api.ChangePlayer: - if dat := api.Unwrap[api.ChangePlayerRequest[com.Uid]](x.Payload); dat == nil { - err, out = api.ErrMalformed, api.EmptyPacket - } else { - out = c.HandleChangePlayer(*dat, w) - } - case api.ResetGame: - dat := api.Unwrap[api.ResetGameRequest[com.Uid]](x.Payload) - if dat == nil { - return api.ErrMalformed - } - c.HandleResetGame(*dat, w) + err = api.Do(x, func(d api.ChangePlayerRequest[com.Uid]) { out = c.HandleChangePlayer(d, w) }) case api.RecordGame: - if dat := api.Unwrap[api.RecordGameRequest[com.Uid]](x.Payload); dat == nil { - err, out = api.ErrMalformed, api.EmptyPacket - } else { - out = c.HandleRecordGame(*dat, w) - } + err = api.Do(x, func(d api.RecordGameRequest[com.Uid]) { out = c.HandleRecordGame(d, w) }) + case api.WebrtcAnswer: + err = api.Do(x, func(d api.WebrtcAnswerRequest[com.Uid]) { c.HandleWebrtcAnswer(d, w) }) + case api.WebrtcIce: + err = api.Do(x, func(d api.WebrtcIceCandidateRequest[com.Uid]) { c.HandleWebrtcIceCandidate(d, w) }) + case api.TerminateSession: + err = api.Do(x, func(d api.TerminateSessionRequest[com.Uid]) { c.HandleTerminateSession(d, w) }) + case api.QuitGame: + err = api.Do(x, func(d api.GameQuitRequest[com.Uid]) { c.HandleQuitGame(d, w) }) + case api.ResetGame: + err = api.Do(x, func(d api.ResetGameRequest[com.Uid]) { c.HandleResetGame(d, w) }) default: c.log.Warn().Msgf("unhandled packet type %v", x.T) } - if out != skipped { + + if out != (api.Out{}) { w.cord.Route(x, &out) } - return err + return }) } From baa9bad6f8dae096126dc01459576bcfaf2bca33 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Mon, 22 Dec 2025 15:38:17 +0300 Subject: [PATCH 354/361] Update dependencies --- go.mod | 4 ++-- go.sum | 4 ++++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/go.mod b/go.mod index 7763a58c..5cfb890b 100644 --- a/go.mod +++ b/go.mod @@ -44,9 +44,9 @@ require ( github.com/pion/mdns/v2 v2.1.0 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.16 // indirect - github.com/pion/rtp v1.8.26 // indirect + github.com/pion/rtp v1.8.27 // indirect github.com/pion/sctp v1.8.41 // indirect - github.com/pion/sdp/v3 v3.0.16 // indirect + github.com/pion/sdp/v3 v3.0.17 // indirect github.com/pion/srtp/v3 v3.0.9 // indirect github.com/pion/stun/v3 v3.0.2 // indirect github.com/pion/transport/v3 v3.1.1 // indirect diff --git a/go.sum b/go.sum index b5ab82f5..e104a47a 100644 --- a/go.sum +++ b/go.sum @@ -74,10 +74,14 @@ github.com/pion/rtcp v1.2.16 h1:fk1B1dNW4hsI78XUCljZJlC4kZOPk67mNRuQ0fcEkSo= github.com/pion/rtcp v1.2.16/go.mod h1:/as7VKfYbs5NIb4h6muQ35kQF/J0ZVNz2Z3xKoCBYOo= github.com/pion/rtp v1.8.26 h1:VB+ESQFQhBXFytD+Gk8cxB6dXeVf2WQzg4aORvAvAAc= github.com/pion/rtp v1.8.26/go.mod h1:rF5nS1GqbR7H/TCpKwylzeq6yDM+MM6k+On5EgeThEM= +github.com/pion/rtp v1.8.27 h1:kbWTdZr62RDlYjatVAW4qFwrAu9XcGnwMsofCfAHlOU= +github.com/pion/rtp v1.8.27/go.mod h1:rF5nS1GqbR7H/TCpKwylzeq6yDM+MM6k+On5EgeThEM= github.com/pion/sctp v1.8.41 h1:20R4OHAno4Vky3/iE4xccInAScAa83X6nWUfyc65MIs= github.com/pion/sctp v1.8.41/go.mod h1:2wO6HBycUH7iCssuGyc2e9+0giXVW0pyCv3ZuL8LiyY= github.com/pion/sdp/v3 v3.0.16 h1:0dKzYO6gTAvuLaAKQkC02eCPjMIi4NuAr/ibAwrGDCo= github.com/pion/sdp/v3 v3.0.16/go.mod h1:9tyKzznud3qiweZcD86kS0ff1pGYB3VX+Bcsmkx6IXo= +github.com/pion/sdp/v3 v3.0.17 h1:9SfLAW/fF1XC8yRqQ3iWGzxkySxup4k4V7yN8Fs8nuo= +github.com/pion/sdp/v3 v3.0.17/go.mod h1:9tyKzznud3qiweZcD86kS0ff1pGYB3VX+Bcsmkx6IXo= github.com/pion/srtp/v3 v3.0.9 h1:lRGF4G61xxj+m/YluB3ZnBpiALSri2lTzba0kGZMrQY= github.com/pion/srtp/v3 v3.0.9/go.mod h1:E+AuWd7Ug2Fp5u38MKnhduvpVkveXJX6J4Lq4rxUYt8= github.com/pion/stun/v3 v3.0.2 h1:BJuGEN2oLrJisiNEJtUTJC4BGbzbfp37LizfqswblFU= From 059e19d7903c29ce14a41a795ea8f2d57c8998ee Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Wed, 24 Dec 2025 21:23:19 +0300 Subject: [PATCH 355/361] Remove com.Uid from the API --- pkg/api/api.go | 20 +++------- pkg/api/worker.go | 54 ++++++++++---------------- pkg/com/com.go | 17 ++++++-- pkg/com/net.go | 1 - pkg/coordinator/user.go | 2 +- pkg/coordinator/userhandlers.go | 32 ++++++++-------- pkg/coordinator/worker.go | 4 +- pkg/coordinator/workerapi.go | 64 ++++++++++++++++--------------- pkg/coordinator/workerhandlers.go | 9 ++--- pkg/worker/coordinator.go | 29 +++++++------- pkg/worker/coordinatorhandlers.go | 30 +++++++-------- pkg/worker/room/cast.go | 2 +- pkg/worker/room/room.go | 18 ++++----- pkg/worker/room/room_test.go | 2 +- pkg/worker/room/router_test.go | 18 +++++---- 15 files changed, 149 insertions(+), 153 deletions(-) diff --git a/pkg/api/api.go b/pkg/api/api.go index 93fedb17..6605a188 100644 --- a/pkg/api/api.go +++ b/pkg/api/api.go @@ -26,27 +26,19 @@ type ( Id interface { String() string } - Stateful[T Id] struct { - Id T `json:"id"` + Stateful struct { + Id string `json:"id"` } Room struct { - Rid string `json:"room_id"` // room id + Rid string `json:"room_id"` } - StatefulRoom[T Id] struct { - Stateful[T] - Room + StatefulRoom struct { + Id string `json:"id"` + Rid string `json:"room_id"` } PT uint8 ) -func State[T Id](id T) Stateful[T] { - return Stateful[T]{Id: id} -} - -func StateRoom[T Id](id T, rid string) StatefulRoom[T] { - return StatefulRoom[T]{Stateful: State(id), Room: Room{Rid: rid}} -} - type In[I Id] struct { Id I `json:"id,omitempty"` T PT `json:"t"` diff --git a/pkg/api/worker.go b/pkg/api/worker.go index 189daf66..c498009d 100644 --- a/pkg/api/worker.go +++ b/pkg/api/worker.go @@ -1,28 +1,20 @@ package api type ( - ChangePlayerRequest[T Id] struct { - StatefulRoom[T] + ChangePlayerRequest struct { + StatefulRoom Index int `json:"index"` } - ChangePlayerResponse int - GameQuitRequest[T Id] struct { - StatefulRoom[T] - } - LoadGameRequest[T Id] struct { - StatefulRoom[T] - } - LoadGameResponse string - ResetGameRequest[T Id] struct { - StatefulRoom[T] - } - ResetGameResponse string - SaveGameRequest[T Id] struct { - StatefulRoom[T] - } - SaveGameResponse string - StartGameRequest[T Id] struct { - StatefulRoom[T] + ChangePlayerResponse int + GameQuitRequest StatefulRoom + LoadGameRequest StatefulRoom + LoadGameResponse string + ResetGameRequest StatefulRoom + ResetGameResponse string + SaveGameRequest StatefulRoom + SaveGameResponse string + StartGameRequest struct { + StatefulRoom Record bool RecordUser string Game string `json:"game"` @@ -42,26 +34,22 @@ type ( Record bool `json:"record"` KbMouse bool `json:"kb_mouse"` } - RecordGameRequest[T Id] struct { - StatefulRoom[T] + RecordGameRequest struct { + StatefulRoom Active bool `json:"active"` User string `json:"user"` } - RecordGameResponse string - TerminateSessionRequest[T Id] struct { - Stateful[T] - } - WebrtcAnswerRequest[T Id] struct { - Stateful[T] + RecordGameResponse string + TerminateSessionRequest Stateful + WebrtcAnswerRequest struct { + Stateful Sdp string `json:"sdp"` } - WebrtcIceCandidateRequest[T Id] struct { - Stateful[T] + WebrtcIceCandidateRequest struct { + Stateful Candidate string `json:"candidate"` // Base64-encoded ICE candidate } - WebrtcInitRequest[T Id] struct { - Stateful[T] - } + WebrtcInitRequest Stateful WebrtcInitResponse string AppVideoInfo struct { diff --git a/pkg/com/com.go b/pkg/com/com.go index bbeaa0d3..8b475622 100644 --- a/pkg/com/com.go +++ b/pkg/com/com.go @@ -2,14 +2,19 @@ package com import "github.com/giongto35/cloud-game/v3/pkg/logger" -type NetClient[K comparable] interface { +type stringer interface { + comparable + String() string +} + +type NetClient[K stringer] interface { Disconnect() Id() K } -type NetMap[K comparable, T NetClient[K]] struct{ Map[K, T] } +type NetMap[K stringer, T NetClient[K]] struct{ Map[K, T] } -func NewNetMap[K comparable, T NetClient[K]]() NetMap[K, T] { +func NewNetMap[K stringer, T NetClient[K]]() NetMap[K, T] { return NetMap[K, T]{Map: Map[K, T]{m: make(map[K]T, 10)}} } @@ -19,6 +24,12 @@ func (m *NetMap[K, T]) Remove(client T) { m.Map.Remove(client.Id()) } func (m *NetMap[K, T]) RemoveL(client T) int { return m.Map.RemoveL(client.Id()) } func (m *NetMap[K, T]) Reset() { m.Map = Map[K, T]{m: make(map[K]T, 10)} } func (m *NetMap[K, T]) RemoveDisconnect(client T) { client.Disconnect(); m.Remove(client) } +func (m *NetMap[K, T]) Find(id string) T { + v, _ := m.Map.FindBy(func(v T) bool { + return v.Id().String() == id + }) + return v +} type SocketClient[T ~uint8, P Packet[T], X any, P2 Packet2[X]] struct { id Uid diff --git a/pkg/com/net.go b/pkg/com/net.go index 04ed7e54..722ce9b5 100644 --- a/pkg/com/net.go +++ b/pkg/com/net.go @@ -29,7 +29,6 @@ func UidFromString(id string) (Uid, error) { } func (u Uid) Short() string { return u.String()[:3] + "." + u.String()[len(u.String())-3:] } -func (u Uid) Id() string { return u.String() } type HasCallId interface { SetGetId(fmt.Stringer) diff --git a/pkg/coordinator/user.go b/pkg/coordinator/user.go index 2a4f1e98..e1efef49 100644 --- a/pkg/coordinator/user.go +++ b/pkg/coordinator/user.go @@ -39,7 +39,7 @@ func (u *User) Bind(w *Worker) bool { func (u *User) Disconnect() { u.Connection.Disconnect() if u.w != nil { - u.w.TerminateSession(u.Id()) + u.w.TerminateSession(u.Id().String()) } } diff --git a/pkg/coordinator/userhandlers.go b/pkg/coordinator/userhandlers.go index 80d0dc6e..6dddd30e 100644 --- a/pkg/coordinator/userhandlers.go +++ b/pkg/coordinator/userhandlers.go @@ -5,12 +5,12 @@ import ( "time" "github.com/giongto35/cloud-game/v3/pkg/api" - "github.com/giongto35/cloud-game/v3/pkg/com" "github.com/giongto35/cloud-game/v3/pkg/config" ) func (u *User) HandleWebrtcInit() { - resp, err := u.w.WebrtcInit(u.Id()) + uid := u.Id().String() + resp, err := u.w.WebrtcInit(uid) if err != nil || resp == nil || *resp == api.EMPTY { u.log.Error().Err(err).Msg("malformed WebRTC init response") return @@ -19,11 +19,11 @@ func (u *User) HandleWebrtcInit() { } func (u *User) HandleWebrtcAnswer(rq api.WebrtcAnswerUserRequest) { - u.w.WebrtcAnswer(u.Id(), string(rq)) + u.w.WebrtcAnswer(u.Id().String(), string(rq)) } func (u *User) HandleWebrtcIceCandidate(rq api.WebrtcUserIceCandidate) { - u.w.WebrtcIceCandidate(u.Id(), string(rq)) + u.w.WebrtcIceCandidate(u.Id().String(), string(rq)) } func (u *User) HandleStartGame(rq api.GameStartUserRequest, conf config.CoordinatorConfig) { @@ -76,7 +76,7 @@ func (u *User) HandleStartGame(rq api.GameStartUserRequest, conf config.Coordina } } - startGameResp, err := u.w.StartGame(u.Id(), rq) + startGameResp, err := u.w.StartGame(u.Id().String(), rq) if err != nil || startGameResp == nil { u.log.Error().Err(err).Msg("malformed game start response") return @@ -94,21 +94,21 @@ func (u *User) HandleStartGame(rq api.GameStartUserRequest, conf config.Coordina } } -func (u *User) HandleQuitGame(rq api.GameQuitRequest[com.Uid]) { - if rq.Room.Rid == u.w.RoomId { - u.w.QuitGame(u.Id()) +func (u *User) HandleQuitGame(rq api.GameQuitRequest) { + if rq.Rid == u.w.RoomId { + u.w.QuitGame(u.Id().String()) } } -func (u *User) HandleResetGame(rq api.ResetGameRequest[com.Uid]) { - if rq.Room.Rid != u.w.RoomId { +func (u *User) HandleResetGame(rq api.ResetGameRequest) { + if rq.Rid != u.w.RoomId { return } - u.w.ResetGame(u.Id()) + u.w.ResetGame(u.Id().String()) } func (u *User) HandleSaveGame() error { - resp, err := u.w.SaveGame(u.Id()) + resp, err := u.w.SaveGame(u.Id().String()) if err != nil { return err } @@ -124,7 +124,7 @@ func (u *User) HandleSaveGame() error { } func (u *User) HandleLoadGame() error { - resp, err := u.w.LoadGame(u.Id()) + resp, err := u.w.LoadGame(u.Id().String()) if err != nil { return err } @@ -133,7 +133,7 @@ func (u *User) HandleLoadGame() error { } func (u *User) HandleChangePlayer(rq api.ChangePlayerUserRequest) { - resp, err := u.w.ChangePlayer(u.Id(), int(rq)) + resp, err := u.w.ChangePlayer(u.Id().String(), int(rq)) // !to make it a little less convoluted if err != nil || resp == nil || *resp == -1 { u.log.Error().Err(err).Msgf("player select fail, req: %v", rq) @@ -142,7 +142,7 @@ func (u *User) HandleChangePlayer(rq api.ChangePlayerUserRequest) { u.Notify(api.ChangePlayer, rq) } -func (u *User) HandleRecordGame(rq api.RecordGameRequest[com.Uid]) { +func (u *User) HandleRecordGame(rq api.RecordGameRequest) { if u.w == nil { return } @@ -154,7 +154,7 @@ func (u *User) HandleRecordGame(rq api.RecordGameRequest[com.Uid]) { return } - resp, err := u.w.RecordGame(u.Id(), rq.Active, rq.User) + resp, err := u.w.RecordGame(u.Id().String(), rq.Active, rq.User) if err != nil { u.log.Error().Err(err).Msg("malformed game record request") return diff --git a/pkg/coordinator/worker.go b/pkg/coordinator/worker.go index e89d3dad..137d7777 100644 --- a/pkg/coordinator/worker.go +++ b/pkg/coordinator/worker.go @@ -35,7 +35,7 @@ type RegionalClient interface { } type HasUserRegistry interface { - Find(com.Uid) *User + Find(id string) *User } type AppLibrary interface { @@ -86,7 +86,7 @@ func (w *Worker) HandleRequests(users HasUserRegistry) chan struct{} { case api.CloseRoom: err = api.Do(p, w.HandleCloseRoom) case api.IceCandidate: - err = api.DoE(p, func(d api.WebrtcIceCandidateRequest[com.Uid]) error { + err = api.DoE(p, func(d api.WebrtcIceCandidateRequest) error { return w.HandleIceCandidate(d, users) }) case api.LibNewGameList: diff --git a/pkg/coordinator/workerapi.go b/pkg/coordinator/workerapi.go index 43205871..ccf8c700 100644 --- a/pkg/coordinator/workerapi.go +++ b/pkg/coordinator/workerapi.go @@ -1,31 +1,26 @@ package coordinator -import ( - "github.com/giongto35/cloud-game/v3/pkg/api" - "github.com/giongto35/cloud-game/v3/pkg/com" -) +import "github.com/giongto35/cloud-game/v3/pkg/api" -func (w *Worker) room(id com.Uid) api.StatefulRoom[com.Uid] { - return api.StateRoom(id, w.RoomId) -} - -func (w *Worker) WebrtcInit(id com.Uid) (*api.WebrtcInitResponse, error) { +func (w *Worker) WebrtcInit(id string) (*api.WebrtcInitResponse, error) { return api.UnwrapChecked[api.WebrtcInitResponse]( - w.Send(api.WebrtcInit, api.WebrtcInitRequest[com.Uid]{Stateful: api.State(id)})) + w.Send(api.WebrtcInit, api.WebrtcInitRequest{Id: id})) } -func (w *Worker) WebrtcAnswer(id com.Uid, sdp string) { - w.Notify(api.WebrtcAnswer, api.WebrtcAnswerRequest[com.Uid]{Stateful: api.State(id), Sdp: sdp}) +func (w *Worker) WebrtcAnswer(id string, sdp string) { + w.Notify(api.WebrtcAnswer, + api.WebrtcAnswerRequest{Stateful: api.Stateful{Id: id}, Sdp: sdp}) } -func (w *Worker) WebrtcIceCandidate(id com.Uid, can string) { - w.Notify(api.WebrtcIce, api.WebrtcIceCandidateRequest[com.Uid]{Stateful: api.State(id), Candidate: can}) +func (w *Worker) WebrtcIceCandidate(id string, candidate string) { + w.Notify(api.WebrtcIce, + api.WebrtcIceCandidateRequest{Stateful: api.Stateful{Id: id}, Candidate: candidate}) } -func (w *Worker) StartGame(id com.Uid, req api.GameStartUserRequest) (*api.StartGameResponse, error) { +func (w *Worker) StartGame(id string, req api.GameStartUserRequest) (*api.StartGameResponse, error) { return api.UnwrapChecked[api.StartGameResponse]( - w.Send(api.StartGame, api.StartGameRequest[com.Uid]{ - StatefulRoom: api.StateRoom(id, req.RoomId), + w.Send(api.StartGame, api.StartGameRequest{ + StatefulRoom: api.StatefulRoom{Id: id, Rid: req.RoomId}, Game: req.GameName, PlayerIndex: req.PlayerIndex, Record: req.Record, @@ -33,34 +28,41 @@ func (w *Worker) StartGame(id com.Uid, req api.GameStartUserRequest) (*api.Start })) } -func (w *Worker) QuitGame(id com.Uid) { - w.Notify(api.QuitGame, api.GameQuitRequest[com.Uid]{StatefulRoom: w.room(id)}) +func (w *Worker) QuitGame(id string) { + w.Notify(api.QuitGame, api.GameQuitRequest{Id: id, Rid: w.RoomId}) } -func (w *Worker) SaveGame(id com.Uid) (*api.SaveGameResponse, error) { +func (w *Worker) SaveGame(id string) (*api.SaveGameResponse, error) { return api.UnwrapChecked[api.SaveGameResponse]( - w.Send(api.SaveGame, api.SaveGameRequest[com.Uid]{StatefulRoom: w.room(id)})) + w.Send(api.SaveGame, api.SaveGameRequest{Id: id, Rid: w.RoomId})) } -func (w *Worker) LoadGame(id com.Uid) (*api.LoadGameResponse, error) { +func (w *Worker) LoadGame(id string) (*api.LoadGameResponse, error) { return api.UnwrapChecked[api.LoadGameResponse]( - w.Send(api.LoadGame, api.LoadGameRequest[com.Uid]{StatefulRoom: w.room(id)})) + w.Send(api.LoadGame, api.LoadGameRequest{Id: id, Rid: w.RoomId})) } -func (w *Worker) ChangePlayer(id com.Uid, index int) (*api.ChangePlayerResponse, error) { +func (w *Worker) ChangePlayer(id string, index int) (*api.ChangePlayerResponse, error) { return api.UnwrapChecked[api.ChangePlayerResponse]( - w.Send(api.ChangePlayer, api.ChangePlayerRequest[com.Uid]{StatefulRoom: w.room(id), Index: index})) + w.Send(api.ChangePlayer, api.ChangePlayerRequest{ + StatefulRoom: api.StatefulRoom{Id: id, Rid: w.RoomId}, + Index: index, + })) } -func (w *Worker) ResetGame(id com.Uid) { - w.Notify(api.ResetGame, api.ResetGameRequest[com.Uid]{StatefulRoom: w.room(id)}) +func (w *Worker) ResetGame(id string) { + w.Notify(api.ResetGame, api.ResetGameRequest{Id: id, Rid: w.RoomId}) } -func (w *Worker) RecordGame(id com.Uid, rec bool, recUser string) (*api.RecordGameResponse, error) { +func (w *Worker) RecordGame(id string, rec bool, recUser string) (*api.RecordGameResponse, error) { return api.UnwrapChecked[api.RecordGameResponse]( - w.Send(api.RecordGame, api.RecordGameRequest[com.Uid]{StatefulRoom: w.room(id), Active: rec, User: recUser})) + w.Send(api.RecordGame, api.RecordGameRequest{ + StatefulRoom: api.StatefulRoom{Id: id, Rid: w.RoomId}, + Active: rec, + User: recUser, + })) } -func (w *Worker) TerminateSession(id com.Uid) { - _, _ = w.Send(api.TerminateSession, api.TerminateSessionRequest[com.Uid]{Stateful: api.State(id)}) +func (w *Worker) TerminateSession(id string) { + _, _ = w.Send(api.TerminateSession, api.TerminateSessionRequest{Id: id}) } diff --git a/pkg/coordinator/workerhandlers.go b/pkg/coordinator/workerhandlers.go index edd7e210..35609e06 100644 --- a/pkg/coordinator/workerhandlers.go +++ b/pkg/coordinator/workerhandlers.go @@ -1,9 +1,6 @@ package coordinator -import ( - "github.com/giongto35/cloud-game/v3/pkg/api" - "github.com/giongto35/cloud-game/v3/pkg/com" -) +import "github.com/giongto35/cloud-game/v3/pkg/api" func (w *Worker) HandleRegisterRoom(rq api.RegisterRoomRequest) { w.RoomId = string(rq) } @@ -14,11 +11,11 @@ func (w *Worker) HandleCloseRoom(rq api.CloseRoomRequest) { } } -func (w *Worker) HandleIceCandidate(rq api.WebrtcIceCandidateRequest[com.Uid], users HasUserRegistry) error { +func (w *Worker) HandleIceCandidate(rq api.WebrtcIceCandidateRequest, users HasUserRegistry) error { if usr := users.Find(rq.Id); usr != nil { usr.SendWebrtcIceCandidate(rq.Candidate) } else { - w.log.Warn().Str("id", rq.Id.String()).Msg("unknown session") + w.log.Warn().Str("id", rq.Id).Msg("unknown session") } return nil } diff --git a/pkg/worker/coordinator.go b/pkg/worker/coordinator.go index f56f84b4..bd5cd3e1 100644 --- a/pkg/worker/coordinator.go +++ b/pkg/worker/coordinator.go @@ -73,27 +73,27 @@ func (c *coordinator) HandleRequests(w *Worker) chan struct{} { switch x.T { case api.WebrtcInit: - err = api.Do(x, func(d api.WebrtcInitRequest[com.Uid]) { out = c.HandleWebrtcInit(d, w, ap) }) + err = api.Do(x, func(d api.WebrtcInitRequest) { out = c.HandleWebrtcInit(d, w, ap) }) case api.StartGame: - err = api.Do(x, func(d api.StartGameRequest[com.Uid]) { out = c.HandleGameStart(d, w) }) + err = api.Do(x, func(d api.StartGameRequest) { out = c.HandleGameStart(d, w) }) case api.SaveGame: - err = api.Do(x, func(d api.SaveGameRequest[com.Uid]) { out = c.HandleSaveGame(d, w) }) + err = api.Do(x, func(d api.SaveGameRequest) { out = c.HandleSaveGame(d, w) }) case api.LoadGame: - err = api.Do(x, func(d api.LoadGameRequest[com.Uid]) { out = c.HandleLoadGame(d, w) }) + err = api.Do(x, func(d api.LoadGameRequest) { out = c.HandleLoadGame(d, w) }) case api.ChangePlayer: - err = api.Do(x, func(d api.ChangePlayerRequest[com.Uid]) { out = c.HandleChangePlayer(d, w) }) + err = api.Do(x, func(d api.ChangePlayerRequest) { out = c.HandleChangePlayer(d, w) }) case api.RecordGame: - err = api.Do(x, func(d api.RecordGameRequest[com.Uid]) { out = c.HandleRecordGame(d, w) }) + err = api.Do(x, func(d api.RecordGameRequest) { out = c.HandleRecordGame(d, w) }) case api.WebrtcAnswer: - err = api.Do(x, func(d api.WebrtcAnswerRequest[com.Uid]) { c.HandleWebrtcAnswer(d, w) }) + err = api.Do(x, func(d api.WebrtcAnswerRequest) { c.HandleWebrtcAnswer(d, w) }) case api.WebrtcIce: - err = api.Do(x, func(d api.WebrtcIceCandidateRequest[com.Uid]) { c.HandleWebrtcIceCandidate(d, w) }) + err = api.Do(x, func(d api.WebrtcIceCandidateRequest) { c.HandleWebrtcIceCandidate(d, w) }) case api.TerminateSession: - err = api.Do(x, func(d api.TerminateSessionRequest[com.Uid]) { c.HandleTerminateSession(d, w) }) + err = api.Do(x, func(d api.TerminateSessionRequest) { c.HandleTerminateSession(d, w) }) case api.QuitGame: - err = api.Do(x, func(d api.GameQuitRequest[com.Uid]) { c.HandleQuitGame(d, w) }) + err = api.Do(x, func(d api.GameQuitRequest) { c.HandleQuitGame(d, w) }) case api.ResetGame: - err = api.Do(x, func(d api.ResetGameRequest[com.Uid]) { c.HandleResetGame(d, w) }) + err = api.Do(x, func(d api.ResetGameRequest) { c.HandleResetGame(d, w) }) default: c.log.Warn().Msgf("unhandled packet type %v", x.T) } @@ -109,8 +109,11 @@ func (c *coordinator) RegisterRoom(id string) { c.Notify(api.RegisterRoom, id) } // CloseRoom sends a signal to coordinator which will remove that room from its list. func (c *coordinator) CloseRoom(id string) { c.Notify(api.CloseRoom, id) } -func (c *coordinator) IceCandidate(candidate string, sessionId com.Uid) { - c.Notify(api.WebrtcIce, api.WebrtcIceCandidateRequest[com.Uid]{Stateful: api.Stateful[com.Uid]{Id: sessionId}, Candidate: candidate}) +func (c *coordinator) IceCandidate(candidate string, sessionId string) { + c.Notify(api.WebrtcIce, api.WebrtcIceCandidateRequest{ + Stateful: api.Stateful{Id: sessionId}, + Candidate: candidate, + }) } func (c *coordinator) SendLibrary(w *Worker) { diff --git a/pkg/worker/coordinatorhandlers.go b/pkg/worker/coordinatorhandlers.go index 536c6ed6..d8e30a0e 100644 --- a/pkg/worker/coordinatorhandlers.go +++ b/pkg/worker/coordinatorhandlers.go @@ -28,7 +28,7 @@ func buildConnQuery(id com.Uid, conf config.Worker, address string) (string, err }) } -func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest[com.Uid], w *Worker, factory *webrtc.ApiFactory) api.Out { +func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest, w *Worker, factory *webrtc.ApiFactory) api.Out { peer := webrtc.New(c.log, factory) localSDP, err := peer.NewCall(w.conf.Encoder.Video.Codec, "opus", func(data any) { candidate, err := toBase64Json(data) @@ -55,7 +55,7 @@ func (c *coordinator) HandleWebrtcInit(rq api.WebrtcInitRequest[com.Uid], w *Wor return api.Out{Payload: sdp} } -func (c *coordinator) HandleWebrtcAnswer(rq api.WebrtcAnswerRequest[com.Uid], w *Worker) { +func (c *coordinator) HandleWebrtcAnswer(rq api.WebrtcAnswerRequest, w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { if err := room.WithWebRTC(user.Session).SetRemoteSDP(rq.Sdp, fromBase64Json); err != nil { c.log.Error().Err(err).Msgf("cannot set remote SDP of client [%v]", rq.Id) @@ -63,7 +63,7 @@ func (c *coordinator) HandleWebrtcAnswer(rq api.WebrtcAnswerRequest[com.Uid], w } } -func (c *coordinator) HandleWebrtcIceCandidate(rs api.WebrtcIceCandidateRequest[com.Uid], w *Worker) { +func (c *coordinator) HandleWebrtcIceCandidate(rs api.WebrtcIceCandidateRequest, w *Worker) { if user := w.router.FindUser(rs.Id); user != nil { if err := room.WithWebRTC(user.Session).AddCandidate(rs.Candidate, fromBase64Json); err != nil { c.log.Error().Err(err).Msgf("cannot add ICE candidate of the client [%v]", rs.Id) @@ -71,7 +71,7 @@ func (c *coordinator) HandleWebrtcIceCandidate(rs api.WebrtcIceCandidateRequest[ } } -func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worker) api.Out { +func (c *coordinator) HandleGameStart(rq api.StartGameRequest, w *Worker) api.Out { user := w.router.FindUser(rq.Id) if user == nil { c.log.Error().Msgf("no user [%v]", rq.Id) @@ -79,14 +79,14 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke } user.Index = rq.PlayerIndex - r := w.router.FindRoom(rq.Room.Rid) + r := w.router.FindRoom(rq.Rid) // +injects game data into the original game request // the name of the game either in the `room id` field or // it's in the initial request gameName := rq.Game - if rq.Room.Rid != "" { - name := w.launcher.ExtractAppNameFromUrl(rq.Room.Rid) + if rq.Rid != "" { + name := w.launcher.ExtractAppNameFromUrl(rq.Rid) if name == "" { c.log.Warn().Msg("couldn't decode game name from the room id") return api.EmptyPacket @@ -101,7 +101,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke } if r == nil { // new room - uid := rq.Room.Rid + uid := rq.Rid if uid == "" { uid = games.GenerateRoomID(gameName) } @@ -218,7 +218,7 @@ func (c *coordinator) HandleGameStart(rq api.StartGameRequest[com.Uid], w *Worke } // HandleTerminateSession handles cases when a user has been disconnected from the websocket of coordinator. -func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com.Uid], w *Worker) { +func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest, w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) c.log.Debug().Msgf(">>> users: %v", w.router.Users()) @@ -227,14 +227,14 @@ func (c *coordinator) HandleTerminateSession(rq api.TerminateSessionRequest[com. } // HandleQuitGame handles cases when a user manually exits the game. -func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest[com.Uid], w *Worker) { +func (c *coordinator) HandleQuitGame(rq api.GameQuitRequest, w *Worker) { if user := w.router.FindUser(rq.Id); user != nil { w.router.Remove(user) c.log.Debug().Msgf(">>> users: %v", w.router.Users()) } } -func (c *coordinator) HandleResetGame(rq api.ResetGameRequest[com.Uid], w *Worker) api.Out { +func (c *coordinator) HandleResetGame(rq api.ResetGameRequest, w *Worker) api.Out { if r := w.router.FindRoom(rq.Rid); r != nil { room.WithEmulator(r.App()).Reset() return api.OkPacket @@ -242,7 +242,7 @@ func (c *coordinator) HandleResetGame(rq api.ResetGameRequest[com.Uid], w *Worke return api.ErrPacket } -func (c *coordinator) HandleSaveGame(rq api.SaveGameRequest[com.Uid], w *Worker) api.Out { +func (c *coordinator) HandleSaveGame(rq api.SaveGameRequest, w *Worker) api.Out { r := w.router.FindRoom(rq.Rid) if r == nil { return api.ErrPacket @@ -254,7 +254,7 @@ func (c *coordinator) HandleSaveGame(rq api.SaveGameRequest[com.Uid], w *Worker) return api.OkPacket } -func (c *coordinator) HandleLoadGame(rq api.LoadGameRequest[com.Uid], w *Worker) api.Out { +func (c *coordinator) HandleLoadGame(rq api.LoadGameRequest, w *Worker) api.Out { r := w.router.FindRoom(rq.Rid) if r == nil { return api.ErrPacket @@ -266,7 +266,7 @@ func (c *coordinator) HandleLoadGame(rq api.LoadGameRequest[com.Uid], w *Worker) return api.OkPacket } -func (c *coordinator) HandleChangePlayer(rq api.ChangePlayerRequest[com.Uid], w *Worker) api.Out { +func (c *coordinator) HandleChangePlayer(rq api.ChangePlayerRequest, w *Worker) api.Out { user := w.router.FindUser(rq.Id) if user == nil || w.router.FindRoom(rq.Rid) == nil { return api.Out{Payload: -1} // semi-predicates @@ -276,7 +276,7 @@ func (c *coordinator) HandleChangePlayer(rq api.ChangePlayerRequest[com.Uid], w return api.Out{Payload: rq.Index} } -func (c *coordinator) HandleRecordGame(rq api.RecordGameRequest[com.Uid], w *Worker) api.Out { +func (c *coordinator) HandleRecordGame(rq api.RecordGameRequest, w *Worker) api.Out { if !w.conf.Recording.Enabled { return api.ErrPacket } diff --git a/pkg/worker/room/cast.go b/pkg/worker/room/cast.go index d8a9710f..81a6c57d 100644 --- a/pkg/worker/room/cast.go +++ b/pkg/worker/room/cast.go @@ -11,7 +11,7 @@ type GameRouter struct { } func NewGameRouter() *GameRouter { - u := com.NewNetMap[string, *GameSession]() + u := com.NewNetMap[SessionKey, *GameSession]() return &GameRouter{Router: Router[*GameSession]{users: &u}} } diff --git a/pkg/worker/room/room.go b/pkg/worker/room/room.go index c2686bdc..88380683 100644 --- a/pkg/worker/room/room.go +++ b/pkg/worker/room/room.go @@ -41,9 +41,10 @@ type Session interface { SendData([]byte) } -type Uid interface { - Id() string -} +type SessionKey string + +func (s SessionKey) String() string { return string(s) } +func (s SessionKey) Id() string { return s.String() } type Room[T Session] struct { app app.App @@ -137,7 +138,7 @@ func (r *Router[T]) Remove(user T) { func (r *Router[T]) AddUser(user T) { r.users.Add(user) } func (r *Router[T]) Close() { r.mu.Lock(); r.room.Close(); r.room = nil; r.mu.Unlock() } -func (r *Router[T]) FindUser(uid Uid) T { return r.users.Find(uid.Id()) } +func (r *Router[T]) FindUser(uid string) T { return r.users.Find(uid) } func (r *Router[T]) Room() *Room[T] { r.mu.Lock(); defer r.mu.Unlock(); return r.room } func (r *Router[T]) SetRoom(room *Room[T]) { r.mu.Lock(); r.room = room; r.mu.Unlock() } func (r *Router[T]) HasRoom() bool { r.mu.Lock(); defer r.mu.Unlock(); return r.room != nil } @@ -156,18 +157,17 @@ func (r *Router[T]) Reset() { } type AppSession struct { - Uid Session - uid string + uid SessionKey } -func (p AppSession) Id() string { return p.uid } +func (p AppSession) Id() SessionKey { return p.uid } type GameSession struct { AppSession Index int // track user Index (i.e. player 1,2,3,4 select) } -func NewGameSession(id Uid, s Session) *GameSession { - return &GameSession{AppSession: AppSession{uid: id.Id(), Session: s}} +func NewGameSession(id string, s Session) *GameSession { + return &GameSession{AppSession: AppSession{uid: SessionKey(id), Session: s}} } diff --git a/pkg/worker/room/room_test.go b/pkg/worker/room/room_test.go index 9a4bdd73..7a537d69 100644 --- a/pkg/worker/room/room_test.go +++ b/pkg/worker/room/room_test.go @@ -236,7 +236,7 @@ func room(cfg conf) testRoom { l.Fatal().Err(err).Msgf("no init") } - room := NewRoom[*GameSession](id, emu, &com.NetMap[string, *GameSession]{}, m) + room := NewRoom[*GameSession](id, emu, &com.NetMap[SessionKey, *GameSession]{}, m) if cfg.autoAppStart { room.StartApp() } diff --git a/pkg/worker/room/router_test.go b/pkg/worker/room/router_test.go index 013f1e27..d4f2e621 100644 --- a/pkg/worker/room/router_test.go +++ b/pkg/worker/room/router_test.go @@ -6,8 +6,12 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/com" ) +type sKey string + +func (s sKey) String() string { return string(s) } + type tSession struct { - id string + id sKey connected bool } @@ -16,15 +20,15 @@ func (t *tSession) SendVideo([]byte, int32) {} func (t *tSession) SendData([]byte) {} func (t *tSession) Connect() { t.connected = true } func (t *tSession) Disconnect() { t.connected = false } -func (t *tSession) Id() string { return t.id } +func (t *tSession) Id() sKey { return t.id } type lookMap struct { - com.NetMap[string, *tSession] - prev com.NetMap[string, *tSession] // we could use pointers in the original :3 + com.NetMap[sKey, *tSession] + prev com.NetMap[sKey, *tSession] // we could use pointers in the original :3 } func (l *lookMap) Reset() { - l.prev = com.NewNetMap[string, *tSession]() + l.prev = com.NewNetMap[sKey, *tSession]() for s := range l.Map.Values() { l.prev.Add(s) } @@ -51,7 +55,7 @@ func TestRouter(t *testing.T) { } func TestRouterReset(t *testing.T) { - u := lookMap{NetMap: com.NewNetMap[string, *tSession]()} + u := lookMap{NetMap: com.NewNetMap[sKey, *tSession]()} router := Router[*tSession]{users: &u} router.AddUser(&tSession{id: "1", connected: true}) @@ -73,6 +77,6 @@ func TestRouterReset(t *testing.T) { } func newTestRouter() *Router[*tSession] { - u := com.NewNetMap[string, *tSession]() + u := com.NewNetMap[sKey, *tSession]() return &Router[*tSession]{users: &u} } From aeb41008c92ec8062ce36bf70341e7ae490e34ef Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Wed, 24 Dec 2025 21:25:03 +0300 Subject: [PATCH 356/361] Remove room watchers --- pkg/worker/watcher.go | 46 ------------------------------------------- pkg/worker/worker.go | 4 +--- 2 files changed, 1 insertion(+), 49 deletions(-) delete mode 100644 pkg/worker/watcher.go diff --git a/pkg/worker/watcher.go b/pkg/worker/watcher.go deleted file mode 100644 index 953b0036..00000000 --- a/pkg/worker/watcher.go +++ /dev/null @@ -1,46 +0,0 @@ -package worker - -import ( - "time" - - "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/worker/room" -) - -type Watcher struct { - r *room.GameRouter - t *time.Ticker - done chan struct{} - log *logger.Logger -} - -func NewWatcher(p time.Duration, router *room.GameRouter, log *logger.Logger) *Watcher { - return &Watcher{ - r: router, - t: time.NewTicker(p), - done: make(chan struct{}), - log: log, - } -} - -func (w *Watcher) Run() { - go func() { - for { - select { - case <-w.t.C: - if w.r.HasRoom() && w.r.Users().Empty() { - w.r.Close() - w.log.Warn().Msgf("Forced room close!") - } - case <-w.done: - return - } - } - }() -} - -func (w *Watcher) Stop() error { - w.t.Stop() - close(w.done) - return nil -} diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 28c29b60..0da257b2 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -3,7 +3,6 @@ package worker import ( "errors" "fmt" - "time" "github.com/giongto35/cloud-game/v3/pkg/config" "github.com/giongto35/cloud-game/v3/pkg/games" @@ -25,7 +24,7 @@ type Worker struct { log *logger.Logger mana *caged.Manager router *room.GameRouter - services [3]interface { + services [2]interface { Run() Stop() error } @@ -77,7 +76,6 @@ func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { log.Warn().Err(err).Msgf("cloud storage fail, using no storage") } worker.storage = st - worker.services[2] = NewWatcher(30*time.Minute, worker.router, log) return worker, nil } From 8754a5edfae0e061ebe5865eaba1f2c5fc0edc45 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 26 Dec 2025 16:17:37 +0300 Subject: [PATCH 357/361] Tweak OpenGL framebuffer Force alignment for GL ReadPixels and skip unbinding last framebuffer which makes it a bit faster. --- pkg/worker/caged/libretro/graphics/gl/gl.go | 11 +++++++++++ pkg/worker/caged/libretro/graphics/opengl.go | 4 ++-- 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/pkg/worker/caged/libretro/graphics/gl/gl.go b/pkg/worker/caged/libretro/graphics/gl/gl.go index d8f95a62..46e3842e 100644 --- a/pkg/worker/caged/libretro/graphics/gl/gl.go +++ b/pkg/worker/caged/libretro/graphics/gl/gl.go @@ -78,6 +78,7 @@ typedef void (APIENTRYP GPREADPIXELS)(GLint x, GLint y, GLsizei width, GLsizei h typedef void (APIENTRYP GPRENDERBUFFERSTORAGE)(GLenum target, GLenum internalformat, GLsizei width, GLsizei height); typedef void (APIENTRYP GPTEXIMAGE2D)(GLenum target, GLint level, GLint internalformat, GLsizei width, GLsizei height, GLint border, GLenum format, GLenum type, const void *pixels); typedef void (APIENTRYP GPTEXPARAMETERI)(GLenum target, GLenum pname, GLint param); +typedef void (APIENTRYP GPPIXELSTOREI)(GLenum pname, GLint param); static const GLubyte *getString(GPGETSTRING ptr, GLenum name) { return (*ptr)(name); } static GLenum getError(GPGETERROR ptr) { return (*ptr)(); } @@ -113,6 +114,7 @@ static void deleteTextures(GPDELETETEXTURES ptr, GLsizei n, const GLuint *textur static void readPixels(GPREADPIXELS ptr, GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, void *pixels) { (*ptr)(x, y, width, height, format, type, pixels); } +static void pixelStorei(GPPIXELSTOREI ptr, GLenum pname, GLint param) { (*ptr)(pname, param); } */ import "C" import ( @@ -144,6 +146,8 @@ const ( UnsignedShort5551 = 0x8034 UnsignedShort565 = 0x8363 UnsignedInt8888Rev = 0x8367 + + PackAlignment = 0x0D05 ) var ( @@ -165,6 +169,7 @@ var ( gpDeleteFramebuffers C.GPDELETEFRAMEBUFFERS gpDeleteTextures C.GPDELETETEXTURES gpReadPixels C.GPREADPIXELS + gpPixelStorei C.GPPIXELSTOREI ) func InitWithProcAddrFunc(getProcAddr func(name string) unsafe.Pointer) error { @@ -205,6 +210,9 @@ func InitWithProcAddrFunc(getProcAddr func(name string) unsafe.Pointer) error { if gpReadPixels == nil { return errors.New("glReadPixels") } + if gpPixelStorei = (C.GPPIXELSTOREI)(getProcAddr("glPixelStorei")); gpPixelStorei == nil { + return errors.New("glPixelStorei") + } return nil } @@ -257,6 +265,9 @@ func DeleteTextures(n int32, textures *uint32) { func ReadPixels(x int32, y int32, width int32, height int32, format uint32, xtype uint32, pixels unsafe.Pointer) { C.readPixels(gpReadPixels, (C.GLint)(x), (C.GLint)(y), (C.GLsizei)(width), (C.GLsizei)(height), (C.GLenum)(format), (C.GLenum)(xtype), pixels) } +func PixelStorei(pname uint32, param int32) { + C.pixelStorei(gpPixelStorei, (C.GLenum)(pname), (C.GLint)(param)) +} func GetError() uint32 { return (uint32)(C.getError(gpGetError)) } diff --git a/pkg/worker/caged/libretro/graphics/opengl.go b/pkg/worker/caged/libretro/graphics/opengl.go index 99eef10d..44a9a92f 100644 --- a/pkg/worker/caged/libretro/graphics/opengl.go +++ b/pkg/worker/caged/libretro/graphics/opengl.go @@ -110,10 +110,10 @@ func destroyFramebuffer() { } func ReadFramebuffer(bytes, w, h uint) []byte { - data := buf[:bytes] + data := buf[:bytes:bytes] + gl.PixelStorei(gl.PackAlignment, 1) gl.BindFramebuffer(gl.FRAMEBUFFER, opt.fbo) gl.ReadPixels(0, 0, int32(w), int32(h), opt.pixType, opt.pixFormat, unsafe.Pointer(&data[0])) - gl.BindFramebuffer(gl.FRAMEBUFFER, 0) return data } From 58a19affcba89f20085de852a3cf8b6aaf5551c0 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sat, 27 Dec 2025 01:58:14 +0300 Subject: [PATCH 358/361] Clean SDL/OpenGL functions --- pkg/worker/caged/libretro/graphics/opengl.go | 121 +++++-------- pkg/worker/caged/libretro/graphics/sdl.go | 166 +++++++----------- .../caged/libretro/nanoarch/nanoarch.go | 51 +++--- 3 files changed, 135 insertions(+), 203 deletions(-) diff --git a/pkg/worker/caged/libretro/graphics/opengl.go b/pkg/worker/caged/libretro/graphics/opengl.go index 44a9a92f..fca78a6b 100644 --- a/pkg/worker/caged/libretro/graphics/opengl.go +++ b/pkg/worker/caged/libretro/graphics/opengl.go @@ -9,24 +9,6 @@ import ( "github.com/giongto35/cloud-game/v3/pkg/worker/caged/libretro/graphics/gl" ) -type ( - offscreenSetup struct { - tex uint32 - fbo uint32 - rbo uint32 - - width int32 - height int32 - - pixType uint32 - pixFormat uint32 - - hasDepth bool - hasStencil bool - } - PixelFormat int -) - type Context int const ( @@ -37,11 +19,12 @@ const ( CtxOpenGlEs3 CtxOpenGlEsVersion CtxVulkan - CtxUnknown = math.MaxInt32 - 1 CtxDummy = math.MaxInt32 ) +type PixelFormat int + const ( UnsignedShort5551 PixelFormat = iota UnsignedShort565 @@ -49,99 +32,91 @@ const ( ) var ( - opt = offscreenSetup{} - buf = make([]byte, 1024*1024) + fbo, tex, rbo uint32 + hasDepth bool + pixType, pixFormat uint32 + buf []byte + bufPtr unsafe.Pointer ) func initContext(getProcAddr func(name string) unsafe.Pointer) { if err := gl.InitWithProcAddrFunc(getProcAddr); err != nil { panic(err) } + gl.PixelStorei(gl.PackAlignment, 1) } -func initFramebuffer(w int, h int, hasDepth bool, hasStencil bool) error { - opt.width = int32(w) - opt.height = int32(h) - opt.hasDepth = hasDepth - opt.hasStencil = hasStencil - - // texture init - gl.GenTextures(1, &opt.tex) - gl.BindTexture(gl.Texture2d, opt.tex) +func initFramebuffer(width, height int, depth, stencil bool) error { + w, h := int32(width), int32(height) + hasDepth = depth + gl.GenTextures(1, &tex) + gl.BindTexture(gl.Texture2d, tex) gl.TexParameteri(gl.Texture2d, gl.TextureMinFilter, gl.NEAREST) gl.TexParameteri(gl.Texture2d, gl.TextureMagFilter, gl.NEAREST) - - gl.TexImage2D(gl.Texture2d, 0, gl.RGBA8, opt.width, opt.height, 0, opt.pixType, opt.pixFormat, nil) + gl.TexImage2D(gl.Texture2d, 0, gl.RGBA8, w, h, 0, pixType, pixFormat, nil) gl.BindTexture(gl.Texture2d, 0) - // framebuffer init - gl.GenFramebuffers(1, &opt.fbo) - gl.BindFramebuffer(gl.FRAMEBUFFER, opt.fbo) + gl.GenFramebuffers(1, &fbo) + gl.BindFramebuffer(gl.FRAMEBUFFER, fbo) + gl.FramebufferTexture2D(gl.FRAMEBUFFER, gl.ColorAttachment0, gl.Texture2d, tex, 0) - gl.FramebufferTexture2D(gl.FRAMEBUFFER, gl.ColorAttachment0, gl.Texture2d, opt.tex, 0) - - // more buffers init - if opt.hasDepth { - gl.GenRenderbuffers(1, &opt.rbo) - gl.BindRenderbuffer(gl.RENDERBUFFER, opt.rbo) - if opt.hasStencil { - gl.RenderbufferStorage(gl.RENDERBUFFER, gl.Depth24Stencil8, opt.width, opt.height) - gl.FramebufferRenderbuffer(gl.FRAMEBUFFER, gl.DepthStencilAttachment, gl.RENDERBUFFER, opt.rbo) - } else { - gl.RenderbufferStorage(gl.RENDERBUFFER, gl.DepthComponent24, opt.width, opt.height) - gl.FramebufferRenderbuffer(gl.FRAMEBUFFER, gl.DepthAttachment, gl.RENDERBUFFER, opt.rbo) + if depth { + gl.GenRenderbuffers(1, &rbo) + gl.BindRenderbuffer(gl.RENDERBUFFER, rbo) + format, attachment := uint32(gl.DepthComponent24), uint32(gl.DepthAttachment) + if stencil { + format, attachment = gl.Depth24Stencil8, gl.DepthStencilAttachment } + gl.RenderbufferStorage(gl.RENDERBUFFER, format, w, h) + gl.FramebufferRenderbuffer(gl.FRAMEBUFFER, attachment, gl.RENDERBUFFER, rbo) gl.BindRenderbuffer(gl.RENDERBUFFER, 0) } if status := gl.CheckFramebufferStatus(gl.FRAMEBUFFER); status != gl.FramebufferComplete { - return fmt.Errorf("invalid framebuffer (0x%X)", status) + return fmt.Errorf("framebuffer incomplete: 0x%X", status) } return nil } func destroyFramebuffer() { - if opt.hasDepth { - gl.DeleteRenderbuffers(1, &opt.rbo) + if hasDepth { + gl.DeleteRenderbuffers(1, &rbo) } - gl.DeleteFramebuffers(1, &opt.fbo) - gl.DeleteTextures(1, &opt.tex) + gl.DeleteFramebuffers(1, &fbo) + gl.DeleteTextures(1, &tex) } -func ReadFramebuffer(bytes, w, h uint) []byte { - data := buf[:bytes:bytes] - gl.PixelStorei(gl.PackAlignment, 1) - gl.BindFramebuffer(gl.FRAMEBUFFER, opt.fbo) - gl.ReadPixels(0, 0, int32(w), int32(h), opt.pixType, opt.pixFormat, unsafe.Pointer(&data[0])) - return data +func ReadFramebuffer(size, w, h uint) []byte { + gl.BindFramebuffer(gl.FRAMEBUFFER, fbo) + gl.ReadPixels(0, 0, int32(w), int32(h), pixType, pixFormat, bufPtr) + return buf[:size] } -func getFbo() uint32 { return opt.fbo } - -func SetBuffer(size int) { buf = make([]byte, size) } +func SetBuffer(size int) { + buf = make([]byte, size) + bufPtr = unsafe.Pointer(&buf[0]) +} func SetPixelFormat(format PixelFormat) error { switch format { case UnsignedShort5551: - opt.pixFormat = gl.UnsignedShort5551 - opt.pixType = gl.BGRA + pixFormat, pixType = gl.UnsignedShort5551, gl.BGRA case UnsignedShort565: - opt.pixFormat = gl.UnsignedShort565 - opt.pixType = gl.RGB + pixFormat, pixType = gl.UnsignedShort565, gl.RGB case UnsignedInt8888Rev: - opt.pixFormat = gl.UnsignedInt8888Rev - opt.pixType = gl.BGRA + pixFormat, pixType = gl.UnsignedInt8888Rev, gl.BGRA default: return errors.New("unknown pixel format") } return nil } -func GetGLVersionInfo() string { return get(gl.VERSION) } -func GetGLVendorInfo() string { return get(gl.VENDOR) } -func GetGLRendererInfo() string { return get(gl.RENDERER) } -func GetGLSLInfo() string { return get(gl.ShadingLanguageVersion) } -func GetGLError() uint32 { return gl.GetError() } +func GLInfo() (version, vendor, renderer, glsl string) { + return gl.GoStr(gl.GetString(gl.VERSION)), + gl.GoStr(gl.GetString(gl.VENDOR)), + gl.GoStr(gl.GetString(gl.RENDERER)), + gl.GoStr(gl.GetString(gl.ShadingLanguageVersion)) +} -func get(name uint32) string { return gl.GoStr(gl.GetString(name)) } +func GlFbo() uint32 { return fbo } diff --git a/pkg/worker/caged/libretro/graphics/sdl.go b/pkg/worker/caged/libretro/graphics/sdl.go index 7c25efbd..7c885d88 100644 --- a/pkg/worker/caged/libretro/graphics/sdl.go +++ b/pkg/worker/caged/libretro/graphics/sdl.go @@ -4,21 +4,17 @@ import ( "fmt" "unsafe" - "github.com/giongto35/cloud-game/v3/pkg/logger" - "github.com/giongto35/cloud-game/v3/pkg/worker/thread" "github.com/veandco/go-sdl2/sdl" ) type SDL struct { - glWCtx sdl.GLContext - w *sdl.Window - log *logger.Logger + w *sdl.Window + ctx sdl.GLContext } type Config struct { Ctx Context - W int - H int + W, H int GLAutoContext bool GLVersionMajor uint GLVersionMinor uint @@ -26,123 +22,79 @@ type Config struct { GLHasStencil bool } -// NewSDLContext initializes SDL/OpenGL context. -// Uses main thread lock (see thread/mainthread). -func NewSDLContext(cfg Config, log *logger.Logger) (*SDL, error) { - log.Debug().Msg("[SDL/OpenGL] initialization...") - +func NewSDLContext(cfg Config) (*SDL, error) { if err := sdl.Init(sdl.INIT_VIDEO); err != nil { - return nil, fmt.Errorf("SDL initialization fail: %w", err) + return nil, fmt.Errorf("sdl: %w", err) } - display := SDL{log: log} - - if cfg.GLAutoContext { - log.Debug().Msgf("[OpenGL] CONTEXT_AUTO (type: %v v%v.%v)", cfg.Ctx, cfg.GLVersionMajor, cfg.GLVersionMinor) - } else { - switch cfg.Ctx { - case CtxOpenGlCore: - display.setAttribute(sdl.GL_CONTEXT_PROFILE_MASK, sdl.GL_CONTEXT_PROFILE_CORE) - log.Debug().Msgf("[OpenGL] CONTEXT_PROFILE_CORE") - case CtxOpenGlEs2: - display.setAttribute(sdl.GL_CONTEXT_PROFILE_MASK, sdl.GL_CONTEXT_PROFILE_ES) - display.setAttribute(sdl.GL_CONTEXT_MAJOR_VERSION, 3) - display.setAttribute(sdl.GL_CONTEXT_MINOR_VERSION, 0) - log.Debug().Msgf("[OpenGL] CONTEXT_PROFILE_ES 3.0") - case CtxOpenGl: - if cfg.GLVersionMajor >= 3 { - display.setAttribute(sdl.GL_CONTEXT_PROFILE_MASK, sdl.GL_CONTEXT_PROFILE_COMPATIBILITY) - } - log.Debug().Msgf("[OpenGL] CONTEXT_PROFILE_COMPATIBILITY") - default: - log.Error().Msgf("[OpenGL] Unsupported hw context: %v", cfg.Ctx) + if !cfg.GLAutoContext { + if err := setGLAttrs(cfg.Ctx); err != nil { + return nil, err } } - var err error - // In OSX 10.14+ window creation and context creation must happen in the main thread - thread.Main(func() { display.w, display.glWCtx, err = createWindow() }) + w, err := sdl.CreateWindow("cloud-retro", sdl.WINDOWPOS_UNDEFINED, sdl.WINDOWPOS_UNDEFINED, 1, 1, sdl.WINDOW_OPENGL|sdl.WINDOW_HIDDEN) if err != nil { - return nil, fmt.Errorf("window fail: %w", err) + return nil, fmt.Errorf("window: %w", err) } - if err := display.BindContext(); err != nil { - return nil, fmt.Errorf("bind context fail: %w", err) + ctx, err := w.GLCreateContext() + if err != nil { + err1 := w.Destroy() + return nil, fmt.Errorf("gl context: %w, destroy err: %w", err, err1) } + + if err = w.GLMakeCurrent(ctx); err != nil { + return nil, fmt.Errorf("gl bind: %w", err) + } + initContext(sdl.GLGetProcAddress) - if err := initFramebuffer(cfg.W, cfg.H, cfg.GLHasDepth, cfg.GLHasStencil); err != nil { - return nil, fmt.Errorf("OpenGL initialization fail: %w", err) + + if err = initFramebuffer(cfg.W, cfg.H, cfg.GLHasDepth, cfg.GLHasStencil); err != nil { + return nil, fmt.Errorf("fbo: %w", err) } - return &display, nil + + return &SDL{w: w, ctx: ctx}, nil } -// TryInit check weather SDL context can be created on the system. +func setGLAttrs(ctx Context) error { + set := sdl.GLSetAttribute + switch ctx { + case CtxOpenGlCore: + return set(sdl.GL_CONTEXT_PROFILE_MASK, sdl.GL_CONTEXT_PROFILE_CORE) + case CtxOpenGlEs2: + for _, a := range [][2]int{ + {sdl.GL_CONTEXT_PROFILE_MASK, sdl.GL_CONTEXT_PROFILE_ES}, + {sdl.GL_CONTEXT_MAJOR_VERSION, 3}, + {sdl.GL_CONTEXT_MINOR_VERSION, 0}, + } { + if err := set(sdl.GLattr(a[0]), a[1]); err != nil { + return err + } + } + return nil + case CtxOpenGl: + return set(sdl.GL_CONTEXT_PROFILE_MASK, sdl.GL_CONTEXT_PROFILE_COMPATIBILITY) + default: + return fmt.Errorf("unsupported gl context: %v", ctx) + } +} + +func (s *SDL) Deinit() error { + destroyFramebuffer() + sdl.GLDeleteContext(s.ctx) + err := s.w.Destroy() + sdl.Quit() + return err +} + +func (s *SDL) BindContext() error { return s.w.GLMakeCurrent(s.ctx) } +func GlProcAddress(proc string) unsafe.Pointer { return sdl.GLGetProcAddress(proc) } + func TryInit() error { if err := sdl.Init(sdl.INIT_VIDEO); err != nil { - return fmt.Errorf("SDL init fail: %w", err) - } - sdl.Quit() - return nil -} - -// Deinit destroys SDL/OpenGL context. -// Uses main thread lock (see thread/mainthread). -func (s *SDL) Deinit() error { - s.log.Debug().Msg("[SDL/OpenGL] shutdown...") - destroyFramebuffer() - var err error - // In OSX 10.14+ window deletion must happen in the main thread - thread.Main(func() { - err = s.destroyWindow() - }) - if err != nil { - return fmt.Errorf("[SDL/OpenGL] deinit fail: %w", err) - } - sdl.Quit() - s.log.Debug().Msgf("[SDL/OpenGL] shutdown codes:(%v, %v)", sdl.GetError(), GetGLError()) - return nil -} - -// createWindow creates a fake SDL window just for OpenGL initialization purposes. -func createWindow() (*sdl.Window, sdl.GLContext, error) { - w, err := sdl.CreateWindow( - "CloudRetro dummy window", - sdl.WINDOWPOS_UNDEFINED, sdl.WINDOWPOS_UNDEFINED, - 1, 1, - sdl.WINDOW_OPENGL|sdl.WINDOW_HIDDEN, - ) - if err != nil { - return nil, nil, fmt.Errorf("window creation fail: %w", err) - } - glWCtx, err := w.GLCreateContext() - if err != nil { - return nil, nil, fmt.Errorf("window OpenGL context fail: %w", err) - } - return w, glWCtx, nil -} - -// destroyWindow destroys previously created SDL window. -func (s *SDL) destroyWindow() error { - if err := s.BindContext(); err != nil { return err } - sdl.GLDeleteContext(s.glWCtx) - if err := s.w.Destroy(); err != nil { - return fmt.Errorf("window destroy fail: %w", err) - } + sdl.Quit() return nil } - -// BindContext explicitly binds context to current thread. -func (s *SDL) BindContext() error { return s.w.GLMakeCurrent(s.glWCtx) } - -// setAttribute tries to set a GL attribute or prints error. -func (s *SDL) setAttribute(attr sdl.GLattr, value int) { - if err := sdl.GLSetAttribute(attr, value); err != nil { - s.log.Error().Err(err).Msg("[SDL] attribute") - } -} - -func GetGlFbo() uint32 { return getFbo() } - -func GetGlProcAddress(proc string) unsafe.Pointer { return sdl.GLGetProcAddress(proc) } diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index e0be87fd..6153f80e 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -486,10 +486,11 @@ func setRotation(rot uint) { func printOpenGLDriverInfo() { var openGLInfo strings.Builder openGLInfo.Grow(128) - openGLInfo.WriteString(fmt.Sprintf("\n[OpenGL] Version: %v\n", graphics.GetGLVersionInfo())) - openGLInfo.WriteString(fmt.Sprintf("[OpenGL] Vendor: %v\n", graphics.GetGLVendorInfo())) - openGLInfo.WriteString(fmt.Sprintf("[OpenGL] Renderer: %v\n", graphics.GetGLRendererInfo())) - openGLInfo.WriteString(fmt.Sprintf("[OpenGL] GLSL Version: %v", graphics.GetGLSLInfo())) + version, vendor, renderrer, glsl := graphics.GLInfo() + openGLInfo.WriteString(fmt.Sprintf("\n[OpenGL] Version: %v\n", version)) + openGLInfo.WriteString(fmt.Sprintf("[OpenGL] Vendor: %v\n", vendor)) + openGLInfo.WriteString(fmt.Sprintf("[OpenGL] Renderer: %v\n", renderrer)) + openGLInfo.WriteString(fmt.Sprintf("[OpenGL] GLSL Version: %v", glsl)) Nan0.log.Debug().Msg(openGLInfo.String()) } @@ -711,11 +712,11 @@ func coreLog(level C.enum_retro_log_level, msg *C.char) { } //export coreGetCurrentFramebuffer -func coreGetCurrentFramebuffer() C.uintptr_t { return (C.uintptr_t)(graphics.GetGlFbo()) } +func coreGetCurrentFramebuffer() C.uintptr_t { return (C.uintptr_t)(graphics.GlFbo()) } //export coreGetProcAddress func coreGetProcAddress(sym *C.char) C.retro_proc_address_t { - return (C.retro_proc_address_t)(graphics.GetGlProcAddress(C.GoString(sym))) + return (C.retro_proc_address_t)(graphics.GlProcAddress(C.GoString(sym))) } //export coreEnvironment @@ -857,20 +858,22 @@ func initVideo() { context = graphics.CtxUnknown } - sdl, err := graphics.NewSDLContext(graphics.Config{ - Ctx: context, - W: int(Nan0.sys.av.geometry.max_width), - H: int(Nan0.sys.av.geometry.max_height), - GLAutoContext: Nan0.Video.gl.autoCtx, - GLVersionMajor: uint(Nan0.Video.hw.version_major), - GLVersionMinor: uint(Nan0.Video.hw.version_minor), - GLHasDepth: bool(Nan0.Video.hw.depth), - GLHasStencil: bool(Nan0.Video.hw.stencil), - }, Nan0.log) - if err != nil { - panic(err) - } - Nan0.sdlCtx = sdl + thread.Main(func() { + var err error + Nan0.sdlCtx, err = graphics.NewSDLContext(graphics.Config{ + Ctx: context, + W: int(Nan0.sys.av.geometry.max_width), + H: int(Nan0.sys.av.geometry.max_height), + GLAutoContext: Nan0.Video.gl.autoCtx, + GLVersionMajor: uint(Nan0.Video.hw.version_major), + GLVersionMinor: uint(Nan0.Video.hw.version_minor), + GLHasDepth: bool(Nan0.Video.hw.depth), + GLHasStencil: bool(Nan0.Video.hw.stencil), + }) + if err != nil { + panic(err) + } + }) if Nan0.log.GetLevel() < logger.InfoLevel { printOpenGLDriverInfo() @@ -882,9 +885,11 @@ func deinitVideo() { if !Nan0.hackSkipHwContextDestroy { C.bridge_context_reset(Nan0.Video.hw.context_destroy) } - if err := Nan0.sdlCtx.Deinit(); err != nil { - Nan0.log.Error().Err(err).Msg("deinit fail") - } + thread.Main(func() { + if err := Nan0.sdlCtx.Deinit(); err != nil { + Nan0.log.Error().Err(err).Msg("deinit fail") + } + }) Nan0.Video.gl.enabled = false Nan0.Video.gl.autoCtx = false Nan0.hackSkipHwContextDestroy = false From 368bae8c07ed0a5b47308eee5ee08e377e8c2853 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Sun, 28 Dec 2025 21:25:33 +0300 Subject: [PATCH 359/361] Swap mutex to atomics in keyboard input --- pkg/worker/caged/libretro/nanoarch/input.go | 172 +++----- .../caged/libretro/nanoarch/input_test.go | 372 ++++++++++++++++-- .../caged/libretro/nanoarch/nanoarch.go | 2 +- 3 files changed, 407 insertions(+), 139 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/input.go b/pkg/worker/caged/libretro/nanoarch/input.go index e095bbd8..59b5b014 100644 --- a/pkg/worker/caged/libretro/nanoarch/input.go +++ b/pkg/worker/caged/libretro/nanoarch/input.go @@ -2,7 +2,6 @@ package nanoarch import ( "encoding/binary" - "sync" "sync/atomic" ) @@ -19,36 +18,11 @@ void input_cache_clear(void); import "C" const ( - Released C.int16_t = iota - Pressed + maxPort = 4 + numAxes = 4 + RetrokLast = int(C.RETROK_LAST) ) -const RetrokLast = int(C.RETROK_LAST) - -// InputState stores full controller state. -// It consists of: -// - uint16 button values -// - int16 analog stick values -type InputState [maxPort]RetroPadState - -type ( - RetroPadState struct { - keys uint32 - axes [dpadAxes]int32 - } - KeyboardState struct { - keys [RetrokLast]byte - mod uint16 - mu sync.Mutex - } - MouseState struct { - dx, dy atomic.Int32 - buttons atomic.Int32 - } -) - -type MouseBtnState int32 - type Device byte const ( @@ -62,128 +36,110 @@ const ( MouseButton ) +type MouseBtnState int32 + const ( MouseLeft MouseBtnState = 1 << iota MouseRight MouseMiddle ) -const ( - maxPort = 4 - dpadAxes = 4 -) +// InputState stores controller state for all ports. +// - uint16 button bitmask +// - int16 analog axes x4 +type InputState [maxPort]struct { + keys uint32 + axes [numAxes]int32 +} -// Input sets input state for some player in a game session. -func (s *InputState) Input(port int, data []byte) { - atomic.StoreUint32(&s[port].keys, uint32(uint16(data[1])<<8+uint16(data[0]))) - for i, axes := 0, len(data); i < dpadAxes && i<<1+3 < axes; i++ { - axis := i<<1 + 2 - atomic.StoreInt32(&s[port].axes[i], int32(data[axis+1])<<8+int32(data[axis])) +// SetInput sets input state for a player. +// +// [BTN:2][AX0:2][AX1:2][AX2:2][AX3:2] +func (s *InputState) SetInput(port int, data []byte) { + atomic.StoreUint32(&s[port].keys, uint32(binary.LittleEndian.Uint16(data))) + for i := 0; i < numAxes && i*2+3 < len(data); i++ { + atomic.StoreInt32(&s[port].axes[i], int32(int16(binary.LittleEndian.Uint16(data[i*2+2:])))) } } -// IsKeyPressed checks if some button is pressed by any player. -func (s *InputState) IsKeyPressed(port uint, key int) C.int16_t { - return C.int16_t((atomic.LoadUint32(&s[port].keys) >> uint(key)) & 1) +// Button check +func (s *InputState) Button(port, key uint) C.int16_t { + return C.int16_t((atomic.LoadUint32(&s[port].keys) >> key) & 1) } -// IsDpadTouched checks if D-pad is used by any player. -func (s *InputState) IsDpadTouched(port uint, axis uint) (shift C.int16_t) { - return C.int16_t(atomic.LoadInt32(&s[port].axes[axis])) -} - -// SyncToCache syncs the entire input state to the C-side cache. -// Call this once before each Run() instead of having C call back into Go. +// SyncToCache syncs input state to C-side cache before Run(). func (s *InputState) SyncToCache() { - for port := uint(0); port < maxPort; port++ { - buttons := atomic.LoadUint32(&s[port].keys) - axis0 := C.int16_t(atomic.LoadInt32(&s[port].axes[0])) - axis1 := C.int16_t(atomic.LoadInt32(&s[port].axes[1])) - axis2 := C.int16_t(atomic.LoadInt32(&s[port].axes[2])) - axis3 := C.int16_t(atomic.LoadInt32(&s[port].axes[3])) - C.input_cache_set_port(C.uint(port), C.uint32_t(buttons), axis0, axis1, axis2, axis3) + for p := uint(0); p < maxPort; p++ { + a := &s[p].axes + C.input_cache_set_port(C.uint(p), C.uint32_t(atomic.LoadUint32(&s[p].keys)), + C.int16_t(atomic.LoadInt32(&a[0])), C.int16_t(atomic.LoadInt32(&a[1])), + C.int16_t(atomic.LoadInt32(&a[2])), C.int16_t(atomic.LoadInt32(&a[3]))) } } +// KeyboardState tracks keys of the keyboard. +type KeyboardState struct { + keys [6]atomic.Uint64 // 342 keys packed into 6 uint64s (384 bits) + mod atomic.Uint32 +} + // SetKey sets keyboard state. // -// 0 1 2 3 4 5 6 -// [ KEY ] P MOD +// [KEY:4][P:1][MOD:2] // -// KEY contains Libretro code of the keyboard key (4 bytes). -// P contains 0 or 1 if the key is pressed (1 byte). -// MOD contains bitmask for Alt | Ctrl | Meta | Shift keys press state (2 bytes). -// -// Returns decoded state from the input bytes. +// KEY - Libretro key code, P - pressed (0/1), MOD - modifier bitmask func (ks *KeyboardState) SetKey(data []byte) (pressed bool, key uint, mod uint16) { if len(data) != 7 { return } - - press := data[4] - pressed = press == 1 key = uint(binary.BigEndian.Uint32(data)) mod = binary.BigEndian.Uint16(data[5:]) - ks.mu.Lock() - ks.keys[key] = press - ks.mod = mod - ks.mu.Unlock() + pressed = data[4] == 1 + + idx, bit := key/64, uint64(1)<<(key%64) + if pressed { + ks.keys[idx].Or(bit) + } else { + ks.keys[idx].And(^bit) + } + ks.mod.Store(uint32(mod)) + return } -func (ks *KeyboardState) Pressed(key uint) C.int16_t { - ks.mu.Lock() - press := ks.keys[key] - ks.mu.Unlock() - if press == 1 { - return Pressed - } - return Released -} - -// SyncToCache syncs keyboard state to the C-side cache. +// SyncToCache syncs keyboard state to C-side cache. func (ks *KeyboardState) SyncToCache() { - ks.mu.Lock() - defer ks.mu.Unlock() - for id, pressed := range ks.keys { + for id := 0; id < RetrokLast; id++ { + pressed := (ks.keys[id/64].Load() >> (id % 64)) & 1 C.input_cache_set_keyboard_key(C.uint(id), C.uint8_t(pressed)) } } -// ShiftPos sets mouse relative position state. +// MouseState tracks mouse delta and buttons. +type MouseState struct { + dx, dy atomic.Int32 + buttons atomic.Int32 +} + +// ShiftPos adds relative mouse movement. // -// 0 1 2 3 -// [dx] [dy] -// -// dx and dy are relative mouse coordinates +// [dx:2][dy:2] func (ms *MouseState) ShiftPos(data []byte) { if len(data) != 4 { return } - dxy := binary.BigEndian.Uint32(data) - ms.dx.Add(int32(int16(dxy >> 16))) - ms.dy.Add(int32(int16(dxy))) + ms.dx.Add(int32(int16(binary.BigEndian.Uint16(data[:2])))) + ms.dy.Add(int32(int16(binary.BigEndian.Uint16(data[2:])))) } -func (ms *MouseState) PopX() C.int16_t { return C.int16_t(ms.dx.Swap(0)) } -func (ms *MouseState) PopY() C.int16_t { return C.int16_t(ms.dy.Swap(0)) } - -// SetButtons sets the state MouseBtnState of mouse buttons. -func (ms *MouseState) SetButtons(data byte) { ms.buttons.Store(int32(data)) } +func (ms *MouseState) SetButtons(b byte) { ms.buttons.Store(int32(b)) } func (ms *MouseState) Buttons() (l, r, m bool) { - mbs := MouseBtnState(ms.buttons.Load()) - l = mbs&MouseLeft != 0 - r = mbs&MouseRight != 0 - m = mbs&MouseMiddle != 0 - return + b := MouseBtnState(ms.buttons.Load()) + return b&MouseLeft != 0, b&MouseRight != 0, b&MouseMiddle != 0 } -// SyncToCache syncs mouse state to the C-side cache. -// This consumes the delta values (swaps to 0). +// SyncToCache syncs mouse state to C-side cache, consuming deltas. func (ms *MouseState) SyncToCache() { - dx := C.int16_t(ms.dx.Swap(0)) - dy := C.int16_t(ms.dy.Swap(0)) - buttons := C.uint8_t(ms.buttons.Load()) - C.input_cache_set_mouse(dx, dy, buttons) + C.input_cache_set_mouse(C.int16_t(ms.dx.Swap(0)), C.int16_t(ms.dy.Swap(0)), C.uint8_t(ms.buttons.Load())) } diff --git a/pkg/worker/caged/libretro/nanoarch/input_test.go b/pkg/worker/caged/libretro/nanoarch/input_test.go index 042d108e..4cda73f1 100644 --- a/pkg/worker/caged/libretro/nanoarch/input_test.go +++ b/pkg/worker/caged/libretro/nanoarch/input_test.go @@ -7,21 +7,215 @@ import ( "testing" ) -func TestConcurrentInput(t *testing.T) { +func TestInputState_SetInput(t *testing.T) { + tests := []struct { + name string + port int + data []byte + keys uint32 + axes [4]int32 + }{ + { + name: "buttons only", + port: 0, + data: []byte{0xFF, 0x01}, + keys: 0x01FF, + }, + { + name: "buttons and axes", + port: 1, + data: []byte{0x03, 0x00, 0x10, 0x27, 0xF0, 0xD8, 0x00, 0x80, 0xFF, 0x7F}, + keys: 0x0003, + axes: [4]int32{10000, -10000, -32768, 32767}, + }, + { + name: "partial axes", + port: 2, + data: []byte{0x01, 0x00, 0x64, 0x00}, + keys: 0x0001, + axes: [4]int32{100, 0, 0, 0}, + }, + { + name: "max port", + port: 3, + data: []byte{0xFF, 0xFF}, + keys: 0xFFFF, + }, + } + + for _, test := range tests { + t.Run(test.name, func(t *testing.T) { + state := InputState{} + state.SetInput(test.port, test.data) + + if state[test.port].keys != test.keys { + t.Errorf("keys: got %v, want %v", state[test.port].keys, test.keys) + } + for i, want := range test.axes { + if state[test.port].axes[i] != want { + t.Errorf("axes[%d]: got %v, want %v", i, state[test.port].axes[i], want) + } + } + }) + } +} + +func TestInputState_Concurrent(t *testing.T) { var wg sync.WaitGroup state := InputState{} events := 1000 - wg.Add(2 * events) + wg.Add(events) for range events { player := rand.Intn(maxPort) - go func() { state.Input(player, []byte{0, 1}); wg.Done() }() - go func() { state.IsKeyPressed(uint(player), 100); wg.Done() }() + go func() { + state.SetInput(player, []byte{0, 1, 0, 0, 0, 0, 0, 0, 0, 0}) + wg.Done() + }() } wg.Wait() } -func TestMousePos(t *testing.T) { +func TestKeyboardState_SetKey(t *testing.T) { + tests := []struct { + name string + data []byte + pressed bool + key uint + mod uint16 + }{ + { + name: "key pressed", + data: []byte{0, 0, 0, 42, 1, 0, 3}, + pressed: true, + key: 42, + mod: 3, + }, + { + name: "key released", + data: []byte{0, 0, 0, 100, 0, 0, 0}, + pressed: false, + key: 100, + mod: 0, + }, + { + name: "high key code", + data: []byte{0, 0, 1, 50, 1, 0xFF, 0xFF}, + pressed: true, + key: 306, + mod: 0xFFFF, + }, + { + name: "invalid length", + data: []byte{0, 0, 0}, + pressed: false, + key: 0, + mod: 0, + }, + } + + for _, test := range tests { + t.Run(test.name, func(t *testing.T) { + ks := KeyboardState{} + pressed, key, mod := ks.SetKey(test.data) + + if pressed != test.pressed { + t.Errorf("pressed: got %v, want %v", pressed, test.pressed) + } + if key != test.key { + t.Errorf("key: got %v, want %v", key, test.key) + } + if mod != test.mod { + t.Errorf("mod: got %v, want %v", mod, test.mod) + } + }) + } +} + +func TestKeyboardState_IsPressed(t *testing.T) { + ks := KeyboardState{} + + // Initially not pressed + if ks.keys[0].Load() != 0 { + t.Error("key should not be pressed initially") + } + + // Press key + ks.SetKey([]byte{0, 0, 0, 42, 1, 0, 0}) + if (ks.keys[42/64].Load()>>(42%64))&1 != 1 { + t.Error("key should be pressed") + } + + // Release key + ks.SetKey([]byte{0, 0, 0, 42, 0, 0, 0}) + if (ks.keys[42/64].Load()>>(42%64))&1 != 0 { + t.Error("key should be released") + } +} + +func TestKeyboardState_MultipleBits(t *testing.T) { + ks := KeyboardState{} + + // Press keys in different uint64 slots + keys := []uint{0, 63, 64, 127, 128, 200, 300, 341} + for _, k := range keys { + data := make([]byte, 7) + binary.BigEndian.PutUint32(data, uint32(k)) + data[4] = 1 + ks.SetKey(data) + } + + // Check all pressed + for _, k := range keys { + if (ks.keys[k/64].Load()>>(k%64))&1 != 1 { + t.Errorf("key %d should be pressed", k) + } + } + + // Release some + for _, k := range []uint{0, 128, 341} { + data := make([]byte, 7) + binary.BigEndian.PutUint32(data, uint32(k)) + data[4] = 0 + ks.SetKey(data) + } + + // Check states + expected := map[uint]uint64{ + 0: 0, 63: 1, 64: 1, 127: 1, 128: 0, 200: 1, 300: 1, 341: 0, + } + for k, want := range expected { + got := (ks.keys[k/64].Load() >> (k % 64)) & 1 + if got != want { + t.Errorf("key %d: got %v, want %v", k, got, want) + } + } +} + +func TestKeyboardState_Concurrent(t *testing.T) { + var wg sync.WaitGroup + ks := KeyboardState{} + events := 1000 + wg.Add(events * 2) + + for range events { + key := uint(rand.Intn(RetrokLast)) + go func() { + data := make([]byte, 7) + binary.BigEndian.PutUint32(data, uint32(key)) + data[4] = byte(rand.Intn(2)) + ks.SetKey(data) + wg.Done() + }() + go func() { + _ = (ks.keys[key/64].Load() >> (key % 64)) & 1 + wg.Done() + }() + } + wg.Wait() +} + +func TestMouseState_ShiftPos(t *testing.T) { tests := []struct { name string dx int16 @@ -30,42 +224,109 @@ func TestMousePos(t *testing.T) { ry int16 b func(dx, dy int16) []byte }{ - {name: "normal", dx: -10123, dy: 5678, rx: -10123, ry: 5678, b: func(dx, dy int16) []byte { - data := []byte{0, 0, 0, 0} - binary.BigEndian.PutUint16(data, uint16(dx)) - binary.BigEndian.PutUint16(data[2:], uint16(dy)) - return data - }}, - {name: "wrong endian", dx: -1234, dy: 5678, rx: 12027, ry: 11798, b: func(dx, dy int16) []byte { - data := []byte{0, 0, 0, 0} - binary.LittleEndian.PutUint16(data, uint16(dx)) - binary.LittleEndian.PutUint16(data[2:], uint16(dy)) - return data - }}, + { + name: "positive values", + dx: 100, + dy: 200, + rx: 100, + ry: 200, + b: func(dx, dy int16) []byte { + data := make([]byte, 4) + binary.BigEndian.PutUint16(data, uint16(dx)) + binary.BigEndian.PutUint16(data[2:], uint16(dy)) + return data + }, + }, + { + name: "negative values", + dx: -10123, + dy: 5678, + rx: -10123, + ry: 5678, + b: func(dx, dy int16) []byte { + data := make([]byte, 4) + binary.BigEndian.PutUint16(data, uint16(dx)) + binary.BigEndian.PutUint16(data[2:], uint16(dy)) + return data + }, + }, + { + name: "wrong endian", + dx: -1234, + dy: 5678, + rx: 12027, + ry: 11798, + b: func(dx, dy int16) []byte { + data := make([]byte, 4) + binary.LittleEndian.PutUint16(data, uint16(dx)) + binary.LittleEndian.PutUint16(data[2:], uint16(dy)) + return data + }, + }, + { + name: "max values", + dx: 32767, + dy: -32768, + rx: 32767, + ry: -32768, + b: func(dx, dy int16) []byte { + data := make([]byte, 4) + binary.BigEndian.PutUint16(data, uint16(dx)) + binary.BigEndian.PutUint16(data[2:], uint16(dy)) + return data + }, + }, } for _, test := range tests { t.Run(test.name, func(t *testing.T) { - data := test.b(test.dx, test.dy) - ms := MouseState{} - ms.ShiftPos(data) + ms.ShiftPos(test.b(test.dx, test.dy)) - x := int16(ms.PopX()) - y := int16(ms.PopY()) + x, y := int16(ms.dx.Swap(0)), int16(ms.dy.Swap(0)) if x != test.rx || y != test.ry { - t.Errorf("invalid state, %v = %v, %v = %v", test.rx, x, test.ry, y) + t.Errorf("got (%v, %v), want (%v, %v)", x, y, test.rx, test.ry) } if ms.dx.Load() != 0 || ms.dy.Load() != 0 { - t.Errorf("coordinates weren't cleared") + t.Error("coordinates weren't cleared") } }) } } -func TestMouseButtons(t *testing.T) { +func TestMouseState_ShiftPosAccumulates(t *testing.T) { + ms := MouseState{} + + data := make([]byte, 4) + binary.BigEndian.PutUint16(data, uint16(10)) + binary.BigEndian.PutUint16(data[2:], uint16(20)) + + ms.ShiftPos(data) + ms.ShiftPos(data) + ms.ShiftPos(data) + + if got := ms.dx.Load(); got != 30 { + t.Errorf("dx: got %v, want 30", got) + } + if got := ms.dy.Load(); got != 60 { + t.Errorf("dy: got %v, want 60", got) + } +} + +func TestMouseState_ShiftPosInvalidLength(t *testing.T) { + ms := MouseState{} + + ms.ShiftPos([]byte{1, 2, 3}) + ms.ShiftPos([]byte{1, 2, 3, 4, 5}) + + if ms.dx.Load() != 0 || ms.dy.Load() != 0 { + t.Error("invalid data should be ignored") + } +} + +func TestMouseState_Buttons(t *testing.T) { tests := []struct { name string data byte @@ -73,10 +334,13 @@ func TestMouseButtons(t *testing.T) { r bool m bool }{ - {name: "l+r+m+", data: 1 + 2 + 4, l: true, r: true, m: true}, - {name: "l-r-m-", data: 0}, - {name: "l-r+m-", data: 2, r: true}, - {name: "l+r-m+", data: 1 + 4, l: true, m: true}, + {name: "none", data: 0}, + {name: "left", data: 1, l: true}, + {name: "right", data: 2, r: true}, + {name: "middle", data: 4, m: true}, + {name: "left+right", data: 3, l: true, r: true}, + {name: "all", data: 7, l: true, r: true, m: true}, + {name: "left+middle", data: 5, l: true, m: true}, } ms := MouseState{} @@ -86,8 +350,56 @@ func TestMouseButtons(t *testing.T) { ms.SetButtons(test.data) l, r, m := ms.Buttons() if l != test.l || r != test.r || m != test.m { - t.Errorf("wrong button state: %v -> %v, %v, %v", test.data, l, r, m) + t.Errorf("got (%v, %v, %v), want (%v, %v, %v)", l, r, m, test.l, test.r, test.m) } }) } } + +func TestMouseState_Concurrent(t *testing.T) { + var wg sync.WaitGroup + ms := MouseState{} + events := 1000 + wg.Add(events * 3) + + for range events { + go func() { + data := make([]byte, 4) + binary.BigEndian.PutUint16(data, uint16(rand.Int31n(100)-50)) + binary.BigEndian.PutUint16(data[2:], uint16(rand.Int31n(100)-50)) + ms.ShiftPos(data) + wg.Done() + }() + go func() { + ms.SetButtons(byte(rand.Intn(8))) + wg.Done() + }() + go func() { + ms.Buttons() + wg.Done() + }() + } + wg.Wait() +} + +func TestConstants(t *testing.T) { + // MouseBtnState + if MouseLeft != 1 || MouseRight != 2 || MouseMiddle != 4 { + t.Error("invalid MouseBtnState constants") + } + + // Device + if RetroPad != 0 || Keyboard != 1 || Mouse != 2 { + t.Error("invalid Device constants") + } + + // Mouse events + if MouseMove != 0 || MouseButton != 1 { + t.Error("invalid mouse event constants") + } + + // Limits + if maxPort != 4 || numAxes != 4 || RetrokLast != 342 { + t.Error("invalid limit constants") + } +} diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index 6153f80e..5d34dca3 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -426,7 +426,7 @@ func (n *Nanoarch) Run() { func (n *Nanoarch) IsSupported() error { return graphics.TryInit() } func (n *Nanoarch) IsGL() bool { return n.Video.gl.enabled } func (n *Nanoarch) IsStopped() bool { return n.Stopped.Load() } -func (n *Nanoarch) InputRetropad(port int, data []byte) { n.retropad.Input(port, data) } +func (n *Nanoarch) InputRetropad(port int, data []byte) { n.retropad.SetInput(port, data) } func (n *Nanoarch) InputKeyboard(_ int, data []byte) { if n.keyboardCb == nil { return From 1d5bae0c62b5293aa791f9781513577a92036f0e Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Mon, 29 Dec 2025 20:20:55 +0300 Subject: [PATCH 360/361] Add analog triggers and pack axes into atomic int64 - Pack 4 analog axes (LX, LY, RX, RY) into single int64 for atomic access - Pack L2/R2 analog triggers into single int32 - Reduce memory per port from 20 to 16 bytes - Reduce atomic stores per SetInput from 5 to 3 - Add RETRO_DEVICE_INDEX_ANALOG_BUTTON support for analog trigger queries - Fallback to digital (0/0x7FFF) for non-trigger analog button queries Wire format: [BTN:2][LX:2][LY:2][RX:2][RY:2][L2:2][R2:2] (14 bytes) --- pkg/worker/caged/libretro/nanoarch/input.go | 54 +++++--- .../caged/libretro/nanoarch/input_test.go | 129 ++++++++++++++++-- pkg/worker/caged/libretro/nanoarch/nanoarch.c | 49 ++++--- 3 files changed, 188 insertions(+), 44 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/input.go b/pkg/worker/caged/libretro/nanoarch/input.go index 59b5b014..eb6080c5 100644 --- a/pkg/worker/caged/libretro/nanoarch/input.go +++ b/pkg/worker/caged/libretro/nanoarch/input.go @@ -10,7 +10,8 @@ import ( #include "libretro.h" void input_cache_set_port(unsigned port, uint32_t buttons, - int16_t axis0, int16_t axis1, int16_t axis2, int16_t axis3); + int16_t lx, int16_t ly, int16_t rx, int16_t ry, + int16_t l2, int16_t r2); void input_cache_set_keyboard_key(unsigned id, uint8_t pressed); void input_cache_set_mouse(int16_t dx, int16_t dy, uint8_t buttons); void input_cache_clear(void); @@ -46,34 +47,55 @@ const ( // InputState stores controller state for all ports. // - uint16 button bitmask -// - int16 analog axes x4 +// - int16 analog axes x4 (left stick, right stick) +// - int16 analog triggers x2 (L2, R2) type InputState [maxPort]struct { - keys uint32 - axes [numAxes]int32 + keys uint32 // lower 16 bits used + axes int64 // packed: [LX:16][LY:16][RX:16][RY:16] + triggers int32 // packed: [L2:16][R2:16] } // SetInput sets input state for a player. // -// [BTN:2][AX0:2][AX1:2][AX2:2][AX3:2] +// [BTN:2][LX:2][LY:2][RX:2][RY:2][L2:2][R2:2] func (s *InputState) SetInput(port int, data []byte) { - atomic.StoreUint32(&s[port].keys, uint32(binary.LittleEndian.Uint16(data))) - for i := 0; i < numAxes && i*2+3 < len(data); i++ { - atomic.StoreInt32(&s[port].axes[i], int32(int16(binary.LittleEndian.Uint16(data[i*2+2:])))) + if len(data) < 2 { + return } -} -// Button check -func (s *InputState) Button(port, key uint) C.int16_t { - return C.int16_t((atomic.LoadUint32(&s[port].keys) >> key) & 1) + // Buttons + atomic.StoreUint32(&s[port].keys, uint32(binary.LittleEndian.Uint16(data))) + + // Axes - pack into int64 + var packedAxes int64 + for i := 0; i < numAxes && i*2+3 < len(data); i++ { + axis := int64(int16(binary.LittleEndian.Uint16(data[i*2+2:]))) + packedAxes |= (axis & 0xFFFF) << (i * 16) + } + atomic.StoreInt64(&s[port].axes, packedAxes) + + // Analog triggers L2, R2 - pack into int32 + if len(data) >= 14 { + l2 := int32(int16(binary.LittleEndian.Uint16(data[10:]))) + r2 := int32(int16(binary.LittleEndian.Uint16(data[12:]))) + atomic.StoreInt32(&s[port].triggers, (l2&0xFFFF)|((r2&0xFFFF)<<16)) + } } // SyncToCache syncs input state to C-side cache before Run(). func (s *InputState) SyncToCache() { for p := uint(0); p < maxPort; p++ { - a := &s[p].axes - C.input_cache_set_port(C.uint(p), C.uint32_t(atomic.LoadUint32(&s[p].keys)), - C.int16_t(atomic.LoadInt32(&a[0])), C.int16_t(atomic.LoadInt32(&a[1])), - C.int16_t(atomic.LoadInt32(&a[2])), C.int16_t(atomic.LoadInt32(&a[3]))) + keys := atomic.LoadUint32(&s[p].keys) + axes := atomic.LoadInt64(&s[p].axes) + triggers := atomic.LoadInt32(&s[p].triggers) + + C.input_cache_set_port(C.uint(p), C.uint32_t(keys), + C.int16_t(axes), + C.int16_t(axes>>16), + C.int16_t(axes>>32), + C.int16_t(axes>>48), + C.int16_t(triggers), + C.int16_t(triggers>>16)) } } diff --git a/pkg/worker/caged/libretro/nanoarch/input_test.go b/pkg/worker/caged/libretro/nanoarch/input_test.go index 4cda73f1..1df81da7 100644 --- a/pkg/worker/caged/libretro/nanoarch/input_test.go +++ b/pkg/worker/caged/libretro/nanoarch/input_test.go @@ -9,11 +9,12 @@ import ( func TestInputState_SetInput(t *testing.T) { tests := []struct { - name string - port int - data []byte - keys uint32 - axes [4]int32 + name string + port int + data []byte + keys uint32 + axes [4]int16 + triggers [2]int16 }{ { name: "buttons only", @@ -26,14 +27,14 @@ func TestInputState_SetInput(t *testing.T) { port: 1, data: []byte{0x03, 0x00, 0x10, 0x27, 0xF0, 0xD8, 0x00, 0x80, 0xFF, 0x7F}, keys: 0x0003, - axes: [4]int32{10000, -10000, -32768, 32767}, + axes: [4]int16{10000, -10000, -32768, 32767}, }, { name: "partial axes", port: 2, data: []byte{0x01, 0x00, 0x64, 0x00}, keys: 0x0001, - axes: [4]int32{100, 0, 0, 0}, + axes: [4]int16{100, 0, 0, 0}, }, { name: "max port", @@ -41,6 +42,46 @@ func TestInputState_SetInput(t *testing.T) { data: []byte{0xFF, 0xFF}, keys: 0xFFFF, }, + { + name: "full input with triggers", + port: 0, + data: []byte{ + 0x03, 0x00, // buttons + 0x10, 0x27, // LX: 10000 + 0xF0, 0xD8, // LY: -10000 + 0x00, 0x80, // RX: -32768 + 0xFF, 0x7F, // RY: 32767 + 0xFF, 0x3F, // L2: 16383 + 0xFF, 0x7F, // R2: 32767 + }, + keys: 0x0003, + axes: [4]int16{10000, -10000, -32768, 32767}, + triggers: [2]int16{16383, 32767}, + }, + { + name: "axes without triggers", + port: 1, + data: []byte{ + 0x01, 0x00, + 0x64, 0x00, // LX: 100 + 0xC8, 0x00, // LY: 200 + 0x2C, 0x01, // RX: 300 + 0x90, 0x01, // RY: 400 + }, + keys: 0x0001, + axes: [4]int16{100, 200, 300, 400}, + }, + { + name: "zero triggers", + port: 2, + data: []byte{ + 0x00, 0x00, + 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, + 0x00, 0x00, // L2: 0 + 0x00, 0x00, // R2: 0 + }, + keys: 0x0000, + }, } for _, test := range tests { @@ -51,15 +92,82 @@ func TestInputState_SetInput(t *testing.T) { if state[test.port].keys != test.keys { t.Errorf("keys: got %v, want %v", state[test.port].keys, test.keys) } + + // Check axes from packed int64 + axes := state[test.port].axes for i, want := range test.axes { - if state[test.port].axes[i] != want { - t.Errorf("axes[%d]: got %v, want %v", i, state[test.port].axes[i], want) + got := int16(axes >> (i * 16)) + if got != want { + t.Errorf("axes[%d]: got %v, want %v", i, got, want) } } + + // Check triggers from packed int32 + triggers := state[test.port].triggers + l2 := int16(triggers) + r2 := int16(triggers >> 16) + if l2 != test.triggers[0] { + t.Errorf("L2: got %v, want %v", l2, test.triggers[0]) + } + if r2 != test.triggers[1] { + t.Errorf("R2: got %v, want %v", r2, test.triggers[1]) + } }) } } +func TestInputState_AxisExtraction(t *testing.T) { + state := InputState{} + data := []byte{ + 0x00, 0x00, // buttons + 0x01, 0x00, // LX: 1 + 0x02, 0x00, // LY: 2 + 0x03, 0x00, // RX: 3 + 0x04, 0x00, // RY: 4 + 0x05, 0x00, // L2: 5 + 0x06, 0x00, // R2: 6 + } + state.SetInput(0, data) + + axes := state[0].axes + expected := []int16{1, 2, 3, 4} + for i, want := range expected { + got := int16(axes >> (i * 16)) + if got != want { + t.Errorf("axis[%d]: got %v, want %v", i, got, want) + } + } + + triggers := state[0].triggers + if got := int16(triggers); got != 5 { + t.Errorf("L2: got %v, want 5", got) + } + if got := int16(triggers >> 16); got != 6 { + t.Errorf("R2: got %v, want 6", got) + } +} + +func TestInputState_NegativeAxes(t *testing.T) { + state := InputState{} + data := []byte{ + 0x00, 0x00, // buttons + 0x00, 0x80, // LX: -32768 + 0xFF, 0xFF, // LY: -1 + 0x01, 0x80, // RX: -32767 + 0xFE, 0xFF, // RY: -2 + } + state.SetInput(0, data) + + axes := state[0].axes + expected := []int16{-32768, -1, -32767, -2} + for i, want := range expected { + got := int16(axes >> (i * 16)) + if got != want { + t.Errorf("axis[%d]: got %v, want %v", i, got, want) + } + } +} + func TestInputState_Concurrent(t *testing.T) { var wg sync.WaitGroup state := InputState{} @@ -69,7 +177,8 @@ func TestInputState_Concurrent(t *testing.T) { for range events { player := rand.Intn(maxPort) go func() { - state.SetInput(player, []byte{0, 1, 0, 0, 0, 0, 0, 0, 0, 0}) + // Full 14-byte input + state.SetInput(player, []byte{0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}) wg.Done() }() } diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.c b/pkg/worker/caged/libretro/nanoarch/nanoarch.c index d9010539..63d3b4d4 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.c +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.c @@ -33,30 +33,30 @@ void *same_thread_with_args(void *f, int type, ...); #define INPUT_MAX_KEYS 512 typedef struct { - // Retropad: store raw button bitmask and analog axes per port uint32_t buttons[INPUT_MAX_PORTS]; - int16_t analog[INPUT_MAX_PORTS][4]; // 4 axes per port + int16_t analog[INPUT_MAX_PORTS][4]; // LX, LY, RX, RY + int16_t triggers[INPUT_MAX_PORTS][2]; // L2, R2 - // Keyboard uint8_t keyboard[INPUT_MAX_KEYS]; - - // Mouse int16_t mouse_x; int16_t mouse_y; - uint8_t mouse_buttons; // bit 0=left, bit 1=right, bit 2=middle + uint8_t mouse_buttons; } input_cache_t; static input_cache_t input_cache = {0}; // Update entire port state at once void input_cache_set_port(unsigned port, uint32_t buttons, - int16_t axis0, int16_t axis1, int16_t axis2, int16_t axis3) { + int16_t lx, int16_t ly, int16_t rx, int16_t ry, + int16_t l2, int16_t r2) { if (port < INPUT_MAX_PORTS) { input_cache.buttons[port] = buttons; - input_cache.analog[port][0] = axis0; - input_cache.analog[port][1] = axis1; - input_cache.analog[port][2] = axis2; - input_cache.analog[port][3] = axis3; + input_cache.analog[port][0] = lx; + input_cache.analog[port][1] = ly; + input_cache.analog[port][2] = rx; + input_cache.analog[port][3] = ry; + input_cache.triggers[port][0] = l2; + input_cache.triggers[port][1] = r2; } } @@ -202,23 +202,36 @@ int16_t core_input_state_cgo(unsigned port, unsigned device, unsigned index, uns switch (device) { case RETRO_DEVICE_JOYPAD: - // Extract button bit from cached bitmask return (int16_t)((input_cache.buttons[port] >> id) & 1); case RETRO_DEVICE_ANALOG: switch (index) { case RETRO_DEVICE_INDEX_ANALOG_LEFT: - // id: 0=X, 1=Y - if (id < 2) { + // id: RETRO_DEVICE_ID_ANALOG_X=0, RETRO_DEVICE_ID_ANALOG_Y=1 + if (id <= RETRO_DEVICE_ID_ANALOG_Y) { return input_cache.analog[port][id]; } break; case RETRO_DEVICE_INDEX_ANALOG_RIGHT: - // id: 0=X, 1=Y -> stored in axes[2], axes[3] - if (id < 2) { + // id: RETRO_DEVICE_ID_ANALOG_X=0, RETRO_DEVICE_ID_ANALOG_Y=1 + if (id <= RETRO_DEVICE_ID_ANALOG_Y) { return input_cache.analog[port][2 + id]; } break; + case RETRO_DEVICE_INDEX_ANALOG_BUTTON: + // Any button can be queried as analog + // id = RETRO_DEVICE_ID_JOYPAD_* (0-15) + // For now, only L2/R2 have analog values + switch (id) { + case RETRO_DEVICE_ID_JOYPAD_L2: + return input_cache.triggers[port][0]; + case RETRO_DEVICE_ID_JOYPAD_R2: + return input_cache.triggers[port][1]; + default: + // Other buttons: return digital as 0 or 0x7fff + return ((input_cache.buttons[port] >> id) & 1) ? 0x7FFF : 0; + } + break; } break; @@ -232,12 +245,12 @@ int16_t core_input_state_cgo(unsigned port, unsigned device, unsigned index, uns switch (id) { case RETRO_DEVICE_ID_MOUSE_X: { int16_t x = input_cache.mouse_x; - input_cache.mouse_x = 0; // Consume delta + input_cache.mouse_x = 0; return x; } case RETRO_DEVICE_ID_MOUSE_Y: { int16_t y = input_cache.mouse_y; - input_cache.mouse_y = 0; // Consume delta + input_cache.mouse_y = 0; return y; } case RETRO_DEVICE_ID_MOUSE_LEFT: From 9e6efc231993fe5485e8e68ee9ddd78f1b752f53 Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Tue, 30 Dec 2025 14:36:48 +0300 Subject: [PATCH 361/361] Update retropad input --- web/js/input/input.js | 4 +- web/js/input/keys.js | 10 ++- web/js/input/retropad.js | 151 +++++++++++++++------------------------ 3 files changed, 68 insertions(+), 97 deletions(-) diff --git a/web/js/input/input.js b/web/js/input/input.js index a636c6ab..2c3fffa4 100644 --- a/web/js/input/input.js +++ b/web/js/input/input.js @@ -5,7 +5,7 @@ import { sub } from 'event'; -export {KEY} from './keys.js?v=3'; +export {KEY, JOYPAD_KEYS} from './keys.js?v=3'; import {joystick} from './joystick.js?v=3'; import {keyboard} from './keyboard.js?v=3' @@ -44,7 +44,7 @@ export const input = { toggle(on = true) { if (on === input_state.retropad) return input_state.retropad = on - on ? retropad.enable() : retropad.disable() + retropad.toggle(on) } }, set kbm(v) { diff --git a/web/js/input/keys.js b/web/js/input/keys.js index 4406823e..60e45e3e 100644 --- a/web/js/input/keys.js +++ b/web/js/input/keys.js @@ -30,4 +30,12 @@ export const KEY = { R3: 'r3', REC: 'rec', RESET: 'reset', -} +}; + +// Keys match libretro RETRO_DEVICE_ID_JOYPAD_* +export const JOYPAD_KEYS = [ + KEY.B, KEY.Y, KEY.SELECT, KEY.START, + KEY.UP, KEY.DOWN, KEY.LEFT, KEY.RIGHT, + KEY.A, KEY.X, KEY.L, KEY.R, + KEY.L2, KEY.R2, KEY.L3, KEY.R3 +] diff --git a/web/js/input/retropad.js b/web/js/input/retropad.js index 2ecbd659..0e7026ee 100644 --- a/web/js/input/retropad.js +++ b/web/js/input/retropad.js @@ -1,101 +1,64 @@ -import { - pub, - CONTROLLER_UPDATED -} from 'event'; -import {KEY} from 'input' -import {log} from 'log'; +import {pub, CONTROLLER_UPDATED} from 'event'; +import {JOYPAD_KEYS} from 'input'; -const pollingIntervalMs = 5; -let controllerChangedIndex = -1; - -// Libretro config -let controllerState = { - [KEY.B]: false, - [KEY.Y]: false, - [KEY.SELECT]: false, - [KEY.START]: false, - [KEY.UP]: false, - [KEY.DOWN]: false, - [KEY.LEFT]: false, - [KEY.RIGHT]: false, - [KEY.A]: false, - [KEY.X]: false, - // extra - [KEY.L]: false, - [KEY.R]: false, - [KEY.L2]: false, - [KEY.R2]: false, - [KEY.L3]: false, - [KEY.R3]: false -}; - -const poll = (intervalMs, callback) => { - let _ticker = 0; - return { - enable: () => { - if (_ticker > 0) return; - log.debug(`[input] poll set to ${intervalMs}ms`); - _ticker = setInterval(callback, intervalMs) - }, - disable: () => { - if (_ticker < 1) return; - log.debug('[input] poll has been disabled'); - clearInterval(_ticker); - _ticker = 0; - } - } -}; - -const controllerEncoded = [0, 0, 0, 0, 0]; -const keys = Object.keys(controllerState); - -const sendControllerState = () => { - if (controllerChangedIndex >= 0) { - const state = _getState(); - pub(CONTROLLER_UPDATED, _encodeState(state)); - controllerChangedIndex = -1; - } -}; - -const setKeyState = (name, state) => { - if (controllerState[name] !== undefined) { - controllerState[name] = state; - controllerChangedIndex = Math.max(controllerChangedIndex, 0); - } -}; - -const setAxisChanged = (index, value) => { - if (controllerEncoded[index + 1] !== undefined) { - controllerEncoded[index + 1] = Math.floor(32767 * value); - controllerChangedIndex = Math.max(controllerChangedIndex, index + 1); - } -}; - -/** - * Converts key state into a bitmap and prepends it to the axes state. +/* + * [BUTTONS, LEFT_X, LEFT_Y, RIGHT_X, RIGHT_Y] * - * @returns {Uint16Array} The controller state. - * First uint16 is the controller state bitmap. - * The other uint16 are the axes values. - * Truncated to the last value changed. - * - * @private + * Buttons are packed into a 16-bit bitmask where each bit is one button. + * Axes are signed 16-bit values ranging from -32768 to 32767. + * The whole thing is 10 bytes when sent over the wire. */ -const _encodeState = (state) => new Uint16Array(state) +const state = new Int16Array(5); +let buttons = 0; +let dirty = false; +let rafId = 0; -const _getState = () => { - controllerEncoded[0] = 0; - for (let i = 0, len = keys.length; i < len; i++) { - controllerEncoded[0] += controllerState[keys[i]] ? 1 << i : 0; +/* + * Polls controller state using requestAnimationFrame which gives us + * ~60Hz update rate that syncs with the display. As a bonus, + * it automatically pauses when the tab goes to background. + * We only send data when something actually changed. + */ +const poll = () => { + if (dirty) { + state[0] = buttons; + pub(CONTROLLER_UPDATED, new Uint16Array(state.buffer)); + dirty = false; } - return controllerEncoded.slice(0, controllerChangedIndex + 1); -} + rafId = requestAnimationFrame(poll); +}; -const _poll = poll(pollingIntervalMs, sendControllerState) +/* + * Toggles a button on or off in the bitmask. The button's position + * in JOYPAD_KEYS determines which bit gets flipped. For example, + * if A is at index 8, pressing it sets bit 8. + */ +const setKeyState = (key, pressed) => { + const idx = JOYPAD_KEYS.indexOf(key); + if (idx < 0) return; -export const retropad = { - enable: () => _poll.enable(), - disable: () => _poll.disable(), - setKeyState, - setAxisChanged, -} + const prev = buttons; + buttons = pressed ? buttons | (1 << idx) : buttons & ~(1 << idx); + dirty ||= buttons !== prev; +}; + +/* + * Updates an analog stick axis. Axes 0-1 are the left stick (X and Y), + * axes 2-3 are the right stick. Input should be a float from -1 to 1 + * which gets converted to a signed 16-bit integer for transmission. + */ +const setAxisChanged = (axis, value) => { + if (axis < 0 || axis > 3) return; + + const v = Math.trunc(Math.max(-1, Math.min(1, value)) * 32767); + dirty ||= state[++axis] !== v; + state[axis] = v; +}; + +// Starts or stops the polling loop +const toggle = (on) => { + if (on === !!rafId) return; + rafId = on ? requestAnimationFrame(poll) : (cancelAnimationFrame(rafId), 0); +}; + +export const retropad = {toggle, setKeyState, setAxisChanged}; \ No newline at end of file
    • Arrows(move),ZXCVAS(game ABXYLR),1/2(1st/2nd player),Shift/Enter/K/L(select/start/save/load),F(fullscreen),share(copy - sharelink to clipboard) +
    + Arrows (move), ZXCVAS (game ABXYLR), 1/2 (1st/2nd player), Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy shared link to the clipboard)
    - -
    player choice
    -
    -
    -
    -
    -
    -
    -
    -
    +
    + + +
    +
    + +
    +
    +
    +
    +
    +
    @@ -125,16 +127,16 @@ - + - + - + - + diff --git a/web/js/api/api.js b/web/js/api/api.js index bbb21318..20de8312 100644 --- a/web/js/api/api.js +++ b/web/js/api/api.js @@ -21,6 +21,8 @@ const api = (() => { GAME_RECORDING: 110, GET_WORKER_LIST: 111, GAME_ERROR_NO_FREE_SLOTS: 112, + + APP_VIDEO_CHANGE: 150, }); const packet = (type, payload, id) => { @@ -31,18 +33,21 @@ const api = (() => { socket.send(packet); }; + const decodeBytes = (b) => String.fromCharCode.apply(null, new Uint8Array(b)) + return Object.freeze({ endpoint: endpoints, + decode: (b) => JSON.parse(decodeBytes(b)), server: - Object.freeze({ + { initWebrtc: () => packet(endpoints.INIT_WEBRTC), sendIceCandidate: (candidate) => packet(endpoints.ICE_CANDIDATE, btoa(JSON.stringify(candidate))), sendSdp: (sdp) => packet(endpoints.ANSWER, btoa(JSON.stringify(sdp))), latencyCheck: (id, list) => packet(endpoints.LATENCY_CHECK, list, id), getWorkerList: () => packet(endpoints.GET_WORKER_LIST), - }), + }, game: - Object.freeze({ + { load: () => packet(endpoints.GAME_LOAD), save: () => packet(endpoints.GAME_SAVE), setPlayerIndex: (i) => packet(endpoints.GAME_SET_PLAYER_INDEX, i), @@ -60,6 +65,6 @@ const api = (() => { user: userName, }), quit: (roomId) => packet(endpoints.GAME_QUIT, {room_id: roomId}), - }) + } }) })(socket); diff --git a/web/js/controller.js b/web/js/controller.js index 5ae5443c..edd0e61e 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -153,8 +153,8 @@ const saveGame = utils.debounce(() => api.game.save(), 1000); const loadGame = utils.debounce(() => api.game.load(), 1000); - const onMessage = (message) => { - const {id, t, p: payload} = message; + const onMessage = (m) => { + const {id, t, p: payload} = m; switch (t) { case api.endpoint.INIT: event.pub(WEBRTC_NEW_CONNECTION, payload); @@ -166,7 +166,10 @@ event.pub(WEBRTC_ICE_CANDIDATE_RECEIVED, {candidate: payload}); break; case api.endpoint.GAME_START: - event.pub(GAME_ROOM_AVAILABLE, {roomId: payload}); + if (payload.av) { + event.pub(APP_VIDEO_CHANGED, payload.av) + } + event.pub(GAME_ROOM_AVAILABLE, {roomId: payload.roomId}); break; case api.endpoint.GAME_SAVE: event.pub(GAME_SAVED); @@ -189,6 +192,9 @@ case api.endpoint.GAME_ERROR_NO_FREE_SLOTS: event.pub(GAME_ERROR_NO_FREE_SLOTS); break; + case api.endpoint.APP_VIDEO_CHANGE: + event.pub(APP_VIDEO_CHANGED, {...payload}) + break; } } @@ -429,6 +435,7 @@ event.sub(GAME_ERROR_NO_FREE_SLOTS, () => message.show("No free slots :(", 2500)); event.sub(WEBRTC_NEW_CONNECTION, (data) => { workerManager.whoami(data.wid); + webrtc.onData = (x) => onMessage(api.decode(x.data)) webrtc.start(data.ice); api.server.initWebrtc() gameList.set(data.games); @@ -438,7 +445,6 @@ event.sub(WEBRTC_SDP_OFFER, (data) => webrtc.setRemoteDescription(data.sdp, stream.video.el())); event.sub(WEBRTC_ICE_CANDIDATE_RECEIVED, (data) => webrtc.addCandidate(data.candidate)); event.sub(WEBRTC_ICE_CANDIDATES_FLUSH, () => webrtc.flushCandidates()); - // event.sub(MEDIA_STREAM_READY, () => rtcp.start()); event.sub(WEBRTC_CONNECTION_READY, onConnectionReady); event.sub(WEBRTC_CONNECTION_CLOSED, () => { input.poll.disable(); diff --git a/web/js/event/event.js b/web/js/event/event.js index 9ad45a4b..3c412d20 100644 --- a/web/js/event/event.js +++ b/web/js/event/event.js @@ -101,3 +101,5 @@ const SETTINGS_CLOSED = 'settingsClosed'; const RECORDING_TOGGLED = 'recordingToggle' const RECORDING_STATUS_CHANGED = 'recordingStatusChanged' + +const APP_VIDEO_CHANGED = 'appVideoChanged' diff --git a/web/js/network/webrtc.js b/web/js/network/webrtc.js index 99c5432a..8d72c8fd 100644 --- a/web/js/network/webrtc.js +++ b/web/js/network/webrtc.js @@ -12,16 +12,16 @@ */ const webrtc = (() => { let connection; - let inputChannel; + let dataChannel; let mediaStream; - let candidates = Array(); + let candidates = []; let isAnswered = false; let isFlushing = false; let connected = false; let inputReady = false; - let onMessage; + let onData; const start = (iceservers) => { log.info('[rtc] <- ICE servers', iceservers); @@ -31,16 +31,16 @@ const webrtc = (() => { connection.ondatachannel = e => { log.debug('[rtc] ondatachannel', e.channel.label) - inputChannel = e.channel; - inputChannel.onopen = () => { + dataChannel = e.channel; + dataChannel.onopen = () => { log.info('[rtc] the input channel has been opened'); inputReady = true; event.pub(WEBRTC_CONNECTION_READY) }; - if (onMessage) { - inputChannel.onmessage = onMessage; + if (onData) { + dataChannel.onmessage = onData; } - inputChannel.onclose = () => log.info('[rtc] the input channel has been closed'); + dataChannel.onclose = () => log.info('[rtc] the input channel has been closed'); } connection.oniceconnectionstatechange = ice.onIceConnectionStateChange; connection.onicegatheringstatechange = ice.onIceStateChange; @@ -62,9 +62,9 @@ const webrtc = (() => { connection.close(); connection = null; } - if (inputChannel) { - inputChannel.close(); - inputChannel = null; + if (dataChannel) { + dataChannel.close(); + dataChannel = null; } candidates = Array(); log.info('[rtc] WebRTC has been closed'); @@ -173,10 +173,13 @@ const webrtc = (() => { // return false // } // }, - input: (data) => inputChannel.send(data), + input: (data) => dataChannel.send(data), isConnected: () => connected, isInputReady: () => inputReady, getConnection: () => connection, stop, + set onData(fn) { + onData = fn + } } })(event, log); diff --git a/web/js/stream/stream.js b/web/js/stream/stream.js index 64e65a16..9ab3dd49 100644 --- a/web/js/stream/stream.js +++ b/web/js/stream/stream.js @@ -16,6 +16,9 @@ const stream = (() => { state = { screen: screen, timerId: null, + w: 0, + h: 0, + aspect: 4/3 }; const mute = (mute) => screen.muted = mute @@ -82,6 +85,25 @@ const stream = (() => { useCustomScreen(options.mirrorMode === 'mirror'); }, false); + screen.addEventListener('fullscreenchange', () => { + const fullscreen = document.fullscreenElement + + + screen.style.padding = '0' + if (fullscreen) { + const dw = (window.innerWidth - fullscreen.clientHeight * state.aspect) / 2 + screen.style.padding = `0 ${dw}px` + // chrome bug + setTimeout(() => { + const dw = (window.innerHeight - fullscreen.clientHeight * state.aspect) / 2 + screen.style.padding = `0 ${dw}px` + }, 1) + } + + // !to flipped + + }) + const useCustomScreen = (use) => { if (use) { if (screen.paused || screen.ended) return; @@ -95,13 +117,15 @@ const stream = (() => { canvas.setAttribute('width', screen.videoWidth); canvas.setAttribute('height', screen.videoHeight); canvas.style['image-rendering'] = 'pixelated'; + canvas.style.width = '100%' + canvas.style.height = '100%' canvas.classList.add('game-screen'); // stretch depending on the video orientation // portrait -- vertically, landscape -- horizontally const isPortrait = screen.videoWidth < screen.videoHeight; canvas.style.width = isPortrait ? 'auto' : canvas.style.width; - canvas.style.height = isPortrait ? canvas.style.height : 'auto'; + // canvas.style.height = isPortrait ? canvas.style.height : 'auto'; let surface = canvas.getContext('2d'); screen.parentNode.insertBefore(canvas, screen.nextSibling); @@ -135,6 +159,27 @@ const stream = (() => { } }); + + const fit = 'contain' + + event.sub(APP_VIDEO_CHANGED, (payload) => { + const {w, h, a} = payload + + state.aspect = a + + const a2 = w / h + + const attr = a.toFixed(6) !== a2.toFixed(6) ? 'fill' : fit + state.screen.style['object-fit'] = attr + + state.h = payload.h + state.w = Math.floor(payload.h * payload.a) + // payload.a > 0 && (state.aspect = payload.a) + state.screen.setAttribute('width', payload.w) + state.screen.setAttribute('height', payload.h) + state.screen.style.aspectRatio = state.aspect + }) + return { audio: {mute}, video: {toggleFullscreen, el: getVideoEl}, @@ -144,4 +189,4 @@ const stream = (() => { init } } -)(env, gui, log, opts, settings); +)(env, event, gui, log, opts, settings); From e6e537d7991453168b58668c2c498445a7d7ea58 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 13 Nov 2023 18:46:41 +0300 Subject: [PATCH 140/361] Add a generic S3 provider for cloud saves --- go.mod | 29 ++++-- go.sum | 67 +++++++++----- pkg/config/config.yaml | 13 ++- pkg/config/worker.go | 7 +- pkg/worker/caged/libretro/caged.go | 16 ++-- pkg/worker/caged/libretro/cloud.go | 44 +++++---- pkg/worker/caged/libretro/frontend.go | 2 + pkg/worker/cloud/cloudstore.go | 128 -------------------------- pkg/worker/cloud/cloudstore_test.go | 54 ----------- pkg/worker/cloud/s3.go | 91 ++++++++++++++++++ pkg/worker/cloud/s3_test.go | 55 +++++++++++ pkg/worker/cloud/store.go | 24 +++++ pkg/worker/worker.go | 2 +- 13 files changed, 288 insertions(+), 244 deletions(-) delete mode 100644 pkg/worker/cloud/cloudstore.go delete mode 100644 pkg/worker/cloud/cloudstore_test.go create mode 100644 pkg/worker/cloud/s3.go create mode 100644 pkg/worker/cloud/s3_test.go create mode 100644 pkg/worker/cloud/store.go diff --git a/go.mod b/go.mod index e11342a3..df9b8594 100644 --- a/go.mod +++ b/go.mod @@ -11,44 +11,55 @@ require ( github.com/gorilla/websocket v1.5.0 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.0.1 + github.com/minio/minio-go/v7 v7.0.63 github.com/pion/ice/v3 v3.0.2 - github.com/pion/interceptor v0.1.24 + github.com/pion/interceptor v0.1.25 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.0-beta.6 + github.com/pion/webrtc/v4 v4.0.0-beta.7 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.31.0 github.com/veandco/go-sdl2 v0.4.35 - golang.org/x/crypto v0.14.0 + golang.org/x/crypto v0.15.0 golang.org/x/image v0.13.0 gopkg.in/yaml.v3 v3.0.1 ) require ( github.com/davecgh/go-spew v1.1.1 // indirect + github.com/dustin/go-humanize v1.0.1 // indirect github.com/google/uuid v1.4.0 // indirect + github.com/json-iterator/go v1.1.12 // indirect + github.com/klauspost/compress v1.17.2 // indirect + github.com/klauspost/cpuid/v2 v2.2.6 // indirect github.com/mattn/go-colorable v0.1.13 // indirect github.com/mattn/go-isatty v0.0.20 // indirect + github.com/minio/md5-simd v1.1.2 // indirect + github.com/minio/sha256-simd v1.0.1 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect github.com/mitchellh/mapstructure v1.5.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect + github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect + github.com/modern-go/reflect2 v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect github.com/pion/dtls/v2 v2.2.7 // indirect github.com/pion/mdns v0.0.9 // indirect github.com/pion/randutil v0.1.0 // indirect - github.com/pion/rtcp v1.2.10 // indirect - github.com/pion/rtp v1.8.2 // indirect + github.com/pion/rtcp v1.2.12 // indirect + github.com/pion/rtp v1.8.3 // indirect github.com/pion/sctp v1.8.9 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect - github.com/pion/srtp/v3 v3.0.0 // indirect + github.com/pion/srtp/v3 v3.0.1 // indirect github.com/pion/stun/v2 v2.0.0 // indirect github.com/pion/transport/v2 v2.2.4 // indirect github.com/pion/transport/v3 v3.0.1 // indirect github.com/pion/turn/v3 v3.0.1 // indirect github.com/pmezard/go-difflib v1.0.0 // indirect + github.com/sirupsen/logrus v1.9.3 // indirect github.com/stretchr/testify v1.8.4 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.17.0 // indirect - golang.org/x/sys v0.13.0 // indirect - golang.org/x/text v0.13.0 // indirect + golang.org/x/net v0.18.0 // indirect + golang.org/x/sys v0.14.0 // indirect + golang.org/x/text v0.14.0 // indirect + gopkg.in/ini.v1 v1.67.0 // indirect ) diff --git a/go.sum b/go.sum index 1eb82e82..fa96e072 100644 --- a/go.sum +++ b/go.sum @@ -6,6 +6,8 @@ github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSV github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= +github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto= github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo= github.com/fsnotify/fsnotify v1.4.9/go.mod h1:znqG4EE+3YCdAaPaxE2ZRY/06pZUdp0tY4IgpuI1SZQ= github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA= @@ -29,12 +31,20 @@ github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMyw github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= github.com/google/uuid v1.3.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/google/uuid v1.4.0 h1:MtMxsa51/r9yyhkyLsVeVt0B+BGQZzpQiTQ4eHZ8bc4= github.com/google/uuid v1.4.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.0 h1:PPwGk2jz7EePpoHN/+ClbZu8SPxiqlu12wZP/3sWmnc= github.com/gorilla/websocket v1.5.0/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= +github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= +github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= +github.com/klauspost/compress v1.17.2 h1:RlWWUY/Dr4fL8qk9YG7DTZ7PDgME2V4csBXA8L/ixi4= +github.com/klauspost/compress v1.17.2/go.mod h1:ntbaceVETuRiXiv4DpjP66DpAtAGkEQskQzEyD//IeE= +github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/klauspost/cpuid/v2 v2.2.6 h1:ndNyv040zDGIDh8thGkXYjnFtiN02M1PVVF+JE/48xc= +github.com/klauspost/cpuid/v2 v2.2.6/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws= github.com/knadh/koanf/maps v0.1.1 h1:G5TjmUh2D7G2YWf5SQQqSiHRJEjaicvU0KpypqB3NIs= github.com/knadh/koanf/maps v0.1.1/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= github.com/knadh/koanf/v2 v2.0.1 h1:1dYGITt1I23x8cfx8ZnldtezdyaZtfAuRtIFOiRzK7g= @@ -50,12 +60,23 @@ github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/ github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= +github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= +github.com/minio/minio-go/v7 v7.0.63 h1:GbZ2oCvaUdgT5640WJOpyDhhDxvknAJU2/T3yurwcbQ= +github.com/minio/minio-go/v7 v7.0.63/go.mod h1:Q6X7Qjb7WMhvG65qKf4gUgA5XaiSox74kR1uAEjxRS4= +github.com/minio/sha256-simd v1.0.1 h1:6kaan5IFmwTNynnKKpDHe6FWHohJOHhCPchzK49dzMM= +github.com/minio/sha256-simd v1.0.1/go.mod h1:Pz6AKMiUdngCLpeTL/RJY1M9rUuPMYujV5xJjtbRSN8= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= +github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M= +github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk= github.com/nxadm/tail v1.4.4/go.mod h1:kenIhsEOeOJmVchQTgglprH7qJGnHDVpk1VPCcaMI8A= github.com/nxadm/tail v1.4.8/go.mod h1:+ncqLTQzXmGhMZNUePPaPqPvBxHAIsmXswZKocGu+AU= github.com/onsi/ginkgo v1.6.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= @@ -69,30 +90,29 @@ github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= -github.com/pion/ice/v3 v3.0.1/go.mod h1:j4tfTlj4aSEQN9gP3IdliSHcUTWTu9tlOZL0c59MFXo= github.com/pion/ice/v3 v3.0.2 h1:dNQnKsjLvOWz+PaI4tw1VnLYTp9adihC1HIASFGajmI= github.com/pion/ice/v3 v3.0.2/go.mod h1:q3BDzTsxbqP0ySMSHrFuw2MYGUx/AC3WQfRGC5F/0Is= -github.com/pion/interceptor v0.1.24 h1:lN4ua3yUAJCgNKQKcZIM52wFjBgjN0r7shLj91PkJ0c= -github.com/pion/interceptor v0.1.24/go.mod h1:wkbPYAak5zKsfpVDYMtEfWEy8D4zL+rpxCxPImLOg3Y= +github.com/pion/interceptor v0.1.25 h1:pwY9r7P6ToQ3+IF0bajN0xmk/fNw/suTgaTdlwTDmhc= +github.com/pion/interceptor v0.1.25/go.mod h1:wkbPYAak5zKsfpVDYMtEfWEy8D4zL+rpxCxPImLOg3Y= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= -github.com/pion/mdns v0.0.8/go.mod h1:hYE72WX8WDveIhg7fmXgMKivD3Puklk0Ymzog0lSyaI= github.com/pion/mdns v0.0.9 h1:7Ue5KZsqq8EuqStnpPWV33vYYEH0+skdDN5L7EiEsI4= github.com/pion/mdns v0.0.9/go.mod h1:2JA5exfxwzXiCihmxpTKgFUpiQws2MnipoPK09vecIc= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= -github.com/pion/rtcp v1.2.10 h1:nkr3uj+8Sp97zyItdN60tE/S6vk4al5CPRR6Gejsdjc= github.com/pion/rtcp v1.2.10/go.mod h1:ztfEwXZNLGyF1oQDttz/ZKIBaeeg/oWbRYqzBM9TL1I= -github.com/pion/rtp v1.8.1/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= -github.com/pion/rtp v1.8.2 h1:oKMM0K1/QYQ5b5qH+ikqDSZRipP5mIxPJcgcvw5sH0w= +github.com/pion/rtcp v1.2.12 h1:bKWiX93XKgDZENEXCijvHRU/wRifm6JV5DGcH6twtSM= +github.com/pion/rtcp v1.2.12/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9L4= github.com/pion/rtp v1.8.2/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= +github.com/pion/rtp v1.8.3 h1:VEHxqzSVQxCkKDSHro5/4IUUG1ea+MFdqR2R3xSpNU8= +github.com/pion/rtp v1.8.3/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/sctp v1.8.5/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= github.com/pion/sctp v1.8.9 h1:TP5ZVxV5J7rz7uZmbyvnUvsn7EJ2x/5q9uhsTtXbI3g= github.com/pion/sctp v1.8.9/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= github.com/pion/sdp/v3 v3.0.6 h1:WuDLhtuFUUVpTfus9ILC4HRyHsW6TdugjEX/QY9OiUw= github.com/pion/sdp/v3 v3.0.6/go.mod h1:iiFWFpQO8Fy3S5ldclBkpXqmWy02ns78NOKoLLL0YQw= -github.com/pion/srtp/v3 v3.0.0 h1:dH5nZUTxN+JDu4otle8Dfh5E/MHR6m8/aib7eD22QDc= -github.com/pion/srtp/v3 v3.0.0/go.mod h1:WxJGk0scShe0UdUidDgR0kDHywX7JN83JOYPkYiLdpM= +github.com/pion/srtp/v3 v3.0.1 h1:AkIQRIZ+3tAOJMQ7G301xtrD1vekQbNeRO7eY1K8ZHk= +github.com/pion/srtp/v3 v3.0.1/go.mod h1:3R3a1qIOIxBkVTLGFjafKK6/fJoTdQDhcC67HOyMbJ8= github.com/pion/stun/v2 v2.0.0 h1:A5+wXKLAypxQri59+tmQKVs7+l6mMM+3d+eER9ifRU0= github.com/pion/stun/v2 v2.0.0/go.mod h1:22qRSh08fSEttYUmJZGlriq9+03jtVmXNODgLccj8GQ= github.com/pion/transport v0.14.1 h1:XSM6olwW+o8J4SCmOBb/BpwZypkHeyM0PGFCxNQBr40= @@ -104,8 +124,8 @@ github.com/pion/transport/v3 v3.0.1 h1:gDTlPJwROfSfz6QfSi0ZmeCSkFcnWWiiR9ES0ouAN github.com/pion/transport/v3 v3.0.1/go.mod h1:UY7kiITrlMv7/IKgd5eTUcaahZx5oUN3l9SzK5f5xE0= github.com/pion/turn/v3 v3.0.1 h1:wLi7BTQr6/Q20R0vt/lHbjv6y4GChFtC33nkYbasoT8= github.com/pion/turn/v3 v3.0.1/go.mod h1:MrJDKgqryDyWy1/4NT9TWfXWGMC7UHT6pJIv1+gMeNE= -github.com/pion/webrtc/v4 v4.0.0-beta.6 h1:swTwlzDY+1zDtW7ogXjNwlUY0xW733UUIAUMNUTCkPw= -github.com/pion/webrtc/v4 v4.0.0-beta.6/go.mod h1:UcyD8jIeTkFqfYJqoHT9qwUSmrtacKaXxgOEujOdhZ8= +github.com/pion/webrtc/v4 v4.0.0-beta.7 h1:OGCl69njLUKzT0ozJEon18W1LqH0GtuxG9Qx+qtxBdg= +github.com/pion/webrtc/v4 v4.0.0-beta.7/go.mod h1:/zWz+1e1qrjaIKYZG/mOfPrntiHOhnd3vGz2Fdo85Ys= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -114,10 +134,14 @@ github.com/rs/xid v1.5.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg= github.com/rs/zerolog v1.31.0 h1:FcTR3NnLWW+NnTwwhFWiJSZr4ECLpqCm6QsEnyvbV4A= github.com/rs/zerolog v1.31.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss= github.com/sclevine/agouti v3.0.0+incompatible/go.mod h1:b4WX9W9L1sfQKXeJf1mUTLZKJ48R1S7H23Ji7oFO5Bw= +github.com/sirupsen/logrus v1.9.3 h1:dueUQJ1C2q9oE3F7wvmSGAaVtTmUizReu6fjN8uqzbQ= +github.com/sirupsen/logrus v1.9.3/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ= github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA= +github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= @@ -137,11 +161,11 @@ golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8U golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= -golang.org/x/crypto v0.10.0/go.mod h1:o4eNf7Ede1fv+hwOwZsTHl9EsPFO6q6ZvYR8vYfY45I= golang.org/x/crypto v0.12.0/go.mod h1:NF0Gs7EO5K4qLn+Ylc+fih8BSTeIjAP05siRnAh98yw= golang.org/x/crypto v0.13.0/go.mod h1:y6Z2r+Rw4iayiXXAIxJIDAJ1zMW4yaTpebo8fPOliYc= -golang.org/x/crypto v0.14.0 h1:wBqGXzWJW6m1XrIKlAH0Hs1JJ7+9KBwnIO8v66Q9cHc= golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= +golang.org/x/crypto v0.15.0 h1:frVn1TEaCEaZcn3Tmd7Y2b5KKPaZ+I32Q2OA3kYp5TA= +golang.org/x/crypto v0.15.0/go.mod h1:4ChreQoLWfG3xLDer1WdlH5NdlQ3+mwnQq1YTKY+72g= golang.org/x/image v0.13.0 h1:3cge/F/QTkNLauhf2QoE9zp+7sr+ZcL4HnoZmdwg9sg= golang.org/x/image v0.13.0/go.mod h1:6mmbMOeV28HuMTgA6OSRkdXKYw/t5W9Uwn2Yv1r3Yxk= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= @@ -159,12 +183,11 @@ golang.org/x/net v0.1.0/go.mod h1:Cx3nUiGt4eDBEyega/BKRp+/AlGL8hYe7U9odMt2Cco= golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= -golang.org/x/net v0.11.0/go.mod h1:2L/ixqYpgIVXmeoSA/4Lu7BzTG4KIyPIryS4IsOd1oQ= golang.org/x/net v0.14.0/go.mod h1:PpSgVXXLK0OxS0F31C1/tv6XNguvCrnXIDrFMspZIUI= golang.org/x/net v0.15.0/go.mod h1:idbUs1IY1+zTqbi8yxTbhexhEEk5ur9LInksu6HrEpk= -golang.org/x/net v0.16.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= -golang.org/x/net v0.17.0 h1:pVaXccu2ozPjCXewfr1S7xza/zcXTity9cCdXQYSjIM= golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= +golang.org/x/net v0.18.0 h1:mIYleuAkSbHh0tCv7RvjL3F6ZVbLjq4+R7zbOn3Kokg= +golang.org/x/net v0.18.0/go.mod h1:/czyP5RqHAH4odGYxBJ1qz0+CE5WZ+2j1YgoEo8F2jQ= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -183,6 +206,7 @@ golang.org/x/sys v0.0.0-20210112080510-489259a85091/go.mod h1:h1NjWce9XRLGQEsW7w golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= @@ -191,18 +215,17 @@ golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.7.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.9.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.13.0 h1:Af8nKPmuFypiUBjVoU9V20FiaFXOcuZI21p0ycVYYGE= golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.14.0 h1:Vz7Qs629MkJkGyHxUlRHizWJRG2j8fbQKjELVSNhy7Q= +golang.org/x/sys v0.14.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= golang.org/x/term v0.7.0/go.mod h1:P32HKFT3hSsZrRxla30E9HqToFYAQPCMs/zFMBUFqPY= golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= -golang.org/x/term v0.9.0/go.mod h1:M6DEAAIenWoTxdKrOltXcmDY3rSplQUkrvaDU5FcQyo= golang.org/x/term v0.11.0/go.mod h1:zC9APTIj3jG3FdV/Ons+XE1riIZXG4aZ4GTHiPZJPIU= golang.org/x/term v0.12.0/go.mod h1:owVbMEjm3cBLCHdkQu9b1opXd4ETQWc3BhuQGKgXgvU= golang.org/x/term v0.13.0/go.mod h1:LTmsnFJwVN6bCy1rVCoS+qHT1HhALEFxKncY3WNNh4U= @@ -213,10 +236,10 @@ golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ= golang.org/x/text v0.4.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= -golang.org/x/text v0.10.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= golang.org/x/text v0.12.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= -golang.org/x/text v0.13.0 h1:ablQoSUd0tRdKxZewP80B+BaqeKJuVhuRxj/dkrun3k= golang.org/x/text v0.13.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= +golang.org/x/text v0.14.0 h1:ScX5w1eTa3QqT8oi6+ziP7dTV1S2+ALU0bI+0zXKWiQ= +golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= golang.org/x/tools v0.0.0-20201224043029-2b0845dc783e/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= @@ -238,6 +261,8 @@ gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8 gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15 h1:YR8cESwS4TdDjEe65xsg0ogRM/Nc3DYOhEAlW+xobZo= gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= gopkg.in/fsnotify.v1 v1.4.7/go.mod h1:Tz8NjZHkW78fSQdbUxIjBTcgA1z1m8ZHf0WmKUhAMys= +gopkg.in/ini.v1 v1.67.0 h1:Dgnx+6+nfE+IfzjUEISNeydPJh9AXNNsWbGP9KzCsOA= +gopkg.in/ini.v1 v1.67.0/go.mod h1:pNLf8WUiyNEtQjuu5G5vTm06TEv9tsIgeAvK8hOrP4k= gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7/go.mod h1:dt/ZhP58zS4L8KSrWDmTeBkI65Dw0HsyUHuEVlX15mw= gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 13104af5..117cfbbb 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -302,14 +302,19 @@ recording: # save directory folder: ./recording +# cloud storage options +# it is mandatory to use a cloud storage when running +# a distributed multi-server configuration in order to +# share save states between nodes (resume games on a different worker) storage: # cloud storage provider: # - empty (No op storage stub) - # - oracle [Oracle Object Storage](https://www.oracle.com/cloud/storage/object-storage.html) + # - s3 (S3 API compatible object storage) provider: - # this value contains arbitrary key attribute: - # - oracle: pre-authenticated URL (see: https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/usingpreauthenticatedrequests.htm) - key: + s3Endpoint: + s3BucketName: + s3AccessKeyId: + s3SecretAccessKey: webrtc: # turn off default Pion interceptors (see: https://github.com/pion/interceptor) diff --git a/pkg/config/worker.go b/pkg/config/worker.go index c0c39adf..5fd4ef23 100644 --- a/pkg/config/worker.go +++ b/pkg/config/worker.go @@ -22,8 +22,11 @@ type WorkerConfig struct { } type Storage struct { - Provider string - Key string + Provider string + S3Endpoint string + S3BucketName string + S3AccessKeyId string + S3SecretAccessKey string } type Worker struct { diff --git a/pkg/worker/caged/libretro/caged.go b/pkg/worker/caged/libretro/caged.go index f71017bf..a0b5f633 100644 --- a/pkg/worker/caged/libretro/caged.go +++ b/pkg/worker/caged/libretro/caged.go @@ -64,14 +64,14 @@ func (c *Caged) EnableRecording(nowait bool, user string, game string) { } func (c *Caged) EnableCloudStorage(uid string, storage cloud.Storage) { - if storage != nil { - wc, err := WithCloud(c.Emulator, uid, storage) - if err != nil { - c.log.Error().Err(err).Msgf("couldn't init %v", wc.HashPath()) - } else { - c.log.Info().Msgf("cloud state %v has been initialized", wc.HashPath()) - c.Emulator = wc - } + if storage == nil { + return + } + if wc, err := WithCloud(c.Emulator, uid, storage); err == nil { + c.Emulator = wc + c.log.Info().Msgf("cloud storage has been initialized") + } else { + c.log.Error().Err(err).Msgf("couldn't init cloud storage") } } diff --git a/pkg/worker/caged/libretro/cloud.go b/pkg/worker/caged/libretro/cloud.go index caaa0335..67f8da14 100644 --- a/pkg/worker/caged/libretro/cloud.go +++ b/pkg/worker/caged/libretro/cloud.go @@ -7,32 +7,37 @@ import ( type CloudFrontend struct { Emulator - stateName string - stateLocalPath string - storage cloud.Storage // a cloud storage to store room state online + uid string + storage cloud.Storage // a cloud storage to store room state online } -func WithCloud(fe Emulator, stateName string, storage cloud.Storage) (*CloudFrontend, error) { - r := &CloudFrontend{Emulator: fe, stateLocalPath: fe.HashPath(), stateName: stateName, storage: storage} +// WithCloud adds the ability to keep game states in the cloud storage like Amazon S3. +// It supports only one file of main save state. +func WithCloud(fe Emulator, uid string, storage cloud.Storage) (*CloudFrontend, error) { + r := &CloudFrontend{Emulator: fe, uid: uid, storage: storage} - // saveOnlineRoomToLocal save online room to local. - // !Supports only one file of main save state. - data, err := r.storage.Load(stateName) - if err != nil { - return nil, err - } - // save the data fetched from the cloud to a local directory - if data != nil { - if err := os.WriteFile(r.stateLocalPath, data, 0644); err != nil { + name := fe.SaveStateName() + + if r.storage.Has(name) { + data, err := r.storage.Load(fe.SaveStateName()) + if err != nil { return nil, err } + // save the data fetched from the cloud to a local directory + if data != nil { + if err := os.WriteFile(fe.HashPath(), data, 0644); err != nil { + return nil, err + } + } } return r, nil } +// !to use emulator save/load calls instead of the storage + func (c *CloudFrontend) HasSave() bool { - _, err := c.storage.Load(c.stateName) + _, err := c.storage.Load(c.SaveStateName()) if err == nil { return true } @@ -43,8 +48,13 @@ func (c *CloudFrontend) SaveGameState() error { if err := c.Emulator.SaveGameState(); err != nil { return err } - if err := c.storage.Save(c.stateName, c.stateLocalPath); err != nil { + path := c.Emulator.HashPath() + data, err := os.ReadFile(path) + if err != nil { return err } - return nil + return c.storage.Save(c.SaveStateName(), data, map[string]string{ + "uid": c.uid, + "type": "cloudretro-main-save", + }) } diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 6a729cb3..dc8316d5 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -36,6 +36,7 @@ type Emulator interface { // SetSessionId sets distinct name for the game session (in order to save/load it later) SetSessionId(name string) SaveGameState() error + SaveStateName() string // HashPath returns the path emulator will save state to HashPath() string // HasSave returns true if the current ROM was saved before @@ -295,6 +296,7 @@ func (f *Frontend) RestoreGameState() error { return f.Load() } func (f *Frontend) Rotation() uint { return f.nano.Rot } func (f *Frontend) SRAMPath() string { return f.storage.GetSRAMPath() } func (f *Frontend) SaveGameState() error { return f.Save() } +func (f *Frontend) SaveStateName() string { return filepath.Base(f.HashPath()) } func (f *Frontend) Scale() float64 { return f.scale } func (f *Frontend) SetAudioCb(cb func(app.Audio)) { f.onAudio = cb } func (f *Frontend) SetSessionId(name string) { f.storage.SetMainSaveName(name) } diff --git a/pkg/worker/cloud/cloudstore.go b/pkg/worker/cloud/cloudstore.go deleted file mode 100644 index 2413a7a5..00000000 --- a/pkg/worker/cloud/cloudstore.go +++ /dev/null @@ -1,128 +0,0 @@ -package cloud - -import ( - "bytes" - "crypto/md5" - "encoding/base64" - "errors" - "fmt" - "io" - "net/http" - "time" - - "github.com/giongto35/cloud-game/v3/pkg/os" -) - -// !to replace all with unified s3 api - -type Storage interface { - Save(name string, localPath string) (err error) - Load(name string) (data []byte, err error) -} - -type OracleDataStorageClient struct { - accessURL string - client *http.Client -} - -func Store(provider, key string) (Storage, error) { - var st Storage - var err error - switch provider { - case "oracle": - st, err = NewOracleDataStorageClient(key) - case "coordinator": - default: - } - return st, err -} - -// NewOracleDataStorageClient returns either a new Oracle Data Storage -// client or some error in case of failure. -// Oracle infrastructure access is based on pre-authenticated requests, -// see: https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/usingpreauthenticatedrequests.htm -// -// It follows broken Google Cloud Storage client design. -func NewOracleDataStorageClient(accessURL string) (*OracleDataStorageClient, error) { - if accessURL == "" { - return nil, errors.New("pre-authenticated request was not specified") - } - return &OracleDataStorageClient{ - accessURL: accessURL, - client: &http.Client{ - Timeout: 10 * time.Second, - }, - }, nil -} - -func (s *OracleDataStorageClient) Save(name string, localPath string) (err error) { - if s == nil { - return nil - } - - dat, err := os.ReadFile(localPath) - if err != nil { - return err - } - - req, err := http.NewRequest("PUT", s.accessURL+name, bytes.NewBuffer(dat)) - if err != nil { - return err - } - - resp, err := s.client.Do(req) - if err != nil { - return err - } - defer func() { - _ = resp.Body.Close() - }() - if resp.StatusCode != 200 { - return errors.New(resp.Status) - } - - dstMD5 := resp.Header.Get("Opc-Content-Md5") - srcMD5 := base64.StdEncoding.EncodeToString(md5Hash(dat)) - if dstMD5 != srcMD5 { - return fmt.Errorf("MD5 mismatch %v != %v", srcMD5, dstMD5) - } - - return nil -} - -func (s *OracleDataStorageClient) Load(name string) (data []byte, err error) { - if s == nil { - return nil, errors.New("cloud storage was not initialized") - } - - res, err := s.client.Get(s.accessURL + name) - if err != nil { - return nil, err - } - defer func() { - _ = res.Body.Close() - }() - - if res.StatusCode != 200 { - return nil, errors.New(res.Status) - } - - dat, err := io.ReadAll(res.Body) - if err != nil { - return nil, err - } - - dstMD5 := res.Header.Get("Content-Md5") - srcMD5 := base64.StdEncoding.EncodeToString(md5Hash(dat)) - if dstMD5 != srcMD5 { - return nil, fmt.Errorf("MD5 mismatch %v != %v", srcMD5, dstMD5) - } - - return dat, nil -} - -func md5Hash(data []byte) []byte { - hash := md5.New() - hash.Write(data) - return hash.Sum(nil) -} diff --git a/pkg/worker/cloud/cloudstore_test.go b/pkg/worker/cloud/cloudstore_test.go deleted file mode 100644 index 228d4d29..00000000 --- a/pkg/worker/cloud/cloudstore_test.go +++ /dev/null @@ -1,54 +0,0 @@ -package cloud - -import ( - "io" - "net/http" - "os" - "strings" - "testing" -) - -type rtFunc func(req *http.Request) *http.Response - -func (f rtFunc) RoundTrip(req *http.Request) (*http.Response, error) { return f(req), nil } - -func newTestClient(fn rtFunc) *http.Client { - return &http.Client{ - Transport: fn, - } -} - -func TestOracleSave(t *testing.T) { - client, _ := NewOracleDataStorageClient("test-url/") - client.client = newTestClient(func(req *http.Request) *http.Response { - return &http.Response{ - StatusCode: 200, - Body: io.NopCloser(strings.NewReader("")), - Header: map[string][]string{ - "Opc-Content-Md5": {"CY9rzUYh03PK3k6DJie09g=="}, - }, - } - }) - - tempFile, err := os.CreateTemp("", "oracle_test.file") - if err != nil { - t.Errorf("%v", err) - } - defer func() { - _ = tempFile.Close() - err := os.Remove(tempFile.Name()) - if err != nil { - t.Errorf("%v", err) - } - }() - - _, err = tempFile.WriteString("test") - if err != nil { - return - } - - err = client.Save("oracle_test.file", tempFile.Name()) - if err != nil { - t.Errorf("can't save, err: %v", err) - } -} diff --git a/pkg/worker/cloud/s3.go b/pkg/worker/cloud/s3.go new file mode 100644 index 00000000..bc5227f7 --- /dev/null +++ b/pkg/worker/cloud/s3.go @@ -0,0 +1,91 @@ +package cloud + +import ( + "bytes" + "context" + "errors" + "io" + + "github.com/giongto35/cloud-game/v3/pkg/logger" + "github.com/minio/minio-go/v7" + "github.com/minio/minio-go/v7/pkg/credentials" + "github.com/rs/zerolog/log" +) + +type S3Client struct { + c *minio.Client + bucket string + log *logger.Logger +} + +func NewS3Client(endpoint, bucket, key, secret string, log *logger.Logger) (*S3Client, error) { + s3Client, err := minio.New(endpoint, &minio.Options{ + Creds: credentials.NewStaticV4(key, secret, ""), + Secure: true, + }) + if err != nil { + return nil, err + } + + exists, err := s3Client.BucketExists(context.Background(), bucket) + if err != nil { + return nil, err + } + if !exists { + return nil, errors.New("bucket doesn't exist") + } + + return &S3Client{bucket: bucket, c: s3Client, log: log}, nil +} + +func (s *S3Client) SetBucket(bucket string) { s.bucket = bucket } + +func (s *S3Client) Save(name string, data []byte, meta map[string]string) error { + if s == nil || s.c == nil { + return errors.New("s3 client was not initialised") + } + r := bytes.NewReader(data) + opts := minio.PutObjectOptions{ + ContentType: "application/octet-stream", + SendContentMd5: true, + } + if meta != nil { + opts.UserMetadata = meta + } + + info, err := s.c.PutObject(context.Background(), s.bucket, name, r, int64(len(data)), opts) + if err != nil { + return err + } + s.log.Debug().Msgf("Uploaded: %v", info) + return nil +} + +func (s *S3Client) Load(name string) (data []byte, err error) { + if s == nil || s.c == nil { + return nil, errors.New("s3 client was not initialised") + } + + r, err := s.c.GetObject(context.Background(), s.bucket, name, minio.GetObjectOptions{}) + if err != nil { + return nil, err + } + defer func() { err = errors.Join(err, r.Close()) }() + + stats, err := r.Stat() + log.Debug().Msgf("Downloaded: %v", stats) + dat, err := io.ReadAll(r) + if err != nil { + return nil, err + } + + return dat, nil +} + +func (s *S3Client) Has(name string) bool { + if s == nil || s.c == nil { + return false + } + _, err := s.c.StatObject(context.Background(), s.bucket, name, minio.GetObjectOptions{}) + return err == nil +} diff --git a/pkg/worker/cloud/s3_test.go b/pkg/worker/cloud/s3_test.go new file mode 100644 index 00000000..9701cd9c --- /dev/null +++ b/pkg/worker/cloud/s3_test.go @@ -0,0 +1,55 @@ +package cloud + +import ( + "crypto/rand" + "testing" + + "github.com/giongto35/cloud-game/v3/pkg/logger" +) + +func TestS3(t *testing.T) { + t.Skip() + + name := "test" + s3, err := NewS3Client( + "s3.tebi.io", + "cloudretro-001", + "", + "", + logger.Default(), + ) + if err != nil { + t.Error(err) + } + + buf := make([]byte, 1024*4) + // then we can call rand.Read. + _, err = rand.Read(buf) + if err != nil { + t.Error(err) + } + + err = s3.Save(name, buf, map[string]string{"id": "test"}) + if err != nil { + t.Error(err) + } + + exists := s3.Has(name) + if !exists { + t.Errorf("don't exist, but shuld") + } + + ne := s3.Has(name + "123213") + if ne { + t.Errorf("exists, but shouldn't") + } + + dat, err := s3.Load(name) + if err != nil { + t.Error(err) + } + + if len(dat) == 0 { + t.Errorf("should be something") + } +} diff --git a/pkg/worker/cloud/store.go b/pkg/worker/cloud/store.go new file mode 100644 index 00000000..538983cf --- /dev/null +++ b/pkg/worker/cloud/store.go @@ -0,0 +1,24 @@ +package cloud + +import ( + "github.com/giongto35/cloud-game/v3/pkg/config" + "github.com/giongto35/cloud-game/v3/pkg/logger" +) + +type Storage interface { + Save(name string, data []byte, tags map[string]string) (err error) + Load(name string) (data []byte, err error) + Has(name string) bool +} + +func Store(conf config.Storage, log *logger.Logger) (Storage, error) { + var st Storage + var err error + switch conf.Provider { + case "s3": + st, err = NewS3Client(conf.S3Endpoint, conf.S3BucketName, conf.S3AccessKeyId, conf.S3SecretAccessKey, log) + case "coordinator": + default: + } + return st, err +} diff --git a/pkg/worker/worker.go b/pkg/worker/worker.go index 6ff68e03..14818728 100644 --- a/pkg/worker/worker.go +++ b/pkg/worker/worker.go @@ -59,7 +59,7 @@ func New(conf config.WorkerConfig, log *logger.Logger) (*Worker, error) { if conf.Worker.Monitoring.IsEnabled() { worker.services[1] = monitoring.New(conf.Worker.Monitoring, h.GetHost(), log) } - st, err := cloud.Store(conf.Storage.Provider, conf.Storage.Key) + st, err := cloud.Store(conf.Storage, log) if err != nil { log.Warn().Err(err).Msgf("cloud storage fail, using no storage") } From aa10008d1b611dfa4c0e2db58886f4eb696f0d77 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 16 Nov 2023 01:16:09 +0300 Subject: [PATCH 141/361] Use default Pion webrtc interceptors Slightly higher latency, but more stable in high ping situations. --- pkg/config/config.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 117cfbbb..c532fbe1 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -319,7 +319,7 @@ storage: webrtc: # turn off default Pion interceptors (see: https://github.com/pion/interceptor) # (performance) - disableDefaultInterceptors: true + disableDefaultInterceptors: false # indicates the role of the DTLS transport (see: https://github.com/pion/webrtc/blob/master/dtlsrole.go) # (debug) # - (default) From a77069a63489b7d62a9a0cdc09039bc493aada9a Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 23 Nov 2023 01:36:14 +0300 Subject: [PATCH 142/361] Add L2, R2, L3, R3 mappings to keyboard --- web/css/main.css | 2 +- web/index.html | 8 ++++---- web/js/input/keyboard.js | 4 ++++ web/js/settings/settings.js | 12 ++++++++---- 4 files changed, 17 insertions(+), 9 deletions(-) diff --git a/web/css/main.css b/web/css/main.css index 5efbf875..b47047fb 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -91,7 +91,7 @@ body { color: #979797; font-size: 8px; top: 269px; - left: 68px; + left: 30px; position: absolute; user-select: none; diff --git a/web/index.html b/web/index.html index e082abde..a912d443 100644 --- a/web/index.html +++ b/web/index.html @@ -15,7 +15,7 @@ - + Cloud Retro @@ -48,7 +48,7 @@
    - Arrows (move), ZXCVAS (game ABXYLR), 1/2 (1st/2nd player), Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy shared link to the clipboard) + Arrows (move), ZXCVAS;'./ (game ABXYL1-L3R1-R3), 1/2 (1st/2nd player), Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy the link to the clipboard)
    @@ -123,7 +123,7 @@ - + @@ -137,7 +137,7 @@ - + diff --git a/web/js/input/keyboard.js b/web/js/input/keyboard.js index 91b9f548..3a09ba9e 100644 --- a/web/js/input/keyboard.js +++ b/web/js/input/keyboard.js @@ -16,6 +16,10 @@ const keyboard = (() => { KeyV: KEY.Y, KeyA: KEY.L, KeyS: KEY.R, + Semicolon: KEY.L2, + Quote: KEY.R2, + Period: KEY.L3, + Slash: KEY.R3, Enter: KEY.START, ShiftLeft: KEY.SELECT, // non-game diff --git a/web/js/settings/settings.js b/web/js/settings/settings.js index e3be8e81..81b38c0c 100644 --- a/web/js/settings/settings.js +++ b/web/js/settings/settings.js @@ -15,7 +15,7 @@ */ const settings = (() => { // internal structure version - const revision = 1.1; + const revision = 1.2; // default settings // keep them for revert to defaults option @@ -123,6 +123,7 @@ const settings = (() => { return { get, + clear: () => localStorage.removeItem(root), set, remove, save, @@ -164,12 +165,15 @@ const settings = (() => { } const init = () => { + // try to load settings from the localStorage with fallback to null-object provider = localStorageProvider(store) || voidProvider(store); provider.loadSettings(); - if (revision > store.settings._version) { - // !to handle this with migrations - log.warn(`Your settings are in older format (v${store.settings._version})`); + const lastRev = (store.settings || {_version: 0})._version + + if (revision > lastRev) { + log.warn(`Your settings are in older format (v${lastRev}) and will be reset to (v${revision})!`); + _reset(); } } From 4fbfa1d4e3af43b528c532969206f13be97b0be9 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 23 Nov 2023 18:49:45 +0300 Subject: [PATCH 143/361] Fix possible NPEs --- pkg/config/loader.go | 7 +++++- pkg/coordinator/userhandlers.go | 6 +++-- pkg/encoder/encoder.go | 26 ++++++++++++++++++-- pkg/encoder/h264/x264_test.go | 2 ++ pkg/network/address.go | 15 ++++++----- pkg/network/httpx/server.go | 10 ++++---- pkg/worker/caged/libretro/caged.go | 4 +++ pkg/worker/caged/libretro/frontend.go | 9 ++++++- pkg/worker/caged/libretro/graphics/opengl.go | 2 +- pkg/worker/caged/libretro/manager/grab.go | 8 ++++-- pkg/worker/media/media.go | 13 +++++++++- pkg/worker/media/media_test.go | 1 + pkg/worker/recorder/recorder.go | 10 ++++++-- pkg/worker/room/room_test.go | 21 +++++++--------- 14 files changed, 99 insertions(+), 35 deletions(-) diff --git a/pkg/config/loader.go b/pkg/config/loader.go index 99ae6e7c..a2fb6bd8 100644 --- a/pkg/config/loader.go +++ b/pkg/config/loader.go @@ -88,6 +88,9 @@ func (e *Env) Read() (Kv, error) { mp := make(Kv) for _, k := range keys { parts := strings.SplitN(k, "=", 2) + if parts == nil { + continue + } n := strings.ToLower(strings.TrimPrefix(parts[0], string(*e))) if n == "" { continue @@ -102,7 +105,9 @@ func (e *Env) Read() (Kv, error) { } else { key = strings.Replace(n[:x+1], "_", ".", -1) + n[x+2:] } - mp[key] = parts[1] + if len(parts) > 1 { + mp[key] = parts[1] + } } return maps.Unflatten(mp, "."), nil } diff --git a/pkg/coordinator/userhandlers.go b/pkg/coordinator/userhandlers.go index 81b6bf4f..d754109d 100644 --- a/pkg/coordinator/userhandlers.go +++ b/pkg/coordinator/userhandlers.go @@ -127,14 +127,16 @@ func (u *User) handleGetWorkerList(debug bool, info HasServerInfo) { if debug { response.Servers = servers } else { - // not sure if []byte to string always reversible :/ unique := map[string]*api.Server{} for _, s := range servers { mid := s.Machine if _, ok := unique[mid]; !ok { unique[mid] = &api.Server{Addr: s.Addr, PingURL: s.PingURL, Id: s.Id, InGroup: true} } - unique[mid].Replicas++ + v := unique[mid] + if v != nil { + v.Replicas++ + } } for _, v := range unique { response.Servers = append(response.Servers, *v) diff --git a/pkg/encoder/encoder.go b/pkg/encoder/encoder.go index a9f9003c..5378e47c 100644 --- a/pkg/encoder/encoder.go +++ b/pkg/encoder/encoder.go @@ -62,6 +62,9 @@ func NewVideoEncoder(w, h, dw, dh int, scale float64, conf config.Video, log *lo if err != nil { return nil, err } + if enc == nil { + return nil, fmt.Errorf("no encoder") + } return &Video{codec: enc, y: yuv.NewYuvConv(w, h, scale), log: log}, nil } @@ -86,6 +89,10 @@ func (v *Video) Info() string { } func (v *Video) SetPixFormat(f uint32) { + if v == nil { + return + } + switch f { case 1: v.pf = yuv.PixFmt(yuv.FourccArgb) @@ -98,15 +105,28 @@ func (v *Video) SetPixFormat(f uint32) { // SetRot sets the de-rotation angle of the frames. func (v *Video) SetRot(a uint) { + if v == nil { + return + } + if a > 0 { v.rot = (a + 180) % 360 } } // SetFlip tells the encoder to flip the frames vertically. -func (v *Video) SetFlip(b bool) { v.codec.SetFlip(b) } +func (v *Video) SetFlip(b bool) { + if v == nil { + return + } + v.codec.SetFlip(b) +} func (v *Video) Stop() { + if v == nil { + return + } + if v.stopped.Swap(true) { return } @@ -114,6 +134,8 @@ func (v *Video) Stop() { defer func() { v.codec = nil }() if err := v.codec.Shutdown(); err != nil { - v.log.Error().Err(err).Msg("failed to close the encoder") + if v.log != nil { + v.log.Error().Err(err).Msg("failed to close the encoder") + } } } diff --git a/pkg/encoder/h264/x264_test.go b/pkg/encoder/h264/x264_test.go index b13c0bc4..09f22ae3 100644 --- a/pkg/encoder/h264/x264_test.go +++ b/pkg/encoder/h264/x264_test.go @@ -6,6 +6,7 @@ func TestH264Encode(t *testing.T) { h264, err := NewEncoder(120, 120, 0, nil) if err != nil { t.Error(err) + return } data := make([]byte, 120*120*1.5) h264.LoadBuf(data) @@ -20,6 +21,7 @@ func Benchmark(b *testing.B) { h264, err := NewEncoder(w, h, 0, nil) if err != nil { b.Error(err) + return } data := make([]byte, int(float64(w)*float64(h)*1.5)) for i := 0; i < b.N; i++ { diff --git a/pkg/network/address.go b/pkg/network/address.go index 5fcaca49..318c9cd5 100644 --- a/pkg/network/address.go +++ b/pkg/network/address.go @@ -2,6 +2,7 @@ package network import ( "errors" + "net" "strconv" "strings" ) @@ -12,15 +13,17 @@ func (a *Address) Port() (int, error) { if len(string(*a)) == 0 { return 0, errors.New("no address") } - parts := strings.Split(string(*a), ":") - var port string - if len(parts) == 1 { - port = parts[0] - } else { - port = parts[len(parts)-1] + addr := replaceAllExceptLast(string(*a), ":", "_") + _, port, err := net.SplitHostPort(addr) + if err != nil { + return 0, err } if val, err := strconv.Atoi(port); err == nil { return val, nil } return 0, errors.New("port is not a number") } + +func replaceAllExceptLast(s, c, x string) string { + return strings.Replace(s, c, x, strings.Count(s, c)-1) +} diff --git a/pkg/network/httpx/server.go b/pkg/network/httpx/server.go index eb6e8c1e..5486c05c 100644 --- a/pkg/network/httpx/server.go +++ b/pkg/network/httpx/server.go @@ -120,12 +120,12 @@ func (s *Server) run() { s.log.Debug().Msgf("Starting %s server on %s", protocol, s.Addr) if s.opts.Https && s.opts.HttpsRedirect { - rdr, err := s.redirection() - if err != nil { + if rdr, err := s.redirection(); err == nil { + s.redirect = rdr + go s.redirect.Run() + } else { s.log.Error().Err(err).Msg("couldn't init redirection server") } - s.redirect = rdr - go s.redirect.Run() } var err error @@ -165,6 +165,7 @@ func (s *Server) redirection() (*Server, error) { address = s.opts.HttpsDomain } addr := buildAddress(address, s.opts.Zone, *s.listener) + s.log.Info().Str("addr", addr).Msg("Start HTTPS redirect server") srv, err := NewServer(s.opts.HttpsRedirectAddress, func(serv *Server) Handler { h := NewServeMux("") @@ -186,7 +187,6 @@ func (s *Server) redirection() (*Server, error) { }, WithLogger(s.log), ) - s.log.Info().Str("addr", addr).Msg("Start HTTPS redirect server") return srv, err } diff --git a/pkg/worker/caged/libretro/caged.go b/pkg/worker/caged/libretro/caged.go index a0b5f633..dea9bf5c 100644 --- a/pkg/worker/caged/libretro/caged.go +++ b/pkg/worker/caged/libretro/caged.go @@ -38,6 +38,7 @@ func (c *Caged) ReloadFrontend() { frontend, err := NewFrontend(c.conf.Emulator, c.log) if err != nil { c.log.Fatal().Err(err).Send() + return } c.Emulator = frontend c.base = frontend @@ -47,6 +48,9 @@ func (c *Caged) ReloadFrontend() { func (c *Caged) VideoChangeCb(fn func()) { c.base.SetVideoChangeCb(fn) } func (c *Caged) Load(game games.GameMetadata, path string) error { + if c.Emulator == nil { + return nil + } c.Emulator.LoadCore(game.System) if err := c.Emulator.LoadGame(game.FullPath(path)); err != nil { return err diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index dc8316d5..0386b0a8 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -217,6 +217,9 @@ func (f *Frontend) Shutdown() { func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { f.nano = nano + if nano == nil { + return + } f.nano.WaitReady() // start only when nano is available f.nano.OnKeyPress = f.input.isKeyPressed @@ -225,7 +228,11 @@ func (f *Frontend) linkNano(nano *nanoarch.Nanoarch) { f.nano.OnAudio = f.handleAudio } -func (f *Frontend) SetVideoChangeCb(fn func()) { f.nano.OnSystemAvInfo = fn } +func (f *Frontend) SetVideoChangeCb(fn func()) { + if f.nano != nil { + f.nano.OnSystemAvInfo = fn + } +} func (f *Frontend) Start() { f.log.Debug().Msgf("frontend start") diff --git a/pkg/worker/caged/libretro/graphics/opengl.go b/pkg/worker/caged/libretro/graphics/opengl.go index ea8b8c09..99eef10d 100644 --- a/pkg/worker/caged/libretro/graphics/opengl.go +++ b/pkg/worker/caged/libretro/graphics/opengl.go @@ -50,7 +50,7 @@ const ( var ( opt = offscreenSetup{} - buf []byte + buf = make([]byte, 1024*1024) ) func initContext(getProcAddr func(name string) unsafe.Pointer) { diff --git a/pkg/worker/caged/libretro/manager/grab.go b/pkg/worker/caged/libretro/manager/grab.go index a2ece967..f7d40a05 100644 --- a/pkg/worker/caged/libretro/manager/grab.go +++ b/pkg/worker/caged/libretro/manager/grab.go @@ -47,11 +47,15 @@ func (d GrabDownloader) Request(dest string, urls ...Download) (ok []string, noo r := resp.Request if err := resp.Err(); err != nil { d.log.Error().Err(err).Msgf("download [%s] %s has failed: %v", r.Label, r.URL(), err) - if resp.HTTPResponse.StatusCode == 404 { + if resp.HTTPResponse != nil && resp.HTTPResponse.StatusCode == 404 { nook = append(nook, resp.Request.Label) } } else { - d.log.Info().Msgf("Downloaded [%v] [%s] -> %s", resp.HTTPResponse.Status, r.Label, resp.Filename) + status := "" + if resp.HTTPResponse != nil { + status = resp.HTTPResponse.Status + } + d.log.Info().Msgf("Downloaded [%v] [%s] -> %s", status, r.Label, resp.Filename) ok = append(ok, resp.Filename) } } diff --git a/pkg/worker/media/media.go b/pkg/worker/media/media.go index 70758b1c..39c48442 100644 --- a/pkg/worker/media/media.go +++ b/pkg/worker/media/media.go @@ -145,6 +145,10 @@ func (wmp *WebrtcMediaPipe) Init() error { if err := wmp.initVideo(wmp.VideoW, wmp.VideoH, wmp.VideoScale, wmp.vConf); err != nil { return err } + if wmp.v == nil || wmp.a == nil { + return fmt.Errorf("could intit the encoders, v=%v a=%v", wmp.v != nil, wmp.a != nil) + } + wmp.log.Debug().Msgf("%v", wmp.v.Info()) wmp.initialized = true return nil @@ -179,7 +183,14 @@ func (wmp *WebrtcMediaPipe) encodeAudio(pcm samples) { func (wmp *WebrtcMediaPipe) initVideo(w, h int, scale float64, conf config.Video) (err error) { sw, sh := round(w, scale), round(h, scale) - wmp.v, err = encoder.NewVideoEncoder(w, h, sw, sh, scale, conf, wmp.log) + enc, err := encoder.NewVideoEncoder(w, h, sw, sh, scale, conf, wmp.log) + if err != nil { + return err + } + if enc == nil { + return fmt.Errorf("broken video encoder init") + } + wmp.v = enc wmp.log.Debug().Msgf("media scale: %vx%v -> %vx%v", w, h, sw, sh) return err } diff --git a/pkg/worker/media/media_test.go b/pkg/worker/media/media_test.go index 93568cc2..8db75e6c 100644 --- a/pkg/worker/media/media_test.go +++ b/pkg/worker/media/media_test.go @@ -66,6 +66,7 @@ func run(w, h int, cod encoder.VideoCodec, count int, a *image.RGBA, b *image.RG ve, err := encoder.NewVideoEncoder(w, h, w, h, 1, conf, l) if err != nil { backend.Error(err) + return } defer ve.Stop() diff --git a/pkg/worker/recorder/recorder.go b/pkg/worker/recorder/recorder.go index 4c3d1207..d0c1165b 100644 --- a/pkg/worker/recorder/recorder.go +++ b/pkg/worker/recorder/recorder.go @@ -98,11 +98,13 @@ func (r *Recording) Start() { audio, err := newWavStream(path, r.opts) if err != nil { r.log.Fatal().Err(err) + return } r.audio = audio video, err := newRawStream(path) if err != nil { r.log.Fatal().Err(err) + return } r.video = video } @@ -111,8 +113,12 @@ func (r *Recording) Stop() (err error) { r.Lock() defer r.Unlock() r.enabled = false - err = r.audio.Close() - err = r.video.Close() + if r.audio != nil { + err = r.audio.Close() + } + if r.video != nil { + err = r.video.Close() + } path := filepath.Join(r.dir, r.saveDir) // FFMPEG diff --git a/pkg/worker/room/room_test.go b/pkg/worker/room/room_test.go index e41004b9..c1459e0a 100644 --- a/pkg/worker/room/room_test.go +++ b/pkg/worker/room/room_test.go @@ -139,18 +139,15 @@ func TestAll(t *testing.T) { if renderFrames { rect := image.Rect(0, 0, frame.W, frame.H) var src image.Image - if test.color == 1 { - src1 := bgra.NewBGRA(rect) - src1.Pix = frame.Data - src1.Stride = frame.Stride - src = src1 - } else { - if test.color == 2 { - src1 := rgb565.NewRGB565(rect) - src1.Pix = frame.Data - src1.Stride = frame.Stride - src = src1 - } + src1 := bgra.NewBGRA(rect) + src1.Pix = frame.Data + src1.Stride = frame.Stride + src = src1 + if test.color == 2 { + src2 := rgb565.NewRGB565(rect) + src2.Pix = frame.Data + src2.Stride = frame.Stride + src = src2 } dst := rgba.ToRGBA(src, flip) tag := fmt.Sprintf("%v-%v-0x%08x", runtime.GOOS, test.game.Type, crc32.Checksum(frame.Data, crc32q)) From b7b530fe603cb56fad3afcf7d52134613f96a8d4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 25 Nov 2023 03:09:29 +0300 Subject: [PATCH 144/361] Update libretro.h --- pkg/worker/caged/libretro/nanoarch/libretro.h | 484 +++++++++++++++++- 1 file changed, 473 insertions(+), 11 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/libretro.h b/pkg/worker/caged/libretro/nanoarch/libretro.h index e1020c9a..14c05991 100644 --- a/pkg/worker/caged/libretro/nanoarch/libretro.h +++ b/pkg/worker/caged/libretro/nanoarch/libretro.h @@ -291,6 +291,7 @@ enum retro_language RETRO_LANGUAGE_CATALAN = 29, RETRO_LANGUAGE_BRITISH_ENGLISH = 30, RETRO_LANGUAGE_HUNGARIAN = 31, + RETRO_LANGUAGE_BELARUSIAN = 32, RETRO_LANGUAGE_LAST, /* Ensure sizeof(enum) == sizeof(int) */ @@ -928,8 +929,6 @@ enum retro_mod * anything else. * It is recommended to expose all relevant pointers through * retro_get_memory_* as well. - * - * Can be called from retro_init and retro_load_game. */ #define RETRO_ENVIRONMENT_SET_GEOMETRY 37 /* const struct retro_game_geometry * -- @@ -1793,6 +1792,66 @@ enum retro_mod * this environment call to query support. */ +#define RETRO_ENVIRONMENT_GET_JIT_CAPABLE 74 + /* bool * -- + * Result is set to true if the frontend has already verified JIT can be + * used, mainly for use iOS/tvOS. On other platforms the result is true. + */ + +#define RETRO_ENVIRONMENT_GET_MICROPHONE_INTERFACE (75 | RETRO_ENVIRONMENT_EXPERIMENTAL) + /* struct retro_microphone_interface * -- + * Returns an interface that can be used to receive input from the microphone driver. + * + * Returns true if microphone support is available, + * even if no microphones are plugged in. + * Returns false if mic support is disabled or unavailable. + * + * This callback can be invoked at any time, + * even before the microphone driver is ready. + */ + + /* Environment 76 was an obsolete version of RETRO_ENVIRONMENT_SET_NETPACKET_INTERFACE. + * It was not used by any known core at the time, and was removed from the API. */ + +#define RETRO_ENVIRONMENT_GET_DEVICE_POWER (77 | RETRO_ENVIRONMENT_EXPERIMENTAL) + /* struct retro_device_power * -- + * Returns the device's current power state as reported by the frontend. + * This is useful for emulating the battery level in handheld consoles, + * or for reducing power consumption when on battery power. + * + * The return value indicates whether the frontend can provide this information, + * even if the parameter is NULL. + * + * If the frontend does not support this functionality, + * then the provided argument will remain unchanged. + * + * Note that this environment call describes the power state for the entire device, + * not for individual peripherals like controllers. + */ + +#define RETRO_ENVIRONMENT_SET_NETPACKET_INTERFACE 78 + /* const struct retro_netpacket_callback * -- + * When set, a core gains control over network packets sent and + * received during a multiplayer session. This can be used to + * emulate multiplayer games that were originally played on two + * or more separate consoles or computers connected together. + * + * The frontend will take care of connecting players together, + * and the core only needs to send the actual data as needed for + * the emulation, while handshake and connection management happen + * in the background. + * + * When two or more players are connected and this interface has + * been set, time manipulation features (such as pausing, slow motion, + * fast forward, rewinding, save state loading, etc.) are disabled to + * avoid interrupting communication. + * + * Should be set in either retro_init or retro_load_game, but not both. + * + * When not set, a frontend may use state serialization-based + * multiplayer, where a deterministic core supporting multiple + * input devices does not need to take any action on its own. + */ /* VFS functionality */ @@ -1968,13 +2027,13 @@ struct retro_vfs_interface_info enum retro_hw_render_interface_type { - RETRO_HW_RENDER_INTERFACE_VULKAN = 0, - RETRO_HW_RENDER_INTERFACE_D3D9 = 1, - RETRO_HW_RENDER_INTERFACE_D3D10 = 2, - RETRO_HW_RENDER_INTERFACE_D3D11 = 3, - RETRO_HW_RENDER_INTERFACE_D3D12 = 4, + RETRO_HW_RENDER_INTERFACE_VULKAN = 0, + RETRO_HW_RENDER_INTERFACE_D3D9 = 1, + RETRO_HW_RENDER_INTERFACE_D3D10 = 2, + RETRO_HW_RENDER_INTERFACE_D3D11 = 3, + RETRO_HW_RENDER_INTERFACE_D3D12 = 4, RETRO_HW_RENDER_INTERFACE_GSKIT_PS2 = 5, - RETRO_HW_RENDER_INTERFACE_DUMMY = INT_MAX + RETRO_HW_RENDER_INTERFACE_DUMMY = INT_MAX }; /* Base struct. All retro_hw_render_interface_* types @@ -2750,9 +2809,17 @@ enum retro_hw_context_type /* Vulkan, see RETRO_ENVIRONMENT_GET_HW_RENDER_INTERFACE. */ RETRO_HW_CONTEXT_VULKAN = 6, - /* Direct3D, set version_major to select the type of interface - * returned by RETRO_ENVIRONMENT_GET_HW_RENDER_INTERFACE */ - RETRO_HW_CONTEXT_DIRECT3D = 7, + /* Direct3D11, see RETRO_ENVIRONMENT_GET_HW_RENDER_INTERFACE */ + RETRO_HW_CONTEXT_D3D11 = 7, + + /* Direct3D10, see RETRO_ENVIRONMENT_GET_HW_RENDER_INTERFACE */ + RETRO_HW_CONTEXT_D3D10 = 8, + + /* Direct3D12, see RETRO_ENVIRONMENT_GET_HW_RENDER_INTERFACE */ + RETRO_HW_CONTEXT_D3D12 = 9, + + /* Direct3D9, see RETRO_ENVIRONMENT_GET_HW_RENDER_INTERFACE */ + RETRO_HW_CONTEXT_D3D9 = 10, RETRO_HW_CONTEXT_DUMMY = INT_MAX }; @@ -3007,6 +3074,118 @@ struct retro_disk_control_ext_callback retro_get_image_label_t get_image_label; /* Optional - may be NULL */ }; +/* Definitions for RETRO_ENVIRONMENT_SET_NETPACKET_INTERFACE. + * A core can set it if sending and receiving custom network packets + * during a multiplayer session is desired. + */ + +/* Netpacket flags for retro_netpacket_send_t */ +#define RETRO_NETPACKET_UNRELIABLE 0 /* Packet to be sent unreliable, depending on network quality it might not arrive. */ +#define RETRO_NETPACKET_RELIABLE (1 << 0) /* Reliable packets are guaranteed to arrive at the target in the order they were sent. */ +#define RETRO_NETPACKET_UNSEQUENCED (1 << 1) /* Packet will not be sequenced with other packets and may arrive out of order. Cannot be set on reliable packets. */ +#define RETRO_NETPACKET_FLUSH_HINT (1 << 2) /* Request the packet and any previously buffered ones to be sent immediately */ + +/* Broadcast client_id for retro_netpacket_send_t */ +#define RETRO_NETPACKET_BROADCAST 0xFFFF + +/* Used by the core to send a packet to one or all connected players. + * A single packet sent via this interface can contain up to 64 KB of data. + * + * The client_id RETRO_NETPACKET_BROADCAST sends the packet as a broadcast to + * all connected players. This is supported from the host as well as clients. +* Otherwise, the argument indicates the player to send the packet to. + * + * A frontend must support sending reliable packets (RETRO_NETPACKET_RELIABLE). + * Unreliable packets might not be supported by the frontend, but the flags can + * still be specified. Reliable transmission will be used instead. + * + * Calling this with the flag RETRO_NETPACKET_FLUSH_HINT will send off the + * packet and any previously buffered ones immediately and without blocking. + * To only flush previously queued packets, buf or len can be passed as NULL/0. + * + * This function is not guaranteed to be thread-safe and must be called during + * retro_run or any of the netpacket callbacks passed with this interface. + */ +typedef void (RETRO_CALLCONV *retro_netpacket_send_t)(int flags, const void* buf, size_t len, uint16_t client_id); + +/* Optionally read any incoming packets without waiting for the end of the + * frame. While polling, retro_netpacket_receive_t and retro_netpacket_stop_t + * can be called. The core can perform this in a loop to do a blocking read, + * i.e., wait for incoming data, but needs to handle stop getting called and + * also give up after a short while to avoid freezing on a connection problem. + * It is a good idea to manually flush outgoing packets before calling this. + * + * This function is not guaranteed to be thread-safe and must be called during + * retro_run or any of the netpacket callbacks passed with this interface. + */ +typedef void (RETRO_CALLCONV *retro_netpacket_poll_receive_t)(); + +/* Called by the frontend to signify that a multiplayer session has started. + * If client_id is 0 the local player is the host of the session and at this + * point no other player has connected yet. + * + * If client_id is > 0 the local player is a client connected to a host and + * at this point is already fully connected to the host. + * + * The core must store the function pointer send_fn and use it whenever it + * wants to send a packet. Optionally poll_receive_fn can be stored and used + * when regular receiving between frames is not enough. These function pointers + * remain valid until the frontend calls retro_netpacket_stop_t. + */ +typedef void (RETRO_CALLCONV *retro_netpacket_start_t)(uint16_t client_id, retro_netpacket_send_t send_fn, retro_netpacket_poll_receive_t poll_receive_fn); + +/* Called by the frontend when a new packet arrives which has been sent from + * another player with retro_netpacket_send_t. The client_id argument indicates + * who has sent the packet. + */ +typedef void (RETRO_CALLCONV *retro_netpacket_receive_t)(const void* buf, size_t len, uint16_t client_id); + +/* Called by the frontend when the multiplayer session has ended. + * Once this gets called the function pointers passed to + * retro_netpacket_start_t will not be valid anymore. + */ +typedef void (RETRO_CALLCONV *retro_netpacket_stop_t)(void); + +/* Called by the frontend every frame (between calls to retro_run while + * updating the state of the multiplayer session. + * This is a good place for the core to call retro_netpacket_send_t from. + */ +typedef void (RETRO_CALLCONV *retro_netpacket_poll_t)(void); + +/* Called by the frontend when a new player connects to the hosted session. + * This is only called on the host side, not for clients connected to the host. + * If this function returns false, the newly connected player gets dropped. + * This can be used for example to limit the number of players. + */ +typedef bool (RETRO_CALLCONV *retro_netpacket_connected_t)(uint16_t client_id); + +/* Called by the frontend when a player leaves or disconnects from the hosted session. + * This is only called on the host side, not for clients connected to the host. + */ +typedef void (RETRO_CALLCONV *retro_netpacket_disconnected_t)(uint16_t client_id); + +/** + * A callback interface for giving a core the ability to send and receive custom + * network packets during a multiplayer session between two or more instances + * of a libretro frontend. + * + * Normally during connection handshake the frontend will compare library_version + * used by both parties and show a warning if there is a difference. When the core + * supplies protocol_version, the frontend will check against this instead. + * + * @see RETRO_ENVIRONMENT_SET_NETPACKET_INTERFACE + */ +struct retro_netpacket_callback +{ + retro_netpacket_start_t start; + retro_netpacket_receive_t receive; + retro_netpacket_stop_t stop; /* Optional - may be NULL */ + retro_netpacket_poll_t poll; /* Optional - may be NULL */ + retro_netpacket_connected_t connected; /* Optional - may be NULL */ + retro_netpacket_disconnected_t disconnected; /* Optional - may be NULL */ + const char* protocol_version; /* Optional - if not NULL will be used instead of core version to decide if communication is compatible */ +}; + enum retro_pixel_format { /* 0RGB1555, native endian. @@ -3809,6 +3988,289 @@ struct retro_throttle_state float rate; }; +/** + * Opaque handle to a microphone that's been opened for use. + * The underlying object is accessed or created with \c retro_microphone_interface_t. + */ +typedef struct retro_microphone retro_microphone_t; + +/** + * Parameters for configuring a microphone. + * Some of these might not be honored, + * depending on the available hardware and driver configuration. + */ +typedef struct retro_microphone_params +{ + /** + * The desired sample rate of the microphone's input, in Hz. + * The microphone's input will be resampled, + * so cores can ask for whichever frequency they need. + * + * If zero, some reasonable default will be provided by the frontend + * (usually from its config file). + * + * @see retro_get_mic_rate_t + */ + unsigned rate; +} retro_microphone_params_t; + +/** + * @copydoc retro_microphone_interface::open_mic + */ +typedef retro_microphone_t *(RETRO_CALLCONV *retro_open_mic_t)(const retro_microphone_params_t *params); + +/** + * @copydoc retro_microphone_interface::close_mic + */ +typedef void (RETRO_CALLCONV *retro_close_mic_t)(retro_microphone_t *microphone); + +/** + * @copydoc retro_microphone_interface::get_params + */ +typedef bool (RETRO_CALLCONV *retro_get_mic_params_t)(const retro_microphone_t *microphone, retro_microphone_params_t *params); + +/** + * @copydoc retro_microphone_interface::set_mic_state + */ +typedef bool (RETRO_CALLCONV *retro_set_mic_state_t)(retro_microphone_t *microphone, bool state); + +/** + * @copydoc retro_microphone_interface::get_mic_state + */ +typedef bool (RETRO_CALLCONV *retro_get_mic_state_t)(const retro_microphone_t *microphone); + +/** + * @copydoc retro_microphone_interface::read_mic + */ +typedef int (RETRO_CALLCONV *retro_read_mic_t)(retro_microphone_t *microphone, int16_t* samples, size_t num_samples); + +/** + * The current version of the microphone interface. + * Will be incremented whenever \c retro_microphone_interface or \c retro_microphone_params_t + * receive new fields. + * + * Frontends using cores built against older mic interface versions + * should not access fields introduced in newer versions. + */ +#define RETRO_MICROPHONE_INTERFACE_VERSION 1 + +/** + * An interface for querying the microphone and accessing data read from it. + * + * @see RETRO_ENVIRONMENT_GET_MICROPHONE_INTERFACE + */ +struct retro_microphone_interface +{ + /** + * The version of this microphone interface. + * Set by the core to request a particular version, + * and set by the frontend to indicate the returned version. + * 0 indicates that the interface is invalid or uninitialized. + */ + unsigned interface_version; + + /** + * Initializes a new microphone. + * Assuming that microphone support is enabled and provided by the frontend, + * cores may call this function whenever necessary. + * A microphone could be opened throughout a core's lifetime, + * or it could wait until a microphone is plugged in to the emulated device. + * + * The returned handle will be valid until it's freed, + * even if the audio driver is reinitialized. + * + * This function is not guaranteed to be thread-safe. + * + * @param args[in] Parameters used to create the microphone. + * May be \c NULL, in which case the default value of each parameter will be used. + * + * @returns Pointer to the newly-opened microphone, + * or \c NULL if one couldn't be opened. + * This likely means that no microphone is plugged in and recognized, + * or the maximum number of supported microphones has been reached. + * + * @note Microphones are \em inactive by default; + * to begin capturing audio, call \c set_mic_state. + * @see retro_microphone_params_t + */ + retro_open_mic_t open_mic; + + /** + * Closes a microphone that was initialized with \c open_mic. + * Calling this function will stop all microphone activity + * and free up the resources that it allocated. + * Afterwards, the handle is invalid and must not be used. + * + * A frontend may close opened microphones when unloading content, + * but this behavior is not guaranteed. + * Cores should close their microphones when exiting, just to be safe. + * + * @param microphone Pointer to the microphone that was allocated by \c open_mic. + * If \c NULL, this function does nothing. + * + * @note The handle might be reused if another microphone is opened later. + */ + retro_close_mic_t close_mic; + + /** + * Returns the configured parameters of this microphone. + * These may differ from what was requested depending on + * the driver and device configuration. + * + * Cores should check these values before they start fetching samples. + * + * Will not change after the mic was opened. + * + * @param microphone[in] Opaque handle to the microphone + * whose parameters will be retrieved. + * @param params[out] The parameters object that the + * microphone's parameters will be copied to. + * + * @return \c true if the parameters were retrieved, + * \c false if there was an error. + */ + retro_get_mic_params_t get_params; + + /** + * Enables or disables the given microphone. + * Microphones are disabled by default + * and must be explicitly enabled before they can be used. + * Disabled microphones will not process incoming audio samples, + * and will therefore have minimal impact on overall performance. + * Cores may enable microphones throughout their lifetime, + * or only for periods where they're needed. + * + * Cores that accept microphone input should be able to operate without it; + * we suggest substituting silence in this case. + * + * @param microphone Opaque handle to the microphone + * whose state will be adjusted. + * This will have been provided by \c open_mic. + * @param state \c true if the microphone should receive audio input, + * \c false if it should be idle. + * @returns \c true if the microphone's state was successfully set, + * \c false if \c microphone is invalid + * or if there was an error. + */ + retro_set_mic_state_t set_mic_state; + + /** + * Queries the active state of a microphone at the given index. + * Will return whether the microphone is enabled, + * even if the driver is paused. + * + * @param microphone Opaque handle to the microphone + * whose state will be queried. + * @return \c true if the provided \c microphone is valid and active, + * \c false if not or if there was an error. + */ + retro_get_mic_state_t get_mic_state; + + /** + * Retrieves the input processed by the microphone since the last call. + * \em Must be called every frame unless \c microphone is disabled, + * similar to how \c retro_audio_sample_batch_t works. + * + * @param[in] microphone Opaque handle to the microphone + * whose recent input will be retrieved. + * @param[out] samples The buffer that will be used to store the microphone's data. + * Microphone input is in mono (i.e. one number per sample). + * Should be large enough to accommodate the expected number of samples per frame; + * for example, a 44.1kHz sample rate at 60 FPS would require space for 735 samples. + * @param[in] num_samples The size of the data buffer in samples (\em not bytes). + * Microphone input is in mono, so a "frame" and a "sample" are equivalent in length here. + * + * @return The number of samples that were copied into \c samples. + * If \c microphone is pending driver initialization, + * this function will copy silence of the requested length into \c samples. + * + * Will return -1 if the microphone is disabled, + * the audio driver is paused, + * or there was an error. + */ + retro_read_mic_t read_mic; +}; + +/** + * Describes how a device is being powered. + * @see RETRO_ENVIRONMENT_GET_DEVICE_POWER + */ +enum retro_power_state +{ + /** + * Indicates that the frontend cannot report its power state at this time, + * most likely due to a lack of support. + * + * \c RETRO_ENVIRONMENT_GET_DEVICE_POWER will not return this value; + * instead, the environment callback will return \c false. + */ + RETRO_POWERSTATE_UNKNOWN = 0, + + /** + * Indicates that the device is running on its battery. + * Usually applies to portable devices such as handhelds, laptops, and smartphones. + */ + RETRO_POWERSTATE_DISCHARGING, + + /** + * Indicates that the device's battery is currently charging. + */ + RETRO_POWERSTATE_CHARGING, + + /** + * Indicates that the device is connected to a power source + * and that its battery has finished charging. + */ + RETRO_POWERSTATE_CHARGED, + + /** + * Indicates that the device is connected to a power source + * and that it does not have a battery. + * This usually suggests a desktop computer or a non-portable game console. + */ + RETRO_POWERSTATE_PLUGGED_IN +}; + +/** + * Indicates that an estimate is not available for the battery level or time remaining, + * even if the actual power state is known. + */ +#define RETRO_POWERSTATE_NO_ESTIMATE (-1) + +/** + * Describes the power state of the device running the frontend. + * @see RETRO_ENVIRONMENT_GET_DEVICE_POWER + */ +struct retro_device_power +{ + /** + * The current state of the frontend's power usage. + */ + enum retro_power_state state; + + /** + * A rough estimate of the amount of time remaining (in seconds) + * before the device powers off. + * This value depends on a variety of factors, + * so it is not guaranteed to be accurate. + * + * Will be set to \c RETRO_POWERSTATE_NO_ESTIMATE if \c state does not equal \c RETRO_POWERSTATE_DISCHARGING. + * May still be set to \c RETRO_POWERSTATE_NO_ESTIMATE if the frontend is unable to provide an estimate. + */ + int seconds; + + /** + * The approximate percentage of battery charge, + * ranging from 0 to 100 (inclusive). + * The device may power off before this reaches 0. + * + * The user might have configured their device + * to stop charging before the battery is full, + * so do not assume that this will be 100 in the \c RETRO_POWERSTATE_CHARGED state. + */ + int8_t percent; +}; + /* Callbacks */ /* Environment callback. Gives implementations a way of performing From f475dbabb7d3cfe381ee1f45467c3f7e87a0263b Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 4 Dec 2023 01:38:30 +0300 Subject: [PATCH 145/361] Update dependencies --- go.mod | 18 +++++++++--------- go.sum | 35 ++++++++++++++++++----------------- 2 files changed, 27 insertions(+), 26 deletions(-) diff --git a/go.mod b/go.mod index df9b8594..d20298fe 100644 --- a/go.mod +++ b/go.mod @@ -3,23 +3,23 @@ module github.com/giongto35/cloud-game/v3 go 1.20 require ( - github.com/VictoriaMetrics/metrics v1.24.0 + github.com/VictoriaMetrics/metrics v1.25.3 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.7.0 github.com/goccy/go-json v0.10.2 github.com/gofrs/flock v0.8.1 - github.com/gorilla/websocket v1.5.0 + github.com/gorilla/websocket v1.5.1 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.0.1 - github.com/minio/minio-go/v7 v7.0.63 + github.com/minio/minio-go/v7 v7.0.65 github.com/pion/ice/v3 v3.0.2 github.com/pion/interceptor v0.1.25 github.com/pion/logging v0.2.2 github.com/pion/webrtc/v4 v4.0.0-beta.7 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.31.0 - github.com/veandco/go-sdl2 v0.4.35 - golang.org/x/crypto v0.15.0 + github.com/veandco/go-sdl2 v0.4.36 + golang.org/x/crypto v0.16.0 golang.org/x/image v0.13.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -29,7 +29,7 @@ require ( github.com/dustin/go-humanize v1.0.1 // indirect github.com/google/uuid v1.4.0 // indirect github.com/json-iterator/go v1.1.12 // indirect - github.com/klauspost/compress v1.17.2 // indirect + github.com/klauspost/compress v1.17.4 // indirect github.com/klauspost/cpuid/v2 v2.2.6 // indirect github.com/mattn/go-colorable v0.1.13 // indirect github.com/mattn/go-isatty v0.0.20 // indirect @@ -41,7 +41,7 @@ require ( github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect github.com/modern-go/reflect2 v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect - github.com/pion/dtls/v2 v2.2.7 // indirect + github.com/pion/dtls/v2 v2.2.8 // indirect github.com/pion/mdns v0.0.9 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.12 // indirect @@ -58,8 +58,8 @@ require ( github.com/stretchr/testify v1.8.4 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.18.0 // indirect - golang.org/x/sys v0.14.0 // indirect + golang.org/x/net v0.19.0 // indirect + golang.org/x/sys v0.15.0 // indirect golang.org/x/text v0.14.0 // indirect gopkg.in/ini.v1 v1.67.0 // indirect ) diff --git a/go.sum b/go.sum index fa96e072..2397f02d 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,5 @@ -github.com/VictoriaMetrics/metrics v1.24.0 h1:ILavebReOjYctAGY5QU2F9X0MYvkcrG3aEn2RKa1Zkw= -github.com/VictoriaMetrics/metrics v1.24.0/go.mod h1:eFT25kvsTidQFHb6U0oa0rTrDRdz4xTYjpL8+UPohys= +github.com/VictoriaMetrics/metrics v1.25.3 h1:Zcxyj8JbAB6CQU51Er3D7RBRupcP55DevVQi9cFqo2Q= +github.com/VictoriaMetrics/metrics v1.25.3/go.mod h1:ZKmlI+QN6b9LUC0OiHNp2LiGQGlBy4U1re6Slooln1o= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -35,13 +35,13 @@ github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/ github.com/google/uuid v1.3.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/google/uuid v1.4.0 h1:MtMxsa51/r9yyhkyLsVeVt0B+BGQZzpQiTQ4eHZ8bc4= github.com/google/uuid v1.4.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= -github.com/gorilla/websocket v1.5.0 h1:PPwGk2jz7EePpoHN/+ClbZu8SPxiqlu12wZP/3sWmnc= -github.com/gorilla/websocket v1.5.0/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= +github.com/gorilla/websocket v1.5.1 h1:gmztn0JnHVt9JZquRuzLw3g4wouNVzKL15iLr/zn/QY= +github.com/gorilla/websocket v1.5.1/go.mod h1:x3kM2JMyaluk02fnUJpQuwD2dCS5NDG2ZHL0uE0tcaY= github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= -github.com/klauspost/compress v1.17.2 h1:RlWWUY/Dr4fL8qk9YG7DTZ7PDgME2V4csBXA8L/ixi4= -github.com/klauspost/compress v1.17.2/go.mod h1:ntbaceVETuRiXiv4DpjP66DpAtAGkEQskQzEyD//IeE= +github.com/klauspost/compress v1.17.4 h1:Ej5ixsIri7BrIjBkRZLTo6ghwrEtHFk7ijlczPW4fZ4= +github.com/klauspost/compress v1.17.4/go.mod h1:/dCuZOvVtNoHsyb+cuJD3itjs3NbnF6KH9zAO4BDxPM= github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= github.com/klauspost/cpuid/v2 v2.2.6 h1:ndNyv040zDGIDh8thGkXYjnFtiN02M1PVVF+JE/48xc= github.com/klauspost/cpuid/v2 v2.2.6/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws= @@ -62,8 +62,8 @@ github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWE github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.63 h1:GbZ2oCvaUdgT5640WJOpyDhhDxvknAJU2/T3yurwcbQ= -github.com/minio/minio-go/v7 v7.0.63/go.mod h1:Q6X7Qjb7WMhvG65qKf4gUgA5XaiSox74kR1uAEjxRS4= +github.com/minio/minio-go/v7 v7.0.65 h1:sOlB8T3nQK+TApTpuN3k4WD5KasvZIE3vVFzyyCa0go= +github.com/minio/minio-go/v7 v7.0.65/go.mod h1:R4WVUR6ZTedlCcGwZRauLMIKjgyaWxhs4Mqi/OMPmEc= github.com/minio/sha256-simd v1.0.1 h1:6kaan5IFmwTNynnKKpDHe6FWHohJOHhCPchzK49dzMM= github.com/minio/sha256-simd v1.0.1/go.mod h1:Pz6AKMiUdngCLpeTL/RJY1M9rUuPMYujV5xJjtbRSN8= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= @@ -88,8 +88,9 @@ github.com/onsi/gomega v1.10.1/go.mod h1:iN09h71vgCQne3DLsj+A5owkum+a2tYe+TOCB1y github.com/onsi/gomega v1.17.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAlGdZY= github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew8= github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= -github.com/pion/dtls/v2 v2.2.7 h1:cSUBsETxepsCSFSxC3mc/aDo14qQLMSL+O6IjG28yV8= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= +github.com/pion/dtls/v2 v2.2.8 h1:BUroldfiIbV9jSnC6cKOMnyiORRWrWWpV11JUyEu5OA= +github.com/pion/dtls/v2 v2.2.8/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= github.com/pion/ice/v3 v3.0.2 h1:dNQnKsjLvOWz+PaI4tw1VnLYTp9adihC1HIASFGajmI= github.com/pion/ice/v3 v3.0.2/go.mod h1:q3BDzTsxbqP0ySMSHrFuw2MYGUx/AC3WQfRGC5F/0Is= github.com/pion/interceptor v0.1.25 h1:pwY9r7P6ToQ3+IF0bajN0xmk/fNw/suTgaTdlwTDmhc= @@ -152,8 +153,8 @@ github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= github.com/valyala/histogram v1.2.0/go.mod h1:Hb4kBwb4UxsaNbbbh+RRz8ZR6pdodR57tzWUS3BUzXY= -github.com/veandco/go-sdl2 v0.4.35 h1:NohzsfageDWGtCd9nf7Pc3sokMK/MOK+UA2QMJARWzQ= -github.com/veandco/go-sdl2 v0.4.35/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= +github.com/veandco/go-sdl2 v0.4.36 h1:Ltydev536rRQodmIrTWFZ3dRp5A+/6t5CYvbi4Kvia0= +github.com/veandco/go-sdl2 v0.4.36/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= @@ -164,8 +165,8 @@ golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE golang.org/x/crypto v0.12.0/go.mod h1:NF0Gs7EO5K4qLn+Ylc+fih8BSTeIjAP05siRnAh98yw= golang.org/x/crypto v0.13.0/go.mod h1:y6Z2r+Rw4iayiXXAIxJIDAJ1zMW4yaTpebo8fPOliYc= golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= -golang.org/x/crypto v0.15.0 h1:frVn1TEaCEaZcn3Tmd7Y2b5KKPaZ+I32Q2OA3kYp5TA= -golang.org/x/crypto v0.15.0/go.mod h1:4ChreQoLWfG3xLDer1WdlH5NdlQ3+mwnQq1YTKY+72g= +golang.org/x/crypto v0.16.0 h1:mMMrFzRSCF0GvB7Ne27XVtVAaXLrPmgPC7/v0tkwHaY= +golang.org/x/crypto v0.16.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4= golang.org/x/image v0.13.0 h1:3cge/F/QTkNLauhf2QoE9zp+7sr+ZcL4HnoZmdwg9sg= golang.org/x/image v0.13.0/go.mod h1:6mmbMOeV28HuMTgA6OSRkdXKYw/t5W9Uwn2Yv1r3Yxk= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= @@ -186,8 +187,8 @@ golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= golang.org/x/net v0.14.0/go.mod h1:PpSgVXXLK0OxS0F31C1/tv6XNguvCrnXIDrFMspZIUI= golang.org/x/net v0.15.0/go.mod h1:idbUs1IY1+zTqbi8yxTbhexhEEk5ur9LInksu6HrEpk= golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= -golang.org/x/net v0.18.0 h1:mIYleuAkSbHh0tCv7RvjL3F6ZVbLjq4+R7zbOn3Kokg= -golang.org/x/net v0.18.0/go.mod h1:/czyP5RqHAH4odGYxBJ1qz0+CE5WZ+2j1YgoEo8F2jQ= +golang.org/x/net v0.19.0 h1:zTwKpTd2XuCqf8huc7Fo2iSy+4RHPd10s4KzeTnVr1c= +golang.org/x/net v0.19.0/go.mod h1:CfAk/cbD4CthTvqiEl8NpboMuiuOYsAr/7NOjZJtv1U= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -218,8 +219,8 @@ golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.14.0 h1:Vz7Qs629MkJkGyHxUlRHizWJRG2j8fbQKjELVSNhy7Q= -golang.org/x/sys v0.14.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.15.0 h1:h48lPFYpsTvQJZF4EKyI4aLHaev3CxivZmv7yZig9pc= +golang.org/x/sys v0.15.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= From 1993950cd7e098638d63b6fb5bd712ca75db5b76 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 4 Dec 2023 18:20:05 +0300 Subject: [PATCH 146/361] Downgrade requirements for an old Ubuntu --- README.md | 3 +++ pkg/encoder/h264/x264.go | 10 +++++++--- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index ae86ce7e..943eb664 100644 --- a/README.md +++ b/README.md @@ -58,6 +58,9 @@ a better sense of performance. , [libopus](http://opus-codec.org/), [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/) , [sdl2](https://wiki.libsdl.org/Installation) +(If you need to use the app on an older version of Ubuntu that does not have libyuv, you can add a custom apt repository: +`add sudo add-apt-repository ppa:savoury1/graphics`) + ``` # Ubuntu / Windows (WSL2) apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev libjpeg-turbo8-dev diff --git a/pkg/encoder/h264/x264.go b/pkg/encoder/h264/x264.go index 8b10ce58..c55f1502 100644 --- a/pkg/encoder/h264/x264.go +++ b/pkg/encoder/h264/x264.go @@ -33,8 +33,8 @@ type Options struct { func NewEncoder(w, h int, th int, opts *Options) (encoder *H264, err error) { libVersion := LibVersion() - if libVersion < 156 { - return nil, fmt.Errorf("x264: the library version should be newer than v155, you have got version %v", libVersion) + if libVersion < 150 { + return nil, fmt.Errorf("x264: the library version should be newer than v150, you have got version %v", libVersion) } if opts == nil { @@ -64,7 +64,11 @@ func NewEncoder(w, h int, th int, opts *Options) (encoder *H264, err error) { ww, hh := int32(w), int32(h) param.IBitdepth = 8 - param.ICsp = CspI420 + if libVersion > 155 { + param.ICsp = CspI420 + } else { + param.ICsp = 1 + } param.IWidth = ww param.IHeight = hh param.ILogLevel = opts.LogLevel From 27c9ce681b40bb4604a2e8da818dcc9f6c119e2b Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Mon, 4 Dec 2023 18:39:26 +0300 Subject: [PATCH 147/361] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 943eb664..6ba65056 100644 --- a/README.md +++ b/README.md @@ -58,9 +58,6 @@ a better sense of performance. , [libopus](http://opus-codec.org/), [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/) , [sdl2](https://wiki.libsdl.org/Installation) -(If you need to use the app on an older version of Ubuntu that does not have libyuv, you can add a custom apt repository: -`add sudo add-apt-repository ppa:savoury1/graphics`) - ``` # Ubuntu / Windows (WSL2) apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl2-dev libyuv-dev libjpeg-turbo8-dev @@ -72,6 +69,9 @@ brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,x264-git,SDL2,libyuv,libjpeg-turbo} ``` +(If you need to use the app on an older version of Ubuntu that does not have libyuv (when it says: unable to locate package libyuv-dev), you can add a custom apt repository: +`add sudo add-apt-repository ppa:savoury1/graphics`) + Because the coordinator and workers need to run simultaneously. Workers connect to the coordinator. 1. Script From f7d12e65e51536f46a428bb839953d4cf36d0cbc Mon Sep 17 00:00:00 2001 From: sergystepanov Date: Fri, 22 Dec 2023 16:09:59 +0300 Subject: [PATCH 148/361] Update README.md Add some additional libyuv notes. --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 6ba65056..42c1d157 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ a better sense of performance. * Install [Go](https://golang.org/doc/install) * Install [libvpx](https://www.webmproject.org/code/), [libx264](https://www.videolan.org/developers/x264.html) , [libopus](http://opus-codec.org/), [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/) - , [sdl2](https://wiki.libsdl.org/Installation) + , [sdl2](https://wiki.libsdl.org/Installation), [libyuv](https://chromium.googlesource.com/libyuv/libyuv/)+[libjpeg-turbo](https://github.com/libjpeg-turbo/libjpeg-turbo) ``` # Ubuntu / Windows (WSL2) @@ -69,6 +69,8 @@ brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,x264-git,SDL2,libyuv,libjpeg-turbo} ``` +(You don't need to download libyuv on macOS) + (If you need to use the app on an older version of Ubuntu that does not have libyuv (when it says: unable to locate package libyuv-dev), you can add a custom apt repository: `add sudo add-apt-repository ppa:savoury1/graphics`) From fca46f1a32ed6583c918a5e6cbb01e3585d03091 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 22 Dec 2023 20:35:48 +0300 Subject: [PATCH 149/361] Update dependencies --- go.mod | 10 +++++----- go.sum | 19 ++++++++++--------- 2 files changed, 15 insertions(+), 14 deletions(-) diff --git a/go.mod b/go.mod index d20298fe..a2d212db 100644 --- a/go.mod +++ b/go.mod @@ -3,7 +3,7 @@ module github.com/giongto35/cloud-game/v3 go 1.20 require ( - github.com/VictoriaMetrics/metrics v1.25.3 + github.com/VictoriaMetrics/metrics v1.29.1 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.7.0 github.com/goccy/go-json v0.10.2 @@ -11,7 +11,7 @@ require ( github.com/gorilla/websocket v1.5.1 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.0.1 - github.com/minio/minio-go/v7 v7.0.65 + github.com/minio/minio-go/v7 v7.0.66 github.com/pion/ice/v3 v3.0.2 github.com/pion/interceptor v0.1.25 github.com/pion/logging v0.2.2 @@ -19,7 +19,7 @@ require ( github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.31.0 github.com/veandco/go-sdl2 v0.4.36 - golang.org/x/crypto v0.16.0 + golang.org/x/crypto v0.17.0 golang.org/x/image v0.13.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -27,7 +27,7 @@ require ( require ( github.com/davecgh/go-spew v1.1.1 // indirect github.com/dustin/go-humanize v1.0.1 // indirect - github.com/google/uuid v1.4.0 // indirect + github.com/google/uuid v1.5.0 // indirect github.com/json-iterator/go v1.1.12 // indirect github.com/klauspost/compress v1.17.4 // indirect github.com/klauspost/cpuid/v2 v2.2.6 // indirect @@ -44,7 +44,7 @@ require ( github.com/pion/dtls/v2 v2.2.8 // indirect github.com/pion/mdns v0.0.9 // indirect github.com/pion/randutil v0.1.0 // indirect - github.com/pion/rtcp v1.2.12 // indirect + github.com/pion/rtcp v1.2.13 // indirect github.com/pion/rtp v1.8.3 // indirect github.com/pion/sctp v1.8.9 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect diff --git a/go.sum b/go.sum index 2397f02d..d1fe4710 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,5 @@ -github.com/VictoriaMetrics/metrics v1.25.3 h1:Zcxyj8JbAB6CQU51Er3D7RBRupcP55DevVQi9cFqo2Q= -github.com/VictoriaMetrics/metrics v1.25.3/go.mod h1:ZKmlI+QN6b9LUC0OiHNp2LiGQGlBy4U1re6Slooln1o= +github.com/VictoriaMetrics/metrics v1.29.1 h1:yTORfGeO1T0C6P/tEeT4Mf7rBU5TUu3kjmHvmlaoeO8= +github.com/VictoriaMetrics/metrics v1.29.1/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -33,8 +33,8 @@ github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/ github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= github.com/google/uuid v1.3.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= -github.com/google/uuid v1.4.0 h1:MtMxsa51/r9yyhkyLsVeVt0B+BGQZzpQiTQ4eHZ8bc4= -github.com/google/uuid v1.4.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/google/uuid v1.5.0 h1:1p67kYwdtXjb0gL0BPiP1Av9wiZPo5A8z2cWkTZ+eyU= +github.com/google/uuid v1.5.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.1 h1:gmztn0JnHVt9JZquRuzLw3g4wouNVzKL15iLr/zn/QY= github.com/gorilla/websocket v1.5.1/go.mod h1:x3kM2JMyaluk02fnUJpQuwD2dCS5NDG2ZHL0uE0tcaY= github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= @@ -62,8 +62,8 @@ github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWE github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.65 h1:sOlB8T3nQK+TApTpuN3k4WD5KasvZIE3vVFzyyCa0go= -github.com/minio/minio-go/v7 v7.0.65/go.mod h1:R4WVUR6ZTedlCcGwZRauLMIKjgyaWxhs4Mqi/OMPmEc= +github.com/minio/minio-go/v7 v7.0.66 h1:bnTOXOHjOqv/gcMuiVbN9o2ngRItvqE774dG9nq0Dzw= +github.com/minio/minio-go/v7 v7.0.66/go.mod h1:DHAgmyQEGdW3Cif0UooKOyrT3Vxs82zNdV6tkKhRtbs= github.com/minio/sha256-simd v1.0.1 h1:6kaan5IFmwTNynnKKpDHe6FWHohJOHhCPchzK49dzMM= github.com/minio/sha256-simd v1.0.1/go.mod h1:Pz6AKMiUdngCLpeTL/RJY1M9rUuPMYujV5xJjtbRSN8= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= @@ -102,8 +102,9 @@ github.com/pion/mdns v0.0.9/go.mod h1:2JA5exfxwzXiCihmxpTKgFUpiQws2MnipoPK09vecI github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.10/go.mod h1:ztfEwXZNLGyF1oQDttz/ZKIBaeeg/oWbRYqzBM9TL1I= -github.com/pion/rtcp v1.2.12 h1:bKWiX93XKgDZENEXCijvHRU/wRifm6JV5DGcH6twtSM= github.com/pion/rtcp v1.2.12/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9L4= +github.com/pion/rtcp v1.2.13 h1:+EQijuisKwm/8VBs8nWllr0bIndR7Lf7cZG200mpbNo= +github.com/pion/rtcp v1.2.13/go.mod h1:sn6qjxvnwyAkkPzPULIbVqSKI5Dv54Rv7VG0kNxh9L4= github.com/pion/rtp v1.8.2/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/rtp v1.8.3 h1:VEHxqzSVQxCkKDSHro5/4IUUG1ea+MFdqR2R3xSpNU8= github.com/pion/rtp v1.8.3/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= @@ -165,8 +166,8 @@ golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE golang.org/x/crypto v0.12.0/go.mod h1:NF0Gs7EO5K4qLn+Ylc+fih8BSTeIjAP05siRnAh98yw= golang.org/x/crypto v0.13.0/go.mod h1:y6Z2r+Rw4iayiXXAIxJIDAJ1zMW4yaTpebo8fPOliYc= golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= -golang.org/x/crypto v0.16.0 h1:mMMrFzRSCF0GvB7Ne27XVtVAaXLrPmgPC7/v0tkwHaY= -golang.org/x/crypto v0.16.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4= +golang.org/x/crypto v0.17.0 h1:r8bRNjWL3GshPW3gkd+RpvzWrZAwPS49OmTGZ/uhM4k= +golang.org/x/crypto v0.17.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4= golang.org/x/image v0.13.0 h1:3cge/F/QTkNLauhf2QoE9zp+7sr+ZcL4HnoZmdwg9sg= golang.org/x/image v0.13.0/go.mod h1:6mmbMOeV28HuMTgA6OSRkdXKYw/t5W9Uwn2Yv1r3Yxk= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= From 610e087bcd5bb3a6cad43925744478eedf4177c4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 7 Feb 2024 11:44:27 +0300 Subject: [PATCH 150/361] Update to Go 1.22.0 --- .github/workflows/build.yml | 2 +- Dockerfile | 2 +- cmd/worker/default.pgo | Bin 49125 -> 0 bytes 3 files changed, 2 insertions(+), 2 deletions(-) delete mode 100644 cmd/worker/default.pgo diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 5fccc156..164398e7 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -25,7 +25,7 @@ jobs: - uses: actions/setup-go@v4 with: - go-version: 1.20.8 + go-version: 1.22.0 - name: Linux if: matrix.os == 'ubuntu-latest' diff --git a/Dockerfile b/Dockerfile index 0d696da1..abae4a67 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:lunar AS build0 -ARG GO=1.20.8 +ARG GO=1.22.0 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ diff --git a/cmd/worker/default.pgo b/cmd/worker/default.pgo deleted file mode 100644 index 35a67035847acc971e1a31dbe34b4c0848e08869..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 49125 zcmZs?byQnh*FAh&3bfFo#T|-Uf#O!6K=C5MHMqN5TM7h%l;ReOdvLb`!CiuDaDtTL z{>#13eZTQMV|@85BWH|#&RJ`&IpvaCBhgHzi%m-ZKOSn3YZV9tGENv9N&2btbI#A4A8%gdJY!%32{V9-ii%Pg zwtq_iGSF_ZF*n9@Ga$LrX;-PrppwE*@X)B_UQ7{PxE zgKn&YE_Q+*NP!UcWQ#ruprtI@{`p`VZEwZ!C$wVHtjXp&Cdk?c?s<)czE20jyY!!MWPk>nSyjql;|&4a7x4=`E=oP2i-)z(o-Ts**O89L&zEdAX( z-}#L7$lE%TR-X6av$#d(0lxn*r1B`SyfCfsfXsi?_zXn9EUs9R+$I~R@dhoc16ZM# za+wsBEL9Vvyfy9(Zo*<78I5~kl60)LG385;)fw-*8UZiWZQvW(^jq7|x>8?kAh-h( zUtVO!`vi2@i+dTM+v_V%d}@LrAVE-LKRiSvrR ziU)|3;gF!eHuwWsa(C`fPD4e`kfl>CE`xo7$!4m^JzMKBJoZha+w_a1G0cPHhON1$ z58FiB=GPY@#{FQwmVjWpjeM4E#@2+29qK|BieCe(@q|Oy7{;A~e^gq3=)C&w`6F-t zq51Ay z8rRD4hd?#er4gi$`08n|Kx{Gt`IYg?@n0%GYGaRg&^WPah8l2xhun=*^i}#psV@9} zV@`^9#kwt7+_2x)Q?_K%P$-wioD$x>ao*&S@8MP@Bc!JTMJ%WJj4@@gY^3>?eSNYg zI%04|wvt;6w~2(Y=jMqF-BKmE2e{lGJrn*T=Db02CA-2dcIcX+)S78>A%xiZ)6IUj zPqOlUC2`|iV6L;`1bK(iG2nc%c!$$5bbNAq_awMKms(ISW-s7WL`05BY~Nc;Zs@A7 zl}0Zo3W}Da#`VA13 z-EZYmzIE0E5Ifm4JiT}AZwi%b+UF_*m{!xB81?wdxZhR$;9MfJ(nnJxboOzWx&1(- zDtvzFmo!psW#C@++8)Y3mgbzVZ#(nUKD(~}kK8*Aj(V}~?@pXmesDsvZiOF7`eZY_ z_DzYlmU`@Ei8E~M6duvvyLAi#z4KnUZIauU17?p2Zel2t&0oFC_q%8{v_~JS`BVPX zJ`-Sbex@I{SC`F}v2q>MrL)!7qa6XTD{mMqbF&Wtm^s$6T``qTmQW_zjv_eRoOS%|}CFyPb5! z*zeumdV!8^TSbQs4FKy`Ye6)F4g2NdGqh?}<`&W^{JK?Ry(bz6br*WKT!+{9mrGHHf`ps>1~b}0i~HOwRNV4Q zJnqm(+07#oqYtRcyezv-GUmq+^Af8Rvqq?GwcvK>@*fYLWX_n@OLzEK_|9yMZTiP{ z*u;O;kf?&_H&&uvnh)7@-sNZ8R_)j46lclKvSnXdA!W8`KCVlaF;uv4{~9?FLmOsS1d+opS@Y2mgY{#n2sV0~eB8?}9>v!hd^&-V* zd+Yu<3VT8Bw^Js$w-)6m;jAt6Z18TStm>zx z6`I{q5M8ET6KjISR7rEyi8ttq4}A)28>WWU^;@+PM;!UBY@$?V=upbUEs%b7ptk0K z=t9xoW#{T|?KzOjx{>_uR4+b9!O)?5m`Rm2ggZNDf0*(h>2eltzO&%#)qcMnZ{|IM zUT>XzuiW0?G|uJ+<-7Y|v2|Z!(#X6@}qmS_turn zh1o4AaGLt+NzbC&0Z$8it)$as2TxSoi=NhRS(Udh;#3!$8#|q9F;6}fS;K|SWl11B zyx9ZPYwbDn5{?aX)(6_RWr3p-&JFV<2jB}ve=hq5@zcHPz@ClS_^p&uucPz=w1M~G zMqL&2;)2WK5AMtDX1FC!B6yFUwUC+DM}6;h?)i zJbx+98J$c&Og)EtsJiGMVS0HfWEGk5dyd-YErXY8LWJ5u;e`@1b@@>p*|dCo{tNpy z|9&vY(LY&X*~_|Qs^%T42n&TF48dxDJeUVk*WZZpW$MKgcFn6EVCAQ5_}skdNktC3 zZ;L{Vgy3X%Tp8OS^cd#940c~49)O}?@gX^dy8Z~N#Q=^~+ACU-SFoeJC=;tSmNFmsAIgWSrOel3(_+ivd zct?-RJ|;+7(Zy~3&>R!=^1@Ivd|sqaR2G|xDmhwvJ(T;Ay^}j~JPddcN>Env+EpBw z+F;eeBEN@`p#9T>VW#Cpej-b`o0wpEkb3kaxwGI+kCnW`NzsDcAO@guZ|#`*sz;#K zPIRWFd$BGzuf)?!#C@L2xWMgFBay&)GQ`yepR6TK^-;-kVEQC!I~qgVyeV3cI7w~DM2!5_ouyc9nx?gLFlN#3?1pan zeltje!L$XDgm3l7^reV%G3gHfD5{fZe3Cs_S#%Qe-acO}P3YUZsw?ojC0rhhCBCbk zeks`lDPS<@%m?wH#hFR}I@!dM89sT9!C+35zzc7vnB`gJo~-PD zs?|7-iQP*-+)Bzr<@y4lF`e;c(o%x-Y)gW)Pnl+TgM*{xsVgIb4dy`8cxRUYl`=%4 zjSWlLasjCY-qPfwgOCAlxv|ytznv53);_EHJAq{N4V3v5ci2t63DkdlA=!+BLIDjw3+K!#0#V$KM#CrWU)OMf?{=lW%42etHx-W*BKLgSvj65n zg+XBVH85TW{vmbl0Ngg~MIscvWzg!`7r}>NL==?NEa%KzZnLL171#|BVn-tV*yW6N z0^90=tLUq;tBhF!SO%oE9VQ`PG<9q7%k>wq6MkT z=PR;+OP7En28s70xcH*c+eg>y8eRe14bn7XaFgg*~AMe(TO-#U;fd zYbg1wAdswtt#25Wy~;5GRQl%b6Lssc(oGH%Rg=u^!W^jo$f+%SC2~67PkCdz_hxCr|B`kfItb1U4KEDtzls2;@W9!icpztw1}WBpo(AokC#Cv2`uc*wn?h zr|2+n%Jq-gC|0*Fij}*wZ_jKVEz7pB5C9lX?K*i$bBs^7sQgBLqwwa;_eB{$C;xi{ zj$H?M>p1(YorKVGDTMB~ob!j@kc^a}KXcu5nKIO`QirHJM>3mp-goZ8 zihQ9vUt&xw%(jU@?D#r#R=L}7jF#>L{uJNx&(U0%L)*Y@F<1cXDa;cTx~n5A6xNf{ z^iPQ;amv^VBQUsQzIU_3xMv>zW!dEw zzlnV77azi*73n?4vP&GrWBL`D)>uoLpJ#MHW&{JbY8)Xo_zBJ0#p{5teh_*InShw9 zr>}w{#80vEE2V>6s0*;-e%?hczgO1W&ul;S?@I^RqpI&9y_U(P(a5;%GN617s_Jvt??iJn`wESPX-#oOE#ZZPOzebzBi0$ z#KPqCXUQnlG2iCbJthwLUhBm&JWI)u4kp^leurW}-3bxO-_pZ|-%`Qq?k|9>2tODv z%nkMmM5KExm*B)Zci4qeFzGV6GBPaONWokWY=kz<5wtkbPsLJxj^q86@+Ky#f_~N)bdo|V$mzEk<9sbFW^yE20 z9cI4!rBB`O>B$=)1A-OC1haxofjB|dcn0`m^bi@b*tsyDCnxj>Mwl0D2&B_$bP35I zz4b&Jo0AV3@8X8~5e3pN$7Iij;oNl?Kz#m+ZsgJOS?z3!KwfbU2T+{gG*1{M{GE=g zzfS15;xbtRzg>}@yg+Ey?x*UAXk+;IHI9Wpl0c!5+@mbnM?$g;?*!V z{`p6lz$qc;+d1!Wc}%+G^gmCcssH#s@$g$Sjh+A>VaL6xx*8P$unBzeRWCRic z`GKzxRxnQEsAOR2L16t-SdwFMWyRrp&pME(>l?3Z4?!RmP#i%G!>9l}*;{14R5+#x zyPeoa6Jo{9sg?nSw+YEHo!uusSHt@(i?R?hVn;nFSK2;{^_$pkO!QgN_8Xvi1)Uh& z`gwZgd%lYi+k|>rNat`li#XT^=R^!hfj~dY1GBV!n~U)wJHaYxjuh}V-L?nK@|?bc zrKemIBOGC(AaDHR?Co0+ZsiMH^@WHMYP0RWlxqdGE^UC!JLVCK@hSUKM%;PSCAb{m} zn+^>AD<&X4<5EPvE>GFz;jSV_C02S|^d!9d*X_*DZ2RyCPDr(|t^f%SF8iQ706oQ* z3P=aU2lD)^RSNT6G>A-{%_XyB;k?Z8&CT19>=LICAuf5p1ZsRyMNoxRMP7yB%7-9^ zmCsc>vMe9U-bdHzVJ*^FSnG!U~=_E6zHdCq9DQK`6$?b0~nL;wA~i!gMvE32pXi+`gGe6gS%Ie8AU1Z{!- zF+VqVTH^h@BJ%y#o2;U(y}Pk6?cC z!#lx4n86r|_E9W896)&jb6I*+#W}t;rw*C`g{smC&vmBTR^j=Y=ZoAY&a7XTd73tpMRne@Bn+9ejI*0gy3xnCk21G`iF{PE|gC5peek|lc-E%d z773#tGD1_W8Ahd)dFGby{_Y7-UXuu^BD04gT@V!3mEzCRLS=`ghGmCkhGV;n;kS3yYtm(Yp5nU{^=)F1*0qms0Pp4pTC2ddGy8EHUEClil~y5>_3%{ z`>T_IDBl)@U0H{%-uyfttezIr_{^0Rh*6>+Hi`1=AUzN}o{pbul(H_-?s3-H9X$mY zDrXqdNX&!DgW^{nnkrh_8FaB*enl`I7+OOw~Dc})Usk> zK9ncV5DG9km?lUCG-9*)k2*;?$cp_(oD3=k0_j|M@NT19CwLz;e$J|O%Uhmk)M9dB z{tga=`T#mO`;1?C+*dkohKJqiMT(BM+s|>&s{3_=H8;NnNes_4B&8Sa{HtLTdHyVI z|G0?1J>B#jX}%g>7I52|B@kuiP8bpFuvw59y3jw)0fy?1Km#DYHd5aR!r;IDGDaM{ zK>IY}z}>6FBQG07UuoTPxlPI};|_oS_*4WJKK6e+i|2}u0Kz=b(ORG7E46*({WQp% zuye{PPL^!e^iRzH&OXt8v>JhSP8h(rbR)lC`$~bSLpK_I=0DKxkrk0Lh`^+| z+ZpzBH#gntq}on)B>Zz;Xx0A@z+s#q1N;U$r@ki(D56O9 zrazKiLiM$}v5lBjPh2ZVP*eJbnm{|3$Cg?eBC7XdAfM+am48zomAc6q)vw$lBq_ob zMrf>@;A-Zjaei+C`I!)1@{Q#3#`CjgQR#~+vXgf}Yy=rhoASPfMSQ16U1PasjQv<` z*Z=Elj{o*~copU2kClCjSnj`@K4tTS1Jy9=74@qA#jQh9KxUPkGecQ|Y{~w{F;>b_#L?k>GLD8%sO< z-Q0N`J3I8ajSLB~R{ZQO1yO-!@hTWr-nT~hV4n!2xnky{JR9ALe85@{Zr<(Nhgu@! z>1?1s1B<0~z-8=`H+#Uh8yW@)ses6W{yJJMBMga2>vlm7}4qRB4?+5Qa~Y=V8C7bYp6O)^iw zvbqjDK$JLg2XRRnrhShazdTWplysP_3C;Zv`ONJSu^6G6oBvZvlm|vY65~JLI&u;B z%M8nNyf+Nj1?hg%jdJ9Yvi+~7=0EyKuT7`Tyf(9Z*)?=)ZX>?_#BM&S5#5y?AprZY zO#F@gW0Zxc|IED^m=S=RWcz;Uf5Oi|EhQG|^YWyT1Z~orzVognU@R9d zpaw+r%rlaiD_znJ_{X#>vaR7hG$&6GGB8z`JP0+bp_Pyg2)p{PwqFWYk%xcx1=?3q z4BGz>@Yt>b2uj#%SQF?JZ-=3P9@RL$Hzb8|x~RLjz7?N4ee0L;lJf=EE30S8=<6Y| zaTQWg@!4Bdu(-*resA6olTE(*4GR|br1t(^RKwsCtkkYHPlPtds~V<_LkoGsI;@Sp zYHE1#7x_w(xeg`+a{Slo%Hesz$S(kt?B`&^rp>XlY0rbj4emhf494t&aOaY#@!Q@p zRq$5O2LwMvry z+Vc7V{@&Il&}B`xCAJ+%-Nt@=$}_7eo<&FX6CHIB!F=WFh5ne}thjZy#408ywqNl5 zqmeMRr1RTf-cv&%6h1FjJI$LOZOA(4=ElO?`v%4hS0258jR>yX*7-y!Kd*@l!g#~7 z)w@<;YFWvqOLg{U=9wVogg3JSTTpkQ3u<_iv^KL=Z+cu2O}=w@+Bpqz?sLSIsH?2^ z-fW}_Nd*&H0#o1^$-4L3q?{Yx7`Jh#%}VyU*i+fP%M!w(NHRHqjm}s&h$SpZZ7d)~JR2Rq) zvLCCqDJmb*_q8v?$XTzq8T-)uKEm`^?W9l1wOS{HsXs0n&1v?y-_=NvHt@)aXVu>g zQM|V1=k+76!1P!!>PC5Ydu`8D>9=wv|L%F?*rvaA$j(=jUA`t1{C7g`0|kD@+6JyV zz&K2PXm*uxUde_9m%U6=YwL^Q=nSi8}yp`5!3#2 z7;68sh5GI*jsC-@c25SOUxbMg?8_r-#B>bt;xHoI{@kVdxYlx;@~8kdlwwR>tx3=3n5OUR>T^4&KNExF2Xnc zNSQ$^Z|C}0p!S`?Ius+VM~c-tyu?3~BMdA|x6aSS_)c*8@{t&&**l@z;TVKajC|!+ z`Jv;Fs4Xe_Lbl$gwvbmiuPHF{4e|6z+4c`d!P01Hl|l*B`UDHkRJ+E7eM9(4GKJ+G z2gfFSt3PtVP0Z7=^8+UFSr*?ggyb$vcxeNNq=#huTN|`fvr|rm*=wJ=$rTI?j+fv` z^q@AO9js>$q{@a-bKryVnYDf6``tlxdue-_ww32ce2MPTj;&+45D7x&G0EL|5!Em^ znM1LgrmEIYK}EFFQ&3mlX=+`P{Tl&avm%yneNm|WODLMUxAN5LV9I`XqI#CR3}be? znS(O=8#HTQ6{5Y$^ve_Qcb$9K0uArUIh zs4cXee6fuOHu6#7 z1OvLxx=Z8RGTAyk#&v7Lf|u7?QPd0^M9{WmQ9xn%n6?UBcEN5gAvNq%XVKY%;nBj^ z;sL0Mi~d}wVcW({sI2uAm|uS%cUj0x^L!e3B+{kb64oTO{%Pb+v)&$CKHA%HU31mz z9<|LBb1-QcRz%}^4}4xH+4fVt=mpf|xxV=9YqFA{zH@N)w7%J=k}UUo>B*tZDe~}Q z1*pl(+`;4#^6*j`uX~^nkq+ru>2XWYdSSCXlY7RE!YnspcQ4+a9BseUDdYJkJ;jzo z5$WRirD(!PEbir5$_gtUK~>mP4rUnPH2%nogepYp_D?^8m&@3Px4ZAy>WJ}ND_u(kpa`38^A0#fvw(=Rdk+&+r~5XnVyjtBuJeN z+!VwUxsV?1Q+pFe!7Mjb%V}l=Cr#{J!Uw)ITFfeG@hvO)-4sJwNR5knUyizt{uyy$ zA)Zt>9q8;`y<+{c(1`$?iXDCz zBVyeYbb@1a%u;7)&|3O18%=mTxhHDikzP;)Ur1xsT5VT}9rfSWL9Ikh)ln$}Ue($2 z^H?dokO`CgWZ+>g@iR|f^G?RIYbS<)Mx$qeu=z@UKX8_qrgQ+xDWSgVagShV7P-tL z4lD`kJ_pAZ-}mrDn`qE92A#YZ$?!AWu-+F$tmueO^BykS&aaWMjS-Vy~K-=blj;*oQ z5cg~rka|>GF`0=>P3y>3^e7CBHm)Uqup$Z0To_VD9WylW@5wNes>tYw?7PuzmK3`4*DkIl(*j{S-|FLDXBPAkZ=3odMY8cmS=y;- z!D#{jiU%^l@bU!0+UAyR!%4EV9l3zmncjgi1R3K7WnAgmDe?gBzp}vr_mqz80=~iO zf%B+)sEt`soNyNdGw(@QtP9pnj@TZ+(^X4n3l&AuBOM-5rs0sJ;P_m<5qqfuQI z#hiW#L7`YP>v7RzEsZQ?70}dtcRXHC zW|UtZko|M2O)h=TdyGc~h(GlNp;qs&5z z)$k*O=b94gNf`9wG>Wc8OQeQ6WE2L%I!X(WTbnIfS$1;!v2a5xjJKIhxiFfkQU|{0 z!8s4Gx}L0(ipKgYzH_u$?uTz|#^mz1?jga7Dh;n5LT{3gB*AjRV=o`_Zy=~UW+XxR z+fH=$BcVs!Hrq~92EpYbo}Q0t%ah0*lgWZz?LU~PCtzn&;xQOlEo$mU)x@kvOYO(g z)e_*c^@#?3(GHs)~WB4knRvK!36k2+NKRxdBMs(y3pC)@81#97Y zklcwoN?LCpN)~r7y^0L}NjBxQYx^*^FAC*sFMQ}d2M6cLz#BXe9VxOmS-bOL49&xr z00DOyMAqKQmrAF;juQ0Yx}J_=8WeQ=JuX+UGm)zRaqoMC$*z;s7wtbZ`wgfE3>brNSs@r#!>DmpgC`D#AwAQqMekhx&5|IjzTb8UA1K(zH7Qu0ZPCcwZEV| zXjm}mIcO+X1Krw7@Ks)}Gi2Q6Y4%^)OdXp>D4-U#t`+CB8>wi15;wSO=nFfk*X4?M zC#ST{J!7en>Sxg;5!b7g+r(5Q=Au1Qwx)RJl=Mq(aCJ04bW zib$@b?l4Q?KpuxxiELpWpWi}4iRNVLg7EY!5Mz|aW!iJoj6pI4224Ya3Rh?E8>4dI z@+;6wxo{Dc1}@8e_M?wgQ4^=pR!=S8o@+uGlJ+jX>yGZuXNc=xyA@o%&FZ(<&pFyw zmJ<#~dMXlY`ZuPtRFiTR>6Xd|pledpLKBr4n-$AUwLZlcqL-#L?>9cF`Y|!==-a$n zor;CJ0<68VfR0wD6<;p_=+h?>ONB)&UupVE2-0fviRioPj>Xg|w;f`@$mQgdso^h# zmG7Yxc=lvQ4*coFCU-_P5oQHr8=?cw}9T}q=?F+!}6$lughOX zhggfGjMg8Lf7ptQdC4gm43j!q?MGf*Q$-CXL*Zf0X8R;dpNlMOdEjpxEbUN5qFTNM zI=q1i6wKIgwvbZ!1?Uz!Sc`bzfR>|-odic#C*TVra{Nj;ToKV&ag|d#`>{=U zo7&txJgHr7bp9-Na0^+t_LruLpPu-D&G8|-{<2iT<@#qEiv$n4>O_IPDzP3LZ8*8n zE}rH{^C!aG8?kt|l;Ro*od_#AeqpAq=bB_9Tkmoc#5N@5Q`4ZdyWDt32Av*Ygx@ZUQZWLDNI(59}|j9(8Ql@hV2eqcx6t$ z*0Ww98{uk%!rvi@v?GS1LU!3Y(aEl9ZzK7P2_lgkz-=Od4q17l zekpc_C7Y(V6=rU&SG-$Hv5sGV1&S^LiUAqc`^QF%P`)(phltV1-su=KD1jhpqLsuH zD@jT-*)f}Iy!s?Z{0_Y)zn{P|(4(qcv$P2|P1B^fWToZi-!?iq>OoorqmoOkOZObK zEWoOjT(V549nCW|E74o@j#Ym+$`sjR)1){H^U9iNN3-fgnzAW*AEU{=0;{lim)qY5 z_OtA0#f`dU?)?>*vuok8n{hHgq3k$r-=k8HbZeN^*mHIxpdkkIsIN3;ZyK3?HjD3_ zawDh{(HEsEn69$VrCH~<=!mTK`d^m<;vTK5 zm}x1(!qIBT9G$v_i#|ooSdyzE+uIhol+s5RG@x)Hg>{Z=KX>yRUSY>zQ;zgOz)G@V zR!T2ib{0Sn*8J0B^G3hOe2^$Zq??I0bri1FqFA<>(9r8ZqhOfD`LPV4<y==RdAq=iqwyx#BYLVFsr*jT(nlZRuz$@ z*?7aQ6A_(ZOxd1WH@amM*UhAgX@6`}e%hP{7}&evihr9`YBKSKu<)f?8-px=;i-|V zMpN1(;7|DS=c4u3D;*lMNxdUnZK+dG&xyt=pC}4E10nHfxhuFI=E7jHQ_Nljx?$Vo z$WpJZrp8#E)O&}WX`itZE_UgH0MR{q=nv1} zqb-kFce6a0glcBX$kUdT(tx(2gB>mM5#ZNbw2UL7^n9MoQepieDODY;XlKs#{Tu33nC8vKFG+gOCZHKY=Dr zZIc?|GmpCY{b{|eq+uR)EiuMxlDvlCqzQ2zD$lCu4#1zb!RuV@md)xv0}PGEDK^nn zPiN!>L-Ug;n7Q2SR+j@!q!0v!TkZDhC#>MN@Z(>jh&&0+a+rw%RBTWgN({uH6fx_lll3E`0 zr3{867e8Io!Lp70A*YGpr<#9l!rTGqb3LU5Nq}AvzM8k?1JEv0I-{CisnN-G>{&i z<8Gh=Ysy680O&_@qFymsV(N&V?Q&Pz>|oSW}M|*Bopbk-)$lX>CG( zey*7qG7=kj6fpSV&)79Z&@blUZZ_KWYZAVZiLbGoGtn z0VV>T6^ zau#w(*ol$74Q}UJxW3V{!pkwI@gg48Hu^@>Y9i;~ovT> z*Y2KQ7bSUnzO#!F=KGpF>P5C^DGj-vC$2557#9Q2am{DLuRzcbe zT@PpTv$P{BL0WQ-l5qb&ZNyY<26n2yjgZq4U@VjLDPK_?15e!JhTR7^lu%4(WI+vA zH$khaCu6OtIj3CGM!jukg;kZZx(LcluZ5_T?J2fOZyJPq1PTcQ)n)I+GbcMe4Yvtr z8x?0?iQ7#?7EXEW81C$=zwc8aUS{JM*IrrMkM&%#n25~Xe$lT2eb7c-*jhCz6x|`7 z1*^T!s4Y7EIpCIF+A*{KLpBvt`K}#OY~q$EWI0jS!&J=%USbu{^Qh}QF!65mE75td zI?QI;;?n8s+xtF{Q?^SOcPo(W&KYEnFqm3RyyR4D)2^clSY6~)FfcW6&Y_(%lB2TaX?2W19rF6oXsW(P z6~Duy^NPuMi%q`yiR(npVKnm@NNj80*^rS-F99APZ5`MPNQ3@d&PkZo5!n*f!L2ng zuD7{Xi2w7o)U$bzoj70Y9V<5qIo3A-FmG3d=O893C1}5 z3>}mDY?B5j*>By!NltuKzde*3C-{y-Wjzy_7zZ?Dx1|Siyjnl_T22HCO|;eTs!MGS zoQpX6%oV_SHVTUc4$of$fN3f%+EPjdiyk?*ewJ;JTLpnSPC*9#ZVeN!J}{YpxUa2K zc|0e-Mg@P;O>JqmaP!`P01?yJESr^Hi3T?hpCg;3z8$1T&uC1;YX0nvq~GFVvAAo! zN_qK&HEZct5yR@e3!bTBcaA#u*3u7=DuV?B~#X0_HZN>a!HN}X5l8>fl zN7Xxv3G?^UX7Lhl@)lknNfhq6Yo@7y{UNEn5$FPp=VGoZudy8$NNVIs=4-|Mo^r#d ztgBQ!g^c$EMo|BCLCr%1GC8B7bTTELa@Flw<=WmDDpB23BA;lQe~tO!urMwj>$K}z zJ6sUbK;L;P=n-WxHD4pHM)uKS!Qud>hA=61rS zvCE*$Z|oh}7N{~^370?jSM5!AU+d3HE8Qnj;57*lt@6A8bJSFC&nG0>g?U%yD|$F@ zFP>GF?WBP|d{JQxAL-3>+KZ2#ZyfRnL^}8_ls{xGeP*dGUOvSF5y%QKdYe!hQSW1X zs8UH5w~qVFQnlx&u$lPOefg7}=G7VJp{Nqaxw(jLb@AFJ=W>KnIaCSEo4${e&Ow%R zqb5i@=r~xUHl>)P$F#6ws<|O@+Hc#GFEjqRsIs`~7W$jSBhNz9@r>$=NSlvyH7hHt zU!hL=E>ompI!@2oAX_>PG^Q32n?vlntr zoL(>6jT`vaoSmlQqT6ZFtcK%4ZvA}ip~G3+hK%E;SNg)X{AI?ih-J7+jcWS1eQ17( z=X-#?rm>s_Y0_KoygA#c`SwdcS75TrP#Z~0i=(0lfoE|~vyrF3$g#u{v+dToz+uRD zn^+Z2Nap(pjP&}INb>tGL*Ds!>^D%QAF6ZKnxoaA&~291)dE7Q?Jl4Ee6FA}^Ec@W zEhew~Q}X`)21&VXCQ}X^dj*mafUoctf&fXAV7OU2d6M_CgRWib%4+PK$7QR6o@23_ zxP(2&`TGh6dB;Jv*cH#RS*dHD^qGt(h!kWu@w!pPbNS0|Y_lukn~L?AkMWU^Eh>g> zKb(yGADoDlILA{U(i1CM-04%r~`Zjc`qBRG5!Qv1j$|7Epu0DFM$6 zURL3xlF9n|x!Q*Ug@HP)-1_qO(8vCyPJ9-bd6;LEfG`ckC&GJ5*HS6Tv4iGM!=X^Ft;7R2ib7#IHz2IX?|?(3mkOQIyw8cEmd7+0d~nRuB=WW7dWp>CYGX49e9k@fQrb!22yVXJY+a!bAM2E+}U9(%4Z z;>1mx>Xt+vf&8C4Qrxm>W~TAI4VL-|H@9eS`|*>w4) zN!e_v;~`gx*ET(06TP?EGg^m84qeSJGw%sl>Ze?v*lKkJ%~Ku9ITc;am*|vf4!v3( zeeRNDZj>BKy=NXoZnM+_^X$!`j>qOmu-#JMasy(9Lsc`{b;1ryeMJXF4&80Iq|4M= zUB{rA4y`|6Qg&Kur3s20y1&On(L(_w;;+4wjmfJ(kMWQDmw^xt^UpAkrLq z^3pu1Zm`rZy8*Glq5TJ<+uA?4ablrEj}L^M$XjhnEOO|0w>NZZZ&>V5{gvoT5!$wN zhfY1J^ah+u9BSW`VJ>VewOhO5Qiobknv{K(nr1GG9BMvpQudpafLP|x?3>GU#~iTK zpXoTrp%>9jWjS*bM5d!Sm1SHg3O}3RTEaY$%yOvqmGOf^mMWO+CWsY|vS{zq*9B91 za;rG#);LuCd`9i`o^oq-xxyU{-f}q( zz3hZ?xei^Ko!nDSi9ClMO$VFu9h#8~DFqHSWkSk2hn8nX-%`mkS4R$2ERUuvH!+Yy zw^N{P#oESet1fzNEOBT@Hs~&ODEARqz22c6b0ANdL%Z6c{pGs9S1(Ln=jrba4sD$Z z7F1{p!fEM+9t$=))UaoUw@)@Xv^nMFB~PA8hi)$e3#uGig*{O1(D|oeca1}{T0EKq zVzWbcqwo4I(udP64!xMwq!SKzZRJ}X%0#`}9J>7g^lo=(>QS(GheM~Z4Ydxny)aAj z5ldau8{AHZE;pH!qn4Vb^Xzgcxhv(ErDp1s-Fg8sE9Y^m>n(#ihn^Re*jPu{^*s-w_GLmI&`=sdJ#U)Ja2O-<0Y89-=UQ= zlf8p_Ko4r;{Ab=tbkL!U3>b<-4lT@rl*0}kc?!CZI8;)W)b1J5qYjm(K&fL6Rig_Z zcWB;H$aBJ>c`v~6PHLCRo(2=P(V>S}?vz6>aN;#NbZ9E1G&@w32c=Fsbn`T{qs5_h zN1^^Rjy@$xv$McI0%{c?sUUH}@3~g+8X!9krlAp3vzCNQ~cBt-_IaW7W zYKQiaW=oyX@!%DQo_83@X-jR;DOdFfEz>D2mYT2ibvSf%hq2;}rB(#ofVk$+()`F2 zD;VM?i0j&k&R0##^ElBBhpxQ>Q*SzSx_j`=1L0c^)yx9pZ#(qx7L>Z<(9?a8a@V0J z*yMW-%{*_K+-h~b+H~KcZQadSqzCbVqa4b6v}$Q`Pq~K<d^g%9p07knRbVJOTZnTJ2ZO^Sn$H3^95kRONX)=9$xg6 zdgaiudEk7n9co5BVIS3WyFs2_L#F!Z39g>geDq`u=$Y=L{jb3JlYENPRowMv_-NTf z(3I?>%?;)O(^*T^m=MWFDcuh`*7@87G0UeM+MNl#G}}j&=+JX~v?Cc>lH#M+4UlK9 zj|!eb-_FxkzFG=>JKsm^yo**qr243Jr3v|WGV{(-nvYtZLqit$=rp?RLLV(khfZ4L zqeoAnlNRfyt$O)liKl7lJ}N%`)H`fTd{lTF$}QDqpYL4n-7GVF^!j{hx<}J8A3Z>u zmiuTu+LY;|WL&kfe9EFD8FPy~lX8WRuBJfeuJqBWz2I)Ed{nut#k-DY`)GR-)VA73 zudiUZfnA-$zfTPR;a&OFn8o20gOQ zM>8{FaVhlCg`1$K$VX|fp^u7n|G&T~S>mIP7SLVlqYcfFvff8$AD#7%ZJCb>?m=zk zKH7K#Qa1Rg<}B1-q3f^5`ZxM$2JTUte6(;X^kk*>w~S-2z5Z6^qf0m`s&%fTIN@r1 zbU*W%*YeFi+VL7%x5Y;lsi(aju+>M&I8C?tXdUjY+kNz+zSl=h)1cfw zT`mnrWxtQsVoY?vN3(IOI_RTYX&5*8XexT;VIL)9Bz43`l?Oo2Q6C-XK8u-$KgWEu zEj{`;Y^sTyeAJF{%LyO7#31&hk8(;K3Ww$ zE&hj&ntW6~3tG|Qql3%gAaF)|-=5XreXTxv@*L_q>!T;#L4kP>=A4gS)vot?-+3Q( zUhD8KMPTI@Fc>0Z=uTl8!%W;uwN z-HVY&tfuEA!Qz%;y9DRM3>N3|M*12ldI`MdV#;%%mPSpL^s#)*Ei*;6CgA>VP96mX*mcXRY zyCiL*|u z?WEC=x8CMN6QA|%P880tO3pcvwXn0T^q&NpoY)@SZy%8kr`(H@@sk(qktQb|@d?=F zL}%-Sy$=_hSmj{rq7&s@N4uREcof4xlM|hJJ1J{*M7iX|di9pQ=3XaexCegOiE%!Q zt~fEsDOa7S=bmIAnU?y)3=mv%VseU=x=#9^wzy$;5^gwA_l8CJ`ki<^zaz+Rg#%)M zKI^^1KD+6}Yp%$*oM<}4499H}_h@#jUEFt^=;7*c*NIav7@PN~y@|#od&uLy6Mb7u zWgj@v_Kb1x(24eoD|Ycda^eLara>n*d7xy-iE{3!4?D5RgSsP5^zzu+s1w!P0F613 z&u#L!6PZh_XOF38a~D`x{fQHKci49mPK->jzD_zZ%2(JaCysNoIqk&YWk#8CVq=O? zo;uOb-Th}y9OmBctP`mm^E`KAwA9Ld8PjBflaP`V%ZGNdVMg~7QgUMQ_RjuLoOJ@u ziFR(Z7M*B+&XJN6_c&sI>BMy&SXgpm#dhFF7q6Unxf^Nt=kUkHvJ+Vki~s+}MaMPy z^b=tzR-DMcYi(~l*5qlTtU8f-$D%yZWGhkDoG47Of-Do79Q=4#7q6Wd*txi(o;tMd zME&fM55aRlyrJQIa`@pf+se2>wC%CcQ#RTr(faFRTWz#0q7B|%Y_ZX{iS}mvXqAl? zEu@Ckvo-c|`-pb0t<_H3PqfLE+s!sw4ACw<7-+K5Vu{w+v1F&k5v{oUuKnA1qRlt3 zb`ywpB)iPcUn0@ApGVvKmL%jJER-`B`hdU`-7jMKt<#k3|bTA)hcIs}GFcr;32 zb7{=3d0hhcQkYgKW76E5yO%z`NmR|!0PbJJeasI{CN zVlLX4z~h6grg4EgT>g&*qIXX&T8Av22%LX0Vwd)WKpb}wCk1kNJbX&vHOE8K0@>3X zR|(Yd*xys)dhBU}-7-BRTII_Py9Jvi+VwORrGGAPf?Mr5fnz*cHZO24k;Q5jXrAob z%D2yxMS*9j%<@1%m6vy(*#QBw{&34XL1d1***I`xQ z%I;+!pCVW#u#YSFYk}0)Pwd08E>QNA3HXh`EAH-X2t;qQdNu`$ct~wa;9UFCW831h zO-zrju!#~Kg_ZKy!}y9MQmG_ecg|VLQVw}N-TZZew__*9MM+KU9<<$ z;-ipokxlA^D2#A7Bryv02~X@H{-h{e<%sD(6c+d-PmaRy?gnzH9+n~{3b|ZTsZn@w zoh1*XMPaj>P2hCmy5=NP%#0|E^KGZhD7@mna#j=uc+aw@ItMg30xlwWt zt~_9Bm=}dEUVDBNo^7+b3h29(lkB^~D6C8~J`YBrfX5|@qR`F(Mlp@>Py)-PITVHR zL3tGJ@r|z|Q5fWg_GlD3M_HMQDD30= z+{cLP(KN>O@hG%&ta~B~eH_SCMxl(GzN#oRb1+aHg%loDsG-(Yub0?cI~j$m%dAu_ zmFnR<)kWb#=^6u0QJ9No^R6LE?!`i8qdh#(7=_Xy_FYpH&hc5-Y;l!PWN+_O6b86E z-V%kXLiSxN>CVD5)1A{%SbxT|o}y5^JDOJf>}(W9;#l2nQRsMZf^FhOVTSAOxhTwb zvc>Lv6drMZqazB5Wupu>Md8S9T=9?+)7;R^(qq7Z%So}J@MQ7E=o;}gA682a$GJt;0np^674u0)}d`$t!4Zl}Lw%XMEA zQm^vOyC|&MEs0lLk3z}0_B}h*+@K+CohY*pX@3+>UthBi-~cr?eTn5$-HgJKO~%qK zDs|-H1G`baO|+F;kL^zR9inX{7S-EmcZv4+&80dU?HTSET{fKD2*=OyvL81-ZpR&`2takS`+G)c?t3H%yceY1}7Bf34cljy4ve5X~*jB6aOS{_*3s?!F)uEov#XtLV!ptY03pf4M}Z zs<|zE6@?6LiI%DUinwU|tXYXd+k@0e`^H`rs$UJ;@ywcK`BoU{dmV-P3D%$WD8%1m zuiD8HJegNjsBU)Yup|{@YQA;rR^FE>v@az0ZZo1FXCI zT~bBiP`$mT7#FJSh7Kauh4!~T@>5M(mr_k@vX{!nxzP7uCv-FM2?A6uq-U{VO>p7W z{&BX$=fW|bRGQ>Max~k|JK#e3+w<$sG3Q@V@)X+uW_N7E9prWp2skSsdZtHFL8BL_ssISDqG$4E~GwV6S2XC+Bk-|8tJ>u zVdf7txp3+x!zs-!bdE9EopPb~Hlwt-(7>mCs|%wXJ)S1{wrtzvtBW%(bnYgM`v_dQ zu+YzAQZA(Ncv`y)M_%sa>ehT4fh!lbc|_p63jT;oGjREWn zB%+%$Ohgx5*lJ=(q?<|&Hg4N7Mi0>zRub$+{gMk=Ws@u_Uq?vFio;S5jqdE!FHbRG*%x$uC8`6fx4^;cNXeaeLao`^VY*%^*i zW-PhnGr2r|Sy1s+7h7yBH1lfbY3d7_cz6jHNJ|bx-rH*<}^26 z@(rzYHzqIenRD-Q4q+(_U{QK1{#d@JIh8z+xEwYOE|#+j5y_Af{wURwsYvD+DTx^jjRM#O@$lv z+=)3xg73&;PRwyPlFL}Q?1UR<(v}!lqVJMxC+q`Oa*U7qC9I%Drns~b=FdUo2<(6F`-s{HG9@hWMRBB;@+0!d-ByebV)r~BE)UA)Cn>op1 z+}GTw;_KUWH(FoD+3nyBHwy0YjXXD2c^rPgjiW^@;(ODL)&z#DZ@ICUvU4K)xpnKM z8?hI5ZdvMjFRY6@Zrs`N)L+x0bJvZ#PuZZ|bK@xAcfU^p$!k4q7svxQ%6L%Yp=Fl& zj?p7G9*i=4I_O3TPlp_GBa0`54qJj;NVFUM5vskyejY#*~=#&JGT=cv2mtxQqp-MBJ1W@li*jar@tvq%g) z>0!Y0g&T*t625e!<4mJn<(Axt8DcfPqMFY3GLXJZTqR#%rf9{DrN`{cRr>P$GBZVM zZd^S4#GU~4no3={&dlh#8>8Itym6yFecc|&+Mw@dpQqW^j!idC@b9+V=;3S5Ht~MA zmO+bX4`Miw+~-005(CNmJyJs>hw?EV3}o@`JSx@O#BxI7Jm{L?(8+_L3v6O1cu>u^ zQW8Blzz-27d2n-tLnjZ-+R7sPWJvZPfuCha@u0Me)t%}=I!}K}^Prc5t8@<bP8_$nE)WMjsQIr`n~OZ?NU@z>3y5O+zIBPYK8HMLyUp4?>_L1!3*nRy zzjt}yw$y{`{2WCY)xMCBYsW6-9z5srI6|f7U$VJ#)Pu}Krfn5e>QpkT>zD^^)mApp zye2bDLR219?q0lJ{SF~24<2zxv66Uye3RM#Di3-;vc2cQO-`xtpqx8XCq3xqOM9&c zi(LQeJb1_#wt5fN9`o~g9=zbLT%!klJg1?_gSMnnyZvhRVDl-f=adIa7g%3gNNVS^ zo9#xu)q|WGwz+$nN{zR$rT&Zumw1lSSq}<$sIAR|S3EhOooedmdrs#(DB-a1ya)C5 zV|EMILEm)_Gt1cNK@88v=%P{+`%~@OdclKB+@4+Zpo?d6b$hVH^U``eNald+k_T%e z%m(y&(A&;N?y?7UC5)ph#L;9w)7`5cwDZyI^B|r(71umyOyTGAJb0bUuA#W$K`cMU z(eJ@3w=M%7^z!ZXn;ukl@f|+W_k~<`n(4L&`K$bdo(HjIJI|yf?IkSbK`zh8y63^G z(@aM9J!ooRaQA@+=eaF?=)om^PVA8fInm5t8uTEYuh&B!T(t-BbTRBfY>{;x>w+f# zF8r<-@!;t5LNauV+S^O1`!x9{VJSvEIG8?Y2c=^k+}h7ZZrmgHV4WWUcvo6lJy%d&+m=H~2Jc!g*UQ^WS%=2fEAWH;GqYeb8#x>#eQy(Zd? zV;lC}+;vMrU2F&X4bjS5GVQz98$@e)Fl*oS-6Yz>tVkam7`3?F)0$w z@M3%SadeOv9d65@Kc+|Dni>!WD&mk|G z_%8ZkFP`xu+a+F%jxp!5)QgP;o@(yJ%_5#^P72n4m;tyWUi5V{qkPnhXI&F4K;=c^ z2J_I4dGWeo=gPxxCoJW~aKp|MU=2z*AWl$Y``eQ3Xrj`K6po6jyy*GJp*=6^xD~DO zVl0Mf_erXIW#NRq?piO(Rv4nJqf(`r3c#cZa(g1eX)pFSFi-Q07w5Rrob{rX2U6O+sNtxk-HQTF zIp;+_zt`uyWjQzw@9^U3Np@_m(~B6s0(W^)%i|;$yjUAxl#5=}@;$*5%;xa3983j40ti;)>7waZ>i@twpgG_ub&QtXO+)r;XSwtdv+#T?%ny5_|`zL|a9 zi~al_hZ|m;ism;RcyTxJhQ0j(YCoMv5pH^Mh>!m*FXniP;cb#Y@?wkKo4aFK{o8E6 z^Dfb@KW4Oh^zCTvY5VBi_o9h=eGj}i%rDD%=tay&Zi@0^l$(=5FE%qz+D+Gx7sY%b z81~{Om)(dL^>K_c>cvxj`P`USI8Be^3<@xIqB$chR zEKg(7i#+>IbU;i|sbU^Cnf4-Wg>6aAc=2NF!`A@=;wgQ0av;}U`7Vf z?{hC!6KkxC*fsga9hPFwi?m|v6}cr%UZM4D-it>2<&6QcK&_?mWc5WanyQ-YgYd$O zv#U&jUeb4itFd;)U-IGs4@bVDQsq+m? zUup8hp0E_Jy*O85Jv6Ya$@D#8U95XCz4NYg`W`}1G@c6&SQvf7i)emAWRqB`-Oq%u z<;62TXScn`;LBLFPpTNtWwr0~;Tgy5`+ZVFNjzKZVtlyFH(_IaDCc%F&WA3(Ld5%! z%I$c94@*2Gp6J5@AA}_0vgA&$eXHUC(O#cnb2!m!z1oL7WnYo4uia+(1+6UoupMM4*GEQQki`&6!|ce%Z`~9Q`d&3GuTB@ zKD2N+aoC60QMOc-_>jUWr9Pa?J!WsM%!jfqCdhIU+S4v3v?D&u@m-&zKAh*nR6$&x z%U~|pF&}CtS?$NERLAQwd#1q&qQ#H06A+ce#ZVS=u&PMp>j{N+MX2^+jbAEML#0OF z@GGNyNEu`N*ZPphb0F%7i`4OEI~Vmt8!uwplMO!99j~?rup6n=Lw?U`lMmB8^Q75_ z+x#lCQ$92vtFVKl79WnDIBp-GRv+#UzqSX3PE%{wZnC_SGd`?w2y&K6oxaCp+D4L@ z=h=GgK9m;UU~tNZYcqU@&xdJ#i$jMG!#oh&Np&YK)Y%vOF5)4*CXNNBd>BpOiRV7V z+XHr=5Zyi;Ew>Jxt!VP(cZK(gRZZUcE^C+MzIFYk4=>VLC6|0yKXcSB%3dG#A7W)L z`%uddbX@V_+}3`(xUc#!&u=^H^Pw+m*^V2p`A|5?2J*TOm(!T|Z&257WixBkPa^7H z%&?1SfXbB(x7(+~O)6KzZ^gRh!xMfn$ZaZB*UK>O9UsQ;GGutyheCcX_nr@@Il8&; z!(;BKKJcNMEAK-esyP07VhJ2{viN(V{T;n(YjQG&N6D>x4SkGqi z93wd$xz2FnIMIrD(#B&SN_Yay6Cc|7dA123vbc*o=|c?1^iw|E>SE5~v=22LqRdc# zXHOnt_elA$J-=a(S3dJ0x`6d%miR6|$kJV&TVu}CNauVg<~h*w^ksi_iM_`QKJ?gM zJCI`0hxUqi2CsZb!ke%7+-9rm*b86@CC}h4@~IXVI5cAEGZY z%~&J8S4x-{@!E%nxvY2VRM(h&OFkgp(3h)&%(QO!&|*J41hMHu`eo}$tu;;7%J5$C zT9X$gp)4O_4_W`LYx1>=P?irv`4;7kCQlJ1TF22ui?X4~E+=6u9TV|8Pjs~rWxtLw zo~jz7V`h+1Vs%{R8WN{V6~{MNB1t^a%CE8`00}xa$JoYyqK?bl2q)?2ILHq3AJ7rK z`!J9m4v1u`x-*(7WQvZBN9=S#DwTS9mL<}s>4@Gv2VuSQnXY4=!f zlPya}HAfuTI%@gKo1^2{_^4eyb9KDpkTOq~d-2?U=}SQ56W`DKFWH4zK(yBbg?5!G z)CplEFtB}4M=amQDALiuo&RDTojfJt5Y^txH;NDIxY;{qj}n&XxbT3D)Mvy;_V zMx2$TGS13%EOT>sM8|_;9Bb*=;y0vMP)!GNlGud^Iu1T%5cN2fis2j9Cv>D$TF;1X zYI2=?wn`m`D=f;ECacLqtkUHkoVvxYL(uV>Zw=MxSZp7&EA2@gWqkB&bxiT>zd9Y; zIRp05uh;RQg6Ev;NZ=u-Mjg-ZGc9hiWchfX-4r(KnB|#lr*w=rv$|V!yyOc~tB%ue zm}7m~nxZ^>bVf((DJI>s#K8l8xkMXDZZw5$pS0_^|B+LDI*#&lNauCb@gw9NI_4HQ z!lL#n_@VYL9Syn9?C9_U@t&W<+>(nrs>XQgIhD#>WJs__$EgQQR+n^KfIK|`F*L57@Cx>t7SnOu~=%;>kBruCN zpkt+p=bh`Q8)h-&TRJ8#Fk5z8N76L=>W+?km8`Y9Gy)IrvVhAy9m70id0)rNNmkPX z9ko19_o0q@ezx|Jj&gpL<)DtFD%SpxrEvvGcHl5f61bVhE({&farr3oAV=xTcAk_n zrlYyRR{y(VTu1KBQZ>9sY-=(U-YcRVa#0Yf($Vr{=K=N0pCnYJV|@2@wJrytDjgeX zJBewj*89OaX8E!5DIFu+Kc3cc^!CoXJJvhIGdhy^5tOGo9`NJ;&vcXyF>^3WVn|Ca zw=2SP9nl|2JJ&H=$nF4{*D=fQ0AA2BdX=@msAG`lJiO4+HTI@-{q=`9dSI~`$os{5vEWZ z#L<4fwX~_@!F9&>mSrqv+wBYQHqqi658D^sXel+^-DI)qeG+HJc@`CwI(?hvUc^Y8 zxyZ4U#41OuaT0fUpdwyM6Ojm)iZ`z(}>p3kFBLkJm&3XNVFwX+857EiF@1tWl5ajzG${Y z+kJLDV2;GCX4cp&0vXA&e1`M>wG2@ zNwo0nmtu+Wmuw5|kVInP&Z|s+Mi@$BbnP(9L6^wyWsts9B4hWV@?QHxEjYvFPIvfkQmKoxxJMV8~n26Dv8o( zYy-MlVrBO*{V#Xx{yxDcYCVC^{AP(xo|AP-B5RUao)(D)9z|}ISmV2jrzJZ1GJS?x zi{VesoRxUo$1*+IXc*@Qn2+C1U(Rh@vupD?iPIBoIX^E^!}o$ZBp&mFSe;bUb$$}L zOQM?R@?4N8UjPUi~lElVMer8YNGT%eGEYZyO|E@@^?cP6h z%{sIvQO(t_Poj-StFK8s`v`QBIL&WGz9Dgj$9VcBo~E-T{Q-&1sVnxt=1m%rj%Bu$ za!aCsA3wbA4>&> z`*DL`TN&fWB2TM{_2b^PZTm!u^GglMH<=2@`?1CE{z{-y+qEo&km$$gM{YatV~KB^ z9`IwC2Lh7)=;11y;zufXcvAhC<{5Np)P6}8i-M*TZT$H$`*hFnBZud^W>TrE(@ery zepK)*|7x=M z{2uFb5w+IwlpVAz_9LHTszZJZ^H)d?({~N)tj8sO9NM%VZLe45pc3|pQa=iZKX{<@ z=fVL|MjCaqrpAs=%c-Uj?!q4NBaL6GbkuK!8p`dv5*0+dlEO^RF+W-=nLLkEsbzkk z`vmdPmBO6#N9C^df6*IN&tt%(} zc)9zI;ui@p`BCtZm-GBM&EMdwCx$levm}fLKZg16HTtoSI~+}Zxd+QUy3_1Oc^Z#7 z`O!SWrbCM#0>i#)JHj+VV^J71UhwXmc z;MWSCquw50WKi$CAAREte09*kRX$^?+380c&%NvNBZ))A3w~tqgDe;Qh~W?Ibo;S* z*?NrNfGWGJ4Lm<4IgGsIM_Dhcr`L}=M>t^e_)&erI&g8oA!oiX zEX7Sf>UST8t9mya5VxqN`h^DjMMt;&7`(}Ny+gbfahLY49|QHQkN5nDyUEV*-uGkV z607L})zojlnJyq6TIQ8643GS{a)f<3NTn8vyX{7J$d8Uv7Qq|#qw6u>#`9yECy$K! zF~Sc5jrsBXI-`vHvBrI{$9|M`u`*BmxNwo_^aSzPw$8GHCjF@9+A-xvMLg@anzR*AOBc4Y-XZ=Y2NQRUjaXe-_M|_@&V~fzdA0_;d!-5}G z1&s4WKaOWI&R-CheThZ(@q9_OCyuc3T=HYme$nVB#4A6hx~+@NlO6Kk!h1!EL!MCH z9v6M`URa7{KazJJ=S#I-h@r+hGMU9*^`nPpw66K_kWbmyew^ecYu%5`CRXN+A2IoC zA8W&pjP)JB`A6Y^*tDQQ0fQ!6ejMF>Ew5Y+Lu~tTaGE`unCg&+qX=9DFxO+vzBGr- zmtkG(3t(aA&Cx`1KlTTZ(ZcwO3E`p*-RuBv9Ak;R zIRT8F=ddb3KxgO4SQS8Q(av`5uqzx8g(Q(9`8M0G&!K?^_DQxiaDHygE+G-@S$hp9Gz=X`yy3!wYiwmrq6K7dUAKwAUV zbS92@){Qih9X$+(GzD;*k7RQI>!;Z?JQYBGHj`6J09pKUr`7;UmsyzPbO3n`tmZQT z-JxTy9}JbQA9r3(QsO3E(l0L0k&pQV$FB_6Bg8kLTq84%f3D zUkPA?ZvkAT)_V9oWPJf7MYEc&1(0!(QLYE@w2$$9gKC=1WjfX$z}0i?yMX|T`C5K6 zfbn#G6G8w_D@N=K$?X6x+AhHgh&$9+<{kEKz}*0{d9?Ii07shh8Jr3rx|=ojAb_nL zMtK-OY9i~}BWi7bGxLxJ14y~Sz8eZ4ljocb2N2C+!-!RrJ$X+TqXBfzTPK*ZH5n!> z6+rb1X3xe0C@f)1>*D}AtE?+9^HljhL8$ zbO6yyA0$Gj?jaOKdR$OkVAt)Z)Q#3l{ODc)Px=`HvjL3omFjr_89aP27r;J#=4U>D zReltBfi#2%paSUT$0uI|kdwjMdKtjUYkcD_fIa%e@y)&E0A6rEXeEHhJp8p9 zz(NmGkTsIgBmVaL>j3gK3EMVB2l#{{K@lndMCHgE+=LpsXMoc!qCw5Z7A@NS2un^4N8e6GUZEu5}R6A^##Q zMQ#wWy9qhVi+1{z-GU4T-AcmGKh?=U&dhPAon~yB46vW1EgI&bJp&%AGK=+hkGl9I}ci$ATELU-s)0$AdU*e*pDF5YfBORGivFI4OwE zM>{Rm&{$Lj(UomM^m;}9XIK~2L99JI?g;M@>x%rT@VlZWh$FSu3733_Or$^lQl7Bx zj0&RR#cBGqQI%gIoD@X=H48ZxIOHR0uP%t1#4MuRR^_(!hF%ckyKlL*k>neKnB9$x zbP`XEL6knUc-p7P_rtnq3gYB$OTR@3DTwF{%kL?4$Y={81u+qAQ4Tuf1*)YbhzG}y zk>HCQRxPbTq}5s%(-k}9m&5Of(?JyFS_*T>A%8o(N5m@f%Y>4G7|XU&Jq|l$Kf+R+ z4I=5yPAp^o9l}UK9H_M79VHI==KBaE1#xIM0`izB=YqI%+xjYAl_h~N#Q7jzCRsI? zI%MIGhWCnnnw)+&>=PY9MDL8}mrq^v1~FT^^TOa42s#B(`gTgCY4VB%oq||>`;6@o2RWs> zxEe%#T|cq*4RWr1qA!T&nGcmv$w-pIW{V#KP|J z<-ZQ=qCbe}rVnbho@E&b;zqM&X(}8tktjEVsEN1q@0deAx1J;pV&sLTqj%M}bM1Bz zZ$_<_suYf~Xs}+B@NpBgDaA5HkgqJSrWs=GzG} z1u;-+QEC)<>|3G3o%5Pj?duV+DANVIL%>S8vC1GeN}DV_&WT5ApNNryZ@AI$~v{DO6B^F37# z><#N;K8W__ox{xE8`i}_5G$1*Tz%I~=6ErPm19NJ<64K@N0b*qOkA`M!PPnB3UT)` zh`X(pLVQ71Q<0@0QcJ9cx~#{q-xIHbSh{-nqmSwB5gDrd8o{R^8twPdyen3MNP0Wv z*;I#E4I=ifJ*u~ww`NHf!n#-sV&%mKb>^RB4=r%7gE(7cP2~oM%>Q6Y_wFS~6~ugw z6*zCSw)UiW6GTSAPAL624gN+DImMQ2wpID*ur4-(n2WcJ%&)vnY}^W>_F$crtER|% zBCLz;Ag;0(5~4#md)PKk?}&XNTzNZln;h~JZzu4dg{9aZ!cc}Kvu1~EAwv-p!ns}R z^0Ne|LWn(onRq?OU8rSBKzZ2dg+8y%q;XUGWWczfH6GCimJ@xRM!&2+q z5QYy~g!2yhV+5%}c$wKoVwzB8EU83(2=_1U+?sdqy|5GoAv_(}!3PD@!@>~8u1?Wc z9S*rbl!GA*-?b>WHCaI7E(+mp*#{TAju11&A(W0jp|(36@}~$(g^<~|Q;T)U+u;x{ zCBL074w-1hokGZdx)WvFh$1i*!q|zOHFlX+)Upsx?TRHaL})66(zDi-zu=G;thiGM z-MeAP^NujY(GZ@$vW(0{hiu#P*2tvp2}4wbFyC)wSamz(nZ0i_tVYO891EfKUMF>- z$02__EXDB0%G5v50ys}6!!A@prp`*;1CT%&5LLTFmEj6knL z{&84}>JW1F@8FbMB#D|3j-9l6aQOqAc`}69m7OIukt(hYA-loSyekg5K_adT;ohl> zRPkR)%Nwl^p|SY`iankpgGqTLh~8R^p2{skb2P`!r9#ws-8YN z7ed3Moyq;vVO^XL;bETD^Uujj>Ssp?rFJ9b6P+Q%f4E%hqAP^ek`JCFJ!HKF6T(80 zwK83E$O&gyii;s!-90sv>kdP7hmdjLzW{H#=n0{!X=hFO?yyf>3Sns9ZhH{DAw<8b zpii$m}{35 z5tgDaguK+9T;pZp_*w|DQ#%>T`F`zgULLCqB4~MYOzhl()lj4np z5OdO+gm)aWm+Bo2p}6Wppzxj;3*mh8e_@h8n1JIUw2xZWpjeY*B+3k(M5GW z3E{*6%LTbhW=0niA@ry2II+JJmSQr5iCr{(o&-7-LT2Fy`hJqSGaW+dO-sA_Rr#3a z$V>>^mp@1~JMAPi6+&j?j)uM$*2S|Bl1Dzc65$4MI~ziFZU)J*UU{48^E`yCV>_=E zpP^djLKy3-pla`tvg%?!gubd1M7U2*ImAK;i3^q-3sf5Zz2cf8Yqapk#bO9+w~DA} zye8iv!$Iq#?=AyNvI)Dvgrg zgYPj6^VcIT;ga8r?=`;9{Dp{1xTOix_-2)U6((MA2xo({O*WbNcp4qQR6e_YbD|me)(hgG2_S0UyQg#K>h@N!uWCX zh7xg$p!`Yvr14qvr9a{pA^G3%-;B?iSWJC~{5(Eye8K#e zh+BN8{3ZO7@xIx(H{urW$zR4V8}FO*dm}FKarr;-KaKxoemUY6pO9a~7mZ&r=cp<} z{wjXe_%-w2BX03Y`6YbG__Dd|j<`iw{yKi$__BG~8*z*8lD~o9Fn-gVcSPLcyX9B# z72`L}TrJ`j-y?quzh(TkIYU3bSN;xu$M|jYnig@1?~}ia-!=ZX`OS!1nDY1Vd&d7U zlc>q>m%oqSH~zqUH{uo%`Bi+?_(L;Zjkv`R$gkmR#vhthB)T7ze}q3W{@A=p?0-uB z3I4?RQ`3yN#1F|o!=D*{YK9{&@oD*g@qdj!wFL3Q^3U<-#-9P%JSM}MUyiuMkI4Ur z|7ZM#`F#&tZ}GRr zXUqd4;ub$4{|;vbD~nswCk zpOXKCe=@#ho+JVNwESoMv+*r6pMLyz`7ihv<6q5o`u=C+zv17Ee>ZRt|#OGv!f&|4#RLl}3;uD{jNeYsz-#PUA3-W-11J>_cHR2J! zB$E{+E5=WoUyXRh`!YpAiejWH=8s2w;+JKbf;6k{GWz&`%5(+k*6$i6;uZf(W+=!| zj7-J+bi^mVD6*wD`yy8z~oq{^+=Vv2c@n^DLLA~|!>k+T` zzp_C=1Bu`|vGM1!Q9&d9d__P1pKMalL^7BmdHscKR?w^%-)Y8qB0lk#@|1#8iqWE& z$4NwgC0iA=D#mHWY$a*`wLGKXjAEQs%)g9y#ox#_1#ODaPA&Vy-^z0e&MC%u#hj(K z{!Vr%=unKWo7dHdSA1P|D(F;yC-y6HSi!Jjj3}lv;uA57991x?7-Ne0=MkTXRphvWaqIW5MSLPo zk&hKTR*Waas!zl#azep`_4{WcK9QivNd=RNF{PNl7x59Im{u@tegB1sE|L^EqhQA3 zxAZ$Bx;UW7rwX1b#xun%77?9*lS-s3azVj@Vk|1=Q!0_6$QKG;D8@_0oQaC)B2$q|3YILw7B!ot$X5zp zS%fS{L>JkLTvo7b5gt(;If`6SuwoH%Nf~n$xvF4QG2S;Dq9Q(#r^q!0Yl`t&F~2wB z6Zwi*6;rj@rpu4ZYtO$W&f3kPaIU_mVzzC_?VflMs!i6 z$ZZANiV>}v_mzk)iWRv}#Xi;8uaZ*f;*cU^RK!?>1~uXnhZPyCB33oxRP);+x+qa( zyoz|$NKnnpJrSQMRb--yMAb-AO@BleWr{qY;(%2khN>)AWU`86)ksmz3Nm*`6q%|b zRW;I76A_;{s>pN|>8g>TS_)L5$V?TPs*$CdzZ}uUF-2yp$X1OU)hs8gbzG6TDsojL zPc^?B(ZvZx=Bvn8jRKVnk1i?|S*W5=rO|5+M08Q5$b%{lT7<-4L?_3)NJWuFctwO7 zMHZ_lwg@pFi|FL<9a3?~B9webL>IM+JgnldN;*qau&0II0>IZ_76+@|cQas&QO3LlK{7R^$m4CsdelPv?6O&)LMjUnh0kU zS*M~-rI}JoQ}?VQ>s8dN#{1?ZsaKmK8&ou?Mx$!}WW*=h71^Ys$@)!VJEzEI70s$~ zN;Qi~u;&%oqM}7LT2(WKYV1(tX%(kcMV?b}PBqS}<|iUPaZ!;SDmtwH|2EnCW6?sX;CF?gW`&Sg%tD;vmF01B0Ms#sikylh) zv3}1}jeUx|s^Y3@^r_}O;`y2)uc^4E8ecc7XqH}AWTPkj;#;=%_G;3}t^0tcG^n248(Zy{= z-cfN!HSVfrA1T)zMcz|!Po<^gYZ0HgtH}E*?yJUU%r3I3_Z0a+#RJv&8#9;0a9@!R zRXn8s3mp-!c%aBfDjw1QKN|6ghl(6jF-U)(r0O3ja!AFHY7DF9S0g?#sK^l&Bi8Rf ziulBkB1ct>s>YaVekP)eVMUIs7*~zQs+mHwdPI>=R6MZ=o5aAVA}3T#sK(^m8paek zrD94oK5L$HM|@&jk<%)s>Gz~R;uDV*Iiq5Rez%Y=K2hXT6;D;;nQH!O#3v>cIjdq; zHJ+>HUq^gmQjv2i=2YX4%^2#zlp^O<%+v2H#L%=N7gQ`*3{{e~ol)eXibZR_7ShW8 zRFN-KyikpgnV*aJ#4|;{RPj#Ffh zGn%aHOGUm>@kTYiWu73*wxq}n6&v*bK`Q@Bk((+u>HjL~)3PGBRBWlV9vmVbR}{Ie zVp}z$H8YD?T2L6uN4`iAx0ykP)T2`D>7C?tY*Y% z=8r{u;*BEXHNH6;K+|ebg^HR85%My!u2qr232Ni z$kfQj|7=7Tv8v3{kfo8K$RRG`RGFsY!fOEr{QzrQEq6B(*3(@>_-dO%&uRAsq_ za?LoRnd_v&S*kp$;iyI!qn4~fwkj($RA_{#<7upNRC!FpG0ixxnSVieL6s*ooUpq1 zFN7CVS*fAY8vXYpy2w{$m4+&-i7x76fhwytRBOi9&0{o+3RPL7p++FR%M-rI?brpEQ5VWl?@siNQm|H!C_T4YG~AqCe2JC z6)sU_vxa6;ry)||QdOSPa7r^;H1iV8yE0X_YG}0x!=z5-sywaXv}T;q%v1Eq5mlbm za8@(gG{W$@II7Ba4egq7PBWWmYFDW8yoU3d@o_T}@rh%q?9kAm8J(K>>4+|ltFlW& zmqrseZg0dZPN?#Nh6|eU-IkwIsmhBQE?VWkKjITrs_fR#tr_1({+mx!tFlK!kEJ=k z6!D1~RbJ9?i8?()|DRN4uZCXw-ABJ`Re4#%W%`{;zw19>~U9MN-_EG~=db z!LC!PyrtomX57}yDXOwXm3K7Uu?QP9GOen-tKqIiI7nhWt;%~E?pcH$8mcp@yszQD zW<1c$PepWbR+SGmJk*Rwn)!gfXjA2&hCz#vO7^NpDU_-uHiZH^OcBCTvg?qhB@Nrhy@i?Ij>>f znxK88s@GJxpkcwXN++qrbyY5EShNV%Fx*h(3k@$cq8){JO}743MS%6$&(bI@oI6(cp}z@_+*e97eLka%M(Vnc_f-!}yk&OSWfBm8lM-I*f0csU(MSRi-(R=Ad<^ zf(krVWx50D4kN>18R#df%yb~rVPrYXpC-tl%4`R+9mXG<+0@{qDsvpjq2Jx4ty8MZ zbs(314^kJVRhj2No`c}+HwZDPGT(uGhf&}#3#bcERaxjjp~E=nFk?xK&s16DK#{}v zthr1a%&M~3fnoEm|bLV=T%wiK&e&Ws}Wr+ zsIts~G6zlk<@X3OsIuIFa*I&+9zh0G9&zA^!#Jy$KM~QzOI03q;Hbl>aF|WR+Dytl*vPzUui4|2=J5X&AETg=t${Gi1EW#xs ztf}&(11Bv)o-5)LuT@#=K&_=9|0kl0bye0mP-p#4phn)PvfhDuhtc3LUy{AqP-UY7 zjTYe`wYsUwCI^}4SZm zJmbI_OE@F%5^T`qSqIKKXhLR_d}B1(=0Kan_=ed;LmsQicE|rm+ndL^Qj`nBm)qUB zb5)o^Kng?*h?$(-~40cX0pp698mu6p*T zflJjDitiF*`sDHX;h{Gu=x!C?EgIem4R2J?XH@(d(Qwa8 z^TR{uE9kQ-{;WXyLE&vs(C1YAInnTWXt+Q@_o(oC zeQNg0s^qnoDCm9_->+uBqUK%>s)K^Qs^YJz*$33znb6_w3i_Igza|=LpgJh%K@~r! zX1}iHCi25Wmn!HRD*lEFI^H#~GM6dnn=1aMpm`6_e5ZoGrQ&aig}4#E#^nlnNW~Aq ziN9GW4+{FWioY#7+^d7~prG%l_&aL$yK3&a`NM{;RM7WS{5>`MZ@H%d!MhdoeHDKn zo^OC{`yK^7tm21N&?TOL9rIoV{XoS(5Dk9=+wCd^J)+`AM8gHp<7x#xs^UjQ!&jik z|0w7&6+fnCf2c|w`x*uPNX0)=vrin7y97Y4RnU)B{A1B@B`}irDd;CE{)w7>{E%EW zKRon)1^raTKNTIm3%lk63VK|{kBf!}0q1oJ`k9JP2f}T?GQ?RLSgD?Cs1^rINzZ07b-ruC4->dld z@O&*i->jggRs1v@rYGQV-J+mBsQ3?R_K#}L&JPcLTtRfqAP|#mg{1-L*S2Z^S`h$Z0rsBVe=l_)-9=c6IXK45g4HUJ@SjSH*=(QStt!TJh=nx8eorYhhW%uX4 z4jt}N(AgS3TLU}skN*ftgo4h|@HwL4vS;Uqhd!gAb2WUfXm}KM)n^rSo`%m84S#@z z_?&`Xui@8g*}D$O?Ep1GL2uCT8?@|7?oQappI6WuHT*^`d%l)C3mWcK(3>>;Ced&v zh_Wvz=mHI2pk?2z<^C(L41G~J8WeP)hA-4$xvm9^;ywkvMZ<5=vTxOLhl1{)po=to zk?8PK;b&0L#Tvd?G@Jt{zM`N@G<=C@I2#(is-U-N_-z_+k{<%)2Nd*n4Zj`M$3at%k1^L>_s5et75+1-(zh?-LC-L&KvAdcTI>FB-0bhQ}220S$jZ zG~5r|`-cj;PQ%w}AY$GKoBBrzx?aQAYuOKKx!1x}eypGmY4}5;;SOl{iGps>@C{<1 zR|-8sK_AxehqdfSH0fr2TtPQ#_(lyhx(DDW{Y*h0)$m6(P}u%AC=v?#n1(;5WpC1Q zTl0qv{X#)EYxrg@d#%(PeyN~aG<=H~=6SjNp+mn?(8o3WaoB~Xm#!Fv9!f^OIF?OOJxLvo*mee$G&?$GcZ zfbbfSKu;;?QyTu1mR-wT04(iy3i`B$KP@-w3qXfZ(488-Q#5=P8lG0rT^hbiO!9h^ zA0GOHg6`Jv-J;<(X!xUoKBM8!h=zxN$Nfn`pVjbZMZ=q6-~3rYpVRQ?M8hXw_5Y%v zdo+BHmi@ezdjyv9uL`c?tLW<*{yIDg=kqx#`i6$TA=csNFv4?H^i2(aQv)Vl! zx5UT31$w+*MGtBCA$b^HoIh;n4J!J!hQBQ~%>M@}go?hS;qQoNAzRN^(RVfcU2(wP z0Some6@5>`-;6c!;gxkH1oqlZ&lG_8h%X6{!q)^1WS97ihiWwABl!T^M?&xtfC)l_{UoICt7Ye zKRk4aihio$pK94Nl-#9&@og%4T*HrR*<*8O!5H4IqMvE_XW}q@6?V}(RP=KV|6I#H zdPwd|uoRc7=ocFPg=qK?ptwv$ztr$AMFZI0?^MyRH2fa<752 z@g5aDrQxSE(2f3oP$E?HI}QI%oM*xBu2RwOHT-*l;dY!qZ0KqgJ+0xV#ZtZkbO;sw zLBoI0z#h9>=nyLUqlW(|AT9;Lb*+m2q~Sk_hWn1l4-dUhMSs@tpGCtJ$K($idcTVP zqT#=2*}rPJU7$m#=x-YSoA`eBgNAUOiq6R3GcwTdBn<0%6`h&EXJ%k^UoZR+Dmp8J z&&p)ia(@zj2o=31gI|-$uH>E&eh3x4HiKWA0T%ldG<;Y^ugl=qWq^ae1wO||RCIO* zpPc~{NdzfxRM9yZd`A0E0%MQ_O9 zH)OJJ%z({5Jan^)&d=cUGuby~a*qLxTU2yG249fLzBwZ!Mjuzvg&BNdCi|95?mIB7 zTUGSd41Q|{*5+0)S3jYmi!%743~;kofgYivi!=D*O!fxp>bp%vmt^oIne5v#BFu2R zir${VZ_i}kkr7Ay4i#OR!Ix&T`*Xj7S$#@Hmu2u}ne00=xtD#tuFl}AGui*i`o;A=A3d;UK6G%Ve{ zD!Mje8MfV5RP>Py{)kxncN?Hl zsOZKFzENzN%Rw?cprVgv@JBP*k7aT&udk`-rVPF*ljTy9JgB0ZGx+8V=%HY9eO*Pj zWbiGS?8h_05&sPp-I~F-X0o5i3au0;En}2WYK={h zNjggDggHGvx}`d0jZRH&shSfL->*N}#(*g+s%7cQ*d>Rz$ z4Uf8$1B%n2{Tst`xUaM#r}lr^kw9YqX=1>7=U z@)ChlAJxZ-Ms5q8ni$<;jTNgC#YtleElyR<(b0-EI!@^XG3aPzR~3sA z>o`olSezu&)lq{^5Nb_K6{pRyi3+hM>Gt2$%DC7OK~VSU zexNndH!b7kgA$UvH~wrXdtTDAYCfq8Vy|GfE2+I~KxzU9^TYx^w`TLDMnyMSz2Mo* zEz~VH&`Z=`p}sNRi8!Sq$Im_8*3S7XNWyO7vJS7&O}<;Io)5fgxt2fwY~Dy{h3EUb*_x%}Mh_ML<;QJ?xF z;dCUqnGMNBXiixf(+#~?gaOn-WI*_z`X;=S@?CIl=ZR11lv6)2PU!_aPpJ=wpPKUU z)u>B-!s$M@PPn;5tU1G0ALNB@JeM&6q8^#9vG?a5OmKrmT4AnLrY>yp2r8`K#n@W0` zdRHfo!^B2MO;FiXGmT@KErDa3w6e}AX94$Zx7G`z>;V{`S*>%uhckNcTlVL=GZaRDJw^!>iV9!(&Bb`oSODc%18u6 z2v=jq(JhExDG<$+_7sgHQeHIe^xkO84y_S$9k6#u8H+msNOC#iS?Y7UYMX@9kihhY zaw^0ClHCBUM34tsCv~G$b?n*_AD<_FK>HBoZ3IH-kgZFlvd(V+PV3aapUCFm#^Bpu$y=uwPq~Kr$M04Sk@w&2|8DUg0haBM1miPY$#?dI}A`vkkgwYJ)>WxKUf!vv9RZ0!nT zN(<0|&eWl1LX`+{gc^nMPXj8^fj}3kf*l{DebDm2%()fTa4ln|`*?|K*%sjxcv~Bo z)I37PMk|IEyoqE}J!0t}(vuQL(G`94NhAj95EKU9y95W2%R8 z*#TT|iOYy@F2P7nJy;{@TWjr#DVN{jGnZ4>8i}zEHnVDo0A@BZm=3>(t}ZZEH%{z9 z&}ULr-gOYn1DIWj6Q3KU0T<3SnMM7=k})~n+;?ln2OMH6((UqLuSebR z2&d}BDWJluZAkavj)OCTzD>|HJbUPBh{`DRJB8->Uq0wZhV3(=+pf)DX!2U3M1vr7d%BjyaZ=CI-{4ZW+j)RnL!K(VI3V|p z5J_1p7ce}b|2mLey_1R=ZH!NhPMKRsk&Ko*x*gS~TvUj;Tr0*7fMm0AL`tji!tUBg(%d~Z z@&c>}oYn&lhc;NXxw&MV_J2cF@f)r&cc6& zn@f>&@}F>n52}-O#W(ObO=8OBPc6g6fX8LYde z9-fM_=QDHOc8wFdpC;%M21;EaEEsb}bkBCvoMOWG%Wi-1)Ib%*iLBSy#j$e**XZV1CV|#sEmIZ6j7y7t-{&}73e_3 zNn#wvD-M*;5I`nA*MZwWAalgvq{!S#faQ;L6;B;q4~s+luEklLdLW=cJq{{g{AxRka)!QQ(dSry?Ckv`;E9y z+`wbLaOY2T<%03|t~b{7Tzy=uqq>a5# zAqJTBs9u~X1QJgf+JWR)caqYO;XWnxQkz{gI9Y)vqB_~ju!2s4l)t0F8$L}C-i%cU z=*nWn{Bl(wgb@^bjbLGM9)t^UWB51JTsEF{Cvl&9fxwi0(qJQ))Z@(87Z&H6lXlH; zbERafbjKjlE%f4+7OZXI-gX#)*Qeqbz#fB<&c&}s^sTmQg*GmHz;Gq@ZE9RGt%6*W za@$B}dwr8c-$fSN-g3hV8~{4t(=9rA zxNiOU$pC@GGO#mrgF(dWMnDgr_bIJ=JWXSXHGR<~vYiK0mSYvnu9F(ot3IhyW2_&i zvj6~5yh1jSGty32Xa*}J7}2-+WHtO2kq;rDbz<&s*gh@xvU;GKhz+-xOQi_dcur{C zoJMS!5jUd4pJ}-T!YEoLHm^ZH!1`|oae{H61~gln7vszaJ17aS$4=(62De?Brr2QtHh1iV*Nsa~;p=renE zM8+g8tNb@LdqdXDI`La)QZu*t#CG=>&xu=Rg1`=>#aT3-o7x`E^QhF9v3tp)R>S1- z)vQk~o5vt^vP?x1ipjinSheaU*f(b$ z08=Z`Eijj;)o^Hx$Rqx8xgM`ZUFc#FzpvAJovqMbN=DcvTAWR)zb$^%U5r>;8`Z?X zMVbbjh+YyN`iN}q_T;k)13p;@?3!NU#I=ZT&5AC@)W+FuF);iW&GW?ce)>Mwr^H+$ z6^9xVePeeS58-PpLQN>BfrJL(ISlGT7lfB-zNHwd&^%!>8SlidRXp20<~TylNr-q3 zjcEj$Xu>XKDjZ+QJkP4_S_=)=6|-;CV@5X}`;c0ay*4#9HDw&0&_zPU;rRAL?{m}B z8*ZKW!4h%$$Z!Gxk*28^M++Wl=C7tB-WMV6%i}UTKcZVyezlFw%N`yV(~~tW-C1_i zw=LL1sOW6$+3G?Ph`qQQv1UU4ENj4?GPVv(Wtpy*E$Z7Vq?vwoY+~DoJbo*%u$iEq zCNmS;JsBX3c3r~-U?Wx!Wy5JUUs@pUaxb0+{e0psmsz#i!goWQ$Aq*&bm_S~{4=62 z(17wZF_7piA=<*^{R-aZnwMZJ%ryAYBB`|mxBEpD?nc;}y|z;%aFhKvPG(J!xEt== zh}5&_I3fTA@P0pu+_9En6#%PE9*>^ z?dI_gD0O3_A+W35Vyo_=U8jC8OSMTS66Jow-Rn{bhZ2okw8X*mC2B5y79lrG3V)CEF}EFVo;VDtOwn2W7cWR5RqS>riTCw^1EPUo5 zN|QOdPWV#6C$6RE@(aYZM)WzCPmZN&N>NwYzs3yQ3BAvD`Iyn^V~0)+Zo|m|An45M zJ0(kkX@zhbZ;B=&>De6>qk^%#sDnM2+-sJs1pzZ{Au0M1XeJlZd`jO^ATeZmGByyA zRW!zEFAs8Qc5!~O8TDyqO>FF9Pl+g)+-nIR^$4POR-g&d4rA$E_Lm9<7SoPFph}c4 z&^qIE8x2g~7L~AJXt={rOX6W3>TEoJMA#(Ulz9!F{ zJImKXpMEG2?FYL-(KC$g1S;ag< zt+5(2hT96=W4Dh_i4{LBz*C#_vum!fHnz|0SzMUgYv9!SZ2%l*V1w+i9V%TWY3{D3 z^C$`@CxHZ(XR<*2A>2uWdiuMiY0U~3$U#mRH#Y6dZ699Mr}V%R@>&KrrWa%Tr{=R& z;b4r^QQ<_%*e50&U4cWXmoW1gr?M$_ zQq2>8IerW{^XkS6(+@#ptZ%hl;;$Q{-EJxH$hyObB`Xko$+vd+tZw}4fL9fSh{|R? zklvj3e!VW(2!h1;&D*IV|FjNijMLKK||?C`NnW>GT;{cZDd z!14fzKSKq7W1~K~lO;~!$ScRYI_=Cf$CRDiw`ch-67UkJ$_d|IMM&WTNv913=1wLB`rd<< znHzrmqr=ed!fB!ZU}2y1K-hI&J^#cUT&?_R$oVy8WJR2?>u zNWV)+oVj2pYYLp_#oV*btcF7^!pVpZ%yn7@gm}zOZEyaoNf!dgE5C%JD_W8zm&K_0Y zBm??1(yOu~Wc{joU8;BHg3!fCt-dc->MY+$VtIzmgt<23IL5IlF(Fp4+2Dnm9Y;WT zvJUbd-UWutLEVZ1<3ZhuO&8PwZN=!;f`hRYBVi8X`=5Ol#H`K!$l?J@4A^8qIvK!(+?LTMsre zA4G@tdm(wCY&MHDp+fl16ITJnh7iXU2G z{i?R(^t|*-^b{EYo#4%z!;B*;jjGMWT@=FORr*QLx4SF0 z&)hn7xp7k0;=g3CmbBeE@ybD+I4QY1E%BrVx1FG{#(e!%VX9>xwOVN*qzDoG7wf|R zZ*YWY*V8T`O}nPcp>wXu>b6^xuCUI) zS34AJ^%>Wa#{8gnfsOS_Cv8p8k|sb$@V{F*+ibI*Z8J4=Q8AlLi|HB1-L|-^l!!Wq zbxO1In~FTcYHdF9yc*H&h?BQgqRn=eqIHCk2B{)*81q6`$>B}g8bsOxack6gUN^&9 zy4E_bnH`jJtVSfumCC_-P-ku|XnopJ&2)H6Ij_(hk!&)>Minh7dG#*k&Fet3p*hVR zkp;?kQ4(+|Izspqr6PujuC>F$L96HTTf-9ZD6)|vBShbVEGF+9M0_RzexJ*2CrVar z@3BBl=39IH+1Zluyq4q@I!oHZ*4N~P_F z@rr{c(l!d=?DZN!N(g6D5hhXQ7e|;5j~!=}IHxgxxidnugZVR-?roFfNn63@ zq_RjV4qaULsPy$ELP(Uu`}jkWAfP^q zY*2|`Z>)ig>Rq4SejmW@#@dK(*?}h9orYmubkO6w=Le8e#71GHMnu8?OJpVWMhR{>uFaa$MqcR zz=djs2qI#TErB?<;W&xH#qc6)mx%yy+_T}DE(nlkC3sxoCQr{?Ax?wFY|Aq(!ij8r zeti4_zAUPD<Czyq-`iwIsYUbA3ZsISWCjCV+7TYUrre?N;TwCE|LIHII8}0agfaZpt z_ZgSEap>gH<9w%G)a~Omw_65Ygs~h}3~uH=fo`?M^9`OTA(vIp@=$e@8Fqxc8gAz$ zC;cWVZ=A#32^n()v&QCJsp%&+H2ia_9dK6jNgX(t&?9>!PAoM$x76U7B&Y?P@J6C+ zgsxGu!Bg^PS`?}D!L0VfUbj#)htzF(JbZm=# z; z`Ye#ii@HOjed8P5<8rPidBVt@ffYW=EsE$fmF%oYid;gn;ex$?*}9GeCSg<65Ov;u%ICKkFxP z6r$VUW6Qv&E|~+RI*|cS`R-X_E)AUA(555JxhvG?#i`N$7@fS`#%DaLDr&tL6BI4f zX1#cu4#}pl`-<(h@UhLtq?4$(w&BFWi5h*(ww$t`5`D#|)04l$2h|c|W zdBMyPiC8U|9ndE>yrXcf;CCKzTSB6VNUnHyT>86qBPv*>)MGB)fD?#rB4pYGtkgtX zJZ7*{iO)Cs^@w0SD6dUTwus6EXw@}N6iK_bTPyr`z+63--$ui`u3!~kDeTu25!wP3 z22w=wQ&)8Ij~3@};^&-ZnH#WXqEx6n_Y82R{HT*DakTqB5>y8x?trIusRS#+jnaMojFL#EdHnKZ}LVH4I^xpF+NPr#8FNvLm z+U!rycwuibG8HnNle%|HuqKqyL!=WlQVuMidG&ZZ5->OEZjn?S#Lc;UJ@AMt&tEc& z0$NKnEMMt$j-X>89n&Xt98b^};N(W@@v@f0SSeU6pRDSxD*{m-6MRVrzDdgqJGair z|CM|*?N*BpWT&i*>eKqDz*(^Co}+jC0BLukB_Mi$mv$`Bz&@S!{*jDUxhkeA^2gK5 z8$_9VsZlphXo?g0TX@8>d?8Rq^dNj}$ySNKYcowKj_l>~0j-k-#>8a@GJzs_!CWZB zi=DT}g>OK%wcj2$V_9jJ%54Kq94Gw4Z00P7?wsAj=Hu!^lDgNU0poW{0Ak;J|N}lbywws8u ztdeEwB`ggZP#!dUB_w6lUK8T3ncLLE`%`cBO+S|6)ovKyE|GSf!VfC&k&o|aZe}M* z#dNUSzq=&3>|!QXrS+XyGK@<|d)H1rW)Odyki-ia3c8{PHWLOt^TY~~i(HmZ>lCd$s}{$4I^ z;)v>xTqGNPT6L(&9hp1ia}jit)|hZmrrdXz1{>+}Edh}lb9_bL>J!b@Q21WzSg*pA+`}tONLEjrPJaJs8CIV_`8JHyb0M)eZQB* z7j{jVQ&U%h2bmJv5uJd4w$Z?h%!M>hQOCtj;s(0dZZTf8AzEqQ9ow!`ZFd`WDajMz zG3&n@0q62Er8vEsxD5X2<-rt_by<}xw{p&gy9(R Date: Wed, 7 Feb 2024 12:23:14 +0300 Subject: [PATCH 151/361] Update dependencies --- go.mod | 30 +++++++++++++++--------------- go.sum | 55 +++++++++++++++++++++++++++++-------------------------- 2 files changed, 44 insertions(+), 41 deletions(-) diff --git a/go.mod b/go.mod index a2d212db..23ed99de 100644 --- a/go.mod +++ b/go.mod @@ -1,52 +1,52 @@ module github.com/giongto35/cloud-game/v3 -go 1.20 +go 1.22 require ( - github.com/VictoriaMetrics/metrics v1.29.1 + github.com/VictoriaMetrics/metrics v1.31.0 github.com/cavaliergopher/grab/v3 v3.0.1 github.com/fsnotify/fsnotify v1.7.0 github.com/goccy/go-json v0.10.2 github.com/gofrs/flock v0.8.1 github.com/gorilla/websocket v1.5.1 github.com/knadh/koanf/maps v0.1.1 - github.com/knadh/koanf/v2 v2.0.1 + github.com/knadh/koanf/v2 v2.1.0 github.com/minio/minio-go/v7 v7.0.66 github.com/pion/ice/v3 v3.0.2 github.com/pion/interceptor v0.1.25 github.com/pion/logging v0.2.2 github.com/pion/webrtc/v4 v4.0.0-beta.7 github.com/rs/xid v1.5.0 - github.com/rs/zerolog v1.31.0 - github.com/veandco/go-sdl2 v0.4.36 - golang.org/x/crypto v0.17.0 - golang.org/x/image v0.13.0 + github.com/rs/zerolog v1.32.0 + github.com/veandco/go-sdl2 v0.4.38 + golang.org/x/crypto v0.18.0 + golang.org/x/image v0.15.0 gopkg.in/yaml.v3 v3.0.1 ) require ( github.com/davecgh/go-spew v1.1.1 // indirect github.com/dustin/go-humanize v1.0.1 // indirect - github.com/google/uuid v1.5.0 // indirect + github.com/go-viper/mapstructure/v2 v2.0.0-alpha.1 // indirect + github.com/google/uuid v1.6.0 // indirect github.com/json-iterator/go v1.1.12 // indirect - github.com/klauspost/compress v1.17.4 // indirect + github.com/klauspost/compress v1.17.6 // indirect github.com/klauspost/cpuid/v2 v2.2.6 // indirect github.com/mattn/go-colorable v0.1.13 // indirect github.com/mattn/go-isatty v0.0.20 // indirect github.com/minio/md5-simd v1.1.2 // indirect github.com/minio/sha256-simd v1.0.1 // indirect github.com/mitchellh/copystructure v1.2.0 // indirect - github.com/mitchellh/mapstructure v1.5.0 // indirect github.com/mitchellh/reflectwalk v1.0.2 // indirect github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect github.com/modern-go/reflect2 v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect - github.com/pion/dtls/v2 v2.2.8 // indirect - github.com/pion/mdns v0.0.9 // indirect + github.com/pion/dtls/v2 v2.2.10 // indirect + github.com/pion/mdns v0.0.10 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.13 // indirect github.com/pion/rtp v1.8.3 // indirect - github.com/pion/sctp v1.8.9 // indirect + github.com/pion/sctp v1.8.10 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect github.com/pion/srtp/v3 v3.0.1 // indirect github.com/pion/stun/v2 v2.0.0 // indirect @@ -58,8 +58,8 @@ require ( github.com/stretchr/testify v1.8.4 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.19.0 // indirect - golang.org/x/sys v0.15.0 // indirect + golang.org/x/net v0.20.0 // indirect + golang.org/x/sys v0.16.0 // indirect golang.org/x/text v0.14.0 // indirect gopkg.in/ini.v1 v1.67.0 // indirect ) diff --git a/go.sum b/go.sum index d1fe4710..dcbb94b2 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,5 @@ -github.com/VictoriaMetrics/metrics v1.29.1 h1:yTORfGeO1T0C6P/tEeT4Mf7rBU5TUu3kjmHvmlaoeO8= -github.com/VictoriaMetrics/metrics v1.29.1/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= +github.com/VictoriaMetrics/metrics v1.31.0 h1:X6+nBvAP0UB+GjR0Ht9hhQ3pjL1AN4b8dt9zFfzTsUo= +github.com/VictoriaMetrics/metrics v1.31.0/go.mod h1:r7hveu6xMdUACXvB8TYdAj8WEsKzWB0EkpJN+RDtOf8= github.com/cavaliergopher/grab/v3 v3.0.1 h1:4z7TkBfmPjmLAAmkkAZNX/6QJ1nNFdv3SdIHXju0Fr4= github.com/cavaliergopher/grab/v3 v3.0.1/go.mod h1:1U/KNnD+Ft6JJiYoYBAimKH2XrYptb8Kl3DFGmsjpq4= github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc= @@ -13,6 +13,8 @@ github.com/fsnotify/fsnotify v1.4.9/go.mod h1:znqG4EE+3YCdAaPaxE2ZRY/06pZUdp0tY4 github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA= github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM= github.com/go-task/slim-sprig v0.0.0-20210107165309-348f09dbbbc0/go.mod h1:fyg7847qk6SyHyPtNmDHnmrv/HOrqktSC+C9fM+CJOE= +github.com/go-viper/mapstructure/v2 v2.0.0-alpha.1 h1:TQcrn6Wq+sKGkpyPvppOz99zsMBaUOKXq6HSv655U1c= +github.com/go-viper/mapstructure/v2 v2.0.0-alpha.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM= github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU= github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I= github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= @@ -33,22 +35,22 @@ github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/ github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= github.com/google/uuid v1.3.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= -github.com/google/uuid v1.5.0 h1:1p67kYwdtXjb0gL0BPiP1Av9wiZPo5A8z2cWkTZ+eyU= -github.com/google/uuid v1.5.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= +github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.1 h1:gmztn0JnHVt9JZquRuzLw3g4wouNVzKL15iLr/zn/QY= github.com/gorilla/websocket v1.5.1/go.mod h1:x3kM2JMyaluk02fnUJpQuwD2dCS5NDG2ZHL0uE0tcaY= github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM= github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo= -github.com/klauspost/compress v1.17.4 h1:Ej5ixsIri7BrIjBkRZLTo6ghwrEtHFk7ijlczPW4fZ4= -github.com/klauspost/compress v1.17.4/go.mod h1:/dCuZOvVtNoHsyb+cuJD3itjs3NbnF6KH9zAO4BDxPM= +github.com/klauspost/compress v1.17.6 h1:60eq2E/jlfwQXtvZEeBUYADs+BwKBWURIY+Gj2eRGjI= +github.com/klauspost/compress v1.17.6/go.mod h1:/dCuZOvVtNoHsyb+cuJD3itjs3NbnF6KH9zAO4BDxPM= github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= github.com/klauspost/cpuid/v2 v2.2.6 h1:ndNyv040zDGIDh8thGkXYjnFtiN02M1PVVF+JE/48xc= github.com/klauspost/cpuid/v2 v2.2.6/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws= github.com/knadh/koanf/maps v0.1.1 h1:G5TjmUh2D7G2YWf5SQQqSiHRJEjaicvU0KpypqB3NIs= github.com/knadh/koanf/maps v0.1.1/go.mod h1:npD/QZY3V6ghQDdcQzl1W4ICNVTkohC8E73eI2xW4yI= -github.com/knadh/koanf/v2 v2.0.1 h1:1dYGITt1I23x8cfx8ZnldtezdyaZtfAuRtIFOiRzK7g= -github.com/knadh/koanf/v2 v2.0.1/go.mod h1:ZeiIlIDXTE7w1lMT6UVcNiRAS2/rCeLn/GdLNvY1Dus= +github.com/knadh/koanf/v2 v2.1.0 h1:eh4QmHHBuU8BybfIJ8mB8K8gsGCD/AUQTdwGq/GzId8= +github.com/knadh/koanf/v2 v2.1.0/go.mod h1:4mnTRbZCK+ALuBXHZMjDfG9y714L7TykVnZkXbMU3Es= github.com/kr/pretty v0.1.0 h1:L/CwN0zerZDmRFUapSPitk6f+Q3+0za1rQkzVuMiMFI= github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo= github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= @@ -68,8 +70,6 @@ github.com/minio/sha256-simd v1.0.1 h1:6kaan5IFmwTNynnKKpDHe6FWHohJOHhCPchzK49dz github.com/minio/sha256-simd v1.0.1/go.mod h1:Pz6AKMiUdngCLpeTL/RJY1M9rUuPMYujV5xJjtbRSN8= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= github.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s= -github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY= -github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo= github.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ= github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw= github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= @@ -89,16 +89,17 @@ github.com/onsi/gomega v1.17.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAl github.com/pion/datachannel v1.5.5 h1:10ef4kwdjije+M9d7Xm9im2Y3O6A6ccQb0zcqZcJew8= github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V118yimL0= github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= -github.com/pion/dtls/v2 v2.2.8 h1:BUroldfiIbV9jSnC6cKOMnyiORRWrWWpV11JUyEu5OA= -github.com/pion/dtls/v2 v2.2.8/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= +github.com/pion/dtls/v2 v2.2.10 h1:u2Axk+FyIR1VFTPurktB+1zoEPGIW3bmyj3LEFrXjAA= +github.com/pion/dtls/v2 v2.2.10/go.mod h1:d9SYc9fch0CqK90mRk1dC7AkzzpwJj6u2GU3u+9pqFE= github.com/pion/ice/v3 v3.0.2 h1:dNQnKsjLvOWz+PaI4tw1VnLYTp9adihC1HIASFGajmI= github.com/pion/ice/v3 v3.0.2/go.mod h1:q3BDzTsxbqP0ySMSHrFuw2MYGUx/AC3WQfRGC5F/0Is= github.com/pion/interceptor v0.1.25 h1:pwY9r7P6ToQ3+IF0bajN0xmk/fNw/suTgaTdlwTDmhc= github.com/pion/interceptor v0.1.25/go.mod h1:wkbPYAak5zKsfpVDYMtEfWEy8D4zL+rpxCxPImLOg3Y= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= -github.com/pion/mdns v0.0.9 h1:7Ue5KZsqq8EuqStnpPWV33vYYEH0+skdDN5L7EiEsI4= github.com/pion/mdns v0.0.9/go.mod h1:2JA5exfxwzXiCihmxpTKgFUpiQws2MnipoPK09vecIc= +github.com/pion/mdns v0.0.10 h1:u9/12WL2NNgtGT2nNPXT6+A+xeOF0PkawM/S/wPMWQA= +github.com/pion/mdns v0.0.10/go.mod h1:Y1scL/8TT8KQ172UfxrE4j0c04NOY71bJS1aE1zvyGY= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.10/go.mod h1:ztfEwXZNLGyF1oQDttz/ZKIBaeeg/oWbRYqzBM9TL1I= @@ -109,8 +110,9 @@ github.com/pion/rtp v1.8.2/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU github.com/pion/rtp v1.8.3 h1:VEHxqzSVQxCkKDSHro5/4IUUG1ea+MFdqR2R3xSpNU8= github.com/pion/rtp v1.8.3/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/sctp v1.8.5/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= -github.com/pion/sctp v1.8.9 h1:TP5ZVxV5J7rz7uZmbyvnUvsn7EJ2x/5q9uhsTtXbI3g= github.com/pion/sctp v1.8.9/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= +github.com/pion/sctp v1.8.10 h1:FDPlkojWQ2hIjnvgFs+frHR33TZCxoRhV2HztZ07NnU= +github.com/pion/sctp v1.8.10/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= github.com/pion/sdp/v3 v3.0.6 h1:WuDLhtuFUUVpTfus9ILC4HRyHsW6TdugjEX/QY9OiUw= github.com/pion/sdp/v3 v3.0.6/go.mod h1:iiFWFpQO8Fy3S5ldclBkpXqmWy02ns78NOKoLLL0YQw= github.com/pion/srtp/v3 v3.0.1 h1:AkIQRIZ+3tAOJMQ7G301xtrD1vekQbNeRO7eY1K8ZHk= @@ -133,8 +135,8 @@ github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZb github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= github.com/rs/xid v1.5.0 h1:mKX4bl4iPYJtEIxp6CYiUuLQ/8DYMoz0PUdtGgMFRVc= github.com/rs/xid v1.5.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg= -github.com/rs/zerolog v1.31.0 h1:FcTR3NnLWW+NnTwwhFWiJSZr4ECLpqCm6QsEnyvbV4A= -github.com/rs/zerolog v1.31.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss= +github.com/rs/zerolog v1.32.0 h1:keLypqrlIjaFsbmJOBdB/qvyF8KEtCWHwobLp5l/mQ0= +github.com/rs/zerolog v1.32.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss= github.com/sclevine/agouti v3.0.0+incompatible/go.mod h1:b4WX9W9L1sfQKXeJf1mUTLZKJ48R1S7H23Ji7oFO5Bw= github.com/sirupsen/logrus v1.9.3 h1:dueUQJ1C2q9oE3F7wvmSGAaVtTmUizReu6fjN8uqzbQ= github.com/sirupsen/logrus v1.9.3/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ= @@ -154,8 +156,8 @@ github.com/valyala/fastrand v1.1.0 h1:f+5HkLW4rsgzdNoleUOB69hyT9IlD2ZQh9GyDMfb5G github.com/valyala/fastrand v1.1.0/go.mod h1:HWqCzkrkg6QXT8V2EXWvXCoow7vLwOFN002oeRzjapQ= github.com/valyala/histogram v1.2.0 h1:wyYGAZZt3CpwUiIb9AU/Zbllg1llXyrtApRS815OLoQ= github.com/valyala/histogram v1.2.0/go.mod h1:Hb4kBwb4UxsaNbbbh+RRz8ZR6pdodR57tzWUS3BUzXY= -github.com/veandco/go-sdl2 v0.4.36 h1:Ltydev536rRQodmIrTWFZ3dRp5A+/6t5CYvbi4Kvia0= -github.com/veandco/go-sdl2 v0.4.36/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= +github.com/veandco/go-sdl2 v0.4.38 h1:lx8syOA2ccXlgViYkQe2Kn/4xt+p9mdd1Qc/yYMrmSo= +github.com/veandco/go-sdl2 v0.4.38/go.mod h1:OROqMhHD43nT4/i9crJukyVecjPNYYuCofep6SNiAjY= github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= @@ -166,10 +168,10 @@ golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE golang.org/x/crypto v0.12.0/go.mod h1:NF0Gs7EO5K4qLn+Ylc+fih8BSTeIjAP05siRnAh98yw= golang.org/x/crypto v0.13.0/go.mod h1:y6Z2r+Rw4iayiXXAIxJIDAJ1zMW4yaTpebo8fPOliYc= golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= -golang.org/x/crypto v0.17.0 h1:r8bRNjWL3GshPW3gkd+RpvzWrZAwPS49OmTGZ/uhM4k= -golang.org/x/crypto v0.17.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4= -golang.org/x/image v0.13.0 h1:3cge/F/QTkNLauhf2QoE9zp+7sr+ZcL4HnoZmdwg9sg= -golang.org/x/image v0.13.0/go.mod h1:6mmbMOeV28HuMTgA6OSRkdXKYw/t5W9Uwn2Yv1r3Yxk= +golang.org/x/crypto v0.18.0 h1:PGVlW0xEltQnzFZ55hkuX5+KLyrMYhHld1YHO4AKcdc= +golang.org/x/crypto v0.18.0/go.mod h1:R0j02AL6hcrfOiy9T4ZYp/rcWeMxM3L6QYxlOuEG1mg= +golang.org/x/image v0.15.0 h1:kOELfmgrmJlw4Cdb7g/QGuB3CvDrXbqEIww/pNtNBm8= +golang.org/x/image v0.15.0/go.mod h1:HUYqC05R2ZcZ3ejNQsIHQDQiwWM4JBqmm6MKANTp4LE= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= @@ -188,8 +190,8 @@ golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= golang.org/x/net v0.14.0/go.mod h1:PpSgVXXLK0OxS0F31C1/tv6XNguvCrnXIDrFMspZIUI= golang.org/x/net v0.15.0/go.mod h1:idbUs1IY1+zTqbi8yxTbhexhEEk5ur9LInksu6HrEpk= golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= -golang.org/x/net v0.19.0 h1:zTwKpTd2XuCqf8huc7Fo2iSy+4RHPd10s4KzeTnVr1c= -golang.org/x/net v0.19.0/go.mod h1:CfAk/cbD4CthTvqiEl8NpboMuiuOYsAr/7NOjZJtv1U= +golang.org/x/net v0.20.0 h1:aCL9BSgETF1k+blQaYUBx9hJ9LOGP3gAVemcZlf1Kpo= +golang.org/x/net v0.20.0/go.mod h1:z8BVo6PvndSri0LbOE3hAn0apkU+1YvI6E70E9jsnvY= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -220,8 +222,8 @@ golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.15.0 h1:h48lPFYpsTvQJZF4EKyI4aLHaev3CxivZmv7yZig9pc= -golang.org/x/sys v0.15.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.16.0 h1:xWw16ngr6ZMtmxDyKyIgsE93KNKz5HKmMa3b8ALHidU= +golang.org/x/sys v0.16.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= @@ -231,6 +233,7 @@ golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= golang.org/x/term v0.11.0/go.mod h1:zC9APTIj3jG3FdV/Ons+XE1riIZXG4aZ4GTHiPZJPIU= golang.org/x/term v0.12.0/go.mod h1:owVbMEjm3cBLCHdkQu9b1opXd4ETQWc3BhuQGKgXgvU= golang.org/x/term v0.13.0/go.mod h1:LTmsnFJwVN6bCy1rVCoS+qHT1HhALEFxKncY3WNNh4U= +golang.org/x/term v0.16.0/go.mod h1:yn7UURbUtPyrVJPGPq404EukNFxcm/foM+bV/bfcDsY= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= From e67b98d6fe18f97080ffd1056cdfea7eeb023f17 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 7 Feb 2024 12:33:29 +0300 Subject: [PATCH 152/361] Update Github actions --- .github/workflows/build.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 164398e7..c66984d4 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -23,7 +23,7 @@ jobs: steps: - uses: actions/checkout@v4 - - uses: actions/setup-go@v4 + - uses: actions/setup-go@v5 with: go-version: 1.22.0 @@ -77,7 +77,7 @@ jobs: make build test verify-cores - - uses: actions/upload-artifact@v3 + - uses: actions/upload-artifact@v4 if: always() with: name: emulator-test-frames From d6ceaad2205fcf9e8517ebb5212bb51b76c9403b Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 7 Feb 2024 12:39:17 +0300 Subject: [PATCH 153/361] Enable overwrite for the upload-artifact action --- .github/workflows/build.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index c66984d4..159d4a10 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -81,4 +81,5 @@ jobs: if: always() with: name: emulator-test-frames + overwrite: true path: _rendered/*.png From 53a3624aefd50cabb172d410d3dfc4998b1e2b28 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 7 Feb 2024 12:48:59 +0300 Subject: [PATCH 154/361] Upload test frames separately --- .github/workflows/build.yml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 159d4a10..da4711d5 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -80,6 +80,5 @@ jobs: - uses: actions/upload-artifact@v4 if: always() with: - name: emulator-test-frames - overwrite: true + name: emulator-test-frames-${{ matrix.os }} path: _rendered/*.png From 53e55728db17664c6f8e8d7b5a94690139aa6fb9 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Wed, 7 Feb 2024 15:15:41 +0300 Subject: [PATCH 155/361] Add PGO for 1.22 --- cmd/worker/default.pgo | Bin 0 -> 23472 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 cmd/worker/default.pgo diff --git a/cmd/worker/default.pgo b/cmd/worker/default.pgo new file mode 100644 index 0000000000000000000000000000000000000000..cfc8cc4b008a8f0f3fe1fca1a3e9b7f4c4798bc2 GIT binary patch literal 23472 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 T|NU1000960!i!#AdHDbUWI4-` literal 0 HcmV?d00001 From 1a44b94c85c947b85737cb0be9bdfce5b6eac9fb Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 8 Feb 2024 16:38:40 +0300 Subject: [PATCH 156/361] Revert Go version back to 1.20 Go 1.22 crashes under Windows with h264 encoder. --- .github/workflows/build.yml | 2 +- Dockerfile | 2 +- cmd/worker/default.pgo | Bin 23472 -> 49125 bytes go.mod | 2 +- 4 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index da4711d5..ba19d038 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -25,7 +25,7 @@ jobs: - uses: actions/setup-go@v5 with: - go-version: 1.22.0 + go-version: 1.20.14 - name: Linux if: matrix.os == 'ubuntu-latest' diff --git a/Dockerfile b/Dockerfile index abae4a67..1f33b6be 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:lunar AS build0 -ARG GO=1.22.0 +ARG GO=1.20.14 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ diff --git a/cmd/worker/default.pgo b/cmd/worker/default.pgo index cfc8cc4b008a8f0f3fe1fca1a3e9b7f4c4798bc2..35a67035847acc971e1a31dbe34b4c0848e08869 100644 GIT binary patch literal 49125 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 T|NU1000960!i!#AdHDbUWI4-` diff --git a/go.mod b/go.mod index 23ed99de..cfc02011 100644 --- a/go.mod +++ b/go.mod @@ -1,6 +1,6 @@ module github.com/giongto35/cloud-game/v3 -go 1.22 +go 1.20 require ( github.com/VictoriaMetrics/metrics v1.31.0 From ccb0f410abc5526cd321d5b8cf3224ba7a5a1625 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 8 Feb 2024 16:39:37 +0300 Subject: [PATCH 157/361] Revert "Revert Go version back to 1.20" This reverts commit 1a44b94c85c947b85737cb0be9bdfce5b6eac9fb. --- .github/workflows/build.yml | 2 +- Dockerfile | 2 +- cmd/worker/default.pgo | Bin 49125 -> 23472 bytes go.mod | 2 +- 4 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index ba19d038..da4711d5 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -25,7 +25,7 @@ jobs: - uses: actions/setup-go@v5 with: - go-version: 1.20.14 + go-version: 1.22.0 - name: Linux if: matrix.os == 'ubuntu-latest' diff --git a/Dockerfile b/Dockerfile index 1f33b6be..abae4a67 100644 --- a/Dockerfile +++ b/Dockerfile @@ -3,7 +3,7 @@ ARG VERSION=master # base build stage FROM ubuntu:lunar AS build0 -ARG GO=1.20.14 +ARG GO=1.22.0 ARG GO_DIST=go${GO}.linux-amd64.tar.gz ADD https://go.dev/dl/$GO_DIST ./ diff --git a/cmd/worker/default.pgo b/cmd/worker/default.pgo index 35a67035847acc971e1a31dbe34b4c0848e08869..cfc8cc4b008a8f0f3fe1fca1a3e9b7f4c4798bc2 100644 GIT binary patch literal 23472 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 T|NU1000960!i!#AdHDbUWI4-` literal 49125 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 Date: Wed, 7 Feb 2024 19:45:57 +0300 Subject: [PATCH 158/361] Pin nano string options during Retro callbacks --- pkg/worker/caged/libretro/nanoarch/nanoarch.go | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index cd4d3649..a414cbcf 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -755,10 +755,13 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { if v, ok := (*Nan0.options)[key]; ok { // make Go strings null-terminated copies ;_; (*Nan0.options)[key] = v + "\x00" + ptr := unsafe.Pointer(unsafe.StringData((*Nan0.options)[key])) + var p runtime.Pinner + p.Pin(ptr) + defer p.Unpin() // cast to C string and set the value - // we hope the string won't be collected while C needs it - rv.value = (*C.char)(unsafe.Pointer(unsafe.StringData((*Nan0.options)[key]))) - Nan0.log.Debug().Msgf("Set %s=%v", key, v) + rv.value = (*C.char)(ptr) + Nan0.log.Debug().Msgf("Set %v=%v", key, v) return true } return false From 4e241d04486e690538032504dd8c4949a82d152d Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 8 Feb 2024 18:12:55 +0300 Subject: [PATCH 159/361] Swap x264-git dep to libx264 in Msys2/Arch --- .github/workflows/build.yml | 2 +- README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index da4711d5..c82893d5 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -59,7 +59,7 @@ jobs: mingw-w64-x86_64-dlfcn mingw-w64-x86_64-libvpx mingw-w64-x86_64-opus - mingw-w64-x86_64-x264-git + mingw-w64-x86_64-libx264 mingw-w64-x86_64-SDL2 mingw-w64-x86_64-libyuv mingw-w64-x86_64-libjpeg-turbo diff --git a/README.md b/README.md index 42c1d157..654dc6d6 100644 --- a/README.md +++ b/README.md @@ -66,7 +66,7 @@ apt-get install -y make gcc pkg-config libvpx-dev libx264-dev libopus-dev libsdl brew install pkg-config libvpx x264 opus sdl2 jpeg-turbo # Windows (MSYS2) -pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,x264-git,SDL2,libyuv,libjpeg-turbo} +pacman -Sy --noconfirm --needed git make mingw-w64-x86_64-{gcc,pkgconf,dlfcn,libvpx,opus,libx264,SDL2,libyuv,libjpeg-turbo} ``` (You don't need to download libyuv on macOS) From 11295a28f6e58ac0b3eda9138cfa7966e1bd19d2 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 10 Feb 2024 16:22:45 +0300 Subject: [PATCH 160/361] Fix h264 lib for Go 1.22 Unwrapped X264_ C structs prevent crash on Go version 1.22. --- pkg/encoder/h264/libx264.go | 533 ------------------------------------ pkg/encoder/h264/x264.go | 135 +++++---- 2 files changed, 83 insertions(+), 585 deletions(-) delete mode 100644 pkg/encoder/h264/libx264.go diff --git a/pkg/encoder/h264/libx264.go b/pkg/encoder/h264/libx264.go deleted file mode 100644 index 6be21eb6..00000000 --- a/pkg/encoder/h264/libx264.go +++ /dev/null @@ -1,533 +0,0 @@ -// Package h264 implements cgo bindings for [x264](https://www.videolan.org/developers/x264.html) library. -package h264 - -/* -#cgo !st pkg-config: x264 -#cgo st LDFLAGS: -l:libx264.a - -#include "stdint.h" -#include "x264.h" -#include - -static int x264_encode( x264_t *h, uintptr_t pp_nal, int *pi_nal, x264_picture_t *pic_in, x264_picture_t *pic_out ) { - return x264_encoder_encode(h, (x264_nal_t **)pp_nal, pi_nal, pic_in, pic_out); -} - -*/ -import "C" -import "unsafe" - -const Build = C.X264_BUILD - -// T is opaque handler for encoder -type T struct{} - -// Nal is The data within the payload is already NAL-encapsulated; the ref_idc and type -// are merely in the struct for easy access by the calling application. -// All data returned in x264_nal_t, including the data in p_payload, is no longer -// valid after the next call to x264_encoder_encode. Thus, it must be used or copied -// before calling x264_encoder_encode or x264_encoder_headers again. -type Nal struct { - IRefIdc int32 /* nal_priority_e */ - IType int32 /* nal_unit_type_e */ - BLongStartcode int32 - IFirstMb int32 /* If this NAL is a slice, the index of the first MB in the slice. */ - ILastMb int32 /* If this NAL is a slice, the index of the last MB in the slice. */ - - /* Size of payload (including any padding) in bytes. */ - IPayload int32 - /* If param->b_annexb is set, Annex-B bytestream with startcode. - * Otherwise, startcode is replaced with a 4-byte size. - * This size is the size used in mp4/similar muxing; it is equal to i_payload-4 */ - /* C.uint8_t */ - PPayload unsafe.Pointer - - /* Size of padding in bytes. */ - IPadding int32 -} - -const RcCrf = 1 - -const ( - CspI420 = 0x0002 // yuv 4:2:0 planar - CspVflip = 0x1000 /* the csp is vertically flipped */ - - // CspMask = 0x00ff /* */ - // CspNone = 0x0000 /* Invalid mode */ - // CspI400 = 0x0001 /* monochrome 4:0:0 */ - - //CspYv12 = 0x0003 /* yvu 4:2:0 planar */ - //CspNv12 = 0x0004 /* yuv 4:2:0, with one y plane and one packed u+v */ - //CspNv21 = 0x0005 /* yuv 4:2:0, with one y plane and one packed v+u */ - //CspI422 = 0x0006 /* yuv 4:2:2 planar */ - //CspYv16 = 0x0007 /* yvu 4:2:2 planar */ - //CspNv16 = 0x0008 /* yuv 4:2:2, with one y plane and one packed u+v */ - //CspYuyv = 0x0009 /* yuyv 4:2:2 packed */ - //CspUyvy = 0x000a /* uyvy 4:2:2 packed */ - //CspV210 = 0x000b /* 10-bit yuv 4:2:2 packed in 32 */ - //CspI444 = 0x000c /* yuv 4:4:4 planar */ - //CspYv24 = 0x000d /* yvu 4:4:4 planar */ - //CspBgr = 0x000e /* packed bgr 24bits */ - //CspBgra = 0x000f /* packed bgr 32bits */ - //CspRgb = 0x0010 /* packed rgb 24bits */ - //CspMax = 0x0011 /* end of list */ - //CspHighDepth = 0x2000 /* the csp has a depth of 16 bits per pixel component */ -) - -type Zone struct { - IStart, IEnd int32 /* range of frame numbers */ - BForceQp int32 /* whether to use qp vs bitrate factor */ - IQp int32 - FBitrateFactor float32 - Param *Param -} - -type Param struct { - /* CPU flags */ - Cpu uint32 - IThreads int32 /* encode multiple frames in parallel */ - ILookaheadThreads int32 /* multiple threads for lookahead analysis */ - BSlicedThreads int32 /* Whether to use slice-based threading. */ - BDeterministic int32 /* whether to allow non-deterministic optimizations when threaded */ - BCpuIndependent int32 /* force canonical behavior rather than cpu-dependent optimal algorithms */ - ISyncLookahead int32 /* threaded lookahead buffer */ - - /* Video Properties */ - IWidth int32 - IHeight int32 - ICsp int32 /* CSP of encoded bitstream */ - IBitdepth int32 - ILevelIdc int32 - IFrameTotal int32 /* number of frames to encode if known, else 0 */ - - /* NAL HRD - * Uses Buffering and Picture Timing SEIs to signal HRD - * The HRD in H.264 was not designed with VFR in mind. - * It is therefore not recommended to use NAL HRD with VFR. - * Furthermore, reconfiguring the VBV (via x264_encoder_reconfig) - * will currently generate invalid HRD. */ - INalHrd int32 - - Vui struct { - /* they will be reduced to be 0 < x <= 65535 and prime */ - ISarHeight int32 - ISarWidth int32 - - IOverscan int32 /* 0=undef, 1=no overscan, 2=overscan */ - - /* see h264 annex E for the values of the following */ - IVidformat int32 - BFullrange int32 - IColorprim int32 - ITransfer int32 - IColmatrix int32 - IChromaLoc int32 /* both top & bottom */ - } - - /* Bitstream parameters */ - IFrameReference int32 /* Maximum number of reference frames */ - IDpbSize int32 /* Force a DPB size larger than that implied by B-frames and reference frames. - * Useful in combination with interactive error resilience. */ - IKeyintMax int32 /* Force an IDR keyframe at this interval */ - IKeyintMin int32 /* Scenecuts closer together than this are coded as I, not IDR. */ - IScenecutThreshold int32 /* how aggressively to insert extra I frames */ - BIntraRefresh int32 /* Whether or not to use periodic intra refresh instead of IDR frames. */ - - IBframe int32 /* how many b-frame between 2 references pictures */ - IBframeAdaptive int32 - IBframeBias int32 - IBframePyramid int32 /* Keep some B-frames as references: 0=off, 1=strict hierarchical, 2=normal */ - BOpenGop int32 - BBlurayCompat int32 - IAvcintraClass int32 - IAvcintraFlavor int32 - - BDeblockingFilter int32 - IDeblockingFilterAlphac0 int32 /* [-6, 6] -6 light filter, 6 strong */ - IDeblockingFilterBeta int32 /* [-6, 6] idem */ - - BCabac int32 - ICabacInitIdc int32 - - BInterlaced int32 - BConstrainedIntra int32 - - ICqmPreset int32 - PszCqmFile *int8 /* filename (in UTF-8) of CQM file, JM format */ - Cqm4iy [16]byte /* used only if i_cqm_preset == X264_CQM_CUSTOM */ - Cqm4py [16]byte - Cqm4ic [16]byte - Cqm4pc [16]byte - Cqm8iy [64]byte - Cqm8py [64]byte - Cqm8ic [64]byte - Cqm8pc [64]byte - - /* Log */ - PfLog *[0]byte - PLogPrivate unsafe.Pointer - ILogLevel int32 - BFullRecon int32 /* fully reconstruct frames, even when not necessary for encoding. Implied by psz_dump_yuv */ - PszDumpYuv *int8 /* filename (in UTF-8) for reconstructed frames */ - - /* Encoder analyser parameters */ - Analyse struct { - Intra uint32 /* intra partitions */ - Inter uint32 /* inter partitions */ - - BTransform8x8 int32 - IWeightedPred int32 /* weighting for P-frames */ - BWeightedBipred int32 /* implicit weighting for B-frames */ - IDirectMvPred int32 /* spatial vs temporal mv prediction */ - IChromaQpOffset int32 - - IMeMethod int32 /* motion estimation algorithm to use (X264_ME_*) */ - IMeRange int32 /* integer pixel motion estimation search range (from predicted mv) */ - IMvRange int32 /* maximum length of a mv (in pixels). -1 = auto, based on level */ - IMvRangeThread int32 /* minimum space between threads. -1 = auto, based on number of threads. */ - ISubpelRefine int32 /* subpixel motion estimation quality */ - BChromaMe int32 /* chroma ME for subpel and mode decision in P-frames */ - BMixedReferences int32 /* allow each mb partition to have its own reference number */ - ITrellis int32 /* trellis RD quantization */ - BFastPskip int32 /* early SKIP detection on P-frames */ - BDctDecimate int32 /* transform coefficient thresholding on P-frames */ - INoiseReduction int32 /* adaptive pseudo-deadzone */ - FPsyRd float32 /* Psy RD strength */ - FPsyTrellis float32 /* Psy trellis strength */ - BPsy int32 /* Toggle all psy optimizations */ - - BMbInfo int32 /* Use input mb_info data in x264_picture_t */ - BMbInfoUpdate int32 /* Update the values in mb_info according to the results of encoding. */ - - /* the deadzone size that will be used in luma quantization */ - ILumaDeadzone [2]int32 - - BPsnr int32 /* compute and print PSNR stats */ - BSsim int32 /* compute and print SSIM stats */ - } - - /* Rate control parameters */ - Rc struct { - IRcMethod int32 /* X264_RC_* */ - - IQpConstant int32 /* 0=lossless */ - IQpMin int32 /* min allowed QP value */ - IQpMax int32 /* max allowed QP value */ - IQpStep int32 /* max QP step between frames */ - - IBitrate int32 - FRfConstant float32 /* 1pass VBR, nominal QP */ - FRfConstantMax float32 /* In CRF mode, maximum CRF as caused by VBV */ - FRateTolerance float32 - IVbvMaxBitrate int32 - IVbvBufferSize int32 - FVbvBufferInit float32 /* <=1: fraction of buffer_size. >1: kbit */ - FIpFactor float32 - FPbFactor float32 - - /* VBV filler: force CBR VBV and use filler bytes to ensure hard-CBR. - * Implied by NAL-HRD CBR. */ - BFiller int32 - - IAqMode int32 /* psy adaptive QP. (X264_AQ_*) */ - FAqStrength float32 - BMbTree int32 /* Macroblock-tree ratecontrol. */ - ILookahead int32 - - /* 2pass */ - BStatWrite int32 /* Enable stat writing in psz_stat_out */ - PszStatOut *int8 /* output filename (in UTF-8) of the 2pass stats file */ - BStatRead int32 /* Read stat from psz_stat_in and use it */ - PszStatIn *int8 /* input filename (in UTF-8) of the 2pass stats file */ - - /* 2pass params (same as ffmpeg ones) */ - FQcompress float32 /* 0.0 => cbr, 1.0 => constant qp */ - FQblur float32 /* temporally blur quants */ - FComplexityBlur float32 /* temporally blur complexity */ - Zones *Zone /* ratecontrol overrides */ - IZones int32 /* number of zone_t's */ - PszZones *int8 /* alternate method of specifying zones */ - } - - /* Cropping Rectangle parameters: added to those implicitly defined by - non-mod16 video resolutions. */ - CropRect struct { - ILeft int32 - ITop int32 - IRight int32 - IBottom int32 - } - - /* frame packing arrangement flag */ - IFramePacking int32 - - /* alternative transfer SEI */ - IAlternativeTransfer int32 - - /* Muxing parameters */ - BAud int32 /* generate access unit delimiters */ - BRepeatHeaders int32 /* put SPS/PPS before each keyframe */ - BAnnexb int32 /* if set, place start codes (4 bytes) before NAL units, - * otherwise place size (4 bytes) before NAL units. */ - ISpsId int32 /* SPS and PPS id number */ - BVfrInput int32 /* VFR input. If 1, use timebase and timestamps for ratecontrol purposes. - * If 0, use fps only. */ - BPulldown int32 /* use explicity set timebase for CFR */ - IFpsNum uint32 - IFpsDen uint32 - ITimebaseNum uint32 /* Timebase numerator */ - ITimebaseDen uint32 /* Timebase denominator */ - - BTff int32 - - /* Pulldown: - * The correct pic_struct must be passed with each input frame. - * The input timebase should be the timebase corresponding to the output framerate. This should be constant. - * e.g. for 3:2 pulldown timebase should be 1001/30000 - * The PTS passed with each frame must be the PTS of the frame after pulldown is applied. - * Frame doubling and tripling require b_vfr_input set to zero (see H.264 Table D-1) - * - * Pulldown changes are not clearly defined in H.264. Therefore, it is the calling app's responsibility to manage this. - */ - - BPicStruct int32 - - /* Fake Interlaced. - * - * Used only when b_interlaced=0. Setting this flag makes it possible to flag the stream as PAFF interlaced yet - * encode all frames progressively. It is useful for encoding 25p and 30p Blu-Ray streams. - */ - BFakeInterlaced int32 - - /* Don't optimize header parameters based on video content, e.g. ensure that splitting an input video, compressing - * each part, and stitching them back together will result in identical SPS/PPS. This is necessary for stitching - * with container formats that don't allow multiple SPS/PPS. */ - BStitchable int32 - - BOpencl int32 /* use OpenCL when available */ - IOpenclDevice int32 /* specify count of GPU devices to skip, for CLI users */ - OpenclDeviceId unsafe.Pointer /* pass explicit cl_device_id as void*, for API users */ - PszClbinFile *int8 /* filename (in UTF-8) of the compiled OpenCL kernel cache file */ - - /* Slicing parameters */ - iSliceMaxSize int32 /* Max size per slice in bytes; includes estimated NAL overhead. */ - iSliceMaxMbs int32 /* Max number of MBs per slice; overrides iSliceCount. */ - iSliceMinMbs int32 /* Min number of MBs per slice */ - iSliceCount int32 /* Number of slices per frame: forces rectangular slices. */ - iSliceCountMax int32 /* Absolute cap on slices per frame; stops applying slice-max-size - * and slice-max-mbs if this is reached. */ - - ParamFree *func(arg unsafe.Pointer) - NaluProcess *func(H []T, Nal []Nal, Opaque unsafe.Pointer) - - Opaque unsafe.Pointer -} - -/**************************************************************************** - * H.264 level restriction information - ****************************************************************************/ - -type Level struct { - LevelIdc byte - Mbps int32 /* max macroblock processing rate (macroblocks/sec) */ - FrameSize int32 /* max frame size (macroblocks) */ - Dpb int32 /* max decoded picture buffer (mbs) */ - Bitrate int32 /* max bitrate (kbit/sec) */ - Cpb int32 /* max vbv buffer (kbit) */ - MvRange uint16 /* max vertical mv component range (pixels) */ - MvsPer2mb byte /* max mvs per 2 consecutive mbs. */ - SliceRate byte /* ?? */ - Mincr byte /* min compression ratio */ - Bipred8x8 byte /* limit bipred to >=8x8 */ - Direct8x8 byte /* limit b_direct to >=8x8 */ - FrameOnly byte /* forbid interlacing */ -} - -type PicStruct int32 - -type Hrd struct { - CpbInitialArrivalTime float64 - CpbFinalArrivalTime float64 - CpbRemovalTime float64 - - DpbOutputTime float64 -} - -type SeiPayload struct { - PayloadSize int32 - PayloadType int32 - Payload *byte -} - -type Sei struct { - NumPayloads int32 - Payloads *SeiPayload - /* In: optional callback to free each payload AND x264_sei_payload_t when used. */ - SeiFree *func(arg0 unsafe.Pointer) -} - -type Image struct { - ICsp int32 /* Colorspace */ - IPlane int32 /* Number of image planes */ - IStride [4]int32 /* Strides for each plane */ - Plane [4]uintptr /* Pointers to each plane */ -} - -type ImageProperties struct { - /* In: an array of quantizer offsets to be applied to this image during encoding. - * These are added on top of the decisions made by x264. - * Offsets can be fractional; they are added before QPs are rounded to integer. - * Adaptive quantization must be enabled to use this feature. Behavior if quant - * offsets differ between encoding passes is undefined. */ - QuantOffsets *float32 - /* In: optional callback to free quant_offsets when used. - * Useful if one wants to use a different quant_offset array for each frame. */ - QuantOffsetsFree *func(arg0 unsafe.Pointer) - - /* In: optional array of flags for each macroblock. - * Allows specifying additional information for the encoder such as which macroblocks - * remain unchanged. Usable flags are listed below. - * x264_param_t.analyse.b_mb_info must be set to use this, since x264 needs to track - * extra data internally to make full use of this information. - * - * Out: if b_mb_info_update is set, x264 will update this array as a result of encoding. - * - * For "MBINFO_CONSTANT", it will remove this flag on any macroblock whose decoded - * pixels have changed. This can be useful for e.g. noting which areas of the - * frame need to actually be blitted. Note: this intentionally ignores the effects - * of deblocking for the current frame, which should be fine unless one needs exact - * pixel-perfect accuracy. - * - * Results for MBINFO_CONSTANT are currently only set for P-frames, and are not - * guaranteed to enumerate all blocks which haven't changed. (There may be false - * negatives, but no false positives.) - */ - MbInfo *byte - /* In: optional callback to free mb_info when used. */ - MbInfoFree *func(arg0 unsafe.Pointer) - - /* Out: SSIM of the the frame luma (if x264_param_t.b_ssim is set) */ - FSsim float64 - /* Out: Average PSNR of the frame (if x264_param_t.b_psnr is set) */ - FPsnrAvg float64 - /* Out: PSNR of Y, U, and V (if x264_param_t.b_psnr is set) */ - FPsnr [3]float64 - - /* Out: Average effective CRF of the encoded frame */ - FCrfAvg float64 -} - -type Picture struct { - /* In: force picture type (if not auto) - * If x264 encoding parameters are violated in the forcing of picture types, - * x264 will correct the input picture type and log a warning. - * Out: type of the picture encoded */ - IType int32 - /* In: force quantizer for != X264_QP_AUTO */ - IQpplus1 int32 - /* In: pic_struct, for pulldown/doubling/etc...used only if b_pic_struct=1. - * use pic_struct_e for pic_struct inputs - * Out: pic_struct element associated with frame */ - IPicStruct int32 - /* Out: whether this frame is a keyframe. Important when using modes that result in - * SEI recovery points being used instead of IDR frames. */ - BKeyframe int32 - /* In: user pts, Out: pts of encoded picture (user)*/ - IPts int64 - /* Out: frame dts. When the pts of the first frame is close to zero, - * initial frames may have a negative dts which must be dealt with by any muxer */ - IDts int64 - /* In: custom encoding parameters to be set from this frame forwards - (in coded order, not display order). If NULL, continue using - parameters from the previous frame. Some parameters, such as - aspect ratio, can only be changed per-GOP due to the limitations - of H.264 itself; in this case, the caller must force an IDR frame - if it needs the changed parameter to apply immediately. */ - Param *Param - /* In: raw image data */ - /* Out: reconstructed image data. x264 may skip part of the reconstruction process, - e.g. deblocking, in frames where it isn't necessary. To force complete - reconstruction, at a small speed cost, set b_full_recon. */ - Img Image - /* In: optional information to modify encoder decisions for this frame - * Out: information about the encoded frame */ - Prop ImageProperties - /* Out: HRD timing information. Output only when i_nal_hrd is set. */ - Hrdiming Hrd - /* In: arbitrary user SEI (e.g subtitles, AFDs) */ - ExtraSei Sei - /* private user data. copied from input to output frames. */ - Opaque unsafe.Pointer -} - -func (t *T) cptr() *C.x264_t { return (*C.x264_t)(unsafe.Pointer(t)) } - -func (n *Nal) cptr() *C.x264_nal_t { return (*C.x264_nal_t)(unsafe.Pointer(n)) } - -func (p *Param) cptr() *C.x264_param_t { return (*C.x264_param_t)(unsafe.Pointer(p)) } - -func (p *Picture) cptr() *C.x264_picture_t { return (*C.x264_picture_t)(unsafe.Pointer(p)) } - -// ParamDefault - fill Param with default values and do CPU detection. -func ParamDefault(param *Param) { C.x264_param_default(param.cptr()) } - -// ParamDefaultPreset - the same as ParamDefault, but also use the passed preset and tune to modify the default settings -// (either can be nil, which implies no preset or no tune, respectively). -// -// Currently available presets are, ordered from fastest to slowest: -// "ultrafast", "superfast", "veryfast", "faster", "fast", "medium", "slow", "slower", "veryslow", "placebo". -// -// Currently available tunings are: -// "film", "animation", "grain", "stillimage", "psnr", "ssim", "fastdecode", "zerolatency". -// -// Returns 0 on success, negative on failure (e.g. invalid preset/tune name). -func ParamDefaultPreset(param *Param, preset string, tune string) int32 { - cpreset := C.CString(preset) - defer C.free(unsafe.Pointer(cpreset)) - ctune := C.CString(tune) - defer C.free(unsafe.Pointer(ctune)) - return (int32)(C.x264_param_default_preset(param.cptr(), cpreset, ctune)) -} - -// ParamApplyProfile - applies the restrictions of the given profile. -// -// Currently available profiles are, from most to least restrictive: -// "baseline", "main", "high", "high10", "high422", "high444". -// (can be nil, in which case the function will do nothing). -// -// Returns 0 on success, negative on failure (e.g. invalid profile name). -func ParamApplyProfile(param *Param, profile string) int32 { - cprofile := C.CString(profile) - defer C.free(unsafe.Pointer(cprofile)) - return (int32)(C.x264_param_apply_profile(param.cptr(), cprofile)) -} - -// EncoderOpen - create a new encoder handler, all parameters from Param are copied. -func EncoderOpen(param *Param) *T { - ret := C.x264_encoder_open(param.cptr()) - return *(**T)(unsafe.Pointer(&ret)) -} - -// EncoderEncode - encode one picture. -// Returns the number of bytes in the returned NALs, negative on error and zero if no NAL units returned. -func EncoderEncode(enc *T, ppNal **Nal, piNal *int32, picIn *Picture, picOut *Picture) int32 { - cenc := enc.cptr() - - cppNal := C.uintptr_t(uintptr(unsafe.Pointer(ppNal))) - cpiNal := (*C.int)(unsafe.Pointer(piNal)) - - cpicIn := picIn.cptr() - cpicOut := picOut.cptr() - - return (int32)(C.x264_encode(cenc, cppNal, cpiNal, cpicIn, cpicOut)) -} - -// EncoderClose closes an encoder handler. -func EncoderClose(enc *T) { C.x264_encoder_close(enc.cptr()) } - -// EncoderIntraRefresh - If an intra refresh is not in progress, begin one with the next P-frame. -// If an intra refresh is in progress, begin one as soon as the current one finishes. -// Requires that BIntraRefresh be set. -// -// Should not be called during an x264_encoder_encode. -//func EncoderIntraRefresh(enc *T) { C.x264_encoder_intra_refresh(enc.cptr()) } diff --git a/pkg/encoder/h264/x264.go b/pkg/encoder/h264/x264.go index c55f1502..74b805c4 100644 --- a/pkg/encoder/h264/x264.go +++ b/pkg/encoder/h264/x264.go @@ -1,18 +1,32 @@ package h264 +/* +// See: [x264](https://www.videolan.org/developers/x264.html) +#cgo !st pkg-config: x264 +#cgo st LDFLAGS: -l:libx264.a + +#include "stdint.h" +#include "x264.h" +#include +*/ +import "C" + import ( "fmt" + "runtime" "unsafe" ) type H264 struct { - ref *T + ref *C.x264_t - pnals *Nal // array of NALs - nnals int32 // number of NALs - y int32 // Y size - uv int32 // U or V size - in, out *Picture + nal *C.x264_nal_t // array of NALs + cNal *C.int // number of NALs + y int // Y size + uv int // U or V size + in, out *C.x264_picture_t + + p runtime.Pinner } type Options struct { @@ -31,10 +45,10 @@ type Options struct { } func NewEncoder(w, h int, th int, opts *Options) (encoder *H264, err error) { - libVersion := LibVersion() + ver := Version() - if libVersion < 150 { - return nil, fmt.Errorf("x264: the library version should be newer than v150, you have got version %v", libVersion) + if ver < 150 { + return nil, fmt.Errorf("x264: the library version should be newer than v150, you have got version %v", ver) } if opts == nil { @@ -46,90 +60,107 @@ func NewEncoder(w, h int, th int, opts *Options) (encoder *H264, err error) { } } - param := Param{} + param := C.x264_param_t{} + if opts.Preset != "" && opts.Tune != "" { - if ParamDefaultPreset(¶m, opts.Preset, opts.Tune) < 0 { + preset := C.CString(opts.Preset) + tune := C.CString(opts.Tune) + defer C.free(unsafe.Pointer(preset)) + defer C.free(unsafe.Pointer(tune)) + if C.x264_param_default_preset(¶m, preset, tune) < 0 { return nil, fmt.Errorf("x264: invalid preset/tune name") } } else { - ParamDefault(¶m) + C.x264_param_default(¶m) } if opts.Profile != "" { - if ParamApplyProfile(¶m, opts.Profile) < 0 { + profile := C.CString(opts.Profile) + defer C.free(unsafe.Pointer(profile)) + if C.x264_param_apply_profile(¶m, profile) < 0 { return nil, fmt.Errorf("x264: invalid profile name") } } - ww, hh := int32(w), int32(h) - - param.IBitdepth = 8 - if libVersion > 155 { - param.ICsp = CspI420 + param.i_bitdepth = 8 + if ver > 155 { + param.i_csp = C.X264_CSP_I420 } else { - param.ICsp = 1 + param.i_csp = 1 } - param.IWidth = ww - param.IHeight = hh - param.ILogLevel = opts.LogLevel - param.ISyncLookahead = 0 - param.IThreads = int32(th) + param.i_width = C.int(w) + param.i_height = C.int(h) + param.i_log_level = C.int(opts.LogLevel) + param.i_sync_lookahead = 0 + param.i_threads = C.int(th) if th != 1 { - param.BSlicedThreads = 1 + param.b_sliced_threads = 1 } - param.Rc.IRcMethod = RcCrf - param.Rc.FRfConstant = float32(opts.Crf) + param.rc.i_rc_method = C.X264_RC_CRF + param.rc.f_rf_constant = C.float(opts.Crf) encoder = &H264{ - y: ww * hh, - uv: ww * hh / 4, - pnals: new(Nal), - out: new(Picture), - in: &Picture{ - Img: Image{ICsp: param.ICsp, IPlane: 3, IStride: [4]int32{0: ww, 1: ww >> 1, 2: ww >> 1}}, + y: w * h, + uv: w * h / 4, + cNal: new(C.int), + nal: new(C.x264_nal_t), + out: new(C.x264_picture_t), + in: &C.x264_picture_t{ + img: C.x264_image_t{ + i_csp: param.i_csp, + i_plane: 3, + i_stride: [4]C.int{0: C.int(w), 1: C.int(w >> 1), 2: C.int(w >> 1)}, + }, }, + ref: C.x264_encoder_open(¶m), } - if encoder.ref = EncoderOpen(¶m); encoder.ref == nil { + if encoder.ref == nil { err = fmt.Errorf("x264: cannot open the encoder") } return } -func LibVersion() int { return int(Build) } - func (e *H264) LoadBuf(yuv []byte) { - e.in.Img.Plane[0] = uintptr(unsafe.Pointer(&yuv[0])) - e.in.Img.Plane[1] = uintptr(unsafe.Pointer(&yuv[e.y])) - e.in.Img.Plane[2] = uintptr(unsafe.Pointer(&yuv[e.y+e.uv])) + e.in.img.plane[0] = (*C.uchar)(unsafe.Pointer(&yuv[0])) + e.in.img.plane[1] = (*C.uchar)(unsafe.Pointer(&yuv[e.y])) + e.in.img.plane[2] = (*C.uchar)(unsafe.Pointer(&yuv[e.y+e.uv])) } -func (e *H264) Encode() (b []byte) { - e.in.IPts += 1 - bytes := EncoderEncode(e.ref, &e.pnals, &e.nnals, e.in, e.out) - if bytes > 0 { - // we merge multiple NALs stored in **pnals into a single byte stream - // ret contains the total size of NALs in bytes, i.e. each e.pnals[...].PPayload * IPayload - b = unsafe.Slice((*byte)(e.pnals.PPayload), bytes) - } - return +func (e *H264) Encode() []byte { + e.in.i_pts += 1 + + e.p.Pin(e.in.img.plane[0]) + e.p.Pin(e.in.img.plane[1]) + e.p.Pin(e.in.img.plane[2]) + + e.p.Pin(e.nal) + bytes := C.x264_encoder_encode(e.ref, &e.nal, e.cNal, e.in, e.out) + e.p.Unpin() + + // we merge multiple NALs stored in **nal into a single byte stream + // ret contains the total size of NALs in bytes, i.e. each e.nal[...].p_payload * i_payload + return unsafe.Slice((*byte)(e.nal.p_payload), bytes) } func (e *H264) IntraRefresh() { // !to implement } -func (e *H264) Info() string { return fmt.Sprintf("x264: v%v", LibVersion()) } +func (e *H264) Info() string { return fmt.Sprintf("x264: v%v", Version()) } func (e *H264) SetFlip(b bool) { if b { - e.in.Img.ICsp |= CspVflip + e.in.img.i_csp |= C.X264_CSP_VFLIP } else { - e.in.Img.ICsp &= ^CspVflip + e.in.img.i_csp &= ^C.X264_CSP_VFLIP } } func (e *H264) Shutdown() error { - EncoderClose(e.ref) + C.x264_encoder_close(e.ref) + e.p.Unpin() return nil } + +func Version() int { return int(C.X264_BUILD) } From 46067dec8f10a431863847e6299b7dcb0dbe49d6 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 11 Feb 2024 15:01:27 +0300 Subject: [PATCH 161/361] Use half GOP size in h264 --- pkg/encoder/h264/x264.go | 1 + 1 file changed, 1 insertion(+) diff --git a/pkg/encoder/h264/x264.go b/pkg/encoder/h264/x264.go index 74b805c4..6ca1f3aa 100644 --- a/pkg/encoder/h264/x264.go +++ b/pkg/encoder/h264/x264.go @@ -91,6 +91,7 @@ func NewEncoder(w, h int, th int, opts *Options) (encoder *H264, err error) { param.i_width = C.int(w) param.i_height = C.int(h) param.i_log_level = C.int(opts.LogLevel) + param.i_keyint_max = 120 param.i_sync_lookahead = 0 param.i_threads = C.int(th) if th != 1 { From b903700077188eddaf29a732bef578715f92fff7 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 11 Feb 2024 15:30:45 +0300 Subject: [PATCH 162/361] Update dependencies --- go.mod | 16 ++++++++-------- go.sum | 40 ++++++++++++++++------------------------ 2 files changed, 24 insertions(+), 32 deletions(-) diff --git a/go.mod b/go.mod index 23ed99de..1e5be76c 100644 --- a/go.mod +++ b/go.mod @@ -11,15 +11,15 @@ require ( github.com/gorilla/websocket v1.5.1 github.com/knadh/koanf/maps v0.1.1 github.com/knadh/koanf/v2 v2.1.0 - github.com/minio/minio-go/v7 v7.0.66 - github.com/pion/ice/v3 v3.0.2 + github.com/minio/minio-go/v7 v7.0.67 + github.com/pion/ice/v3 v3.0.3 github.com/pion/interceptor v0.1.25 github.com/pion/logging v0.2.2 - github.com/pion/webrtc/v4 v4.0.0-beta.7 + github.com/pion/webrtc/v4 v4.0.0-beta.9 github.com/rs/xid v1.5.0 github.com/rs/zerolog v1.32.0 github.com/veandco/go-sdl2 v0.4.38 - golang.org/x/crypto v0.18.0 + golang.org/x/crypto v0.19.0 golang.org/x/image v0.15.0 gopkg.in/yaml.v3 v3.0.1 ) @@ -42,11 +42,11 @@ require ( github.com/modern-go/reflect2 v1.0.2 // indirect github.com/pion/datachannel v1.5.5 // indirect github.com/pion/dtls/v2 v2.2.10 // indirect - github.com/pion/mdns v0.0.10 // indirect + github.com/pion/mdns v0.0.12 // indirect github.com/pion/randutil v0.1.0 // indirect github.com/pion/rtcp v1.2.13 // indirect github.com/pion/rtp v1.8.3 // indirect - github.com/pion/sctp v1.8.10 // indirect + github.com/pion/sctp v1.8.12 // indirect github.com/pion/sdp/v3 v3.0.6 // indirect github.com/pion/srtp/v3 v3.0.1 // indirect github.com/pion/stun/v2 v2.0.0 // indirect @@ -58,8 +58,8 @@ require ( github.com/stretchr/testify v1.8.4 // indirect github.com/valyala/fastrand v1.1.0 // indirect github.com/valyala/histogram v1.2.0 // indirect - golang.org/x/net v0.20.0 // indirect - golang.org/x/sys v0.16.0 // indirect + golang.org/x/net v0.21.0 // indirect + golang.org/x/sys v0.17.0 // indirect golang.org/x/text v0.14.0 // indirect gopkg.in/ini.v1 v1.67.0 // indirect ) diff --git a/go.sum b/go.sum index dcbb94b2..52a0de22 100644 --- a/go.sum +++ b/go.sum @@ -34,7 +34,6 @@ github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMyw github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg= -github.com/google/uuid v1.3.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= github.com/gorilla/websocket v1.5.1 h1:gmztn0JnHVt9JZquRuzLw3g4wouNVzKL15iLr/zn/QY= @@ -64,8 +63,8 @@ github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWE github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34= github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM= -github.com/minio/minio-go/v7 v7.0.66 h1:bnTOXOHjOqv/gcMuiVbN9o2ngRItvqE774dG9nq0Dzw= -github.com/minio/minio-go/v7 v7.0.66/go.mod h1:DHAgmyQEGdW3Cif0UooKOyrT3Vxs82zNdV6tkKhRtbs= +github.com/minio/minio-go/v7 v7.0.67 h1:BeBvZWAS+kRJm1vGTMJYVjKUNoo0FoEt/wUWdUtfmh8= +github.com/minio/minio-go/v7 v7.0.67/go.mod h1:+UXocnUeZ3wHvVh5s95gcrA4YjMIbccT6ubB+1m054A= github.com/minio/sha256-simd v1.0.1 h1:6kaan5IFmwTNynnKKpDHe6FWHohJOHhCPchzK49dzMM= github.com/minio/sha256-simd v1.0.1/go.mod h1:Pz6AKMiUdngCLpeTL/RJY1M9rUuPMYujV5xJjtbRSN8= github.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw= @@ -91,15 +90,14 @@ github.com/pion/datachannel v1.5.5/go.mod h1:iMz+lECmfdCMqFRhXhcA/219B0SQlbpoR2V github.com/pion/dtls/v2 v2.2.7/go.mod h1:8WiMkebSHFD0T+dIU+UeBaoV7kDhOW5oDCzZ7WZ/F9s= github.com/pion/dtls/v2 v2.2.10 h1:u2Axk+FyIR1VFTPurktB+1zoEPGIW3bmyj3LEFrXjAA= github.com/pion/dtls/v2 v2.2.10/go.mod h1:d9SYc9fch0CqK90mRk1dC7AkzzpwJj6u2GU3u+9pqFE= -github.com/pion/ice/v3 v3.0.2 h1:dNQnKsjLvOWz+PaI4tw1VnLYTp9adihC1HIASFGajmI= -github.com/pion/ice/v3 v3.0.2/go.mod h1:q3BDzTsxbqP0ySMSHrFuw2MYGUx/AC3WQfRGC5F/0Is= +github.com/pion/ice/v3 v3.0.3 h1:Mu5QkZ2pYmcjq9JETDcDR7F8UzjP1VHmcZmgU0yqsyk= +github.com/pion/ice/v3 v3.0.3/go.mod h1:YMLU7qbKfVjmEv7EoZPIVEI+kNYxWCdPK3VS0BU+U4Q= github.com/pion/interceptor v0.1.25 h1:pwY9r7P6ToQ3+IF0bajN0xmk/fNw/suTgaTdlwTDmhc= github.com/pion/interceptor v0.1.25/go.mod h1:wkbPYAak5zKsfpVDYMtEfWEy8D4zL+rpxCxPImLOg3Y= github.com/pion/logging v0.2.2 h1:M9+AIj/+pxNsDfAT64+MAVgJO0rsyLnoJKCqf//DoeY= github.com/pion/logging v0.2.2/go.mod h1:k0/tDVsRCX2Mb2ZEmTqNa7CWsQPc+YYCB7Q+5pahoms= -github.com/pion/mdns v0.0.9/go.mod h1:2JA5exfxwzXiCihmxpTKgFUpiQws2MnipoPK09vecIc= -github.com/pion/mdns v0.0.10 h1:u9/12WL2NNgtGT2nNPXT6+A+xeOF0PkawM/S/wPMWQA= -github.com/pion/mdns v0.0.10/go.mod h1:Y1scL/8TT8KQ172UfxrE4j0c04NOY71bJS1aE1zvyGY= +github.com/pion/mdns v0.0.12 h1:CiMYlY+O0azojWDmxdNr7ADGrnZ+V6Ilfner+6mSVK8= +github.com/pion/mdns v0.0.12/go.mod h1:VExJjv8to/6Wqm1FXK+Ii/Z9tsVk/F5sD/N70cnYFbk= github.com/pion/randutil v0.1.0 h1:CFG1UdESneORglEsnimhUjf33Rwjubwj6xfiOXBa3mA= github.com/pion/randutil v0.1.0/go.mod h1:XcJrSMMbbMRhASFVOlj/5hQial/Y8oH/HVo7TBZq+j8= github.com/pion/rtcp v1.2.10/go.mod h1:ztfEwXZNLGyF1oQDttz/ZKIBaeeg/oWbRYqzBM9TL1I= @@ -110,9 +108,8 @@ github.com/pion/rtp v1.8.2/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU github.com/pion/rtp v1.8.3 h1:VEHxqzSVQxCkKDSHro5/4IUUG1ea+MFdqR2R3xSpNU8= github.com/pion/rtp v1.8.3/go.mod h1:pBGHaFt/yW7bf1jjWAoUjpSNoDnw98KTMg+jWWvziqU= github.com/pion/sctp v1.8.5/go.mod h1:SUFFfDpViyKejTAdwD1d/HQsCu+V/40cCs2nZIvC3s0= -github.com/pion/sctp v1.8.9/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= -github.com/pion/sctp v1.8.10 h1:FDPlkojWQ2hIjnvgFs+frHR33TZCxoRhV2HztZ07NnU= -github.com/pion/sctp v1.8.10/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= +github.com/pion/sctp v1.8.12 h1:2VX50pedElH+is6FI+OKyRTeN5oy4mrk2HjnGa3UCmY= +github.com/pion/sctp v1.8.12/go.mod h1:cMLT45jqw3+jiJCrtHVwfQLnfR0MGZ4rgOJwUOIqLkI= github.com/pion/sdp/v3 v3.0.6 h1:WuDLhtuFUUVpTfus9ILC4HRyHsW6TdugjEX/QY9OiUw= github.com/pion/sdp/v3 v3.0.6/go.mod h1:iiFWFpQO8Fy3S5ldclBkpXqmWy02ns78NOKoLLL0YQw= github.com/pion/srtp/v3 v3.0.1 h1:AkIQRIZ+3tAOJMQ7G301xtrD1vekQbNeRO7eY1K8ZHk= @@ -128,8 +125,8 @@ github.com/pion/transport/v3 v3.0.1 h1:gDTlPJwROfSfz6QfSi0ZmeCSkFcnWWiiR9ES0ouAN github.com/pion/transport/v3 v3.0.1/go.mod h1:UY7kiITrlMv7/IKgd5eTUcaahZx5oUN3l9SzK5f5xE0= github.com/pion/turn/v3 v3.0.1 h1:wLi7BTQr6/Q20R0vt/lHbjv6y4GChFtC33nkYbasoT8= github.com/pion/turn/v3 v3.0.1/go.mod h1:MrJDKgqryDyWy1/4NT9TWfXWGMC7UHT6pJIv1+gMeNE= -github.com/pion/webrtc/v4 v4.0.0-beta.7 h1:OGCl69njLUKzT0ozJEon18W1LqH0GtuxG9Qx+qtxBdg= -github.com/pion/webrtc/v4 v4.0.0-beta.7/go.mod h1:/zWz+1e1qrjaIKYZG/mOfPrntiHOhnd3vGz2Fdo85Ys= +github.com/pion/webrtc/v4 v4.0.0-beta.9 h1:xmTVa6aia4fzOSP4Ki/hB7dKKtcIqaPI6YSfGDa5JZE= +github.com/pion/webrtc/v4 v4.0.0-beta.9/go.mod h1:z/hdYIuZUz2MFSdPKf099qRVAyTJwvy2c0nwRItCgZI= github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= @@ -166,10 +163,9 @@ golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPh golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= golang.org/x/crypto v0.8.0/go.mod h1:mRqEX+O9/h5TFCrQhkgjo2yKi0yYA+9ecGkdQoHrywE= golang.org/x/crypto v0.12.0/go.mod h1:NF0Gs7EO5K4qLn+Ylc+fih8BSTeIjAP05siRnAh98yw= -golang.org/x/crypto v0.13.0/go.mod h1:y6Z2r+Rw4iayiXXAIxJIDAJ1zMW4yaTpebo8fPOliYc= -golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= -golang.org/x/crypto v0.18.0 h1:PGVlW0xEltQnzFZ55hkuX5+KLyrMYhHld1YHO4AKcdc= golang.org/x/crypto v0.18.0/go.mod h1:R0j02AL6hcrfOiy9T4ZYp/rcWeMxM3L6QYxlOuEG1mg= +golang.org/x/crypto v0.19.0 h1:ENy+Az/9Y1vSrlrvBSyna3PITt4tiZLf7sgCjZBX7Wo= +golang.org/x/crypto v0.19.0/go.mod h1:Iy9bg/ha4yyC70EfRS8jz+B6ybOBKMaSxLj6P6oBDfU= golang.org/x/image v0.15.0 h1:kOELfmgrmJlw4Cdb7g/QGuB3CvDrXbqEIww/pNtNBm8= golang.org/x/image v0.15.0/go.mod h1:HUYqC05R2ZcZ3ejNQsIHQDQiwWM4JBqmm6MKANTp4LE= golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= @@ -188,10 +184,9 @@ golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= golang.org/x/net v0.9.0/go.mod h1:d48xBJpPfHeWQsugry2m+kC02ZBRGRgulfHnEXEuWns= golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= golang.org/x/net v0.14.0/go.mod h1:PpSgVXXLK0OxS0F31C1/tv6XNguvCrnXIDrFMspZIUI= -golang.org/x/net v0.15.0/go.mod h1:idbUs1IY1+zTqbi8yxTbhexhEEk5ur9LInksu6HrEpk= -golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= -golang.org/x/net v0.20.0 h1:aCL9BSgETF1k+blQaYUBx9hJ9LOGP3gAVemcZlf1Kpo= golang.org/x/net v0.20.0/go.mod h1:z8BVo6PvndSri0LbOE3hAn0apkU+1YvI6E70E9jsnvY= +golang.org/x/net v0.21.0 h1:AQyQV4dYCvJ7vGmJyKki9+PBdyvhkSd8EIx/qb0AYv4= +golang.org/x/net v0.21.0/go.mod h1:bIjVDfnllIU7BJ2DNgfnXvpSvtn8VRwhlsaeUTyUS44= golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= @@ -221,9 +216,9 @@ golang.org/x/sys v0.7.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= -golang.org/x/sys v0.16.0 h1:xWw16ngr6ZMtmxDyKyIgsE93KNKz5HKmMa3b8ALHidU= golang.org/x/sys v0.16.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= +golang.org/x/sys v0.17.0 h1:25cE3gD+tdBA7lp7QfhuV+rJiE9YXTcS3VG1SqssI/Y= +golang.org/x/sys v0.17.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA= golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= golang.org/x/term v0.1.0/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= @@ -231,8 +226,6 @@ golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= golang.org/x/term v0.7.0/go.mod h1:P32HKFT3hSsZrRxla30E9HqToFYAQPCMs/zFMBUFqPY= golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= golang.org/x/term v0.11.0/go.mod h1:zC9APTIj3jG3FdV/Ons+XE1riIZXG4aZ4GTHiPZJPIU= -golang.org/x/term v0.12.0/go.mod h1:owVbMEjm3cBLCHdkQu9b1opXd4ETQWc3BhuQGKgXgvU= -golang.org/x/term v0.13.0/go.mod h1:LTmsnFJwVN6bCy1rVCoS+qHT1HhALEFxKncY3WNNh4U= golang.org/x/term v0.16.0/go.mod h1:yn7UURbUtPyrVJPGPq404EukNFxcm/foM+bV/bfcDsY= golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= @@ -242,7 +235,6 @@ golang.org/x/text v0.4.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= golang.org/x/text v0.12.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= -golang.org/x/text v0.13.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= golang.org/x/text v0.14.0 h1:ScX5w1eTa3QqT8oi6+ziP7dTV1S2+ALU0bI+0zXKWiQ= golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= From e2226e749229c2d5b6c9558ef73b94b02f4b6839 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 12 Feb 2024 11:23:52 +0300 Subject: [PATCH 163/361] Remove Encoder.LoadBuf interface method There is no point in keeping it only for early YUV image pooling. --- pkg/encoder/encoder.go | 9 +++------ pkg/encoder/h264/x264.go | 4 +--- pkg/encoder/h264/x264_test.go | 6 ++---- pkg/encoder/vpx/libvpx.go | 11 ++++------- 4 files changed, 10 insertions(+), 20 deletions(-) diff --git a/pkg/encoder/encoder.go b/pkg/encoder/encoder.go index 5378e47c..b8ef829a 100644 --- a/pkg/encoder/encoder.go +++ b/pkg/encoder/encoder.go @@ -15,8 +15,7 @@ type ( InFrame yuv.RawFrame OutFrame []byte Encoder interface { - LoadBuf(input []byte) - Encode() []byte + Encode([]byte) []byte IntraRefresh() Info() string SetFlip(bool) @@ -75,10 +74,8 @@ func (v *Video) Encode(frame InFrame) OutFrame { } yCbCr := v.y.Process(yuv.RawFrame(frame), v.rot, v.pf) - v.codec.LoadBuf(yCbCr) - v.y.Put(&yCbCr) - - if bytes := v.codec.Encode(); len(bytes) > 0 { + defer v.y.Put(&yCbCr) + if bytes := v.codec.Encode(yCbCr); len(bytes) > 0 { return bytes } return nil diff --git a/pkg/encoder/h264/x264.go b/pkg/encoder/h264/x264.go index 6ca1f3aa..8e75f3ef 100644 --- a/pkg/encoder/h264/x264.go +++ b/pkg/encoder/h264/x264.go @@ -122,13 +122,11 @@ func NewEncoder(w, h int, th int, opts *Options) (encoder *H264, err error) { return } -func (e *H264) LoadBuf(yuv []byte) { +func (e *H264) Encode(yuv []byte) []byte { e.in.img.plane[0] = (*C.uchar)(unsafe.Pointer(&yuv[0])) e.in.img.plane[1] = (*C.uchar)(unsafe.Pointer(&yuv[e.y])) e.in.img.plane[2] = (*C.uchar)(unsafe.Pointer(&yuv[e.y+e.uv])) -} -func (e *H264) Encode() []byte { e.in.i_pts += 1 e.p.Pin(e.in.img.plane[0]) diff --git a/pkg/encoder/h264/x264_test.go b/pkg/encoder/h264/x264_test.go index 09f22ae3..0fe1bb43 100644 --- a/pkg/encoder/h264/x264_test.go +++ b/pkg/encoder/h264/x264_test.go @@ -9,8 +9,7 @@ func TestH264Encode(t *testing.T) { return } data := make([]byte, 120*120*1.5) - h264.LoadBuf(data) - h264.Encode() + h264.Encode(data) if err := h264.Shutdown(); err != nil { t.Error(err) } @@ -25,7 +24,6 @@ func Benchmark(b *testing.B) { } data := make([]byte, int(float64(w)*float64(h)*1.5)) for i := 0; i < b.N; i++ { - h264.LoadBuf(data) - h264.Encode() + h264.Encode(data) } } diff --git a/pkg/encoder/vpx/libvpx.go b/pkg/encoder/vpx/libvpx.go index 81988b9c..8de6ff40 100644 --- a/pkg/encoder/vpx/libvpx.go +++ b/pkg/encoder/vpx/libvpx.go @@ -135,17 +135,13 @@ func NewEncoder(w, h int, opts *Options) (*Vpx, error) { return &vpx, nil } -func (vpx *Vpx) LoadBuf(yuv []byte) { +// Encode encodes yuv image with the VPX8 encoder. +// see: https://chromium.googlesource.com/webm/libvpx/+/master/examples/simple_encoder.c +func (vpx *Vpx) Encode(yuv []byte) []byte { C.vpx_img_read(&vpx.image, unsafe.Pointer(&yuv[0])) if vpx.flipped { C.vpx_img_flip(&vpx.image) } -} - -// Encode encodes yuv image with the VPX8 encoder. -// see: https://chromium.googlesource.com/webm/libvpx/+/master/examples/simple_encoder.c -func (vpx *Vpx) Encode() []byte { - var iter C.vpx_codec_iter_t var flags C.int if vpx.kfi > 0 && vpx.frameCount%vpx.kfi == 0 { @@ -156,6 +152,7 @@ func (vpx *Vpx) Encode() []byte { } vpx.frameCount++ + var iter C.vpx_codec_iter_t fb := C.get_frame_buffer(&vpx.codecCtx, &iter) if fb.ptr == nil { return []byte{} From ce7aa1be623b509e7dd46d1eda40c6f4247be275 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 13 Feb 2024 18:50:38 +0300 Subject: [PATCH 164/361] Disable frame duplication by default It breaks newer PCSX rearmed versions by pushing dozen of frames in bursts. To implement a proper support later. --- pkg/worker/caged/libretro/nanoarch/nanoarch.go | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/pkg/worker/caged/libretro/nanoarch/nanoarch.go b/pkg/worker/caged/libretro/nanoarch/nanoarch.go index a414cbcf..86ca6bd9 100644 --- a/pkg/worker/caged/libretro/nanoarch/nanoarch.go +++ b/pkg/worker/caged/libretro/nanoarch/nanoarch.go @@ -713,8 +713,9 @@ func coreEnvironment(cmd C.unsigned, data unsafe.Pointer) C.bool { setRotation((*(*uint)(data) % 4) * 90) return true case C.RETRO_ENVIRONMENT_GET_CAN_DUPE: - *(*C.bool)(data) = C.bool(true) - return true + // !to implement frame dup (nil) some time later + *(*C.bool)(data) = C.bool(false) + return false case C.RETRO_ENVIRONMENT_GET_USERNAME: *(**C.char)(data) = Nan0.cUserName return true From 61b4108dcedbd19ccfdfbf6df1dc2a22155f4dd4 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 13 Feb 2024 19:37:23 +0300 Subject: [PATCH 165/361] Disable save states tests for Nestopia Savestates are broken in the Nestopia version 1ae59e3. Wait when new version (revert) is pushed into the nightly repo. --- pkg/worker/caged/libretro/frontend_test.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pkg/worker/caged/libretro/frontend_test.go b/pkg/worker/caged/libretro/frontend_test.go index 50dd78c6..5b4e65ae 100644 --- a/pkg/worker/caged/libretro/frontend_test.go +++ b/pkg/worker/caged/libretro/frontend_test.go @@ -217,7 +217,7 @@ func TestSavePersistence(t *testing.T) { // Compare states (a) and (b), should be =. func TestLoad(t *testing.T) { tests := []testRun{ - {room: "test_load_00", system: alwa.system, rom: alwa.rom, frames: 100}, + //{room: "test_load_00", system: alwa.system, rom: alwa.rom, frames: 100}, {room: "test_load_01", system: sushi.system, rom: sushi.rom, frames: 1000}, {room: "test_load_02", system: angua.system, rom: angua.rom, frames: 100}, } From 6258f9a5e49471309f7059095b4b456f698f25c9 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 13 Feb 2024 21:17:27 +0300 Subject: [PATCH 166/361] Add RTCP packet reader for output streams Default interceptors need those. --- pkg/network/webrtc/webrtc.go | 26 ++++++++++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/pkg/network/webrtc/webrtc.go b/pkg/network/webrtc/webrtc.go index f94d7915..0f67ba7d 100644 --- a/pkg/network/webrtc/webrtc.go +++ b/pkg/network/webrtc/webrtc.go @@ -42,9 +42,20 @@ func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp if err != nil { return "", err } - if _, err = p.conn.AddTrack(video); err != nil { + vs, err := p.conn.AddTrack(video) + if err != nil { return "", err } + // Read incoming RTCP packets + go func() { + rtcpBuf := make([]byte, 1500) + for { + _, _, rtcpErr := vs.Read(rtcpBuf) + if rtcpErr != nil { + return + } + } + }() p.v = video p.log.Debug().Msgf("Added [%s] track", video.Codec().MimeType) @@ -53,9 +64,20 @@ func (p *Peer) NewCall(vCodec, aCodec string, onICECandidate func(ice any)) (sdp if err != nil { return "", err } - if _, err = p.conn.AddTrack(audio); err != nil { + as, err := p.conn.AddTrack(audio) + if err != nil { return "", err } + // Read incoming RTCP packets + go func() { + rtcpBuf := make([]byte, 1500) + for { + _, _, rtcpErr := as.Read(rtcpBuf) + if rtcpErr != nil { + return + } + } + }() p.log.Debug().Msgf("Added [%s] track", audio.Codec().MimeType) p.a = audio From 3459c7e8d606afef8c077bdc80cf40e2d2ac6fe6 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 15 Feb 2024 04:10:49 +0300 Subject: [PATCH 167/361] Add VP9 encoder option --- pkg/config/config.yaml | 2 +- pkg/encoder/encoder.go | 12 +++++++++--- pkg/encoder/vpx/libvpx.go | 26 +++++++++++++++++++++----- pkg/network/webrtc/webrtc.go | 2 ++ pkg/worker/room/room_test.go | 12 +++++++----- 5 files changed, 40 insertions(+), 14 deletions(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index c532fbe1..27f1eaac 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -258,7 +258,7 @@ encoder: # so we keep the frame buffer roughly half of that size or 2 RTC packets per frame frame: 10 video: - # h264, vpx (VP8) + # h264, vpx (vp8) or vp9 codec: h264 # Threaded encoder if supported, 0 - auto, 1 - nope, >1 - multi-threaded threads: 0 diff --git a/pkg/encoder/encoder.go b/pkg/encoder/encoder.go index b8ef829a..a323290b 100644 --- a/pkg/encoder/encoder.go +++ b/pkg/encoder/encoder.go @@ -37,6 +37,7 @@ type VideoCodec string const ( H264 VideoCodec = "h264" VP8 VideoCodec = "vp8" + VP9 VideoCodec = "vp9" VPX VideoCodec = "vpx" ) @@ -48,13 +49,18 @@ const ( func NewVideoEncoder(w, h, dw, dh int, scale float64, conf config.Video, log *logger.Logger) (*Video, error) { var enc Encoder var err error - switch VideoCodec(conf.Codec) { + codec := VideoCodec(conf.Codec) + switch codec { case H264: opts := h264.Options(conf.H264) enc, err = h264.NewEncoder(dw, dh, conf.Threads, &opts) - case VP8, VPX: + case VP8, VP9, VPX: opts := vpx.Options(conf.Vpx) - enc, err = vpx.NewEncoder(dw, dh, &opts) + v := 8 + if codec == VP9 { + v = 9 + } + enc, err = vpx.NewEncoder(dw, dh, conf.Threads, v, &opts) default: err = fmt.Errorf("unsupported codec: %v", conf.Codec) } diff --git a/pkg/encoder/vpx/libvpx.go b/pkg/encoder/vpx/libvpx.go index 8de6ff40..c175c14f 100644 --- a/pkg/encoder/vpx/libvpx.go +++ b/pkg/encoder/vpx/libvpx.go @@ -12,6 +12,7 @@ package vpx #include #define VP8_FOURCC 0x30385056 +#define VP9_FOURCC 0x30395056 typedef struct VpxInterface { const char *const name; @@ -42,7 +43,10 @@ FrameBuffer get_frame_buffer(vpx_codec_ctx_t *codec, vpx_codec_iter_t *iter) { return fb; } -const VpxInterface vpx_encoders[] = {{ "vp8", VP8_FOURCC, &vpx_codec_vp8_cx }}; +const VpxInterface vpx_encoders[] = { + { "vp8", VP8_FOURCC, &vpx_codec_vp8_cx }, + { "vp9", VP9_FOURCC, &vpx_codec_vp9_cx }, +}; int vpx_img_plane_width(const vpx_image_t *img, int plane) { if (plane > 0 && img->x_chroma_shift > 0) @@ -85,6 +89,7 @@ type Vpx struct { codecCtx C.vpx_codec_ctx_t kfi C.int flipped bool + v int } func (vpx *Vpx) SetFlip(b bool) { vpx.flipped = b } @@ -96,8 +101,12 @@ type Options struct { KeyframeInterval uint } -func NewEncoder(w, h int, opts *Options) (*Vpx, error) { - encoder := &C.vpx_encoders[0] +func NewEncoder(w, h int, th int, version int, opts *Options) (*Vpx, error) { + idx := 0 + if version == 9 { + idx = 1 + } + encoder := &C.vpx_encoders[idx] if encoder == nil { return nil, fmt.Errorf("couldn't get the encoder") } @@ -112,6 +121,7 @@ func NewEncoder(w, h int, opts *Options) (*Vpx, error) { vpx := Vpx{ frameCount: C.int(0), kfi: C.int(opts.KeyframeInterval), + v: version, } if C.vpx_img_alloc(&vpx.image, C.VPX_IMG_FMT_I420, C.uint(w), C.uint(h), 1) == nil { @@ -125,8 +135,12 @@ func NewEncoder(w, h int, opts *Options) (*Vpx, error) { cfg.g_w = C.uint(w) cfg.g_h = C.uint(h) + if th != 0 { + cfg.g_threads = C.uint(th) + } + cfg.g_lag_in_frames = 0 cfg.rc_target_bitrate = C.uint(opts.Bitrate) - cfg.g_error_resilient = 1 + cfg.g_error_resilient = C.VPX_ERROR_RESILIENT_DEFAULT if C.call_vpx_codec_enc_init(&vpx.codecCtx, encoder, &cfg) != 0 { return nil, fmt.Errorf("failed to initialize encoder") @@ -160,7 +174,9 @@ func (vpx *Vpx) Encode(yuv []byte) []byte { return C.GoBytes(fb.ptr, fb.size) } -func (vpx *Vpx) Info() string { return fmt.Sprintf("vpx: %v", C.GoString(C.vpx_codec_version_str())) } +func (vpx *Vpx) Info() string { + return fmt.Sprintf("vpx (%v): %v", vpx.v, C.GoString(C.vpx_codec_version_str())) +} func (vpx *Vpx) IntraRefresh() { // !to implement diff --git a/pkg/network/webrtc/webrtc.go b/pkg/network/webrtc/webrtc.go index 0f67ba7d..25612d06 100644 --- a/pkg/network/webrtc/webrtc.go +++ b/pkg/network/webrtc/webrtc.go @@ -160,6 +160,8 @@ func newTrack(id string, label string, codec string) (*webrtc.TrackLocalStaticSa mime = webrtc.MimeTypeH264 case "vpx", "vp8": mime = webrtc.MimeTypeVP8 + case "vp9": + mime = webrtc.MimeTypeVP9 } } if mime == "" { diff --git a/pkg/worker/room/room_test.go b/pkg/worker/room/room_test.go index c1459e0a..2be732d5 100644 --- a/pkg/worker/room/room_test.go +++ b/pkg/worker/room/room_test.go @@ -110,13 +110,15 @@ func TestMain(m *testing.M) { func TestRoom(t *testing.T) { tests := []testParams{ - {game: alwas, codecs: []codec{encoder.H264}, frames: 300}, + {game: alwas, codecs: []codec{encoder.H264, encoder.VP8, encoder.VP9}, frames: 300}, } for _, test := range tests { - room := room(conf{codec: test.codecs[0], game: test.game}) - room.WaitFrame(test.frames) - room.Close() + for _, codec := range test.codecs { + room := room(conf{codec: codec, game: test.game}) + room.WaitFrame(test.frames) + room.Close() + } } } @@ -245,7 +247,7 @@ func room(cfg conf) testRoom { func BenchmarkRoom(b *testing.B) { benches := []testParams{ // warm up - {system: "gba", game: sushi, codecs: []codec{encoder.VP8}, frames: 50}, + {system: "gba", game: sushi, codecs: []codec{encoder.VP8, encoder.VP9}, frames: 50}, {system: "gba", game: sushi, codecs: []codec{encoder.VP8, encoder.H264}, frames: 100}, {system: "nes", game: alwas, codecs: []codec{encoder.VP8, encoder.H264}, frames: 100}, } From e7e281083f94c49cd6e49237b9ae0f4178940960 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 16 Feb 2024 22:47:54 +0300 Subject: [PATCH 168/361] Add ugly persistent volume option --- web/index.html | 8 ++++---- web/js/gui/gui.js | 11 +++++++++++ web/js/settings/opts.js | 3 ++- web/js/settings/settings.js | 21 +++++++++++++++++++-- web/js/stream/stream.js | 1 + 5 files changed, 37 insertions(+), 7 deletions(-) diff --git a/web/index.html b/web/index.html index a912d443..bc673e5e 100644 --- a/web/index.html +++ b/web/index.html @@ -118,16 +118,16 @@ - + - - + + - + diff --git a/web/js/gui/gui.js b/web/js/gui/gui.js index 0d14ebff..be5b603f 100644 --- a/web/js/gui/gui.js +++ b/web/js/gui/gui.js @@ -147,6 +147,16 @@ const gui = (() => { el.classList.remove('hidden'); } + const inputN = (key = '', cb = () => ({}), current = 0) => { + const el = _create(); + const input = _create('input'); + input.type = 'number'; + input.value = current; + input.onchange = event => cb(key, event.target.value); + el.append(input); + return el; + } + const hide = (el) => { el.classList.add('hidden'); } @@ -208,6 +218,7 @@ const gui = (() => { create: _create, fragment, hide, + inputN, panel, select, show, diff --git a/web/js/settings/opts.js b/web/js/settings/opts.js index bff7a098..b0b2b966 100644 --- a/web/js/settings/opts.js +++ b/web/js/settings/opts.js @@ -10,5 +10,6 @@ const opts = Object.freeze({ _VERSION: '_version', LOG_LEVEL: 'log.level', INPUT_KEYBOARD_MAP: 'input.keyboard.map', - MIRROR_SCREEN: 'mirror.screen' + MIRROR_SCREEN: 'mirror.screen', + VOLUME: 'volume' }); diff --git a/web/js/settings/settings.js b/web/js/settings/settings.js index 81b38c0c..55dd89dd 100644 --- a/web/js/settings/settings.js +++ b/web/js/settings/settings.js @@ -15,7 +15,7 @@ */ const settings = (() => { // internal structure version - const revision = 1.2; + const revision = 1.3; // default settings // keep them for revert to defaults option @@ -347,6 +347,13 @@ settings._renderrer = (() => { // the main display data holder element const data = document.getElementById('settings-data'); + let sx, sy = 0; + + data.addEventListener("scroll", event => { + sx = data.scrollTop; + sy = data.scrollLeft; + }, {passive: true}); + // a fast way to clear data holder. const clearData = () => { while (data.firstChild) data.removeChild(data.firstChild) @@ -428,7 +435,11 @@ settings._renderrer = (() => { * @param newValue A new value to set. * @param oldValue An old value to use somehow if needed. */ - const onChange = (key, newValue, oldValue) => settings.set(key, newValue); + const onChange = (key, newValue, oldValue) => { + settings.set(key, newValue); + data.scrollTop = sx; + data.scrollLeft = sy; + } const onKeyBindingChange = (key, oldValue) => { clearData(); @@ -467,6 +478,12 @@ settings._renderrer = (() => { .add(gui.select(k, onChange, {values: ['mirror']}, value)) .build(); break; + case opts.VOLUME: + _option(data).withName('Volume (%)') + .add(gui.inputN(k, onChange, value)) + .restartNeeded() + .build() + break; default: _option(data).withName(k).add(value).build(); } diff --git a/web/js/stream/stream.js b/web/js/stream/stream.js index 9ab3dd49..5652b36e 100644 --- a/web/js/stream/stream.js +++ b/web/js/stream/stream.js @@ -149,6 +149,7 @@ const stream = (() => { const init = () => { options.mirrorMode = settings.loadOr(opts.MIRROR_SCREEN, 'none'); + options.volume = settings.loadOr(opts.VOLUME, 50) / 100; } event.sub(SETTINGS_CHANGED, () => { From b79b4c405afb41b4e2c0d05b9c578ea3bd4503eb Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 26 Nov 2023 23:49:13 +0300 Subject: [PATCH 169/361] Get random free port in websocket tests --- pkg/com/net_test.go | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/pkg/com/net_test.go b/pkg/com/net_test.go index fa7d3130..572fb31e 100644 --- a/pkg/com/net_test.go +++ b/pkg/com/net_test.go @@ -4,6 +4,7 @@ import ( "encoding/json" "fmt" "math/rand" + "net" "net/http" "net/url" "sync" @@ -49,7 +50,13 @@ func TestWebsocket(t *testing.T) { } func testWebsocket(t *testing.T) { - addr := ":8989" + port, err := getFreePort() + if err != nil { + t.Logf("couldn't get any free port") + t.Skip() + } + addr := fmt.Sprintf(":%v", port) + server := newServer(addr, t) client := newClient(t, url.URL{Scheme: "ws", Host: "localhost" + addr, Path: "/ws"}) clDone := client.ProcessPackets(func(in TestIn) error { return nil }) @@ -206,3 +213,15 @@ func newServer(addr string, t *testing.T) *serverHandler { wg.Wait() return &handler } + +func getFreePort() (port int, err error) { + var a *net.TCPAddr + var l *net.TCPListener + if a, err = net.ResolveTCPAddr("tcp", ":0"); err == nil { + if l, err = net.ListenTCP("tcp", a); err == nil { + defer func() { _ = l.Close() }() + return l.Addr().(*net.TCPAddr).Port, nil + } + } + return +} From 41bfe4f4d3849508b4c848f760c6df9452cbf7f9 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Mon, 19 Feb 2024 18:27:38 +0300 Subject: [PATCH 170/361] Fix WebRTC datachannels in FF --- web/js/network/webrtc.js | 2 ++ 1 file changed, 2 insertions(+) diff --git a/web/js/network/webrtc.js b/web/js/network/webrtc.js index 8d72c8fd..26e04f59 100644 --- a/web/js/network/webrtc.js +++ b/web/js/network/webrtc.js @@ -31,6 +31,8 @@ const webrtc = (() => { connection.ondatachannel = e => { log.debug('[rtc] ondatachannel', e.channel.label) + e.channel.binaryType = "arraybuffer"; + dataChannel = e.channel; dataChannel.onopen = () => { log.info('[rtc] the input channel has been opened'); From 1452317d451600e81d3ee33b30e4e271b42ced09 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 20 Feb 2024 21:39:49 +0300 Subject: [PATCH 171/361] Scan ROM extensions case-insensitive --- pkg/games/library.go | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pkg/games/library.go b/pkg/games/library.go index 0fde5023..e1338f8c 100644 --- a/pkg/games/library.go +++ b/pkg/games/library.go @@ -235,7 +235,7 @@ func (lib *library) set(games []GameMetadata) { } func (lib *library) isExtAllowed(path string) bool { - ext := filepath.Ext(path) + ext := strings.ToLower(filepath.Ext(path)) if ext == "" { return false } @@ -246,7 +246,7 @@ func (lib *library) isExtAllowed(path string) bool { // getMetadata returns game info from a path func getMetadata(path string, basePath string) GameMetadata { name := filepath.Base(path) - ext := filepath.Ext(name) + ext := strings.ToLower(filepath.Ext(name)) relPath, _ := filepath.Rel(basePath, path) return GameMetadata{ From 9308e1b3889f68ee1eb94a11b2a7212dd80ba126 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Tue, 20 Feb 2024 21:59:36 +0300 Subject: [PATCH 172/361] Sort lib alphabetically in console --- pkg/games/library.go | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/pkg/games/library.go b/pkg/games/library.go index e1338f8c..884f3852 100644 --- a/pkg/games/library.go +++ b/pkg/games/library.go @@ -4,6 +4,7 @@ import ( "fmt" "io/fs" "path/filepath" + "sort" "strings" "sync" "time" @@ -259,8 +260,17 @@ func getMetadata(path string, basePath string) GameMetadata { // dumpLibrary printouts the current library snapshot of games func (lib *library) dumpLibrary() { var gameList strings.Builder - for _, game := range lib.games { - gameList.WriteString(fmt.Sprintf(" %5s %s (%s)\n", game.System, game.Name, game.Path)) + + // oof + keys := make([]string, 0, len(lib.games)) + for k := range lib.games { + keys = append(keys, k) + } + sort.Strings(keys) + + for _, k := range keys { + game := lib.games[k] + gameList.WriteString(fmt.Sprintf(" %7s %s (%s)\n", game.System, game.Name, game.Path)) } lib.log.Debug().Msgf("Lib dump\n"+ From 000bc4f661ee31151bb1cd81a2c328ca42df2abe Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 23 Feb 2024 21:06:55 +0300 Subject: [PATCH 173/361] Load apps after rendering 1 frame This is mandatory for Mupen and DOSBox save states. Enabled for all emulators. --- pkg/worker/caged/libretro/frontend.go | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/pkg/worker/caged/libretro/frontend.go b/pkg/worker/caged/libretro/frontend.go index 0386b0a8..ab6b8ed1 100644 --- a/pkg/worker/caged/libretro/frontend.go +++ b/pkg/worker/caged/libretro/frontend.go @@ -261,10 +261,9 @@ func (f *Frontend) Start() { defer f.mui.Unlock() if f.HasSave() { - // advance 1 frame for Mupen save state - if f.nano.LibCo { - f.Tick() - } + // advance 1 frame for Mupen, DOSBox save states + // loading will work if autostart is selected for DOSBox apps + f.Tick() if err := f.RestoreGameState(); err != nil { f.log.Error().Err(err).Msg("couldn't load a save file") } From c699455b580e676cd6e1c056f22cbb7cc5004f75 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 25 Feb 2024 12:51:37 +0300 Subject: [PATCH 174/361] Hide video element controls in fullscreen --- web/css/main.css | 6 ++++++ web/index.html | 4 ++-- web/js/stream/stream.js | 23 ++++++++++++++++------- 3 files changed, 24 insertions(+), 9 deletions(-) diff --git a/web/css/main.css b/web/css/main.css index b47047fb..10d98e2e 100644 --- a/web/css/main.css +++ b/web/css/main.css @@ -3,6 +3,12 @@ src: url('/fonts/6809-Chargen.woff2'); } + +.no-media-controls::-webkit-media-controls { + display: none !important; +} + + html { /* force full size for Firefox */ width: 100%; diff --git a/web/index.html b/web/index.html index bc673e5e..a760c3fc 100644 --- a/web/index.html +++ b/web/index.html @@ -37,7 +37,7 @@ There is still audio because current audio flow is not from media but it is manually encoded (technical webRTC challenge). Later, when we can integrate audio to media, we can face the issue with mute again . https://developers.google.com/web/updates/2017/09/autoplay-policy-changes --> - +
    +
    Arrows (move), ZXCVAS;'./ (game ABXYL1-L3R1-R3), 1/2 (1st/2nd player), Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy the link to the clipboard) @@ -94,21 +95,6 @@
    {{end}}
    -     - + diff --git a/web/js/gui/gui.js b/web/js/gui/gui.js index be5b603f..239affde 100644 --- a/web/js/gui/gui.js +++ b/web/js/gui/gui.js @@ -26,8 +26,7 @@ const gui = (() => { return el; } - const select = (key = '', callback = function () { - }, values = {values: [], labels: []}, current = '') => { + const select = (key = '', callback = () => ({}), values = {values: [], labels: []}, current = '') => { const el = _create(); const select = _create('select'); select.onchange = event => { @@ -45,6 +44,7 @@ const gui = (() => { const panel = (root, title = '', cc = '', content, buttons = [], onToggle) => { const state = { + br: null, shown: false, loading: false, title: title, @@ -70,6 +70,10 @@ const gui = (() => { el.classList.add('panel__header__controls'); buttons.forEach((b => el.append(_create('span', (el) => { + if (Object.keys(b).length === 0) { + el.classList.add('panel__button_separator'); + return + } el.classList.add('panel__button'); if (b.cl) b.cl.forEach(class_ => el.classList.add(class_)); if (b.title) el.title = b.title; @@ -99,17 +103,19 @@ const gui = (() => { function toggle(show) { state.shown = show; - if (onToggle) { - onToggle(state.shown, _root) - } - if (state.shown) { - gui.show(_root); - } else { - gui.hide(_root); - } + + // hack not transparent jpeg corners :_; + show ? _root.parentElement.style.borderRadius = '0px' : + state.br ? _root.parentElement.style.borderRadius = state.br : + state.br = window.getComputedStyle(_root.parentElement).borderRadius + + onToggle && onToggle(state.shown, _root) + + state.shown ? gui.show(_root) : gui.hide(_root) } return { + contentEl: _content, isHidden: () => !state.shown, setContent, setLoad, diff --git a/web/js/settings/settings.js b/web/js/settings/settings.js index 0e67fdd7..01da6f1c 100644 --- a/web/js/settings/settings.js +++ b/web/js/settings/settings.js @@ -15,7 +15,7 @@ */ const settings = (() => { // internal structure version - const revision = 1.4; + const revision = 1.5; // default settings // keep them for revert to defaults option @@ -46,17 +46,7 @@ const settings = (() => { const exportFileName = `cloud-game.settings.v${revision}.txt`; - // ui references - const ui = document.getElementById('app-settings'), - closeEl = document.getElementById('settings__controls__close'), - loadEl = document.getElementById('settings__controls__load'), - saveEl = document.getElementById('settings__controls__save'), - resetEl = document.getElementById('settings__controls__reset'); - - this._renderrer = this._renderrer || { - render: () => { - } - }; + let _renderer = {render: () => ({})}; const getStore = () => store.settings; @@ -64,8 +54,7 @@ const settings = (() => { * The NullObject provider if everything else fails. */ const voidProvider = (store_ = {settings: {}}) => { - const nil = () => { - } + const nil = () => ({}) return { get: key => store_.settings[key], @@ -107,7 +96,7 @@ const settings = (() => { const get = key => JSON.parse(localStorage.getItem(key)); - const set = (key, value) => save(); + const set = () => save(); const remove = () => save(); @@ -161,7 +150,6 @@ const settings = (() => { document.body.appendChild(el); el.click(); document.body.removeChild(el); - el = undefined; } const init = () => { @@ -256,13 +244,40 @@ const settings = (() => { provider.remove(key, subKey); } - const _render = () => settings._renderrer.render() + const panel = gui.panel(document.getElementById('settings'), '> OPTIONS', 'settings', null, [ + {caption: 'Export', handler: () => _export(), title: 'Save',}, + {caption: 'Import', handler: () => _fileReader.read(onFileLoad), title: 'Load',}, + { + caption: 'Reset', + handler: () => { + if (window.confirm("Are you sure want to reset your settings?")) { + _reset(); + event.pub(SETTINGS_CHANGED); + } + }, + title: 'Reset', + }, + {} + ], + (state) => { + if (state) return; - /** - * Settings modal window toggle handler. - * @returns {boolean} True in case if it's opened. - */ - const toggle = () => ui.classList.toggle('modal-visible') && !_render(); + event.pub(SETTINGS_CLOSED); + // to make sure it's disabled, but it's a tad verbose + event.pub(KEYBOARD_TOGGLE_FILTER_MODE, {mode: true}); + }) + + panel.toggle(false); + + const _render = () => { + _renderer.data = panel.contentEl; + _renderer.render() + } + + const toggle = () => { + panel.toggle(true); + _render() + } function _getType(value) { if (value === undefined) return option.undefined @@ -273,15 +288,8 @@ const settings = (() => { else return option.undefined; } - /** - * File reader submodule (FileReader API). - * - * @type {{read: read}} Tries to read a file. - * @private - */ const _fileReader = (() => { - let callback_ = () => { - } + let callback_ = () => ({}) const el = document.createElement('input'); const reader = new FileReader(); @@ -309,21 +317,6 @@ const settings = (() => { event.sub(SETTINGS_CHANGED, _render); - // internal init section - closeEl.addEventListener('click', () => { - event.pub(SETTINGS_CLOSED); - // to make sure it's disabled, but it's a tad verbose - event.pub(KEYBOARD_TOGGLE_FILTER_MODE, {mode: true}); - }); - saveEl.addEventListener('click', () => _export()); - loadEl.addEventListener('click', () => _fileReader.read(onFileLoad)); - resetEl.addEventListener('click', () => { - if (window.confirm("Are you sure want to reset your settings?")) { - _reset(); - event.pub(SETTINGS_CHANGED); - } - }); - return { init, loadOr, @@ -335,24 +328,31 @@ const settings = (() => { export: _export, ui: { toggle, + }, + set renderer(fn) { + _renderer = fn; } } })(document, event, JSON, localStorage, log, window); // hardcoded ui stuff -settings._renderrer = (() => { - // options to ignore (i.e. ignored = {'_version': 1}) - const ignored = {}; +settings.renderer = (() => { + // don't show these options (i.e. ignored = {'_version': 1}) + const ignored = {'_version': 1}; // the main display data holder element - const data = document.getElementById('settings-data'); + let data = null; - let sx, sy = 0; - - data.addEventListener("scroll", event => { - sx = data.scrollTop; - sy = data.scrollLeft; - }, {passive: true}); + const scrollState = ((sx = 0, sy = 0, el) => ({ + track(_el) { + el = _el + el.addEventListener("scroll", () => ({scrollTop: sx, scrollLeft: sy} = el), {passive: true}) + }, + restore() { + el.scrollTop = sx + el.scrollLeft = sy + } + }))() // a fast way to clear data holder. const clearData = () => { @@ -363,9 +363,11 @@ settings._renderrer = (() => { const wrapperEl = document.createElement('div'); wrapperEl.classList.add('settings__option'); + const titleEl = document.createElement('div'); + titleEl.classList.add('settings__option-title'); + wrapperEl.append(titleEl); + const nameEl = document.createElement('div'); - nameEl.classList.add('settings__option-name'); - wrapperEl.append(nameEl); const valueEl = document.createElement('div'); valueEl.classList.add('settings__option-value'); @@ -373,15 +375,23 @@ settings._renderrer = (() => { return { withName: function (name = '') { + if (name === '') return this; + nameEl.classList.add('settings__option-name'); nameEl.textContent = name; + titleEl.append(nameEl); return this; }, withClass: function (name = '') { wrapperEl.classList.add(name); return this; }, - readOnly: function () { - // reserved + withDescription(text = '') { + if (text === '') return this; + const descEl = document.createElement('div'); + descEl.classList.add('settings__option-desc'); + descEl.textContent = text; + titleEl.append(descEl); + return this; }, restartNeeded: function () { nameEl.classList.add('restart-needed-asterisk'); @@ -408,11 +418,7 @@ settings._renderrer = (() => { } } - // !to check leaks - if (handler) { - handler.unsub(); - handler = undefined; - } + handler?.unsub(); event.pub(KEYBOARD_TOGGLE_FILTER_MODE); event.pub(SETTINGS_CHANGED); @@ -433,12 +439,10 @@ settings._renderrer = (() => { * * @param key The name (id) of an option. * @param newValue A new value to set. - * @param oldValue An old value to use somehow if needed. */ - const onChange = (key, newValue, oldValue) => { + const onChange = (key, newValue) => { settings.set(key, newValue); - data.scrollTop = sx; - data.scrollLeft = sy; + scrollState.restore(data); } const onKeyBindingChange = (key, oldValue) => { @@ -457,7 +461,7 @@ settings._renderrer = (() => { const value = _settings[k]; switch (k) { case opts._VERSION: - _option(data).withName('Format version').add(value).build(); + _option(data).withName('Options format version').add(value).build(); break; case opts.LOG_LEVEL: _option(data).withName('Log level') @@ -474,8 +478,9 @@ settings._renderrer = (() => { .build(); break; case opts.MIRROR_SCREEN: - _option(data).withName('Video mirroring without smooth') - .add(gui.select(k, onChange, {values: ['mirror']}, value)) + _option(data).withName('Video mirroring') + .add(gui.select(k, onChange, {values: ['mirror'], labels: []}, value)) + .withDescription('Disables video image smoothing by rendering the video on a canvas (much more demanding on the CPU/GPU)') .build(); break; case opts.VOLUME: @@ -488,9 +493,25 @@ settings._renderrer = (() => { _option(data).withName(k).add(value).build(); } } + + data.append( + gui.create('br'), + gui.create('div', (el) => { + el.classList.add('settings__info', 'restart-needed-asterisk-b'); + el.innerText = ' -- applied after page reload' + }), + gui.create('div', (el) => { + el.classList.add('settings__info'); + el.innerText = `Options format version: ${_settings?._version}`; + }) + ); } return { render, + set data(el) { + data = el; + scrollState.track(el) + } } -})(document, log, opts, settings); +})(document, gui, log, opts, settings); diff --git a/web/js/workerManager.js b/web/js/workerManager.js index 56f463e4..3d119b2a 100644 --- a/web/js/workerManager.js +++ b/web/js/workerManager.js @@ -7,19 +7,13 @@ const workerManager = (() => { _class = 'server-list', trigger = document.getElementById('w'), panel = gui.panel(document.getElementById(id), 'WORKERS', 'server-list', null, [ - { - caption: '⟳', - cl: ['bold'], - handler: utils.debounce(handleReload, 1000), - title: 'Reload server data', - } - ], - // hack not transparent jpeg corners :_; - ((br) => (state, el) => { - state ? el.parentElement.style.borderRadius = '0px' : - br ? el.parentElement.style.borderRadius = br : - br = window.getComputedStyle(el.parentElement).borderRadius - })()), + { + caption: '⟳', + cl: ['bold'], + handler: utils.debounce(handleReload, 1000), + title: 'Reload server data', + } + ]), index = ((i = 1) => ({v: () => i++, r: () => i = 1}))(), // caption -- the field caption // renderer -- an arbitrary DOM output for the field @@ -117,7 +111,7 @@ const workerManager = (() => { if (server.room) { return gui.create('a', (el) => { el.innerText = state; - el.href = "/?id="+server.room; + el.href = "/?id=" + server.room; }) } return state From cf5248ec54697cbabe755bec09d7fc791c607be9 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 14 Mar 2024 00:36:53 +0300 Subject: [PATCH 187/361] Fix missing gameList transition handler --- web/index.html | 2 +- web/js/gameList.js | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/web/index.html b/web/index.html index 2953032d..e710272f 100644 --- a/web/index.html +++ b/web/index.html @@ -112,7 +112,7 @@ - + diff --git a/web/js/gameList.js b/web/js/gameList.js index 9b10b32a..74338a3e 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -88,7 +88,7 @@ const gameList = (() => { let onTransitionEnd = () => ({}) - rootEl.addEventListener('transitionend', () => onTransitionEnd()) + //rootEl.addEventListener('transitionend', () => onTransitionEnd()) let items = [] From a349fdd0cf99036b45d925e2a0805ddb8756cb25 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Thu, 14 Mar 2024 01:21:13 +0300 Subject: [PATCH 188/361] Add 'force full-screen' option --- web/css/ui.css | 12 ++++++++++-- web/index.html | 14 +++++++------- web/js/controller.js | 1 + web/js/env.js | 3 +-- web/js/gui/gui.js | 31 +++++++++++++++++++++++++++++++ web/js/settings/opts.js | 3 ++- web/js/settings/settings.js | 12 ++++++++++-- web/js/stream/stream.js | 16 +++++++++++++++- 8 files changed, 77 insertions(+), 15 deletions(-) diff --git a/web/css/ui.css b/web/css/ui.css index 1a2d05fd..ce3cfd27 100644 --- a/web/css/ui.css +++ b/web/css/ui.css @@ -74,10 +74,13 @@ .settings__option-value select, .settings__option-value input { font-family: '6809', monospace; - width: 6em; font-size: 90%; } +.settings__option-value input:not([type='checkbox']) { + width: 6em; +} + .settings__option-value option { font-size: 150%; } @@ -88,10 +91,15 @@ .keyboard-bindings .settings__option-value { display: grid; - grid-template-columns: 25% 25% auto auto; + grid-template-columns: 20% 20% 20% 20% auto; row-gap: 5px; } +.settings__option-checkbox label { + display: inline-flex; + align-items: center; +} + .binding-element { display: flex; flex-direction: column; diff --git a/web/index.html b/web/index.html index e710272f..068279c6 100644 --- a/web/index.html +++ b/web/index.html @@ -16,7 +16,7 @@ - + Cloud Retro @@ -102,18 +102,18 @@
    69ff8ae @@ -116,7 +102,7 @@
    - + - - - + + + - + @@ -122,7 +122,7 @@ - + diff --git a/web/js/controller.js b/web/js/controller.js index cd57844a..e85733a0 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -138,6 +138,7 @@ input.poll.disable(); gui.hide(menuScreen); stream.toggle(true); + stream.forceFullscreenMaybe(); gui.show(keyButtons[KEY.SAVE]); gui.show(keyButtons[KEY.LOAD]); // end clear diff --git a/web/js/env.js b/web/js/env.js index 0a6ddb80..a8f79ebd 100644 --- a/web/js/env.js +++ b/web/js/env.js @@ -108,8 +108,7 @@ const env = (() => { return { getOs: getOS, getBrowser: getBrowser, - // Check mobile type because different mobile can accept different video encoder. - isMobileDevice: () => (typeof window.orientation !== 'undefined') || (navigator.userAgent.indexOf('IEMobile') !== -1), + isMobileDevice: () => /Mobi|Android|iPhone/i.test(navigator.userAgent), display: () => ({ isPortrait: isPortrait, toggleFullscreen: toggleFullscreen, diff --git a/web/js/gui/gui.js b/web/js/gui/gui.js index 239affde..b58ca0a3 100644 --- a/web/js/gui/gui.js +++ b/web/js/gui/gui.js @@ -42,6 +42,36 @@ const gui = (() => { return el; } + const checkbox = (id, cb = () => ({}), checked = false, label = '', cc = '') => { + const el = _create(); + cc !== '' && el.classList.add(cc); + + let parent = el; + + if (label) { + const _label = _create('label', (el) => { + el.setAttribute('htmlFor', id); + }) + _label.innerText = label; + el.append(_label) + parent = _label; + } + + const input = _create('input', (el) => { + el.setAttribute('id', id); + el.setAttribute('name', id); + el.setAttribute('type', 'checkbox'); + el.onclick = ((e) => { + checked = e.target.checked + cb(id, checked) + }) + checked && el.setAttribute('checked', ''); + }); + parent.prepend(input); + + return el; + } + const panel = (root, title = '', cc = '', content, buttons = [], onToggle) => { const state = { br: null, @@ -221,6 +251,7 @@ const gui = (() => { fadeInOut, }, binding, + checkbox, create: _create, fragment, hide, diff --git a/web/js/settings/opts.js b/web/js/settings/opts.js index b0b2b966..5e9fac03 100644 --- a/web/js/settings/opts.js +++ b/web/js/settings/opts.js @@ -11,5 +11,6 @@ const opts = Object.freeze({ LOG_LEVEL: 'log.level', INPUT_KEYBOARD_MAP: 'input.keyboard.map', MIRROR_SCREEN: 'mirror.screen', - VOLUME: 'volume' + VOLUME: 'volume', + FORCE_FULLSCREEN: 'force.fullscreen' }); diff --git a/web/js/settings/settings.js b/web/js/settings/settings.js index 01da6f1c..09e1cb7f 100644 --- a/web/js/settings/settings.js +++ b/web/js/settings/settings.js @@ -15,7 +15,7 @@ */ const settings = (() => { // internal structure version - const revision = 1.5; + const revision = 1.51; // default settings // keep them for revert to defaults option @@ -480,7 +480,7 @@ settings.renderer = (() => { case opts.MIRROR_SCREEN: _option(data).withName('Video mirroring') .add(gui.select(k, onChange, {values: ['mirror'], labels: []}, value)) - .withDescription('Disables video image smoothing by rendering the video on a canvas (much more demanding on the CPU/GPU)') + .withDescription('Disables video image smoothing by rendering the video on a canvas (much more demanding for browser)') .build(); break; case opts.VOLUME: @@ -489,6 +489,14 @@ settings.renderer = (() => { .restartNeeded() .build() break; + case opts.FORCE_FULLSCREEN: + _option(data).withName('Force fullscreen') + .withDescription( + 'Whether games should open in full-screen mode after starting up (excluding mobile devices)' + ) + .add(gui.checkbox(k, onChange, value, 'Enbabled', 'settings__option-checkbox')) + .build() + break; default: _option(data).withName(k).add(value).build(); } diff --git a/web/js/stream/stream.js b/web/js/stream/stream.js index c5dcf478..b0fb730d 100644 --- a/web/js/stream/stream.js +++ b/web/js/stream/stream.js @@ -12,6 +12,7 @@ const stream = (() => { poster: '/img/screen_loading.gif', mirrorMode: null, mirrorUpdateRate: 1 / 60, + forceFullscreen: true, }, state = { screen: screen, @@ -112,6 +113,12 @@ const stream = (() => { screen.classList.toggle('no-media-controls', make) } + const forceFullscreenMaybe = () => { + const touchMode = env.isMobileDevice(); + log.debug('touch check', touchMode) + !touchMode && options.forceFullscreen && toggleFullscreen(); + } + const useCustomScreen = (use) => { if (use) { if (screen.paused || screen.ended) return; @@ -158,14 +165,20 @@ const stream = (() => { const init = () => { options.mirrorMode = settings.loadOr(opts.MIRROR_SCREEN, 'none'); options.volume = settings.loadOr(opts.VOLUME, 50) / 100; + options.forceFullscreen = settings.loadOr(opts.FORCE_FULLSCREEN, false); } event.sub(SETTINGS_CHANGED, () => { - const newValue = settings.get()[opts.MIRROR_SCREEN]; + const s = settings.get(); + const newValue = s[opts.MIRROR_SCREEN]; if (newValue !== options.mirrorMode) { useCustomScreen(newValue === 'mirror'); options.mirrorMode = newValue; } + const newValue2 = s[opts.FORCE_FULLSCREEN]; + if (newValue2 !== options.forceFullscreen) { + options.forceFullscreen = newValue2; + } }); @@ -196,6 +209,7 @@ const stream = (() => { play: stream, toggle, useCustomScreen, + forceFullscreenMaybe, init } } From 29eedee3ec4ab177a37c31ef5ba86960accd5f6a Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Fri, 15 Mar 2024 14:38:30 +0300 Subject: [PATCH 189/361] Fix keybindings for options --- web/index.html | 8 ++++---- web/js/controller.js | 6 +----- web/js/event/event.js | 1 - web/js/gui/gui.js | 3 ++- web/js/settings/settings.js | 31 +++++++++++++++++++------------ 5 files changed, 26 insertions(+), 23 deletions(-) diff --git a/web/index.html b/web/index.html index 068279c6..8ca2df5f 100644 --- a/web/index.html +++ b/web/index.html @@ -104,12 +104,12 @@ - + - + - + @@ -122,7 +122,7 @@ - + diff --git a/web/js/controller.js b/web/js/controller.js index e85733a0..3b7d7dc5 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -303,8 +303,7 @@ name: 'settings', keyRelease: key => { if (key === KEY.SETTINGS) { - const isSettingsOpened = settings.ui.toggle(); - if (!isSettingsOpened) setState(lastState); + !settings.ui.toggle() && setState(lastState) } }, menuReady: showMenuScreen @@ -452,9 +451,6 @@ event.sub(KEY_PRESSED, onKeyPress); event.sub(KEY_RELEASED, onKeyRelease); event.sub(SETTINGS_CHANGED, () => message.show('Settings have been updated')); - event.sub(SETTINGS_CLOSED, () => { - state.keyRelease(KEY.SETTINGS); - }); event.sub(AXIS_CHANGED, onAxisChanged); event.sub(CONTROLLER_UPDATED, data => webrtc.input(data)); // recording diff --git a/web/js/event/event.js b/web/js/event/event.js index 3c412d20..301e731b 100644 --- a/web/js/event/event.js +++ b/web/js/event/event.js @@ -97,7 +97,6 @@ const STATS_TOGGLE = 'statsToggle'; const HELP_OVERLAY_TOGGLED = 'helpOverlayToggled'; const SETTINGS_CHANGED = 'settingsChanged'; -const SETTINGS_CLOSED = 'settingsClosed'; const RECORDING_TOGGLED = 'recordingToggle' const RECORDING_STATUS_CHANGED = 'recordingStatusChanged' diff --git a/web/js/gui/gui.js b/web/js/gui/gui.js index b58ca0a3..95b4ee13 100644 --- a/web/js/gui/gui.js +++ b/web/js/gui/gui.js @@ -131,7 +131,7 @@ const gui = (() => { _title.innerText = state.loading ? `${state.title}...` : state.title; } - function toggle(show) { + function toggle(show = true) { state.shown = show; // hack not transparent jpeg corners :_; @@ -142,6 +142,7 @@ const gui = (() => { onToggle && onToggle(state.shown, _root) state.shown ? gui.show(_root) : gui.hide(_root) + return state.shown; } return { diff --git a/web/js/settings/settings.js b/web/js/settings/settings.js index 09e1cb7f..5fed80af 100644 --- a/web/js/settings/settings.js +++ b/web/js/settings/settings.js @@ -244,6 +244,13 @@ const settings = (() => { provider.remove(key, subKey); } + + const _render = () => { + _renderer.data = panel.contentEl; + _renderer.render() + } + + const panel = gui.panel(document.getElementById('settings'), '> OPTIONS', 'settings', null, [ {caption: 'Export', handler: () => _export(), title: 'Save',}, {caption: 'Import', handler: () => _fileReader.read(onFileLoad), title: 'Load',}, @@ -259,25 +266,25 @@ const settings = (() => { }, {} ], - (state) => { - if (state) return; + (show) => { + if (show) { + _render(); + return; + } - event.pub(SETTINGS_CLOSED); // to make sure it's disabled, but it's a tad verbose event.pub(KEYBOARD_TOGGLE_FILTER_MODE, {mode: true}); }) panel.toggle(false); - const _render = () => { - _renderer.data = panel.contentEl; - _renderer.render() - } - - const toggle = () => { - panel.toggle(true); - _render() - } + const toggle = (() => { + let x = false; + return () => { + x = !x; + panel.toggle(x); + } + })(); function _getType(value) { if (value === undefined) return option.undefined From 47bd72e1cd03525112b7f22dc6e7ee761ee33353 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sat, 16 Mar 2024 13:15:05 +0300 Subject: [PATCH 190/361] Fix broken options button --- web/index.html | 6 +++--- web/js/controller.js | 9 ++++----- web/js/gui/gui.js | 30 ++++++++++++++++-------------- web/js/settings/settings.js | 17 +++++------------ 4 files changed, 28 insertions(+), 34 deletions(-) diff --git a/web/index.html b/web/index.html index 8ca2df5f..2446207e 100644 --- a/web/index.html +++ b/web/index.html @@ -104,12 +104,12 @@ - + - + @@ -122,7 +122,7 @@ - + diff --git a/web/js/controller.js b/web/js/controller.js index 3b7d7dc5..d0e336e7 100644 --- a/web/js/controller.js +++ b/web/js/controller.js @@ -301,11 +301,10 @@ ..._default, _uber: true, name: 'settings', - keyRelease: key => { - if (key === KEY.SETTINGS) { - !settings.ui.toggle() && setState(lastState) - } - }, + keyRelease: (() => { + settings.ui.onToggle = (o) => !o && setState(lastState); + return (key) => key === KEY.SETTINGS && settings.ui.toggle() + })(), menuReady: showMenuScreen }, diff --git a/web/js/gui/gui.js b/web/js/gui/gui.js index 95b4ee13..c63a4b89 100644 --- a/web/js/gui/gui.js +++ b/web/js/gui/gui.js @@ -74,14 +74,18 @@ const gui = (() => { const panel = (root, title = '', cc = '', content, buttons = [], onToggle) => { const state = { - br: null, shown: false, loading: false, title: title, } + const tHandlers = []; + onToggle && tHandlers.push(onToggle); + const _root = root || _create('div'); _root.classList.add('panel'); + gui.hide(_root); + const header = _create('div', (el) => el.classList.add('panel__header')); const _content = _create('div', (el) => { if (cc) { @@ -131,23 +135,21 @@ const gui = (() => { _title.innerText = state.loading ? `${state.title}...` : state.title; } - function toggle(show = true) { - state.shown = show; - - // hack not transparent jpeg corners :_; - show ? _root.parentElement.style.borderRadius = '0px' : - state.br ? _root.parentElement.style.borderRadius = state.br : - state.br = window.getComputedStyle(_root.parentElement).borderRadius - - onToggle && onToggle(state.shown, _root) - - state.shown ? gui.show(_root) : gui.hide(_root) - return state.shown; - } + const toggle = (() => { + let br = window.getComputedStyle(_root.parentElement).borderRadius; + return (force) => { + state.shown = force !== undefined ? force : !state.shown; + // hack for not transparent jpeg corners :_; + _root.parentElement.style.borderRadius = state.shown ? '0px' : br; + tHandlers.forEach(h => h?.(state.shown, _root)); + state.shown ? gui.show(_root) : gui.hide(_root) + } + })() return { contentEl: _content, isHidden: () => !state.shown, + onToggle: (fn) => tHandlers.push(fn), setContent, setLoad, toggle, diff --git a/web/js/settings/settings.js b/web/js/settings/settings.js index 5fed80af..76c20c33 100644 --- a/web/js/settings/settings.js +++ b/web/js/settings/settings.js @@ -276,16 +276,6 @@ const settings = (() => { event.pub(KEYBOARD_TOGGLE_FILTER_MODE, {mode: true}); }) - panel.toggle(false); - - const toggle = (() => { - let x = false; - return () => { - x = !x; - panel.toggle(x); - } - })(); - function _getType(value) { if (value === undefined) return option.undefined else if (Array.isArray(value)) return option.list @@ -334,7 +324,10 @@ const settings = (() => { import: _import, export: _export, ui: { - toggle, + set onToggle(fn) { + panel.onToggle(fn); + }, + toggle: () => panel.toggle(), }, set renderer(fn) { _renderer = fn; @@ -501,7 +494,7 @@ settings.renderer = (() => { .withDescription( 'Whether games should open in full-screen mode after starting up (excluding mobile devices)' ) - .add(gui.checkbox(k, onChange, value, 'Enbabled', 'settings__option-checkbox')) + .add(gui.checkbox(k, onChange, value, 'Enabled', 'settings__option-checkbox')) .build() break; default: From 2aaf37b7667da0f41fef0c61ff5454d295e6f09c Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 17 Mar 2024 16:35:58 +0300 Subject: [PATCH 191/361] Add Cache-Control for serving static files Static files will be rechecked every 3 days instead of unlimited cache time. The Cache-Control header is mandatory in order to make browsers handle cache properly with Go's FileServer. The option can be modified in the server.CacheControl line of the config file. --- pkg/config/config.yaml | 1 + pkg/config/shared.go | 7 ++++--- pkg/coordinator/coordinator.go | 6 ++++++ 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/pkg/config/config.yaml b/pkg/config/config.yaml index 39b695ea..57cb39de 100644 --- a/pkg/config/config.yaml +++ b/pkg/config/config.yaml @@ -59,6 +59,7 @@ coordinator: # HTTP(S) server config server: address: :8000 + cacheControl: "max-age=259200, must-revalidate" https: false # Letsencrypt or self cert config tls: diff --git a/pkg/config/shared.go b/pkg/config/shared.go index 026b79d3..ae99d289 100644 --- a/pkg/config/shared.go +++ b/pkg/config/shared.go @@ -30,9 +30,10 @@ type Monitoring struct { func (c *Monitoring) IsEnabled() bool { return c.MetricEnabled || c.ProfilingEnabled } type Server struct { - Address string - Https bool - Tls struct { + Address string + CacheControl string + Https bool + Tls struct { Address string Domain string HttpsKey string diff --git a/pkg/coordinator/coordinator.go b/pkg/coordinator/coordinator.go index bdb21067..cb80b739 100644 --- a/pkg/coordinator/coordinator.go +++ b/pkg/coordinator/coordinator.go @@ -92,6 +92,9 @@ func index(conf config.CoordinatorConfig, log *logger.Logger) httpx.Handler { if conf.Coordinator.Debug { log.Info().Msgf("Using auto-reloading index.html") return httpx.HandlerFunc(func(w httpx.ResponseWriter, r *httpx.Request) { + if conf.Coordinator.Server.CacheControl != "" { + w.Header().Add("Cache-Control", conf.Coordinator.Server.CacheControl) + } if r.URL.Path == "/" || strings.HasSuffix(r.URL.Path, "/index.html") { tpl := template.Must(template.ParseFiles(indexHTML)) handler(tpl, w, r) @@ -102,6 +105,9 @@ func index(conf config.CoordinatorConfig, log *logger.Logger) httpx.Handler { } return httpx.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + if conf.Coordinator.Server.CacheControl != "" { + w.Header().Add("Cache-Control", conf.Coordinator.Server.CacheControl) + } if r.URL.Path == "/" || strings.HasSuffix(r.URL.Path, "/index.html") { handler(indexTpl, w, r) return From 2bc64a3be827993b9be4b9c6b23faedcb7fab7da Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 17 Mar 2024 17:24:00 +0300 Subject: [PATCH 192/361] Migrate from IIFE to modern ES modules These modules should be supported by all contemporary browsers, and this transition should resolve most issues related to the explicit import order of the .js files. --- web/index.html | 47 ++- web/js/api.js | 70 +++++ web/js/api/api.js | 68 ---- web/js/app.js | 541 ++++++++++++++++++++++++++++++++ web/js/controller.js | 468 ---------------------------- web/js/env.js | 212 +++++++------ web/js/event.js | 100 ++++++ web/js/event/event.js | 104 ------- web/js/gameList.js | 458 +++++++++++++-------------- web/js/gui.js | 259 ++++++++++++++++ web/js/gui/gui.js | 267 ---------------- web/js/gui/message.js | 46 --- web/js/init.js | 26 -- web/js/input/input.js | 119 +------ web/js/input/joystick.js | 524 ++++++++++++++++--------------- web/js/input/keyboard.js | 261 ++++++++-------- web/js/input/keys.js | 66 ++-- web/js/input/retropad.js | 98 ++++++ web/js/input/touch.js | 604 ++++++++++++++++++------------------ web/js/log.js | 60 ++-- web/js/message.js | 44 +++ web/js/network/ajax.js | 43 ++- web/js/network/network.js | 3 + web/js/network/socket.js | 94 +++--- web/js/network/webrtc.js | 321 ++++++++++--------- web/js/recording.js | 112 +++---- web/js/room.js | 141 +++++---- web/js/settings.js | 537 ++++++++++++++++++++++++++++++++ web/js/settings/opts.js | 16 - web/js/settings/settings.js | 525 ------------------------------- web/js/stats.js | 440 ++++++++++++++++++++++++++ web/js/stats/stats.js | 433 -------------------------- web/js/stream.js | 222 +++++++++++++ web/js/stream/stream.js | 216 ------------- web/js/utils.js | 84 +++-- web/js/workerManager.js | 273 ++++++++-------- 36 files changed, 3984 insertions(+), 3918 deletions(-) create mode 100644 web/js/api.js delete mode 100644 web/js/api/api.js create mode 100644 web/js/app.js delete mode 100644 web/js/controller.js create mode 100644 web/js/event.js delete mode 100644 web/js/event/event.js create mode 100644 web/js/gui.js delete mode 100644 web/js/gui/gui.js delete mode 100644 web/js/gui/message.js delete mode 100644 web/js/init.js create mode 100644 web/js/input/retropad.js create mode 100644 web/js/message.js create mode 100644 web/js/network/network.js create mode 100644 web/js/settings.js delete mode 100644 web/js/settings/opts.js delete mode 100644 web/js/settings/settings.js create mode 100644 web/js/stats.js delete mode 100644 web/js/stats/stats.js create mode 100644 web/js/stream.js delete mode 100644 web/js/stream/stream.js diff --git a/web/index.html b/web/index.html index 2446207e..61f24f13 100644 --- a/web/index.html +++ b/web/index.html @@ -15,7 +15,7 @@ - + Cloud Retro @@ -49,7 +49,9 @@
    - Arrows (move), ZXCVAS;'./ (game ABXYL1-L3R1-R3), 1/2 (1st/2nd player), Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy the link to the clipboard) + Arrows (move), ZXCVAS;'./ (game ABXYL1-L3R1-R3), 1/2 (1st/2nd player), + Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy the link to the + clipboard)
    @@ -102,32 +104,23 @@
    - - - - - - - - - - - - - - - - - - - - - - - - + - + {{if .Analytics.Inject}} diff --git a/web/js/api.js b/web/js/api.js new file mode 100644 index 00000000..6b93264b --- /dev/null +++ b/web/js/api.js @@ -0,0 +1,70 @@ +import {log} from 'log'; + +const endpoints = { + LATENCY_CHECK: 3, + INIT: 4, + INIT_WEBRTC: 100, + OFFER: 101, + ANSWER: 102, + ICE_CANDIDATE: 103, + GAME_START: 104, + GAME_QUIT: 105, + GAME_SAVE: 106, + GAME_LOAD: 107, + GAME_SET_PLAYER_INDEX: 108, + GAME_RECORDING: 110, + GET_WORKER_LIST: 111, + GAME_ERROR_NO_FREE_SLOTS: 112, + + APP_VIDEO_CHANGE: 150, +} + +/** + * Server API. + * + * Requires the actual api.transport implementation. + */ +export const api = { + set transport(t) { + transport = t; + }, + endpoint: endpoints, + decode: (b) => JSON.parse(decodeBytes(b)), + server: { + initWebrtc: () => packet(endpoints.INIT_WEBRTC), + sendIceCandidate: (candidate) => packet(endpoints.ICE_CANDIDATE, btoa(JSON.stringify(candidate))), + sendSdp: (sdp) => packet(endpoints.ANSWER, btoa(JSON.stringify(sdp))), + latencyCheck: (id, list) => packet(endpoints.LATENCY_CHECK, list, id), + getWorkerList: () => packet(endpoints.GET_WORKER_LIST), + }, + game: { + load: () => packet(endpoints.GAME_LOAD), + save: () => packet(endpoints.GAME_SAVE), + setPlayerIndex: (i) => packet(endpoints.GAME_SET_PLAYER_INDEX, i), + start: (game, roomId, record, recordUser, player) => packet(endpoints.GAME_START, { + game_name: game, + room_id: roomId, + player_index: player, + record: record, + record_user: recordUser, + }), + toggleRecording: (active = false, userName = '') => + packet(endpoints.GAME_RECORDING, {active: active, user: userName}), + quit: (roomId) => packet(endpoints.GAME_QUIT, {room_id: roomId}), + } +} + +let transport = { + send: (packet) => { + log.warn('Default transport is used! Change it with the api.transport variable.', packet) + } +} + +const packet = (type, payload, id) => { + const packet = {t: type}; + if (id !== undefined) packet.id = id; + if (payload !== undefined) packet.p = payload; + transport.send(packet); +} + +const decodeBytes = (b) => String.fromCharCode.apply(null, new Uint8Array(b)) diff --git a/web/js/api/api.js b/web/js/api/api.js deleted file mode 100644 index ad9c1322..00000000 --- a/web/js/api/api.js +++ /dev/null @@ -1,68 +0,0 @@ -/** - * Server API. - * - * @version 1 - * - */ -const api = (() => { - const endpoints = Object.freeze({ - LATENCY_CHECK: 3, - INIT: 4, - INIT_WEBRTC: 100, - OFFER: 101, - ANSWER: 102, - ICE_CANDIDATE: 103, - GAME_START: 104, - GAME_QUIT: 105, - GAME_SAVE: 106, - GAME_LOAD: 107, - GAME_SET_PLAYER_INDEX: 108, - GAME_RECORDING: 110, - GET_WORKER_LIST: 111, - GAME_ERROR_NO_FREE_SLOTS: 112, - - APP_VIDEO_CHANGE: 150, - }); - - const packet = (type, payload, id) => { - const packet = {t: type}; - if (id !== undefined) packet.id = id; - if (payload !== undefined) packet.p = payload; - - socket.send(packet); - }; - - const decodeBytes = (b) => String.fromCharCode.apply(null, new Uint8Array(b)) - - return Object.freeze({ - endpoint: endpoints, - decode: (b) => JSON.parse(decodeBytes(b)), - server: - { - initWebrtc: () => packet(endpoints.INIT_WEBRTC), - sendIceCandidate: (candidate) => packet(endpoints.ICE_CANDIDATE, btoa(JSON.stringify(candidate))), - sendSdp: (sdp) => packet(endpoints.ANSWER, btoa(JSON.stringify(sdp))), - latencyCheck: (id, list) => packet(endpoints.LATENCY_CHECK, list, id), - getWorkerList: () => packet(endpoints.GET_WORKER_LIST), - }, - game: - { - load: () => packet(endpoints.GAME_LOAD), - save: () => packet(endpoints.GAME_SAVE), - setPlayerIndex: (i) => packet(endpoints.GAME_SET_PLAYER_INDEX, i), - start: (game, roomId, record, recordUser, player) => packet(endpoints.GAME_START, { - game_name: game, - room_id: roomId, - player_index: player, - record: record, - record_user: recordUser, - }), - toggleRecording: (active = false, userName = '') => - packet(endpoints.GAME_RECORDING, { - active: active, - user: userName, - }), - quit: (roomId) => packet(endpoints.GAME_QUIT, {room_id: roomId}), - } - }) -})(socket); diff --git a/web/js/app.js b/web/js/app.js new file mode 100644 index 00000000..5e951d26 --- /dev/null +++ b/web/js/app.js @@ -0,0 +1,541 @@ +import {api} from 'api'; +import { + pub, + sub, + APP_VIDEO_CHANGED, + AXIS_CHANGED, + CONTROLLER_UPDATED, + DPAD_TOGGLE, + GAME_ERROR_NO_FREE_SLOTS, + GAME_LOADED, + GAME_PLAYER_IDX, + GAME_PLAYER_IDX_SET, + GAME_ROOM_AVAILABLE, + GAME_SAVED, + GAMEPAD_CONNECTED, + GAMEPAD_DISCONNECTED, + HELP_OVERLAY_TOGGLED, + KEY_PRESSED, + KEY_RELEASED, + LATENCY_CHECK_REQUESTED, + MENU_HANDLER_ATTACHED, + MESSAGE, + RECORDING_STATUS_CHANGED, + RECORDING_TOGGLED, + SETTINGS_CHANGED, + STATS_TOGGLE, + WEBRTC_CONNECTION_CLOSED, + WEBRTC_CONNECTION_READY, + WEBRTC_ICE_CANDIDATE_FOUND, + WEBRTC_ICE_CANDIDATE_RECEIVED, + WEBRTC_ICE_CANDIDATES_FLUSH, + WEBRTC_NEW_CONNECTION, + WEBRTC_SDP_ANSWER, + WEBRTC_SDP_OFFER, + WORKER_LIST_FETCHED +} from 'event'; +import {gui} from 'gui'; +import {keyboard, KEY, joystick, retropad, touch} from 'input'; +import {log} from 'log'; +import {opts, settings} from 'settings'; +import {socket, webrtc} from 'network'; +import {debounce} from 'utils'; + +import {gameList} from './gameList.js?v=3'; +import {message} from './message.js?v=3'; +import {recording} from './recording.js?v=3'; +import {room} from './room.js?v=3'; +import {stats} from './stats.js?v=3'; +import {stream} from './stream.js?v=3'; +import {workerManager} from "./workerManager.js?v=3"; + +// application state +let state; +let lastState; + +// first user interaction +let interacted = false; + +const menuScreen = document.getElementById('menu-screen'); +const helpOverlay = document.getElementById('help-overlay'); +const playerIndex = document.getElementById('playeridx'); + +// keymap +const keyButtons = {}; +Object.keys(KEY).forEach(button => { + keyButtons[KEY[button]] = document.getElementById(`btn-${KEY[button]}`); +}); + +/** + * State machine transition. + * @param newState A new state strictly from app.state.* + * @example + * setState(app.state.eden) + */ +const setState = (newState = app.state.eden) => { + if (newState === state) return; + + const prevState = state; + + // keep the current state intact for one of the "uber" states + if (state && state._uber) { + // if we are done with the uber state + if (lastState === newState) state = newState; + lastState = newState; + } else { + lastState = state + state = newState; + } + + if (log.level === log.DEBUG) { + const previous = prevState ? prevState.name : '???'; + const current = state ? state.name : '???'; + const kept = lastState ? lastState.name : '???'; + + log.debug(`[state] ${previous} -> ${current} [${kept}]`); + } +}; + +const onGameRoomAvailable = () => { + // room is ready +}; + +const onConnectionReady = () => { + // start a game right away or show the menu + if (room.getId()) { + startGame(); + } else { + state.menuReady(); + } +}; + +const onLatencyCheck = async (data) => { + message.show('Connecting to fastest server...'); + const servers = await workerManager.checkLatencies(data); + const latencies = Object.assign({}, ...servers); + log.info('[ping] <->', latencies); + api.server.latencyCheck(data.packetId, latencies); +}; + +const helpScreen = { + // don't call $ if holding the button + shown: false, + // use function () if you need "this" + show: function (show, event) { + if (this.shown === show) return; + + const isGameScreen = state === app.state.game + if (isGameScreen) { + stream.toggle(!show); + } else { + gui.toggle(menuScreen, !show); + } + + gui.toggle(keyButtons[KEY.SAVE], show || isGameScreen); + gui.toggle(keyButtons[KEY.LOAD], show || isGameScreen); + + gui.toggle(helpOverlay, show) + + this.shown = show; + + if (event) pub(HELP_OVERLAY_TOGGLED, {shown: show}); + } +}; + +const showMenuScreen = () => { + log.debug('[control] loading menu screen'); + + stream.toggle(false); + gui.hide(keyButtons[KEY.SAVE]); + gui.hide(keyButtons[KEY.LOAD]); + + gameList.show(); + gui.show(menuScreen); + + setState(app.state.menu); +}; + +const startGame = () => { + if (!webrtc.isConnected()) { + message.show('Game cannot load. Please refresh'); + return; + } + + if (!webrtc.isInputReady()) { + message.show('Game is not ready yet. Please wait'); + return; + } + + log.info('[control] game start'); + + setState(app.state.game); + + stream.play() + + api.game.start( + gameList.selected, + room.getId(), + recording.isActive(), + recording.getUser(), + +playerIndex.value - 1, + ); + + // clear menu screen + retropad.poll.disable(); + gui.hide(menuScreen); + stream.toggle(true); + stream.forceFullscreenMaybe(); + gui.show(keyButtons[KEY.SAVE]); + gui.show(keyButtons[KEY.LOAD]); + // end clear + retropad.poll.enable(); +}; + +const saveGame = debounce(() => api.game.save(), 1000); +const loadGame = debounce(() => api.game.load(), 1000); + +const onMessage = (m) => { + const {id, t, p: payload} = m; + switch (t) { + case api.endpoint.INIT: + pub(WEBRTC_NEW_CONNECTION, payload); + break; + case api.endpoint.OFFER: + pub(WEBRTC_SDP_OFFER, {sdp: payload}); + break; + case api.endpoint.ICE_CANDIDATE: + pub(WEBRTC_ICE_CANDIDATE_RECEIVED, {candidate: payload}); + break; + case api.endpoint.GAME_START: + if (payload.av) { + pub(APP_VIDEO_CHANGED, payload.av) + } + pub(GAME_ROOM_AVAILABLE, {roomId: payload.roomId}); + break; + case api.endpoint.GAME_SAVE: + pub(GAME_SAVED); + break; + case api.endpoint.GAME_LOAD: + pub(GAME_LOADED); + break; + case api.endpoint.GAME_SET_PLAYER_INDEX: + pub(GAME_PLAYER_IDX_SET, payload); + break; + case api.endpoint.GET_WORKER_LIST: + pub(WORKER_LIST_FETCHED, payload); + break; + case api.endpoint.LATENCY_CHECK: + pub(LATENCY_CHECK_REQUESTED, {packetId: id, addresses: payload}); + break; + case api.endpoint.GAME_RECORDING: + pub(RECORDING_STATUS_CHANGED, payload); + break; + case api.endpoint.GAME_ERROR_NO_FREE_SLOTS: + pub(GAME_ERROR_NO_FREE_SLOTS); + break; + case api.endpoint.APP_VIDEO_CHANGE: + pub(APP_VIDEO_CHANGED, {...payload}) + break; + } +} + +const _dpadArrowKeys = [KEY.UP, KEY.DOWN, KEY.LEFT, KEY.RIGHT]; + +// pre-state key press handler +const onKeyPress = (data) => { + const button = keyButtons[data.key]; + + if (_dpadArrowKeys.includes(data.key)) { + button.classList.add('dpad-pressed'); + } else { + if (button) button.classList.add('pressed'); + } + + if (state !== app.state.settings) { + if (KEY.HELP === data.key) helpScreen.show(true, event); + } + + state.keyPress(data.key); +}; + +// pre-state key release handler +const onKeyRelease = data => { + const button = keyButtons[data.key]; + + if (_dpadArrowKeys.includes(data.key)) { + button.classList.remove('dpad-pressed'); + } else { + if (button) button.classList.remove('pressed'); + } + + if (state !== app.state.settings) { + if (KEY.HELP === data.key) helpScreen.show(false, event); + } + + // maybe move it somewhere + if (!interacted) { + // unmute when there is user interaction + stream.audio.mute(false); + interacted = true; + } + + // change app state if settings + if (KEY.SETTINGS === data.key) setState(app.state.settings); + + state.keyRelease(data.key); +}; + +const updatePlayerIndex = (idx, not_game = false) => { + playerIndex.value = idx + 1; + !not_game && api.game.setPlayerIndex(idx); +}; + +// noop function for the state +const _nil = () => ({/*_*/}) + +const onAxisChanged = (data) => { + // maybe move it somewhere + if (!interacted) { + // unmute when there is user interaction + stream.audio.mute(false); + interacted = true; + } + + state.axisChanged(data.id, data.value); +}; + +const handleToggle = () => { + const toggle = document.getElementById('dpad-toggle'); + toggle.checked = !toggle.checked; + pub(DPAD_TOGGLE, {checked: toggle.checked}); +}; + +const handleRecording = (data) => { + const {recording, userName} = data; + api.game.toggleRecording(recording, userName); +} + +const handleRecordingStatus = (data) => { + if (data === 'ok') { + message.show(`Recording ${recording.isActive() ? 'on' : 'off'}`) + if (recording.isActive()) { + recording.setIndicator(true) + } + } else { + message.show(`Recording failed ):`) + recording.setIndicator(false) + } + log.debug("recording is ", recording.isActive()) +} + +const _default = { + name: 'default', + axisChanged: _nil, + keyPress: _nil, + keyRelease: _nil, + menuReady: _nil, +} +const app = { + state: { + eden: { + ..._default, + name: 'eden', + menuReady: showMenuScreen + }, + + settings: { + ..._default, + _uber: true, + name: 'settings', + keyRelease: (() => { + settings.ui.onToggle = (o) => !o && setState(lastState); + return (key) => key === KEY.SETTINGS && settings.ui.toggle() + })(), + menuReady: showMenuScreen + }, + + menu: { + ..._default, + name: 'menu', + axisChanged: (id, val) => id === 1 && gameList.scroll(val < -.5 ? -1 : val > .5 ? 1 : 0), + keyPress: (key) => { + switch (key) { + case KEY.UP: + case KEY.DOWN: + gameList.scroll(key === KEY.UP ? -1 : 1) + break; + } + }, + keyRelease: (key) => { + switch (key) { + case KEY.UP: + case KEY.DOWN: + gameList.scroll(0); + break; + case KEY.JOIN: + case KEY.A: + case KEY.B: + case KEY.X: + case KEY.Y: + case KEY.START: + case KEY.SELECT: + startGame(); + break; + case KEY.QUIT: + message.show('You are already in menu screen!'); + break; + case KEY.LOAD: + message.show('Loading the game.'); + break; + case KEY.SAVE: + message.show('Saving the game.'); + break; + case KEY.STATS: + pub(STATS_TOGGLE); + break; + case KEY.SETTINGS: + break; + case KEY.DTOGGLE: + handleToggle(); + break; + } + }, + }, + + game: { + ..._default, + name: 'game', + axisChanged: (id, value) => retropad.setAxisChanged(id, value), + keyPress: key => retropad.setKeyState(key, true), + keyRelease: function (key) { + retropad.setKeyState(key, false); + + switch (key) { + case KEY.JOIN: // or SHARE + // save when click share + saveGame(); + room.copyToClipboard(); + message.show('Shared link copied to the clipboard!'); + break; + case KEY.SAVE: + saveGame(); + break; + case KEY.LOAD: + loadGame(); + break; + case KEY.FULL: + stream.video.toggleFullscreen(); + break; + case KEY.PAD1: + updatePlayerIndex(0); + break; + case KEY.PAD2: + updatePlayerIndex(1); + break; + case KEY.PAD3: + updatePlayerIndex(2); + break; + case KEY.PAD4: + updatePlayerIndex(3); + break; + case KEY.QUIT: + retropad.poll.disable(); + api.game.quit(room.getId()); + room.reset(); + window.location = window.location.pathname; + break; + case KEY.STATS: + pub(STATS_TOGGLE); + break; + case KEY.DTOGGLE: + handleToggle(); + break; + } + }, + } + } +}; + +// subscriptions +sub(MESSAGE, onMessage); + +sub(GAME_ROOM_AVAILABLE, onGameRoomAvailable, 2); +sub(GAME_SAVED, () => message.show('Saved')); +sub(GAME_LOADED, () => message.show('Loaded')); +sub(GAME_PLAYER_IDX, data => { + updatePlayerIndex(+data.index, state !== app.state.game); +}); +sub(GAME_PLAYER_IDX_SET, idx => { + if (!isNaN(+idx)) message.show(+idx + 1); +}); +sub(GAME_ERROR_NO_FREE_SLOTS, () => message.show("No free slots :(", 2500)); +sub(WEBRTC_NEW_CONNECTION, (data) => { + workerManager.whoami(data.wid); + webrtc.onData = (x) => onMessage(api.decode(x.data)) + webrtc.start(data.ice); + api.server.initWebrtc() + gameList.set(data.games); +}); +sub(WEBRTC_ICE_CANDIDATE_FOUND, (data) => api.server.sendIceCandidate(data.candidate)); +sub(WEBRTC_SDP_ANSWER, (data) => api.server.sendSdp(data.sdp)); +sub(WEBRTC_SDP_OFFER, (data) => webrtc.setRemoteDescription(data.sdp, stream.video.el())); +sub(WEBRTC_ICE_CANDIDATE_RECEIVED, (data) => webrtc.addCandidate(data.candidate)); +sub(WEBRTC_ICE_CANDIDATES_FLUSH, () => webrtc.flushCandidates()); +sub(WEBRTC_CONNECTION_READY, onConnectionReady); +sub(WEBRTC_CONNECTION_CLOSED, () => { + retropad.poll.disable(); + webrtc.stop(); +}); +sub(LATENCY_CHECK_REQUESTED, onLatencyCheck); +sub(GAMEPAD_CONNECTED, () => message.show('Gamepad connected')); +sub(GAMEPAD_DISCONNECTED, () => message.show('Gamepad disconnected')); +// touch stuff +sub(MENU_HANDLER_ATTACHED, (data) => { + menuScreen.addEventListener(data.event, data.handler, {passive: true}); +}); +sub(KEY_PRESSED, onKeyPress); +sub(KEY_RELEASED, onKeyRelease); +sub(SETTINGS_CHANGED, () => message.show('Settings have been updated')); +sub(AXIS_CHANGED, onAxisChanged); +sub(CONTROLLER_UPDATED, data => webrtc.input(data)); +// recording +sub(RECORDING_TOGGLED, handleRecording); +sub(RECORDING_STATUS_CHANGED, handleRecordingStatus); + +sub(SETTINGS_CHANGED, () => { + const newValue = settings.get()[opts.LOG_LEVEL]; + if (newValue !== log.level) { + log.level = newValue; + } +}); + +// initial app state +setState(app.state.eden); + +settings.init(); + +(() => { + let lvl = settings.loadOr(opts.LOG_LEVEL, log.DEFAULT); + // migrate old log level options + // !to remove at some point + if (isNaN(lvl)) { + console.warn( + `The log value [${lvl}] is not supported! ` + + `The default value [debug] will be used instead.`); + settings.set(opts.LOG_LEVEL, `${log.DEFAULT}`) + lvl = log.DEFAULT + } + log.level = lvl +})(); + +keyboard.init(); +joystick.init(); +touch.init(); +stream.init(); + +let [roomId, zone] = room.loadMaybe(); +// find worker id if present +const wid = new URLSearchParams(document.location.search).get('wid'); +// if from URL -> start game immediately! +socket.init(roomId, wid, zone); +api.transport = socket; diff --git a/web/js/controller.js b/web/js/controller.js deleted file mode 100644 index d0e336e7..00000000 --- a/web/js/controller.js +++ /dev/null @@ -1,468 +0,0 @@ -/** - * App controller module. - * @version 1 - */ -(() => { - // application state - let state; - let lastState; - - // first user interaction - let interacted = false; - - const menuScreen = document.getElementById('menu-screen'); - const helpOverlay = document.getElementById('help-overlay'); - const playerIndex = document.getElementById('playeridx'); - - // keymap - const keyButtons = {}; - Object.keys(KEY).forEach(button => { - keyButtons[KEY[button]] = document.getElementById(`btn-${KEY[button]}`); - }); - - /** - * State machine transition. - * @param newState A new state strictly from app.state.* - * @example - * setState(app.state.eden) - */ - const setState = (newState = app.state.eden) => { - if (newState === state) return; - - const prevState = state; - - // keep the current state intact for one of the "uber" states - if (state && state._uber) { - // if we are done with the uber state - if (lastState === newState) state = newState; - lastState = newState; - } else { - lastState = state - state = newState; - } - - if (log.level === log.DEBUG) { - const previous = prevState ? prevState.name : '???'; - const current = state ? state.name : '???'; - const kept = lastState ? lastState.name : '???'; - - log.debug(`[state] ${previous} -> ${current} [${kept}]`); - } - }; - - const onGameRoomAvailable = () => { - // room is ready - }; - - const onConnectionReady = () => { - // start a game right away or show the menu - if (room.getId()) { - startGame(); - } else { - state.menuReady(); - } - }; - - const onLatencyCheck = async (data) => { - message.show('Connecting to fastest server...'); - const servers = await workerManager.checkLatencies(data); - const latencies = Object.assign({}, ...servers); - log.info('[ping] <->', latencies); - api.server.latencyCheck(data.packetId, latencies); - }; - - const helpScreen = { - // don't call $ if holding the button - shown: false, - // use function () if you need "this" - show: function (show, event) { - if (this.shown === show) return; - - const isGameScreen = state === app.state.game - if (isGameScreen) { - stream.toggle(!show); - } else { - gui.toggle(menuScreen, !show); - } - - gui.toggle(keyButtons[KEY.SAVE], show || isGameScreen); - gui.toggle(keyButtons[KEY.LOAD], show || isGameScreen); - - gui.toggle(helpOverlay, show) - - this.shown = show; - - if (event) event.pub(HELP_OVERLAY_TOGGLED, {shown: show}); - } - }; - - const showMenuScreen = () => { - log.debug('[control] loading menu screen'); - - stream.toggle(false); - gui.hide(keyButtons[KEY.SAVE]); - gui.hide(keyButtons[KEY.LOAD]); - - gameList.show(); - gui.show(menuScreen); - - setState(app.state.menu); - }; - - const startGame = () => { - if (!webrtc.isConnected()) { - message.show('Game cannot load. Please refresh'); - return; - } - - if (!webrtc.isInputReady()) { - message.show('Game is not ready yet. Please wait'); - return; - } - - log.info('[control] game start'); - - setState(app.state.game); - - stream.play() - - api.game.start( - gameList.selected, - room.getId(), - recording.isActive(), - recording.getUser(), - +playerIndex.value - 1, - ); - - // clear menu screen - input.poll.disable(); - gui.hide(menuScreen); - stream.toggle(true); - stream.forceFullscreenMaybe(); - gui.show(keyButtons[KEY.SAVE]); - gui.show(keyButtons[KEY.LOAD]); - // end clear - input.poll.enable(); - }; - - const saveGame = utils.debounce(() => api.game.save(), 1000); - const loadGame = utils.debounce(() => api.game.load(), 1000); - - const onMessage = (m) => { - const {id, t, p: payload} = m; - switch (t) { - case api.endpoint.INIT: - event.pub(WEBRTC_NEW_CONNECTION, payload); - break; - case api.endpoint.OFFER: - event.pub(WEBRTC_SDP_OFFER, {sdp: payload}); - break; - case api.endpoint.ICE_CANDIDATE: - event.pub(WEBRTC_ICE_CANDIDATE_RECEIVED, {candidate: payload}); - break; - case api.endpoint.GAME_START: - if (payload.av) { - event.pub(APP_VIDEO_CHANGED, payload.av) - } - event.pub(GAME_ROOM_AVAILABLE, {roomId: payload.roomId}); - break; - case api.endpoint.GAME_SAVE: - event.pub(GAME_SAVED); - break; - case api.endpoint.GAME_LOAD: - event.pub(GAME_LOADED); - break; - case api.endpoint.GAME_SET_PLAYER_INDEX: - event.pub(GAME_PLAYER_IDX_SET, payload); - break; - case api.endpoint.GET_WORKER_LIST: - event.pub(WORKER_LIST_FETCHED, payload); - break; - case api.endpoint.LATENCY_CHECK: - event.pub(LATENCY_CHECK_REQUESTED, {packetId: id, addresses: payload}); - break; - case api.endpoint.GAME_RECORDING: - event.pub(RECORDING_STATUS_CHANGED, payload); - break; - case api.endpoint.GAME_ERROR_NO_FREE_SLOTS: - event.pub(GAME_ERROR_NO_FREE_SLOTS); - break; - case api.endpoint.APP_VIDEO_CHANGE: - event.pub(APP_VIDEO_CHANGED, {...payload}) - break; - } - } - - const _dpadArrowKeys = [KEY.UP, KEY.DOWN, KEY.LEFT, KEY.RIGHT]; - - // pre-state key press handler - const onKeyPress = (data) => { - const button = keyButtons[data.key]; - - if (_dpadArrowKeys.includes(data.key)) { - button.classList.add('dpad-pressed'); - } else { - if (button) button.classList.add('pressed'); - } - - if (state !== app.state.settings) { - if (KEY.HELP === data.key) helpScreen.show(true, event); - } - - state.keyPress(data.key); - }; - - // pre-state key release handler - const onKeyRelease = data => { - const button = keyButtons[data.key]; - - if (_dpadArrowKeys.includes(data.key)) { - button.classList.remove('dpad-pressed'); - } else { - if (button) button.classList.remove('pressed'); - } - - if (state !== app.state.settings) { - if (KEY.HELP === data.key) helpScreen.show(false, event); - } - - // maybe move it somewhere - if (!interacted) { - // unmute when there is user interaction - stream.audio.mute(false); - interacted = true; - } - - // change app state if settings - if (KEY.SETTINGS === data.key) setState(app.state.settings); - - state.keyRelease(data.key); - }; - - const updatePlayerIndex = (idx, not_game = false) => { - playerIndex.value = idx + 1; - !not_game && api.game.setPlayerIndex(idx); - }; - - // noop function for the state - const _nil = () => ({/*_*/}) - - const onAxisChanged = (data) => { - // maybe move it somewhere - if (!interacted) { - // unmute when there is user interaction - stream.audio.mute(false); - interacted = true; - } - - state.axisChanged(data.id, data.value); - }; - - const handleToggle = () => { - const toggle = document.getElementById('dpad-toggle'); - toggle.checked = !toggle.checked; - event.pub(DPAD_TOGGLE, {checked: toggle.checked}); - }; - - const handleRecording = (data) => { - const {recording, userName} = data; - api.game.toggleRecording(recording, userName); - } - - const handleRecordingStatus = (data) => { - if (data === 'ok') { - message.show(`Recording ${recording.isActive() ? 'on' : 'off'}`) - if (recording.isActive()) { - recording.setIndicator(true) - } - } else { - message.show(`Recording failed ):`) - recording.setIndicator(false) - } - log.debug("recording is ", recording.isActive()) - } - - const _default = { - name: 'default', - axisChanged: _nil, - keyPress: _nil, - keyRelease: _nil, - menuReady: _nil, - } - const app = { - state: { - eden: { - ..._default, - name: 'eden', - menuReady: showMenuScreen - }, - - settings: { - ..._default, - _uber: true, - name: 'settings', - keyRelease: (() => { - settings.ui.onToggle = (o) => !o && setState(lastState); - return (key) => key === KEY.SETTINGS && settings.ui.toggle() - })(), - menuReady: showMenuScreen - }, - - menu: { - ..._default, - name: 'menu', - axisChanged: (id, val) => id === 1 && gameList.scroll(val < -.5 ? -1 : val > .5 ? 1 : 0), - keyPress: (key) => { - switch (key) { - case KEY.UP: - case KEY.DOWN: - gameList.scroll(key === KEY.UP ? -1 : 1) - break; - } - }, - keyRelease: (key) => { - switch (key) { - case KEY.UP: - case KEY.DOWN: - gameList.scroll(0); - break; - case KEY.JOIN: - case KEY.A: - case KEY.B: - case KEY.X: - case KEY.Y: - case KEY.START: - case KEY.SELECT: - startGame(); - break; - case KEY.QUIT: - message.show('You are already in menu screen!'); - break; - case KEY.LOAD: - message.show('Loading the game.'); - break; - case KEY.SAVE: - message.show('Saving the game.'); - break; - case KEY.STATS: - event.pub(STATS_TOGGLE); - break; - case KEY.SETTINGS: - break; - case KEY.DTOGGLE: - handleToggle(); - break; - } - }, - }, - - game: { - ..._default, - name: 'game', - axisChanged: (id, value) => input.setAxisChanged(id, value), - keyPress: key => input.setKeyState(key, true), - keyRelease: function (key) { - input.setKeyState(key, false); - - switch (key) { - case KEY.JOIN: // or SHARE - // save when click share - saveGame(); - room.copyToClipboard(); - message.show('Shared link copied to the clipboard!'); - break; - case KEY.SAVE: - saveGame(); - break; - case KEY.LOAD: - loadGame(); - break; - case KEY.FULL: - stream.video.toggleFullscreen(); - break; - case KEY.PAD1: - updatePlayerIndex(0); - break; - case KEY.PAD2: - updatePlayerIndex(1); - break; - case KEY.PAD3: - updatePlayerIndex(2); - break; - case KEY.PAD4: - updatePlayerIndex(3); - break; - case KEY.QUIT: - input.poll.disable(); - api.game.quit(room.getId()); - room.reset(); - window.location = window.location.pathname; - break; - case KEY.STATS: - event.pub(STATS_TOGGLE); - break; - case KEY.DTOGGLE: - handleToggle(); - break; - } - }, - } - } - }; - - // subscriptions - event.sub(MESSAGE, onMessage); - - event.sub(GAME_ROOM_AVAILABLE, onGameRoomAvailable, 2); - event.sub(GAME_SAVED, () => message.show('Saved')); - event.sub(GAME_LOADED, () => message.show('Loaded')); - event.sub(GAME_PLAYER_IDX, data => { - updatePlayerIndex(+data.index, state !== app.state.game); - }); - event.sub(GAME_PLAYER_IDX_SET, idx => { - if (!isNaN(+idx)) message.show(+idx + 1); - }); - event.sub(GAME_ERROR_NO_FREE_SLOTS, () => message.show("No free slots :(", 2500)); - event.sub(WEBRTC_NEW_CONNECTION, (data) => { - workerManager.whoami(data.wid); - webrtc.onData = (x) => onMessage(api.decode(x.data)) - webrtc.start(data.ice); - api.server.initWebrtc() - gameList.set(data.games); - }); - event.sub(WEBRTC_ICE_CANDIDATE_FOUND, (data) => api.server.sendIceCandidate(data.candidate)); - event.sub(WEBRTC_SDP_ANSWER, (data) => api.server.sendSdp(data.sdp)); - event.sub(WEBRTC_SDP_OFFER, (data) => webrtc.setRemoteDescription(data.sdp, stream.video.el())); - event.sub(WEBRTC_ICE_CANDIDATE_RECEIVED, (data) => webrtc.addCandidate(data.candidate)); - event.sub(WEBRTC_ICE_CANDIDATES_FLUSH, () => webrtc.flushCandidates()); - event.sub(WEBRTC_CONNECTION_READY, onConnectionReady); - event.sub(WEBRTC_CONNECTION_CLOSED, () => { - input.poll.disable(); - webrtc.stop(); - }); - event.sub(LATENCY_CHECK_REQUESTED, onLatencyCheck); - event.sub(GAMEPAD_CONNECTED, () => message.show('Gamepad connected')); - event.sub(GAMEPAD_DISCONNECTED, () => message.show('Gamepad disconnected')); - // touch stuff - event.sub(MENU_HANDLER_ATTACHED, (data) => { - menuScreen.addEventListener(data.event, data.handler, {passive: true}); - }); - event.sub(KEY_PRESSED, onKeyPress); - event.sub(KEY_RELEASED, onKeyRelease); - event.sub(SETTINGS_CHANGED, () => message.show('Settings have been updated')); - event.sub(AXIS_CHANGED, onAxisChanged); - event.sub(CONTROLLER_UPDATED, data => webrtc.input(data)); - // recording - event.sub(RECORDING_TOGGLED, handleRecording); - event.sub(RECORDING_STATUS_CHANGED, handleRecordingStatus); - - event.sub(SETTINGS_CHANGED, () => { - const newValue = settings.get()[opts.LOG_LEVEL]; - if (newValue !== log.level) { - log.level = newValue; - } - }); - - // initial app state - setState(app.state.eden); -})(api, document, event, env, gameList, input, KEY, log, message, recording, room, settings, socket, stats, stream, utils, webrtc, workerManager); diff --git a/web/js/env.js b/web/js/env.js index a8f79ebd..ef1ef3d5 100644 --- a/web/js/env.js +++ b/web/js/env.js @@ -1,119 +1,117 @@ -const env = (() => { - // UI - const page = document.getElementsByTagName('html')[0]; - const gameBoy = document.getElementById('gamebody'); - const sourceLink = document.getElementsByClassName('source')[0]; +// UI +const page = document.getElementsByTagName('html')[0]; +const gameBoy = document.getElementById('gamebody'); +const sourceLink = document.getElementsByClassName('source')[0]; - let isLayoutSwitched = false; +let isLayoutSwitched = false; - // Window rerender / rotate screen if needed - const fixScreenLayout = () => { - let pw = getWidth(page), - ph = getHeight(page), - targetWidth = Math.round(pw * 0.9 / 2) * 2, - targetHeight = Math.round(ph * 0.9 / 2) * 2; +// Window rerender / rotate screen if needed +const fixScreenLayout = () => { + let pw = getWidth(page), + ph = getHeight(page), + targetWidth = Math.round(pw * 0.9 / 2) * 2, + targetHeight = Math.round(ph * 0.9 / 2) * 2; - // save page rotation - isLayoutSwitched = isPortrait(); + // save page rotation + isLayoutSwitched = isPortrait(); - rescaleGameBoy(targetWidth, targetHeight); + rescaleGameBoy(targetWidth, targetHeight); - sourceLink.style['bottom'] = isLayoutSwitched ? 0 : ''; - if (isLayoutSwitched) { - sourceLink.style.removeProperty('right'); - sourceLink.style['left'] = 5; - } else { - sourceLink.style.removeProperty('left'); - sourceLink.style['right'] = 5; + sourceLink.style['bottom'] = isLayoutSwitched ? 0 : ''; + if (isLayoutSwitched) { + sourceLink.style.removeProperty('right'); + sourceLink.style['left'] = 5; + } else { + sourceLink.style.removeProperty('left'); + sourceLink.style['right'] = 5; + } + sourceLink.style['transform'] = isLayoutSwitched ? 'rotate(-90deg)' : ''; + sourceLink.style['transform-origin'] = isLayoutSwitched ? 'left top' : ''; +}; + +const rescaleGameBoy = (targetWidth, targetHeight) => { + const transformations = ['translate(-50%, -50%)']; + + if (isLayoutSwitched) { + transformations.push('rotate(90deg)'); + [targetWidth, targetHeight] = [targetHeight, targetWidth] + } + + // scale, fit to target size + const scale = Math.min(targetWidth / getWidth(gameBoy), targetHeight / getHeight(gameBoy)); + transformations.push(`scale(${scale})`); + + gameBoy.style['transform'] = transformations.join(' '); +} + +const getOS = () => { + // linux? ios? + let OSName = 'unknown'; + if (navigator.appVersion.indexOf('Win') !== -1) OSName = 'win'; + else if (navigator.appVersion.indexOf('Mac') !== -1) OSName = 'mac'; + else if (navigator.userAgent.indexOf('Linux') !== -1) OSName = 'linux'; + else if (navigator.userAgent.indexOf('Android') !== -1) OSName = 'android'; + return OSName; +}; + +const getBrowser = () => { + let browserName = 'unknown'; + if (navigator.userAgent.indexOf('Firefox') !== -1) browserName = 'firefox'; + if (navigator.userAgent.indexOf('Chrome') !== -1) browserName = 'chrome'; + if (navigator.userAgent.indexOf('Edge') !== -1) browserName = 'edge'; + if (navigator.userAgent.indexOf('Version/') !== -1) browserName = 'safari'; + if (navigator.userAgent.indexOf('UCBrowser') !== -1) browserName = 'uc'; + return browserName; +}; + +const isPortrait = () => getWidth(page) < getHeight(page); + +const toggleFullscreen = (enable, element) => { + const el = enable ? element : document; + + if (enable) { + if (el.requestFullscreen) { + el.requestFullscreen(); + } else if (el.mozRequestFullScreen) { /* Firefox */ + el.mozRequestFullScreen(); + } else if (el.webkitRequestFullscreen) { /* Chrome, Safari and Opera */ + el.webkitRequestFullscreen(); + } else if (el.msRequestFullscreen) { /* IE/Edge */ + el.msRequestFullscreen(); } - sourceLink.style['transform'] = isLayoutSwitched ? 'rotate(-90deg)' : ''; - sourceLink.style['transform-origin'] = isLayoutSwitched ? 'left top' : ''; - }; - - const rescaleGameBoy = (targetWidth, targetHeight) => { - const transformations = ['translate(-50%, -50%)']; - - if (isLayoutSwitched) { - transformations.push('rotate(90deg)'); - [targetWidth, targetHeight] = [targetHeight, targetWidth] + } else { + if (el.exitFullscreen) { + el.exitFullscreen(); + } else if (el.mozCancelFullScreen) { /* Firefox */ + el.mozCancelFullScreen(); + } else if (el.webkitExitFullscreen) { /* Chrome, Safari and Opera */ + el.webkitExitFullscreen(); + } else if (el.msExitFullscreen) { /* IE/Edge */ + el.msExitFullscreen(); } - - // scale, fit to target size - const scale = Math.min(targetWidth / getWidth(gameBoy), targetHeight / getHeight(gameBoy)); - transformations.push(`scale(${scale})`); - - gameBoy.style['transform'] = transformations.join(' '); } +}; - const getOS = () => { - // linux? ios? - let OSName = 'unknown'; - if (navigator.appVersion.indexOf('Win') !== -1) OSName = 'win'; - else if (navigator.appVersion.indexOf('Mac') !== -1) OSName = 'mac'; - else if (navigator.userAgent.indexOf('Linux') !== -1) OSName = 'linux'; - else if (navigator.userAgent.indexOf('Android') !== -1) OSName = 'android'; - return OSName; - }; +function getHeight(el) { + return parseFloat(getComputedStyle(el, null).height.replace("px", "")); +} - const getBrowser = () => { - let browserName = 'unknown'; - if (navigator.userAgent.indexOf('Firefox') !== -1) browserName = 'firefox'; - if (navigator.userAgent.indexOf('Chrome') !== -1) browserName = 'chrome'; - if (navigator.userAgent.indexOf('Edge') !== -1) browserName = 'edge'; - if (navigator.userAgent.indexOf('Version/') !== -1) browserName = 'safari'; - if (navigator.userAgent.indexOf('UCBrowser') !== -1) browserName = 'uc'; - return browserName; - }; +function getWidth(el) { + return parseFloat(getComputedStyle(el, null).width.replace("px", "")); +} - const isPortrait = () => getWidth(page) < getHeight(page); +window.addEventListener('resize', fixScreenLayout); +window.addEventListener('orientationchange', fixScreenLayout); +document.addEventListener('DOMContentLoaded', () => fixScreenLayout(), false); - const toggleFullscreen = (enable, element) => { - const el = enable ? element : document; - - if (enable) { - if (el.requestFullscreen) { - el.requestFullscreen(); - } else if (el.mozRequestFullScreen) { /* Firefox */ - el.mozRequestFullScreen(); - } else if (el.webkitRequestFullscreen) { /* Chrome, Safari and Opera */ - el.webkitRequestFullscreen(); - } else if (el.msRequestFullscreen) { /* IE/Edge */ - el.msRequestFullscreen(); - } - } else { - if (el.exitFullscreen) { - el.exitFullscreen(); - } else if (el.mozCancelFullScreen) { /* Firefox */ - el.mozCancelFullScreen(); - } else if (el.webkitExitFullscreen) { /* Chrome, Safari and Opera */ - el.webkitExitFullscreen(); - } else if (el.msExitFullscreen) { /* IE/Edge */ - el.msExitFullscreen(); - } - } - }; - - function getHeight(el) { - return parseFloat(getComputedStyle(el, null).height.replace("px", "")); - } - - function getWidth(el) { - return parseFloat(getComputedStyle(el, null).width.replace("px", "")); - } - - window.addEventListener('resize', fixScreenLayout); - window.addEventListener('orientationchange', fixScreenLayout); - document.addEventListener('DOMContentLoaded', () => fixScreenLayout(), false); - - return { - getOs: getOS, - getBrowser: getBrowser, - isMobileDevice: () => /Mobi|Android|iPhone/i.test(navigator.userAgent), - display: () => ({ - isPortrait: isPortrait, - toggleFullscreen: toggleFullscreen, - fixScreenLayout: fixScreenLayout, - isLayoutSwitched: isLayoutSwitched - }) - } -})(document, log, navigator, screen, window); +export const env = { + getOs: getOS, + getBrowser: getBrowser, + isMobileDevice: () => /Mobi|Android|iPhone/i.test(navigator.userAgent), + display: () => ({ + isPortrait: isPortrait, + toggleFullscreen: toggleFullscreen, + fixScreenLayout: fixScreenLayout, + isLayoutSwitched: isLayoutSwitched + }) +} diff --git a/web/js/event.js b/web/js/event.js new file mode 100644 index 00000000..df189044 --- /dev/null +++ b/web/js/event.js @@ -0,0 +1,100 @@ +/** + * Event publishing / subscribe module. + * Just a simple observer pattern. + */ + +const topics = {}; + +// internal listener index +let _index = 0; + +/** + * Subscribes onto some event. + * + * @param topic The name of the event. + * @param listener A callback function to call during the event. + * @param order A number in a queue of event handlers to run callback in ordered manner. + * @returns {{unsub: unsub}} The function to remove this subscription. + * @example + * const sub01 = event.sub('rapture', () => {a}, 1) + * ... + * sub01.unsub() + */ +export const sub = (topic, listener, order = undefined) => { + if (!topics[topic]) topics[topic] = {}; + // order index * big pad + next internal index (e.g. 1*100+1=101) + // use some arbitrary big number to not overlap with non-ordered + let i = (order !== undefined ? order * 1000000 : 0) + _index++; + topics[topic][i] = listener; + return { + unsub: () => { + delete topics[topic][i] + } + } +} + +/** + * Publishes some event for handling. + * + * @param topic The name of the event. + * @param data Additional data for the event handling. + * Because of compatibility we have to use a dumb obj wrapper {a: a, b: b} for params instead of (topic, ...data). + * @example + * event.pub('rapture', {time: now()}) + */ +export const pub = (topic, data) => { + if (!topics[topic]) return; + Object.keys(topics[topic]).forEach((ls) => { + topics[topic][ls](data !== undefined ? data : {}) + }); +} + +// events +export const LATENCY_CHECK_REQUESTED = 'latencyCheckRequested'; +export const PING_REQUEST = 'pingRequest'; +export const PING_RESPONSE = 'pingResponse'; + +export const WORKER_LIST_FETCHED = 'workerListFetched'; + +export const GAME_ROOM_AVAILABLE = 'gameRoomAvailable'; +export const GAME_SAVED = 'gameSaved'; +export const GAME_LOADED = 'gameLoaded'; +export const GAME_PLAYER_IDX = 'gamePlayerIndex'; +export const GAME_PLAYER_IDX_SET = 'gamePlayerIndexSet' +export const GAME_ERROR_NO_FREE_SLOTS = 'gameNoFreeSlots' + +export const WEBRTC_CONNECTION_CLOSED = 'webrtcConnectionClosed'; +export const WEBRTC_CONNECTION_READY = 'webrtcConnectionReady'; +export const WEBRTC_ICE_CANDIDATE_FOUND = 'webrtcIceCandidateFound' +export const WEBRTC_ICE_CANDIDATE_RECEIVED = 'webrtcIceCandidateReceived'; +export const WEBRTC_ICE_CANDIDATES_FLUSH = 'webrtcIceCandidatesFlush'; +export const WEBRTC_NEW_CONNECTION = 'webrtcNewConnection'; +export const WEBRTC_SDP_ANSWER = 'webrtcSdpAnswer' +export const WEBRTC_SDP_OFFER = 'webrtcSdpOffer'; + +export const MESSAGE = 'message' + +export const GAMEPAD_CONNECTED = 'gamepadConnected'; +export const GAMEPAD_DISCONNECTED = 'gamepadDisconnected'; + +export const MENU_HANDLER_ATTACHED = 'menuHandlerAttached'; +export const MENU_PRESSED = 'menuPressed'; +export const MENU_RELEASED = 'menuReleased'; + +export const KEY_PRESSED = 'keyPressed'; +export const KEY_RELEASED = 'keyReleased'; +export const KEYBOARD_TOGGLE_FILTER_MODE = 'keyboardToggleFilterMode'; +export const KEYBOARD_KEY_PRESSED = 'keyboardKeyPressed'; +export const AXIS_CHANGED = 'axisChanged'; +export const CONTROLLER_UPDATED = 'controllerUpdated'; + +export const DPAD_TOGGLE = 'dpadToggle'; +export const STATS_TOGGLE = 'statsToggle'; +export const HELP_OVERLAY_TOGGLED = 'helpOverlayToggled'; + +export const SETTINGS_CHANGED = 'settingsChanged'; + +export const RECORDING_TOGGLED = 'recordingToggle' +export const RECORDING_STATUS_CHANGED = 'recordingStatusChanged' + +export const APP_VIDEO_CHANGED = 'appVideoChanged' diff --git a/web/js/event/event.js b/web/js/event/event.js deleted file mode 100644 index 301e731b..00000000 --- a/web/js/event/event.js +++ /dev/null @@ -1,104 +0,0 @@ -/** - * Event publishing / subscribe module. - * Just a simple observer pattern. - * @version 1 - */ -const event = (() => { - const topics = {}; - - // internal listener index - let _index = 0; - - return { - /** - * Subscribes onto some event. - * - * @param topic The name of the event. - * @param listener A callback function to call during the event. - * @param order A number in a queue of event handlers to run callback in ordered manner. - * @returns {{unsub: unsub}} The function to remove this subscription. - * @example - * const sub01 = event.sub('rapture', () => {a}, 1) - * ... - * sub01.unsub() - */ - sub: (topic, listener, order = undefined) => { - if (!topics[topic]) topics[topic] = {}; - // order index * big pad + next internal index (e.g. 1*100+1=101) - // use some arbitrary big number to not overlap with non-ordered - let i = (order !== undefined ? order * 1000000 : 0) + _index++; - topics[topic][i] = listener; - return Object.freeze({ - unsub: () => { - delete topics[topic][i] - } - }); - }, - - /** - * Publishes some event for handling. - * - * @param topic The name of the event. - * @param data Additional data for the event handling. - * Because of compatibility we have to use a dumb obj wrapper {a: a, b: b} for params instead of (topic, ...data). - * @example - * event.pub('rapture', {time: now()}) - */ - pub: (topic, data) => { - if (!topics[topic]) return; - Object.keys(topics[topic]).forEach((ls) => { - topics[topic][ls](data !== undefined ? data : {}) - }); - } - } -})(); - -// events -const LATENCY_CHECK_REQUESTED = 'latencyCheckRequested'; -const PING_REQUEST = 'pingRequest'; -const PING_RESPONSE = 'pingResponse'; - -const WORKER_LIST_FETCHED = 'workerListFetched'; - -const GAME_ROOM_AVAILABLE = 'gameRoomAvailable'; -const GAME_SAVED = 'gameSaved'; -const GAME_LOADED = 'gameLoaded'; -const GAME_PLAYER_IDX = 'gamePlayerIndex'; -const GAME_PLAYER_IDX_SET = 'gamePlayerIndexSet' -const GAME_ERROR_NO_FREE_SLOTS = 'gameNoFreeSlots' - -const WEBRTC_CONNECTION_CLOSED = 'webrtcConnectionClosed'; -const WEBRTC_CONNECTION_READY = 'webrtcConnectionReady'; -const WEBRTC_ICE_CANDIDATE_FOUND = 'webrtcIceCandidateFound' -const WEBRTC_ICE_CANDIDATE_RECEIVED = 'webrtcIceCandidateReceived'; -const WEBRTC_ICE_CANDIDATES_FLUSH = 'webrtcIceCandidatesFlush'; -const WEBRTC_NEW_CONNECTION = 'webrtcNewConnection'; -const WEBRTC_SDP_ANSWER = 'webrtcSdpAnswer' -const WEBRTC_SDP_OFFER = 'webrtcSdpOffer'; - -const MESSAGE = 'message' - -const GAMEPAD_CONNECTED = 'gamepadConnected'; -const GAMEPAD_DISCONNECTED = 'gamepadDisconnected'; - -const MENU_HANDLER_ATTACHED = 'menuHandlerAttached'; -const MENU_PRESSED = 'menuPressed'; -const MENU_RELEASED = 'menuReleased'; - -const KEY_PRESSED = 'keyPressed'; -const KEY_RELEASED = 'keyReleased'; -const KEYBOARD_TOGGLE_FILTER_MODE = 'keyboardToggleFilterMode'; -const KEYBOARD_KEY_PRESSED = 'keyboardKeyPressed'; -const AXIS_CHANGED = 'axisChanged'; -const CONTROLLER_UPDATED = 'controllerUpdated'; - -const DPAD_TOGGLE = 'dpadToggle'; -const STATS_TOGGLE = 'statsToggle'; -const HELP_OVERLAY_TOGGLED = 'helpOverlayToggled'; - -const SETTINGS_CHANGED = 'settingsChanged'; - -const RECORDING_TOGGLED = 'recordingToggle' -const RECORDING_STATUS_CHANGED = 'recordingStatusChanged' - -const APP_VIDEO_CHANGED = 'appVideoChanged' diff --git a/web/js/gameList.js b/web/js/gameList.js index 74338a3e..48ef73b6 100644 --- a/web/js/gameList.js +++ b/web/js/gameList.js @@ -1,235 +1,239 @@ -/** - * Game list module. - * @version 1 - */ -const gameList = (() => { - const TOP_POSITION = 102 - const SELECT_THRESHOLD_MS = 160 +import { + sub, + MENU_PRESSED, + MENU_RELEASED +} from 'event'; +import {gui} from 'gui'; - const games = (() => { - let list = [], index = 0 - return { - get index() { - return index - }, - get list() { - return list - }, - get selected() { - return list[index].title // selected by the game title, oof - }, - set index(i) { - //-2 | - //-1 | | - // 0 < | < - // 1 | | - // 2 < < | - //+1 | | - //+2 | - index = i < -1 ? i = 0 : - i > list.length ? i = list.length - 1 : - (i % list.length + list.length) % list.length - }, - set: (data = []) => list = data.sort((a, b) => a.title.toLowerCase() > b.title.toLowerCase() ? 1 : -1), - empty: () => list.length === 0 - } - })() - - const scroll = ((DEFAULT_INTERVAL) => { - const state = { - IDLE: 0, UP: -1, DOWN: 1, DRAG: 3 - } - let last = state.IDLE - let _si - let onShift, onStop - - const shift = (delta) => { - if (scroll.scrolling) return - onShift(delta) - // velocity? - // keep rolling the game list if the button is pressed - _si = setInterval(() => onShift(delta), DEFAULT_INTERVAL) - } - - const stop = () => { - onStop() - _si && (clearInterval(_si) && (_si = null)) - } - - const handle = {[state.IDLE]: stop, [state.UP]: shift, [state.DOWN]: shift, [state.DRAG]: null} - - return { - scroll: (move = state.IDLE) => { - handle[move] && handle[move](move) - last = move - }, - get scrolling() { - return last !== state.IDLE - }, - set onShift(fn) { - onShift = fn - }, - set onStop(fn) { - onStop = fn - }, - state, - last: () => last - } - })(SELECT_THRESHOLD_MS) - - const ui = (() => { - const rootEl = document.getElementById('menu-container') - const choiceMarkerEl = document.getElementById('menu-item-choice') - - const TRANSITION_DEFAULT = `top ${SELECT_THRESHOLD_MS}ms` - let listTopPos = TOP_POSITION - - rootEl.style.transition = TRANSITION_DEFAULT - - let onTransitionEnd = () => ({}) - - //rootEl.addEventListener('transitionend', () => onTransitionEnd()) - - let items = [] - - const item = (parent) => { - const title = parent.firstChild.firstChild - const desc = parent.children[1] - - const _desc = { - hide: () => gui.hide(desc), - show: async () => { - gui.show(desc) - await gui.anim.fadeIn(desc, .054321) - }, - } - - const _title = { - animate: () => title.classList.add('text-move'), - pick: () => title.classList.add('pick'), - reset: () => title.classList.remove('pick', 'text-move'), - } - - const clear = () => { - _title.reset() - // _desc.hide() - } - - return { - get description() { - return _desc - }, - get title() { - return _title - }, - clear, - } - } - - const render = () => { - rootEl.innerHTML = games.list.map(game => - `
    ` + - `
    ${game.title}
    ` + - //`
    ${game.system}
    ` + - `
    `) - .join('') - items = [...rootEl.querySelectorAll('.menu-item')].map(x => item(x)) - } - - return { - get items() { - return items - }, - get selected() { - return items[games.index] - }, - get roundIndex() { - const closest = Math.round((listTopPos - TOP_POSITION) / -36) - return closest < 0 ? 0 : - closest > games.list.length - 1 ? games.list.length - 1 : - closest // don't wrap the list on drag - }, - set onTransitionEnd(x) { - onTransitionEnd = x - }, - set pos(idx) { - listTopPos = TOP_POSITION - idx * 36 - rootEl.style.top = `${listTopPos}px` - }, - drag: { - startPos: (pos) => { - rootEl.style.top = `${listTopPos - pos}px` - rootEl.style.transition = '' - }, - stopPos: (pos) => { - listTopPos -= pos - rootEl.style.transition = TRANSITION_DEFAULT - }, - }, - render, - marker: { - show: () => gui.show(choiceMarkerEl) - }, - NO_TRANSITION: onTransitionEnd(), - } - })(TOP_POSITION, SELECT_THRESHOLD_MS, games) - - const show = () => { - ui.render() - ui.marker.show() // we show square pseudo-selection marker only after rendering - scroll.scroll(scroll.state.DOWN) // interactively moves games select down - scroll.scroll(scroll.state.IDLE) - } - - const select = (index) => { - ui.items.forEach(i => i.clear()) // !to rewrite - games.index = index - ui.pos = games.index - } - - scroll.onShift = (delta) => select(games.index + delta) - - let hasTransition = true // needed for cases when MENU_RELEASE called instead MENU_PRESSED - - scroll.onStop = () => { - const item = ui.selected - if (item) { - item.title.pick() - item.title.animate() - // hasTransition ? (ui.onTransitionEnd = item.description.show) : item.description.show() - } - } - - event.sub(MENU_PRESSED, (position) => { - if (games.empty()) return - ui.onTransitionEnd = ui.NO_TRANSITION - hasTransition = false - scroll.scroll(scroll.state.DRAG) - ui.selected && ui.selected.clear() - ui.drag.startPos(position) - }) - - event.sub(MENU_RELEASED, (position) => { - if (games.empty()) return - ui.drag.stopPos(position) - select(ui.roundIndex) - hasTransition = !hasTransition - scroll.scroll(scroll.state.IDLE) - hasTransition = true - }) +const TOP_POSITION = 102 +const SELECT_THRESHOLD_MS = 160 +const games = (() => { + let list = [], index = 0 return { - scroll: (x) => { - if (games.empty()) return - scroll.scroll(x) + get index() { + return index + }, + get list() { + return list }, get selected() { - return games.selected + return list[index].title // selected by the game title, oof }, - set: games.set, - show: () => { - if (games.empty()) return - show() + set index(i) { + //-2 | + //-1 | | + // 0 < | < + // 1 | | + // 2 < < | + //+1 | | + //+2 | + index = i < -1 ? i = 0 : + i > list.length ? i = list.length - 1 : + (i % list.length + list.length) % list.length }, + set: (data = []) => list = data.sort((a, b) => a.title.toLowerCase() > b.title.toLowerCase() ? 1 : -1), + empty: () => list.length === 0 } -})(document, event, gui) +})() + +const scroll = ((DEFAULT_INTERVAL) => { + const state = { + IDLE: 0, UP: -1, DOWN: 1, DRAG: 3 + } + let last = state.IDLE + let _si + let onShift, onStop + + const shift = (delta) => { + if (scroll.scrolling) return + onShift(delta) + // velocity? + // keep rolling the game list if the button is pressed + _si = setInterval(() => onShift(delta), DEFAULT_INTERVAL) + } + + const stop = () => { + onStop() + _si && (clearInterval(_si) && (_si = null)) + } + + const handle = {[state.IDLE]: stop, [state.UP]: shift, [state.DOWN]: shift, [state.DRAG]: null} + + return { + scroll: (move = state.IDLE) => { + handle[move] && handle[move](move) + last = move + }, + get scrolling() { + return last !== state.IDLE + }, + set onShift(fn) { + onShift = fn + }, + set onStop(fn) { + onStop = fn + }, + state, + last: () => last + } +})(SELECT_THRESHOLD_MS) + +const ui = (() => { + const rootEl = document.getElementById('menu-container') + const choiceMarkerEl = document.getElementById('menu-item-choice') + + const TRANSITION_DEFAULT = `top ${SELECT_THRESHOLD_MS}ms` + let listTopPos = TOP_POSITION + + rootEl.style.transition = TRANSITION_DEFAULT + + let onTransitionEnd = () => ({}) + + //rootEl.addEventListener('transitionend', () => onTransitionEnd()) + + let items = [] + + const item = (parent) => { + const title = parent.firstChild.firstChild + const desc = parent.children[1] + + const _desc = { + hide: () => gui.hide(desc), + show: async () => { + gui.show(desc) + await gui.anim.fadeIn(desc, .054321) + }, + } + + const _title = { + animate: () => title.classList.add('text-move'), + pick: () => title.classList.add('pick'), + reset: () => title.classList.remove('pick', 'text-move'), + } + + const clear = () => { + _title.reset() + // _desc.hide() + } + + return { + get description() { + return _desc + }, + get title() { + return _title + }, + clear, + } + } + + const render = () => { + rootEl.innerHTML = games.list.map(game => + `
    ` + + `
    ${game.title}
    ` + + //`
    ${game.system}
    ` + + `
    `) + .join('') + items = [...rootEl.querySelectorAll('.menu-item')].map(x => item(x)) + } + + return { + get items() { + return items + }, + get selected() { + return items[games.index] + }, + get roundIndex() { + const closest = Math.round((listTopPos - TOP_POSITION) / -36) + return closest < 0 ? 0 : + closest > games.list.length - 1 ? games.list.length - 1 : + closest // don't wrap the list on drag + }, + set onTransitionEnd(x) { + onTransitionEnd = x + }, + set pos(idx) { + listTopPos = TOP_POSITION - idx * 36 + rootEl.style.top = `${listTopPos}px` + }, + drag: { + startPos: (pos) => { + rootEl.style.top = `${listTopPos - pos}px` + rootEl.style.transition = '' + }, + stopPos: (pos) => { + listTopPos -= pos + rootEl.style.transition = TRANSITION_DEFAULT + }, + }, + render, + marker: { + show: () => gui.show(choiceMarkerEl) + }, + NO_TRANSITION: onTransitionEnd(), + } +})(TOP_POSITION, SELECT_THRESHOLD_MS, games) + +const show = () => { + ui.render() + ui.marker.show() // we show square pseudo-selection marker only after rendering + scroll.scroll(scroll.state.DOWN) // interactively moves games select down + scroll.scroll(scroll.state.IDLE) +} + +const select = (index) => { + ui.items.forEach(i => i.clear()) // !to rewrite + games.index = index + ui.pos = games.index +} + +scroll.onShift = (delta) => select(games.index + delta) + +let hasTransition = true // needed for cases when MENU_RELEASE called instead MENU_PRESSED + +scroll.onStop = () => { + const item = ui.selected + if (item) { + item.title.pick() + item.title.animate() + // hasTransition ? (ui.onTransitionEnd = item.description.show) : item.description.show() + } +} + +sub(MENU_PRESSED, (position) => { + if (games.empty()) return + ui.onTransitionEnd = ui.NO_TRANSITION + hasTransition = false + scroll.scroll(scroll.state.DRAG) + ui.selected && ui.selected.clear() + ui.drag.startPos(position) +}) + +sub(MENU_RELEASED, (position) => { + if (games.empty()) return + ui.drag.stopPos(position) + select(ui.roundIndex) + hasTransition = !hasTransition + scroll.scroll(scroll.state.IDLE) + hasTransition = true +}) + +/** + * Game list module. + */ +export const gameList = { + scroll: (x) => { + if (games.empty()) return + scroll.scroll(x) + }, + get selected() { + return games.selected + }, + set: games.set, + show: () => { + if (games.empty()) return + show() + }, +} diff --git a/web/js/gui.js b/web/js/gui.js new file mode 100644 index 00000000..0d295ea1 --- /dev/null +++ b/web/js/gui.js @@ -0,0 +1,259 @@ +/** + * App UI elements module. + */ + +const _create = (name = 'div', modFn) => { + const el = document.createElement(name); + if (modFn) { + modFn(el); + } + return el; +} + +const _option = (text = '', selected = false, label) => { + const el = _create('option'); + if (label) { + el.textContent = label; + el.value = text; + } else { + el.textContent = text; + } + if (selected) el.selected = true; + + return el; +} + +const select = (key = '', callback = () => ({}), values = {values: [], labels: []}, current = '') => { + const el = _create(); + const select = _create('select'); + select.onchange = event => { + callback(key, event.target.value); + }; + el.append(select); + + select.append(_option('none', current === '')); + values.values.forEach((value, index) => { + select.append(_option(value, current === value, values.labels?.[index])); + }); + + return el; +} + +const checkbox = (id, cb = () => ({}), checked = false, label = '', cc = '') => { + const el = _create(); + cc !== '' && el.classList.add(cc); + + let parent = el; + + if (label) { + const _label = _create('label', (el) => { + el.setAttribute('htmlFor', id); + }) + _label.innerText = label; + el.append(_label) + parent = _label; + } + + const input = _create('input', (el) => { + el.setAttribute('id', id); + el.setAttribute('name', id); + el.setAttribute('type', 'checkbox'); + el.onclick = ((e) => { + checked = e.target.checked + cb(id, checked) + }) + checked && el.setAttribute('checked', ''); + }); + parent.prepend(input); + + return el; +} + +const panel = (root, title = '', cc = '', content, buttons = [], onToggle) => { + const state = { + shown: false, + loading: false, + title: title, + } + + const tHandlers = []; + onToggle && tHandlers.push(onToggle); + + const _root = root || _create('div'); + _root.classList.add('panel'); + gui.hide(_root); + + const header = _create('div', (el) => el.classList.add('panel__header')); + const _content = _create('div', (el) => { + if (cc) { + el.classList.add(cc); + } + el.classList.add('panel__content') + }); + + const _title = _create('span', (el) => { + el.classList.add('panel__header__title'); + el.innerText = title; + }); + header.append(_title); + + header.append(_create('div', (el) => { + el.classList.add('panel__header__controls'); + + buttons.forEach((b => el.append(_create('span', (el) => { + if (Object.keys(b).length === 0) { + el.classList.add('panel__button_separator'); + return + } + el.classList.add('panel__button'); + if (b.cl) b.cl.forEach(class_ => el.classList.add(class_)); + if (b.title) el.title = b.title; + el.innerText = b.caption; + el.addEventListener('click', b.handler) + })))) + + el.append(_create('span', (el) => { + el.classList.add('panel__button'); + el.innerText = 'X'; + el.title = 'Close'; + el.addEventListener('click', () => toggle(false)) + })) + })) + + root.append(header, _content); + if (content) { + _content.append(content); + } + + const setContent = (content) => _content.replaceChildren(content) + + const setLoad = (load = true) => { + state.loading = load; + _title.innerText = state.loading ? `${state.title}...` : state.title; + } + + const toggle = (() => { + let br = window.getComputedStyle(_root.parentElement).borderRadius; + return (force) => { + state.shown = force !== undefined ? force : !state.shown; + // hack for not transparent jpeg corners :_; + _root.parentElement.style.borderRadius = state.shown ? '0px' : br; + tHandlers.forEach(h => h?.(state.shown, _root)); + state.shown ? gui.show(_root) : gui.hide(_root) + } + })() + + return { + contentEl: _content, + isHidden: () => !state.shown, + onToggle: (fn) => tHandlers.push(fn), + setContent, + setLoad, + toggle, + } +} + +const _bind = (cb = () => ({}), name = '', oldValue) => { + const el = _create('button'); + el.onclick = () => cb(name, oldValue); + el.textContent = name; + return el; +} + +const binding = (key = '', value = '', cb = () => ({})) => { + const el = _create(); + el.setAttribute('class', 'binding-element'); + + const k = _bind(cb, key, value); + + el.append(k); + + const v = _create(); + v.textContent = value; + el.append(v); + + return el; +} + +const show = (el) => { + el.classList.remove('hidden'); +} + +const inputN = (key = '', cb = () => ({}), current = 0) => { + const el = _create(); + const input = _create('input'); + input.type = 'number'; + input.value = current; + input.onchange = event => cb(key, event.target.value); + el.append(input); + return el; +} + +const hide = (el) => { + el.classList.add('hidden'); +} + +const toggle = (el, what) => { + if (what) { + show(el) + } else { + hide(el) + } +} + +const fadeIn = async (el, speed = .1) => { + el.style.opacity = '0'; + el.style.display = 'block'; + return new Promise((done) => (function fade() { + let val = parseFloat(el.style.opacity); + const proceed = ((val += speed) <= 1); + if (proceed) { + el.style.opacity = '' + val; + requestAnimationFrame(fade); + } else { + done(); + } + })() + ); +} + +const fadeOut = async (el, speed = .1) => { + el.style.opacity = '1'; + return new Promise((done) => (function fade() { + if ((el.style.opacity -= speed) < 0) { + el.style.display = "none"; + done(); + } else { + requestAnimationFrame(fade); + } + })() + ) +} + +const fragment = () => document.createDocumentFragment(); + +const sleep = async (ms) => new Promise(resolve => setTimeout(resolve, ms)); + +const fadeInOut = async (el, wait = 1000, speed = .1) => { + await fadeIn(el, speed) + await sleep(wait); + await fadeOut(el, speed) +} + +export const gui = { + anim: { + fadeIn, + fadeOut, + fadeInOut, + }, + binding, + checkbox, + create: _create, + fragment, + hide, + inputN, + panel, + select, + show, + toggle, +} diff --git a/web/js/gui/gui.js b/web/js/gui/gui.js deleted file mode 100644 index c63a4b89..00000000 --- a/web/js/gui/gui.js +++ /dev/null @@ -1,267 +0,0 @@ -/** - * App UI elements module. - * - * @version 1 - */ -const gui = (() => { - - const _create = (name = 'div', modFn) => { - const el = document.createElement(name); - if (modFn) { - modFn(el); - } - return el; - } - - const _option = (text = '', selected = false, label) => { - const el = _create('option'); - if (label) { - el.textContent = label; - el.value = text; - } else { - el.textContent = text; - } - if (selected) el.selected = true; - - return el; - } - - const select = (key = '', callback = () => ({}), values = {values: [], labels: []}, current = '') => { - const el = _create(); - const select = _create('select'); - select.onchange = event => { - callback(key, event.target.value); - }; - el.append(select); - - select.append(_option('none', current === '')); - values.values.forEach((value, index) => { - select.append(_option(value, current === value, values.labels?.[index])); - }); - - return el; - } - - const checkbox = (id, cb = () => ({}), checked = false, label = '', cc = '') => { - const el = _create(); - cc !== '' && el.classList.add(cc); - - let parent = el; - - if (label) { - const _label = _create('label', (el) => { - el.setAttribute('htmlFor', id); - }) - _label.innerText = label; - el.append(_label) - parent = _label; - } - - const input = _create('input', (el) => { - el.setAttribute('id', id); - el.setAttribute('name', id); - el.setAttribute('type', 'checkbox'); - el.onclick = ((e) => { - checked = e.target.checked - cb(id, checked) - }) - checked && el.setAttribute('checked', ''); - }); - parent.prepend(input); - - return el; - } - - const panel = (root, title = '', cc = '', content, buttons = [], onToggle) => { - const state = { - shown: false, - loading: false, - title: title, - } - - const tHandlers = []; - onToggle && tHandlers.push(onToggle); - - const _root = root || _create('div'); - _root.classList.add('panel'); - gui.hide(_root); - - const header = _create('div', (el) => el.classList.add('panel__header')); - const _content = _create('div', (el) => { - if (cc) { - el.classList.add(cc); - } - el.classList.add('panel__content') - }); - - const _title = _create('span', (el) => { - el.classList.add('panel__header__title'); - el.innerText = title; - }); - header.append(_title); - - header.append(_create('div', (el) => { - el.classList.add('panel__header__controls'); - - buttons.forEach((b => el.append(_create('span', (el) => { - if (Object.keys(b).length === 0) { - el.classList.add('panel__button_separator'); - return - } - el.classList.add('panel__button'); - if (b.cl) b.cl.forEach(class_ => el.classList.add(class_)); - if (b.title) el.title = b.title; - el.innerText = b.caption; - el.addEventListener('click', b.handler) - })))) - - el.append(_create('span', (el) => { - el.classList.add('panel__button'); - el.innerText = 'X'; - el.title = 'Close'; - el.addEventListener('click', () => toggle(false)) - })) - })) - - root.append(header, _content); - if (content) { - _content.append(content); - } - - const setContent = (content) => _content.replaceChildren(content) - - const setLoad = (load = true) => { - state.loading = load; - _title.innerText = state.loading ? `${state.title}...` : state.title; - } - - const toggle = (() => { - let br = window.getComputedStyle(_root.parentElement).borderRadius; - return (force) => { - state.shown = force !== undefined ? force : !state.shown; - // hack for not transparent jpeg corners :_; - _root.parentElement.style.borderRadius = state.shown ? '0px' : br; - tHandlers.forEach(h => h?.(state.shown, _root)); - state.shown ? gui.show(_root) : gui.hide(_root) - } - })() - - return { - contentEl: _content, - isHidden: () => !state.shown, - onToggle: (fn) => tHandlers.push(fn), - setContent, - setLoad, - toggle, - } - } - - const _bind = (callback = function () { - }, name = '', oldValue) => { - const el = _create('button'); - el.onclick = () => callback(name, oldValue); - - el.textContent = name; - - return el; - } - - const binding = (key = '', value = '', callback = function () { - }) => { - const el = _create(); - el.setAttribute('class', 'binding-element'); - - const k = _bind(callback, key, value); - - el.append(k); - - const v = _create(); - v.textContent = value; - el.append(v); - - return el; - } - - const show = (el) => { - el.classList.remove('hidden'); - } - - const inputN = (key = '', cb = () => ({}), current = 0) => { - const el = _create(); - const input = _create('input'); - input.type = 'number'; - input.value = current; - input.onchange = event => cb(key, event.target.value); - el.append(input); - return el; - } - - const hide = (el) => { - el.classList.add('hidden'); - } - - const toggle = (el, what) => { - if (what) { - show(el) - } else { - hide(el) - } - } - - const fadeIn = async (el, speed = .1) => { - el.style.opacity = '0'; - el.style.display = 'block'; - return new Promise((done) => (function fade() { - let val = parseFloat(el.style.opacity); - const proceed = ((val += speed) <= 1); - if (proceed) { - el.style.opacity = '' + val; - requestAnimationFrame(fade); - } else { - done(); - } - })() - ); - } - - const fadeOut = async (el, speed = .1) => { - el.style.opacity = '1'; - return new Promise((done) => (function fade() { - if ((el.style.opacity -= speed) < 0) { - el.style.display = "none"; - done(); - } else { - requestAnimationFrame(fade); - } - })() - ) - } - - const fragment = () => document.createDocumentFragment(); - - const sleep = async (ms) => new Promise(resolve => setTimeout(resolve, ms)); - - const fadeInOut = async (el, wait = 1000, speed = .1) => { - await fadeIn(el, speed) - await sleep(wait); - await fadeOut(el, speed) - } - - return { - anim: { - fadeIn, - fadeOut, - fadeInOut, - }, - binding, - checkbox, - create: _create, - fragment, - hide, - inputN, - panel, - select, - show, - toggle, - } -})(document); diff --git a/web/js/gui/message.js b/web/js/gui/message.js deleted file mode 100644 index 598d69e9..00000000 --- a/web/js/gui/message.js +++ /dev/null @@ -1,46 +0,0 @@ -/** - * App UI message module. - * - * @version 1 - */ -const message = (() => { - const popupBox = document.getElementById('noti-box'); - - // fifo queue - let queue = []; - const queueMaxSize = 5; - - let isScreenFree = true; - - const _popup = (time = 1000) => { - // recursion edge case: - // no messages in the queue or one on the screen - if (!(queue.length > 0 && isScreenFree)) { - return; - } - - isScreenFree = false; - popupBox.innerText = queue.shift(); - gui.anim.fadeInOut(popupBox, time, .05).finally(() => { - isScreenFree = true; - _popup(); - }) - } - - const _storeMessage = (text) => { - if (queue.length <= queueMaxSize) { - queue.push(text); - } - } - - const _proceed = (text, time) => { - _storeMessage(text); - _popup(time); - } - - const show = (text, time = 1000) => _proceed(text, time) - - return Object.freeze({ - show: show - }) -})(document, gui, utils); diff --git a/web/js/init.js b/web/js/init.js deleted file mode 100644 index d421bddb..00000000 --- a/web/js/init.js +++ /dev/null @@ -1,26 +0,0 @@ -settings.init(); - -(() => { - let lvl = settings.loadOr(opts.LOG_LEVEL, log.DEFAULT); - // migrate old log level options - // !to remove at some point - if (isNaN(lvl)) { - console.warn( - `The log value [${lvl}] is not supported! ` + - `The default value [debug] will be used instead.`); - settings.set(opts.LOG_LEVEL, `${log.DEFAULT}`) - lvl = log.DEFAULT - } - log.level = lvl -})(); - -keyboard.init(); -joystick.init(); -touch.init(); -stream.init(); - -[roomId, zone] = room.loadMaybe(); -// find worker id if present -const wid = new URLSearchParams(document.location.search).get('wid'); -// if from URL -> start game immediately! -socket.init(roomId, wid, zone); diff --git a/web/js/input/input.js b/web/js/input/input.js index 0ccf5b48..a6aa333d 100644 --- a/web/js/input/input.js +++ b/web/js/input/input.js @@ -1,114 +1,5 @@ -const input = (() => { - const pollingIntervalMs = 4; - let controllerChangedIndex = -1; - - // Libretro config - let controllerState = { - [KEY.B]: false, - [KEY.Y]: false, - [KEY.SELECT]: false, - [KEY.START]: false, - [KEY.UP]: false, - [KEY.DOWN]: false, - [KEY.LEFT]: false, - [KEY.RIGHT]: false, - [KEY.A]: false, - [KEY.X]: false, - // extra - [KEY.L]: false, - [KEY.R]: false, - [KEY.L2]: false, - [KEY.R2]: false, - [KEY.L3]: false, - [KEY.R3]: false - }; - - const poll = (intervalMs, callback) => { - let _ticker = 0; - return { - enable: () => { - if (_ticker > 0) return; - log.debug(`[input] poll set to ${intervalMs}ms`); - _ticker = setInterval(callback, intervalMs) - }, - disable: () => { - if (_ticker < 1) return; - log.debug('[input] poll has been disabled'); - clearInterval(_ticker); - _ticker = 0; - } - } - }; - - const controllerEncoded = [0, 0, 0, 0, 0]; - const keys = Object.keys(controllerState); - - const compare = (a, b) => { - if (a.length !== b.length) return false; - for (let i = 0; i < a.length; i++) { - if (a[i] !== b[i]) { - return false; - } - } - return true; - }; - - - // let lastState = controllerEncoded; - - const sendControllerState = () => { - if (controllerChangedIndex >= 0) { - const state = _getState(); - - // log.debug(state) - - // if (compare(lastState, state)) { - // log.debug('!skip') - // } else { - event.pub(CONTROLLER_UPDATED, _encodeState(state)); - // } - // lastState = state; - controllerChangedIndex = -1; - } - }; - - const setKeyState = (name, state) => { - if (controllerState[name] !== undefined) { - controllerState[name] = state; - controllerChangedIndex = Math.max(controllerChangedIndex, 0); - } - }; - - const setAxisChanged = (index, value) => { - if (controllerEncoded[index + 1] !== undefined) { - controllerEncoded[index + 1] = Math.floor(32767 * value); - controllerChangedIndex = Math.max(controllerChangedIndex, index + 1); - } - }; - - /** - * Converts key state into a bitmap and prepends it to the axes state. - * - * @returns {Uint16Array} The controller state. - * First uint16 is the controller state bitmap. - * The other uint16 are the axes values. - * Truncated to the last value changed. - * - * @private - */ - const _encodeState = (state) => new Uint16Array(state) - - const _getState = () => { - controllerEncoded[0] = 0; - for (let i = 0, len = keys.length; i < len; i++) { - controllerEncoded[0] += controllerState[keys[i]] ? 1 << i : 0; - } - return controllerEncoded.slice(0, controllerChangedIndex + 1); - } - - return { - poll: poll(pollingIntervalMs, sendControllerState), - setKeyState, - setAxisChanged, - } -})(event, KEY, log); +export {joystick} from './joystick.js?v=3'; +export {KEY} from './keys.js?v=3'; +export {keyboard} from './keyboard.js?v=3' +export {retropad} from './retropad.js?v=3'; +export {touch} from './touch.js?v=3'; diff --git a/web/js/input/joystick.js b/web/js/input/joystick.js index c5ee2fdb..b7f9a54a 100644 --- a/web/js/input/joystick.js +++ b/web/js/input/joystick.js @@ -1,3 +1,260 @@ +import { + pub, + sub, + AXIS_CHANGED, + DPAD_TOGGLE, + GAMEPAD_CONNECTED, + GAMEPAD_DISCONNECTED, + KEY_PRESSED, + KEY_RELEASED +} from 'event'; +import {env} from 'env'; +import {KEY} from 'input'; +import {log} from 'log'; + +const deadZone = 0.1; +let joystickMap; +let joystickState = {}; +let joystickAxes = []; +let joystickIdx; +let joystickTimer = null; +let dpadMode = true; + +function onDpadToggle(checked) { + if (dpadMode === checked) { + return //error? + } + if (dpadMode) { + dpadMode = false; + // reset dpad keys pressed before moving to analog stick mode + checkJoystickAxisState(KEY.LEFT, false); + checkJoystickAxisState(KEY.RIGHT, false); + checkJoystickAxisState(KEY.UP, false); + checkJoystickAxisState(KEY.DOWN, false); + } else { + dpadMode = true; + // reset analog stick axes before moving to dpad mode + joystickAxes.forEach(function (value, index) { + checkJoystickAxis(index, 0); + }); + } +} + +// check state for each axis -> dpad +function checkJoystickAxisState(name, state) { + if (joystickState[name] !== state) { + joystickState[name] = state; + pub(state === true ? KEY_PRESSED : KEY_RELEASED, {key: name}); + } +} + +function checkJoystickAxis(axis, value) { + if (-deadZone < value && value < deadZone) value = 0; + if (joystickAxes[axis] !== value) { + joystickAxes[axis] = value; + pub(AXIS_CHANGED, {id: axis, value: value}); + } +} + +// loop timer for checking joystick state +function checkJoystickState() { + let gamepad = navigator.getGamepads()[joystickIdx]; + if (gamepad) { + if (dpadMode) { + // axis -> dpad + let corX = gamepad.axes[0]; // -1 -> 1, left -> right + let corY = gamepad.axes[1]; // -1 -> 1, up -> down + checkJoystickAxisState(KEY.LEFT, corX <= -0.5); + checkJoystickAxisState(KEY.RIGHT, corX >= 0.5); + checkJoystickAxisState(KEY.UP, corY <= -0.5); + checkJoystickAxisState(KEY.DOWN, corY >= 0.5); + } else { + gamepad.axes.forEach(function (value, index) { + checkJoystickAxis(index, value); + }); + } + + // normal button map + Object.keys(joystickMap).forEach(function (btnIdx) { + const buttonState = gamepad.buttons[btnIdx]; + + const isPressed = navigator.webkitGetGamepads ? buttonState === 1 : + buttonState.value > 0 || buttonState.pressed === true; + + if (joystickState[btnIdx] !== isPressed) { + joystickState[btnIdx] = isPressed; + pub(isPressed === true ? KEY_PRESSED : KEY_RELEASED, {key: joystickMap[btnIdx]}); + } + }); + } +} + +// we only capture the last plugged joystick +const onGamepadConnected = (e) => { + let gamepad = e.gamepad; + log.info(`Gamepad connected at index ${gamepad.index}: ${gamepad.id}. ${gamepad.buttons.length} buttons, ${gamepad.axes.length} axes.`); + + joystickIdx = gamepad.index; + + // Ref: https://github.com/giongto35/cloud-game/issues/14 + // get mapping first (default KeyMap2) + let os = env.getOs(); + let browser = env.getBrowser(); + + if (os === 'android') { + // default of android is KeyMap1 + joystickMap = { + 2: KEY.A, + 0: KEY.B, + 3: KEY.START, + 4: KEY.SELECT, + 10: KEY.LOAD, + 11: KEY.SAVE, + 8: KEY.HELP, + 9: KEY.QUIT, + 12: KEY.UP, + 13: KEY.DOWN, + 14: KEY.LEFT, + 15: KEY.RIGHT + }; + } else { + // default of other OS is KeyMap2 + joystickMap = { + 0: KEY.A, + 1: KEY.B, + 2: KEY.START, + 3: KEY.SELECT, + 8: KEY.LOAD, + 9: KEY.SAVE, + 6: KEY.HELP, + 7: KEY.QUIT, + 12: KEY.UP, + 13: KEY.DOWN, + 14: KEY.LEFT, + 15: KEY.RIGHT + }; + } + + if (os === 'android' && (browser === 'firefox' || browser === 'uc')) { //KeyMap2 + joystickMap = { + 0: KEY.A, + 1: KEY.B, + 2: KEY.START, + 3: KEY.SELECT, + 8: KEY.LOAD, + 9: KEY.SAVE, + 6: KEY.HELP, + 7: KEY.QUIT, + 12: KEY.UP, + 13: KEY.DOWN, + 14: KEY.LEFT, + 15: KEY.RIGHT + }; + } + + if (os === 'win' && browser === 'firefox') { //KeyMap3 + joystickMap = { + 1: KEY.A, + 2: KEY.B, + 0: KEY.START, + 3: KEY.SELECT, + 8: KEY.LOAD, + 9: KEY.SAVE, + 6: KEY.HELP, + 7: KEY.QUIT + }; + } + + if (os === 'mac' && browser === 'safari') { //KeyMap4 + joystickMap = { + 1: KEY.A, + 2: KEY.B, + 0: KEY.START, + 3: KEY.SELECT, + 8: KEY.LOAD, + 9: KEY.SAVE, + 6: KEY.HELP, + 7: KEY.QUIT, + 14: KEY.UP, + 15: KEY.DOWN, + 16: KEY.LEFT, + 17: KEY.RIGHT + }; + } + + if (os === 'mac' && browser === 'firefox') { //KeyMap5 + joystickMap = { + 1: KEY.A, + 2: KEY.B, + 0: KEY.START, + 3: KEY.SELECT, + 8: KEY.LOAD, + 9: KEY.SAVE, + 6: KEY.HELP, + 7: KEY.QUIT, + 14: KEY.UP, + 15: KEY.DOWN, + 16: KEY.LEFT, + 17: KEY.RIGHT + }; + } + + // https://bugs.chromium.org/p/chromium/issues/detail?id=1076272 + if (gamepad.id.includes('PLAYSTATION(R)3')) { + if (browser === 'chrome') { + joystickMap = { + 1: KEY.A, + 0: KEY.B, + 2: KEY.Y, + 3: KEY.X, + 4: KEY.L, + 5: KEY.R, + 8: KEY.SELECT, + 9: KEY.START, + 10: KEY.DTOGGLE, + 11: KEY.R3, + }; + } else { + joystickMap = { + 13: KEY.A, + 14: KEY.B, + 12: KEY.X, + 15: KEY.Y, + 3: KEY.START, + 0: KEY.SELECT, + 4: KEY.UP, + 6: KEY.DOWN, + 7: KEY.LEFT, + 5: KEY.RIGHT, + 10: KEY.L, + 11: KEY.R, + 8: KEY.L2, + 9: KEY.R2, + 1: KEY.DTOGGLE, + 2: KEY.R3, + }; + } + } + + // reset state + joystickState = {[KEY.LEFT]: false, [KEY.RIGHT]: false, [KEY.UP]: false, [KEY.DOWN]: false}; + Object.keys(joystickMap).forEach(function (btnIdx) { + joystickState[btnIdx] = false; + }); + + joystickAxes = new Array(gamepad.axes.length).fill(0); + + // looper, too intense? + if (joystickTimer !== null) { + clearInterval(joystickTimer); + } + + joystickTimer = setInterval(checkJoystickState, 10); // milliseconds per hit + pub(GAMEPAD_CONNECTED); +}; + +sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); + /** * Joystick controls. * @@ -16,263 +273,18 @@ * * @version 1 */ -const joystick = (() => { - const deadZone = 0.1; - let joystickMap; - let joystickState = {}; - let joystickAxes = []; - let joystickIdx; - let joystickTimer = null; - let dpadMode = true; +export const joystick = { + init: () => { + // we only capture the last plugged joystick + window.addEventListener('gamepadconnected', onGamepadConnected); - function onDpadToggle(checked) { - if (dpadMode === checked) { - return //error? - } - if (dpadMode) { - dpadMode = false; - // reset dpad keys pressed before moving to analog stick mode - checkJoystickAxisState(KEY.LEFT, false); - checkJoystickAxisState(KEY.RIGHT, false); - checkJoystickAxisState(KEY.UP, false); - checkJoystickAxisState(KEY.DOWN, false); - } else { - dpadMode = true; - // reset analog stick axes before moving to dpad mode - joystickAxes.forEach(function (value, index) { - checkJoystickAxis(index, 0); - }); - } - } - - // check state for each axis -> dpad - function checkJoystickAxisState(name, state) { - if (joystickState[name] !== state) { - joystickState[name] = state; - event.pub(state === true ? KEY_PRESSED : KEY_RELEASED, {key: name}); - } - } - - function checkJoystickAxis(axis, value) { - if (-deadZone < value && value < deadZone) value = 0; - if (joystickAxes[axis] !== value) { - joystickAxes[axis] = value; - event.pub(AXIS_CHANGED, {id: axis, value: value}); - } - } - - // loop timer for checking joystick state - function checkJoystickState() { - let gamepad = navigator.getGamepads()[joystickIdx]; - if (gamepad) { - if (dpadMode) { - // axis -> dpad - let corX = gamepad.axes[0]; // -1 -> 1, left -> right - let corY = gamepad.axes[1]; // -1 -> 1, up -> down - checkJoystickAxisState(KEY.LEFT, corX <= -0.5); - checkJoystickAxisState(KEY.RIGHT, corX >= 0.5); - checkJoystickAxisState(KEY.UP, corY <= -0.5); - checkJoystickAxisState(KEY.DOWN, corY >= 0.5); - } else { - gamepad.axes.forEach(function (value, index) { - checkJoystickAxis(index, value); - }); - } - - // normal button map - Object.keys(joystickMap).forEach(function (btnIdx) { - const buttonState = gamepad.buttons[btnIdx]; - - const isPressed = navigator.webkitGetGamepads ? buttonState === 1 : - buttonState.value > 0 || buttonState.pressed === true; - - if (joystickState[btnIdx] !== isPressed) { - joystickState[btnIdx] = isPressed; - event.pub(isPressed === true ? KEY_PRESSED : KEY_RELEASED, {key: joystickMap[btnIdx]}); - } - }); - } - } - - // we only capture the last plugged joystick - const onGamepadConnected = (e) => { - let gamepad = e.gamepad; - log.info(`Gamepad connected at index ${gamepad.index}: ${gamepad.id}. ${gamepad.buttons.length} buttons, ${gamepad.axes.length} axes.`); - - joystickIdx = gamepad.index; - - // Ref: https://github.com/giongto35/cloud-game/issues/14 - // get mapping first (default KeyMap2) - let os = env.getOs(); - let browser = env.getBrowser(); - - if (os === 'android') { - // default of android is KeyMap1 - joystickMap = { - 2: KEY.A, - 0: KEY.B, - 3: KEY.START, - 4: KEY.SELECT, - 10: KEY.LOAD, - 11: KEY.SAVE, - 8: KEY.HELP, - 9: KEY.QUIT, - 12: KEY.UP, - 13: KEY.DOWN, - 14: KEY.LEFT, - 15: KEY.RIGHT - }; - } else { - // default of other OS is KeyMap2 - joystickMap = { - 0: KEY.A, - 1: KEY.B, - 2: KEY.START, - 3: KEY.SELECT, - 8: KEY.LOAD, - 9: KEY.SAVE, - 6: KEY.HELP, - 7: KEY.QUIT, - 12: KEY.UP, - 13: KEY.DOWN, - 14: KEY.LEFT, - 15: KEY.RIGHT - }; - } - - if (os === 'android' && (browser === 'firefox' || browser === 'uc')) { //KeyMap2 - joystickMap = { - 0: KEY.A, - 1: KEY.B, - 2: KEY.START, - 3: KEY.SELECT, - 8: KEY.LOAD, - 9: KEY.SAVE, - 6: KEY.HELP, - 7: KEY.QUIT, - 12: KEY.UP, - 13: KEY.DOWN, - 14: KEY.LEFT, - 15: KEY.RIGHT - }; - } - - if (os === 'win' && browser === 'firefox') { //KeyMap3 - joystickMap = { - 1: KEY.A, - 2: KEY.B, - 0: KEY.START, - 3: KEY.SELECT, - 8: KEY.LOAD, - 9: KEY.SAVE, - 6: KEY.HELP, - 7: KEY.QUIT - }; - } - - if (os === 'mac' && browser === 'safari') { //KeyMap4 - joystickMap = { - 1: KEY.A, - 2: KEY.B, - 0: KEY.START, - 3: KEY.SELECT, - 8: KEY.LOAD, - 9: KEY.SAVE, - 6: KEY.HELP, - 7: KEY.QUIT, - 14: KEY.UP, - 15: KEY.DOWN, - 16: KEY.LEFT, - 17: KEY.RIGHT - }; - } - - if (os === 'mac' && browser === 'firefox') { //KeyMap5 - joystickMap = { - 1: KEY.A, - 2: KEY.B, - 0: KEY.START, - 3: KEY.SELECT, - 8: KEY.LOAD, - 9: KEY.SAVE, - 6: KEY.HELP, - 7: KEY.QUIT, - 14: KEY.UP, - 15: KEY.DOWN, - 16: KEY.LEFT, - 17: KEY.RIGHT - }; - } - - // https://bugs.chromium.org/p/chromium/issues/detail?id=1076272 - if (gamepad.id.includes('PLAYSTATION(R)3')) { - if (browser === 'chrome') { - joystickMap = { - 1: KEY.A, - 0: KEY.B, - 2: KEY.Y, - 3: KEY.X, - 4: KEY.L, - 5: KEY.R, - 8: KEY.SELECT, - 9: KEY.START, - 10: KEY.DTOGGLE, - 11: KEY.R3, - }; - } else { - joystickMap = { - 13: KEY.A, - 14: KEY.B, - 12: KEY.X, - 15: KEY.Y, - 3: KEY.START, - 0: KEY.SELECT, - 4: KEY.UP, - 6: KEY.DOWN, - 7: KEY.LEFT, - 5: KEY.RIGHT, - 10: KEY.L, - 11: KEY.R, - 8: KEY.L2, - 9: KEY.R2, - 1: KEY.DTOGGLE, - 2: KEY.R3, - }; - } - } - - // reset state - joystickState = {[KEY.LEFT]: false, [KEY.RIGHT]: false, [KEY.UP]: false, [KEY.DOWN]: false}; - Object.keys(joystickMap).forEach(function (btnIdx) { - joystickState[btnIdx] = false; + // disconnected event is triggered + window.addEventListener('gamepaddisconnected', (event) => { + clearInterval(joystickTimer); + log.info(`Gamepad disconnected at index ${event.gamepad.index}`); + pub(GAMEPAD_DISCONNECTED); }); - joystickAxes = new Array(gamepad.axes.length).fill(0); - - // looper, too intense? - if (joystickTimer !== null) { - clearInterval(joystickTimer); - } - - joystickTimer = setInterval(checkJoystickState, 10); // miliseconds per hit - event.pub(GAMEPAD_CONNECTED); - }; - - event.sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); - - return { - init: () => { - // we only capture the last plugged joystick - window.addEventListener('gamepadconnected', onGamepadConnected); - - // disconnected event is triggered - window.addEventListener('gamepaddisconnected', (event) => { - clearInterval(joystickTimer); - log.info(`Gamepad disconnected at index ${event.gamepad.index}`); - event.pub(GAMEPAD_DISCONNECTED); - }); - - log.info('[input] joystick has been initialized'); - } + log.info('[input] joystick has been initialized'); } -})(event, env, KEY, navigator, window); +} diff --git a/web/js/input/keyboard.js b/web/js/input/keyboard.js index 7b46c2cb..1ccba499 100644 --- a/web/js/input/keyboard.js +++ b/web/js/input/keyboard.js @@ -1,131 +1,142 @@ +import { + pub, + sub, + KEYBOARD_TOGGLE_FILTER_MODE, + AXIS_CHANGED, + DPAD_TOGGLE, + KEY_PRESSED, + KEY_RELEASED, + KEYBOARD_KEY_PRESSED +} from 'event'; +import {KEY} from 'input'; +import {log} from 'log' +import {opts, settings} from 'settings'; + +// default keyboard bindings +const defaultMap = Object.freeze({ + ArrowLeft: KEY.LEFT, + ArrowUp: KEY.UP, + ArrowRight: KEY.RIGHT, + ArrowDown: KEY.DOWN, + KeyZ: KEY.A, + KeyX: KEY.B, + KeyC: KEY.X, + KeyV: KEY.Y, + KeyA: KEY.L, + KeyS: KEY.R, + Semicolon: KEY.L2, + Quote: KEY.R2, + Period: KEY.L3, + Slash: KEY.R3, + Enter: KEY.START, + ShiftLeft: KEY.SELECT, + // non-game + KeyQ: KEY.QUIT, + KeyW: KEY.JOIN, + KeyK: KEY.SAVE, + KeyL: KEY.LOAD, + Digit1: KEY.PAD1, + Digit2: KEY.PAD2, + Digit3: KEY.PAD3, + Digit4: KEY.PAD4, + KeyF: KEY.FULL, + KeyH: KEY.HELP, + Backslash: KEY.STATS, + Digit9: KEY.SETTINGS, + KeyT: KEY.DTOGGLE +}); + +let keyMap = {}; +let isKeysFilteredMode = true; + +const remap = (map = {}) => { + settings.set(opts.INPUT_KEYBOARD_MAP, map); + log.info('Keyboard keys have been remapped') +} + +sub(KEYBOARD_TOGGLE_FILTER_MODE, data => { + isKeysFilteredMode = data.mode !== undefined ? data.mode : !isKeysFilteredMode; + log.debug(`New keyboard filter mode: ${isKeysFilteredMode}`); +}); + +let dpadMode = true; +let dpadState = {[KEY.LEFT]: false, [KEY.RIGHT]: false, [KEY.UP]: false, [KEY.DOWN]: false}; + +function onDpadToggle(checked) { + if (dpadMode === checked) { + return //error? + } + + dpadMode = !dpadMode + if (dpadMode) { + // reset dpad keys pressed before moving to analog stick mode + for (const key in dpadState) { + if (dpadState[key]) { + dpadState[key] = false; + pub(KEY_RELEASED, {key: key}); + } + } + } else { + // reset analog stick axes before moving to dpad mode + if (!!dpadState[KEY.RIGHT] - !!dpadState[KEY.LEFT] !== 0) { + pub(AXIS_CHANGED, {id: 0, value: 0}); + } + if (!!dpadState[KEY.DOWN] - !!dpadState[KEY.UP] !== 0) { + pub(AXIS_CHANGED, {id: 1, value: 0}); + } + dpadState = {[KEY.LEFT]: false, [KEY.RIGHT]: false, [KEY.UP]: false, [KEY.DOWN]: false}; + } +} + +const onKey = (code, evt, state) => { + const key = keyMap[code] + if (key === undefined) return + + if (dpadState[key] !== undefined) { + dpadState[key] = state + if (!dpadMode) { + const LR = key === KEY.LEFT || key === KEY.RIGHT + pub(AXIS_CHANGED, { + id: !LR, + value: !!dpadState[LR ? KEY.RIGHT : KEY.DOWN] - !!dpadState[LR ? KEY.LEFT : KEY.UP] + }) + return + } + } + pub(evt, {key: key}) +} + +sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); + /** * Keyboard controls. - * - * @version 1 */ -const keyboard = (() => { - // default keyboard bindings - const defaultMap = Object.freeze({ - ArrowLeft: KEY.LEFT, - ArrowUp: KEY.UP, - ArrowRight: KEY.RIGHT, - ArrowDown: KEY.DOWN, - KeyZ: KEY.A, - KeyX: KEY.B, - KeyC: KEY.X, - KeyV: KEY.Y, - KeyA: KEY.L, - KeyS: KEY.R, - Semicolon: KEY.L2, - Quote: KEY.R2, - Period: KEY.L3, - Slash: KEY.R3, - Enter: KEY.START, - ShiftLeft: KEY.SELECT, - // non-game - KeyQ: KEY.QUIT, - KeyW: KEY.JOIN, - KeyK: KEY.SAVE, - KeyL: KEY.LOAD, - Digit1: KEY.PAD1, - Digit2: KEY.PAD2, - Digit3: KEY.PAD3, - Digit4: KEY.PAD4, - KeyF: KEY.FULL, - KeyH: KEY.HELP, - Backslash: KEY.STATS, - Digit9: KEY.SETTINGS, - KeyT: KEY.DTOGGLE - }); - - let keyMap = {}; - let isKeysFilteredMode = true; - - const remap = (map = {}) => { - settings.set(opts.INPUT_KEYBOARD_MAP, map); - log.info('Keyboard keys have been remapped') - } - - event.sub(KEYBOARD_TOGGLE_FILTER_MODE, data => { - isKeysFilteredMode = data.mode !== undefined ? data.mode : !isKeysFilteredMode; - log.debug(`New keyboard filter mode: ${isKeysFilteredMode}`); - }); - - let dpadMode = true; - let dpadState = {[KEY.LEFT]: false, [KEY.RIGHT]: false, [KEY.UP]: false, [KEY.DOWN]: false}; - - function onDpadToggle(checked) { - if (dpadMode === checked) { - return //error? - } - - dpadMode = !dpadMode - if (dpadMode) { - // reset dpad keys pressed before moving to analog stick mode - for (const key in dpadState) { - if (dpadState[key]) { - dpadState[key] = false; - event.pub(KEY_RELEASED, {key: key}); - } +export const keyboard = { + init: () => { + keyMap = settings.loadOr(opts.INPUT_KEYBOARD_MAP, defaultMap); + const body = document.body; + // !to use prevent default as everyone + body.addEventListener('keyup', e => { + e.stopPropagation(); + if (isKeysFilteredMode) { + onKey(e.code, KEY_RELEASED, false) + } else { + pub(KEYBOARD_KEY_PRESSED, {key: e.code}); } - } else { - // reset analog stick axes before moving to dpad mode - if (!!dpadState[KEY.RIGHT] - !!dpadState[KEY.LEFT] !== 0) { - event.pub(AXIS_CHANGED, {id: 0, value: 0}); + }, false); + + body.addEventListener('keydown', e => { + e.stopPropagation(); + if (isKeysFilteredMode) { + onKey(e.code, KEY_PRESSED, true) + } else { + pub(KEYBOARD_KEY_PRESSED, {key: e.code}); } - if (!!dpadState[KEY.DOWN] - !!dpadState[KEY.UP] !== 0) { - event.pub(AXIS_CHANGED, {id: 1, value: 0}); - } - dpadState = {[KEY.LEFT]: false, [KEY.RIGHT]: false, [KEY.UP]: false, [KEY.DOWN]: false}; - } + }); + + log.info('[input] keyboard has been initialized'); + }, + settings: { + remap } - - const onKey = (code, evt, state) => { - const key = keyMap[code] - if (key === undefined) return - - if (dpadState[key] !== undefined) { - dpadState[key] = state - if (!dpadMode) { - const LR = key === KEY.LEFT || key === KEY.RIGHT - event.pub(AXIS_CHANGED, { - id: !LR, - value: !!dpadState[LR ? KEY.RIGHT : KEY.DOWN] - !!dpadState[LR ? KEY.LEFT : KEY.UP] - }) - return - } - } - event.pub(evt, {key: key}) - } - - event.sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); - - return { - init: () => { - keyMap = settings.loadOr(opts.INPUT_KEYBOARD_MAP, defaultMap); - const body = document.body; - // !to use prevent default as everyone - body.addEventListener('keyup', e => { - e.stopPropagation(); - if (isKeysFilteredMode) { - onKey(e.code, KEY_RELEASED, false) - } else { - event.pub(KEYBOARD_KEY_PRESSED, {key: e.code}); - } - }, false); - - body.addEventListener('keydown', e => { - e.stopPropagation(); - if (isKeysFilteredMode) { - onKey(e.code, KEY_PRESSED, true) - } else { - event.pub(KEYBOARD_KEY_PRESSED, {key: e.code}); - } - }); - - log.info('[input] keyboard has been initialized'); - }, settings: { - remap - } - } -})(event, document, KEY, log, opts, settings); +} diff --git a/web/js/input/keys.js b/web/js/input/keys.js index 7b16777c..6f94c2ff 100644 --- a/web/js/input/keys.js +++ b/web/js/input/keys.js @@ -1,34 +1,32 @@ -const KEY = (() => { - return { - A: 'a', - B: 'b', - X: 'x', - Y: 'y', - L: 'l', - R: 'r', - START: 'start', - SELECT: 'select', - LOAD: 'load', - SAVE: 'save', - HELP: 'help', - JOIN: 'join', - FULL: 'full', - QUIT: 'quit', - UP: 'up', - DOWN: 'down', - LEFT: 'left', - RIGHT: 'right', - PAD1: 'pad1', - PAD2: 'pad2', - PAD3: 'pad3', - PAD4: 'pad4', - STATS: 'stats', - SETTINGS: 'settings', - DTOGGLE: 'dtoggle', - L2: 'l2', - R2: 'r2', - L3: 'l3', - R3: 'r3', - REC: 'rec', - } -})(); +export const KEY = { + A: 'a', + B: 'b', + X: 'x', + Y: 'y', + L: 'l', + R: 'r', + START: 'start', + SELECT: 'select', + LOAD: 'load', + SAVE: 'save', + HELP: 'help', + JOIN: 'join', + FULL: 'full', + QUIT: 'quit', + UP: 'up', + DOWN: 'down', + LEFT: 'left', + RIGHT: 'right', + PAD1: 'pad1', + PAD2: 'pad2', + PAD3: 'pad3', + PAD4: 'pad4', + STATS: 'stats', + SETTINGS: 'settings', + DTOGGLE: 'dtoggle', + L2: 'l2', + R2: 'r2', + L3: 'l3', + R3: 'r3', + REC: 'rec', +} diff --git a/web/js/input/retropad.js b/web/js/input/retropad.js new file mode 100644 index 00000000..e841dea6 --- /dev/null +++ b/web/js/input/retropad.js @@ -0,0 +1,98 @@ +import { + pub, + CONTROLLER_UPDATED +} from 'event'; +import {KEY} from 'input' +import {log} from 'log'; + +const pollingIntervalMs = 4; +let controllerChangedIndex = -1; + +// Libretro config +let controllerState = { + [KEY.B]: false, + [KEY.Y]: false, + [KEY.SELECT]: false, + [KEY.START]: false, + [KEY.UP]: false, + [KEY.DOWN]: false, + [KEY.LEFT]: false, + [KEY.RIGHT]: false, + [KEY.A]: false, + [KEY.X]: false, + // extra + [KEY.L]: false, + [KEY.R]: false, + [KEY.L2]: false, + [KEY.R2]: false, + [KEY.L3]: false, + [KEY.R3]: false +}; + +const poll = (intervalMs, callback) => { + let _ticker = 0; + return { + enable: () => { + if (_ticker > 0) return; + log.debug(`[input] poll set to ${intervalMs}ms`); + _ticker = setInterval(callback, intervalMs) + }, + disable: () => { + if (_ticker < 1) return; + log.debug('[input] poll has been disabled'); + clearInterval(_ticker); + _ticker = 0; + } + } +}; + +const controllerEncoded = [0, 0, 0, 0, 0]; +const keys = Object.keys(controllerState); + +const sendControllerState = () => { + if (controllerChangedIndex >= 0) { + const state = _getState(); + pub(CONTROLLER_UPDATED, _encodeState(state)); + controllerChangedIndex = -1; + } +}; + +const setKeyState = (name, state) => { + if (controllerState[name] !== undefined) { + controllerState[name] = state; + controllerChangedIndex = Math.max(controllerChangedIndex, 0); + } +}; + +const setAxisChanged = (index, value) => { + if (controllerEncoded[index + 1] !== undefined) { + controllerEncoded[index + 1] = Math.floor(32767 * value); + controllerChangedIndex = Math.max(controllerChangedIndex, index + 1); + } +}; + +/** + * Converts key state into a bitmap and prepends it to the axes state. + * + * @returns {Uint16Array} The controller state. + * First uint16 is the controller state bitmap. + * The other uint16 are the axes values. + * Truncated to the last value changed. + * + * @private + */ +const _encodeState = (state) => new Uint16Array(state) + +const _getState = () => { + controllerEncoded[0] = 0; + for (let i = 0, len = keys.length; i < len; i++) { + controllerEncoded[0] += controllerState[keys[i]] ? 1 << i : 0; + } + return controllerEncoded.slice(0, controllerChangedIndex + 1); +} + +export const retropad = { + poll: poll(pollingIntervalMs, sendControllerState), + setKeyState, + setAxisChanged, +} diff --git a/web/js/input/touch.js b/web/js/input/touch.js index a0a8c32d..a246ef56 100644 --- a/web/js/input/touch.js +++ b/web/js/input/touch.js @@ -1,3 +1,300 @@ +import {env} from 'env'; +import { + pub, + sub, + AXIS_CHANGED, + KEY_PRESSED, + KEY_RELEASED, + GAME_PLAYER_IDX, + DPAD_TOGGLE, + MENU_HANDLER_ATTACHED, + MENU_PRESSED, + MENU_RELEASED +} from 'event'; +import {KEY} from 'input'; +import {log} from 'log'; + +const MAX_DIFF = 20; // radius of circle boundary + +// vpad state, use for mouse button down +let vpadState = {[KEY.UP]: false, [KEY.DOWN]: false, [KEY.LEFT]: false, [KEY.RIGHT]: false}; +let analogState = [0, 0]; + +let vpadTouchIdx = null; +let vpadTouchDrag = null; +let vpadHolder = document.getElementById('circle-pad-holder'); +let vpadCircle = document.getElementById('circle-pad'); + +const buttons = Array.from(document.getElementsByClassName('btn')); +const playerSlider = document.getElementById('playeridx'); +const dpad = Array.from(document.getElementsByClassName('dpad')); + +const dpadToggle = document.getElementById('dpad-toggle') +dpadToggle.addEventListener('change', (e) => { + pub(DPAD_TOGGLE, {checked: e.target.checked}); +}); + +let dpadMode = true; +const deadZone = 0.1; + +function onDpadToggle(checked) { + if (dpadMode === checked) { + return //error? + } + if (dpadMode) { + dpadMode = false; + vpadHolder.classList.add('dpad-empty'); + vpadCircle.classList.add('bong-full'); + // reset dpad keys pressed before moving to analog stick mode + resetVpadState() + } else { + dpadMode = true; + vpadHolder.classList.remove('dpad-empty'); + vpadCircle.classList.remove('bong-full'); + } +} + +function resetVpadState() { + if (dpadMode) { + // trigger up event? + checkVpadState(KEY.UP, false); + checkVpadState(KEY.DOWN, false); + checkVpadState(KEY.LEFT, false); + checkVpadState(KEY.RIGHT, false); + } else { + checkAnalogState(0, 0); + checkAnalogState(1, 0); + } + + vpadTouchDrag = null; + vpadTouchIdx = null; + + dpad.forEach(arrow => arrow.classList.remove('pressed')); +} + +function checkVpadState(axis, state) { + if (state !== vpadState[axis]) { + vpadState[axis] = state; + pub(state ? KEY_PRESSED : KEY_RELEASED, {key: axis}); + } +} + +function checkAnalogState(axis, value) { + if (-deadZone < value && value < deadZone) value = 0; + if (analogState[axis] !== value) { + analogState[axis] = value; + pub(AXIS_CHANGED, {id: axis, value: value}); + } +} + +function handleVpadJoystickDown(event) { + vpadCircle.style['transition'] = '0s'; + + if (event.changedTouches) { + resetVpadState(); + vpadTouchIdx = event.changedTouches[0].identifier; + event.clientX = event.changedTouches[0].clientX; + event.clientY = event.changedTouches[0].clientY; + } + + vpadTouchDrag = {x: event.clientX, y: event.clientY}; +} + +function handleVpadJoystickUp() { + if (vpadTouchDrag === null) return; + + vpadCircle.style['transition'] = '.2s'; + vpadCircle.style['transform'] = 'translate3d(0px, 0px, 0px)'; + + resetVpadState(); +} + +function handleVpadJoystickMove(event) { + if (vpadTouchDrag === null) return; + + if (event.changedTouches) { + // check if moving source is from other touch? + for (let i = 0; i < event.changedTouches.length; i++) { + if (event.changedTouches[i].identifier === vpadTouchIdx) { + event.clientX = event.changedTouches[i].clientX; + event.clientY = event.changedTouches[i].clientY; + } + } + if (event.clientX === undefined || event.clientY === undefined) + return; + } + + let xDiff = event.clientX - vpadTouchDrag.x; + let yDiff = event.clientY - vpadTouchDrag.y; + let angle = Math.atan2(yDiff, xDiff); + let distance = Math.min(MAX_DIFF, Math.hypot(xDiff, yDiff)); + let xNew = distance * Math.cos(angle); + let yNew = distance * Math.sin(angle); + + if (env.display().isLayoutSwitched) { + let tmp = xNew; + xNew = yNew; + yNew = -tmp; + } + + vpadCircle.style['transform'] = `translate(${xNew}px, ${yNew}px)`; + + let xRatio = xNew / MAX_DIFF; + let yRatio = yNew / MAX_DIFF; + + if (dpadMode) { + checkVpadState(KEY.LEFT, xRatio <= -0.5); + checkVpadState(KEY.RIGHT, xRatio >= 0.5); + checkVpadState(KEY.UP, yRatio <= -0.5); + checkVpadState(KEY.DOWN, yRatio >= 0.5); + } else { + checkAnalogState(0, xRatio); + checkAnalogState(1, yRatio); + } +} + +// right side - control buttons +const _handleButton = (key, state) => checkVpadState(key, state) + +function handleButtonDown() { + _handleButton(this.getAttribute('value'), true); +} + +function handleButtonUp() { + _handleButton(this.getAttribute('value'), false); +} + +function handleButtonClick() { + _handleButton(this.getAttribute('value'), true); + setTimeout(() => { + _handleButton(this.getAttribute('value'), false); + }, 30); +} + +function handlePlayerSlider() { + pub(GAME_PLAYER_IDX, {index: this.value - 1}); +} + +// Touch menu +let menuTouchIdx = null; +let menuTouchDrag = null; +let menuTouchTime = null; + +function handleMenuDown(event) { + // Identify of touch point + if (event.changedTouches) { + menuTouchIdx = event.changedTouches[0].identifier; + event.clientX = event.changedTouches[0].clientX; + event.clientY = event.changedTouches[0].clientY; + } + + menuTouchDrag = {x: event.clientX, y: event.clientY,}; + menuTouchTime = Date.now(); +} + +function handleMenuMove(evt) { + if (menuTouchDrag === null) return; + + if (evt.changedTouches) { + // check if moving source is from other touch? + for (let i = 0; i < evt.changedTouches.length; i++) { + if (evt.changedTouches[i].identifier === menuTouchIdx) { + evt.clientX = evt.changedTouches[i].clientX; + evt.clientY = evt.changedTouches[i].clientY; + } + } + if (evt.clientX === undefined || evt.clientY === undefined) + return; + } + + const pos = env.display().isLayoutSwitched ? evt.clientX - menuTouchDrag.x : menuTouchDrag.y - evt.clientY; + pub(MENU_PRESSED, pos); +} + +function handleMenuUp(evt) { + if (menuTouchDrag === null) return; + if (evt.changedTouches) { + if (evt.changedTouches[0].identifier !== menuTouchIdx) + return; + evt.clientX = evt.changedTouches[0].clientX; + evt.clientY = evt.changedTouches[0].clientY; + } + + let newY = env.display().isLayoutSwitched ? -menuTouchDrag.x + evt.clientX : menuTouchDrag.y - evt.clientY; + + let interval = Date.now() - menuTouchTime; // 100ms? + if (interval < 200) { + // calc velocity + newY = newY / interval * 250; + } + + // current item? + pub(MENU_RELEASED, newY); + menuTouchDrag = null; +} + +// Common events +function handleWindowMove(event) { + event.preventDefault(); + handleVpadJoystickMove(event); + handleMenuMove(event); + + // moving touch + if (event.changedTouches) { + for (let i = 0; i < event.changedTouches.length; i++) { + if (event.changedTouches[i].identifier !== menuTouchIdx && event.changedTouches[i].identifier !== vpadTouchIdx) { + // check class + + let elem = document.elementFromPoint(event.changedTouches[i].clientX, event.changedTouches[i].clientY); + + if (elem.classList.contains('btn')) { + elem.dispatchEvent(new Event('touchstart')); + } else { + elem.dispatchEvent(new Event('touchend')); + } + } + } + } +} + +function handleWindowUp(ev) { + handleVpadJoystickUp(ev); + handleMenuUp(ev); + buttons.forEach((btn) => { + btn.dispatchEvent(new Event('touchend')); + }); +} + +// touch/mouse events for control buttons. mouseup events is bound to window. +buttons.forEach((btn) => { + btn.addEventListener('mousedown', handleButtonDown); + btn.addEventListener('touchstart', handleButtonDown, {passive: true}); + btn.addEventListener('touchend', handleButtonUp); +}); + +// touch/mouse events for dpad. mouseup events is bound to window. +vpadHolder.addEventListener('mousedown', handleVpadJoystickDown); +vpadHolder.addEventListener('touchstart', handleVpadJoystickDown, {passive: true}); +vpadHolder.addEventListener('touchend', handleVpadJoystickUp); + +dpad.forEach((arrow) => { + arrow.addEventListener('click', handleButtonClick); +}); + +// touch/mouse events for player slider. +playerSlider.addEventListener('oninput', handlePlayerSlider); +playerSlider.addEventListener('onchange', handlePlayerSlider); +playerSlider.addEventListener('click', handlePlayerSlider); +playerSlider.addEventListener('touchend', handlePlayerSlider); + +// Bind events for menu +// TODO change this flow +pub(MENU_HANDLER_ATTACHED, {event: 'mousedown', handler: handleMenuDown}); +pub(MENU_HANDLER_ATTACHED, {event: 'touchstart', handler: handleMenuDown}); +pub(MENU_HANDLER_ATTACHED, {event: 'touchend', handler: handleMenuUp}); + +sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); + /** * Touch controls. * @@ -7,300 +304,17 @@ * @link https://jsfiddle.net/aa0et7tr/5/ * @version 1 */ -const touch = (() => { - const MAX_DIFF = 20; // radius of circle boundary - - // vpad state, use for mouse button down - let vpadState = {[KEY.UP]: false, [KEY.DOWN]: false, [KEY.LEFT]: false, [KEY.RIGHT]: false}; - let analogState = [0, 0]; - - let vpadTouchIdx = null; - let vpadTouchDrag = null; - let vpadHolder = document.getElementById('circle-pad-holder'); - let vpadCircle = document.getElementById('circle-pad'); - - const buttons = Array.from(document.getElementsByClassName('btn')); - const playerSlider = document.getElementById('playeridx'); - const dpad = Array.from(document.getElementsByClassName('dpad')); - - const dpadToggle = document.getElementById('dpad-toggle') - dpadToggle.addEventListener('change', (e) => { - event.pub(DPAD_TOGGLE, {checked: e.target.checked}); - }); - - let dpadMode = true; - const deadZone = 0.1; - - function onDpadToggle(checked) { - if (dpadMode === checked) { - return //error? - } - if (dpadMode) { - dpadMode = false; - vpadHolder.classList.add('dpad-empty'); - vpadCircle.classList.add('bong-full'); - // reset dpad keys pressed before moving to analog stick mode - resetVpadState() - } else { - dpadMode = true; - vpadHolder.classList.remove('dpad-empty'); - vpadCircle.classList.remove('bong-full'); - } - } - - function resetVpadState() { - if (dpadMode) { - // trigger up event? - checkVpadState(KEY.UP, false); - checkVpadState(KEY.DOWN, false); - checkVpadState(KEY.LEFT, false); - checkVpadState(KEY.RIGHT, false); - } else { - checkAnalogState(0, 0); - checkAnalogState(1, 0); - } - - vpadTouchDrag = null; - vpadTouchIdx = null; - - dpad.forEach(arrow => arrow.classList.remove('pressed')); - } - - function checkVpadState(axis, state) { - if (state !== vpadState[axis]) { - vpadState[axis] = state; - event.pub(state ? KEY_PRESSED : KEY_RELEASED, {key: axis}); - } - } - - function checkAnalogState(axis, value) { - if (-deadZone < value && value < deadZone) value = 0; - if (analogState[axis] !== value) { - analogState[axis] = value; - event.pub(AXIS_CHANGED, {id: axis, value: value}); - } - } - - function handleVpadJoystickDown(event) { - vpadCircle.style['transition'] = '0s'; - - if (event.changedTouches) { - resetVpadState(); - vpadTouchIdx = event.changedTouches[0].identifier; - event.clientX = event.changedTouches[0].clientX; - event.clientY = event.changedTouches[0].clientY; - } - - vpadTouchDrag = {x: event.clientX, y: event.clientY}; - } - - function handleVpadJoystickUp() { - if (vpadTouchDrag === null) return; - - vpadCircle.style['transition'] = '.2s'; - vpadCircle.style['transform'] = 'translate3d(0px, 0px, 0px)'; - - resetVpadState(); - } - - function handleVpadJoystickMove(event) { - if (vpadTouchDrag === null) return; - - if (event.changedTouches) { - // check if moving source is from other touch? - for (let i = 0; i < event.changedTouches.length; i++) { - if (event.changedTouches[i].identifier === vpadTouchIdx) { - event.clientX = event.changedTouches[i].clientX; - event.clientY = event.changedTouches[i].clientY; - } - } - if (event.clientX === undefined || event.clientY === undefined) - return; - } - - let xDiff = event.clientX - vpadTouchDrag.x; - let yDiff = event.clientY - vpadTouchDrag.y; - let angle = Math.atan2(yDiff, xDiff); - let distance = Math.min(MAX_DIFF, Math.hypot(xDiff, yDiff)); - let xNew = distance * Math.cos(angle); - let yNew = distance * Math.sin(angle); - - if (env.display().isLayoutSwitched) { - let tmp = xNew; - xNew = yNew; - yNew = -tmp; - } - - vpadCircle.style['transform'] = `translate(${xNew}px, ${yNew}px)`; - - let xRatio = xNew / MAX_DIFF; - let yRatio = yNew / MAX_DIFF; - - if (dpadMode) { - checkVpadState(KEY.LEFT, xRatio <= -0.5); - checkVpadState(KEY.RIGHT, xRatio >= 0.5); - checkVpadState(KEY.UP, yRatio <= -0.5); - checkVpadState(KEY.DOWN, yRatio >= 0.5); - } else { - checkAnalogState(0, xRatio); - checkAnalogState(1, yRatio); - } - } - - // right side - control buttons - const _handleButton = (key, state) => checkVpadState(key, state) - - function handleButtonDown() { - _handleButton(this.getAttribute('value'), true); - } - - function handleButtonUp() { - _handleButton(this.getAttribute('value'), false); - } - - function handleButtonClick() { - _handleButton(this.getAttribute('value'), true); - setTimeout(() => { - _handleButton(this.getAttribute('value'), false); - }, 30); - } - - function handlePlayerSlider() { - event.pub(GAME_PLAYER_IDX, {index: this.value - 1}); - } - - // Touch menu - let menuTouchIdx = null; - let menuTouchDrag = null; - let menuTouchTime = null; - - function handleMenuDown(event) { - // Identify of touch point - if (event.changedTouches) { - menuTouchIdx = event.changedTouches[0].identifier; - event.clientX = event.changedTouches[0].clientX; - event.clientY = event.changedTouches[0].clientY; - } - - menuTouchDrag = {x: event.clientX, y: event.clientY,}; - menuTouchTime = Date.now(); - } - - function handleMenuMove(evt) { - if (menuTouchDrag === null) return; - - if (evt.changedTouches) { - // check if moving source is from other touch? - for (let i = 0; i < evt.changedTouches.length; i++) { - if (evt.changedTouches[i].identifier === menuTouchIdx) { - evt.clientX = evt.changedTouches[i].clientX; - evt.clientY = evt.changedTouches[i].clientY; - } - } - if (evt.clientX === undefined || evt.clientY === undefined) - return; - } - - const pos = env.display().isLayoutSwitched ? evt.clientX - menuTouchDrag.x : menuTouchDrag.y - evt.clientY; - event.pub(MENU_PRESSED, pos); - } - - function handleMenuUp(evt) { - if (menuTouchDrag === null) return; - if (evt.changedTouches) { - if (evt.changedTouches[0].identifier !== menuTouchIdx) - return; - evt.clientX = evt.changedTouches[0].clientX; - evt.clientY = evt.changedTouches[0].clientY; - } - - let newY = env.display().isLayoutSwitched ? -menuTouchDrag.x + evt.clientX : menuTouchDrag.y - evt.clientY; - - let interval = Date.now() - menuTouchTime; // 100ms? - if (interval < 200) { - // calc velo - newY = newY / interval * 250; - } - - // current item? - event.pub(MENU_RELEASED, newY); - menuTouchDrag = null; - } - - // Common events - function handleWindowMove(event) { - event.preventDefault(); - handleVpadJoystickMove(event); - handleMenuMove(event); - - // moving touch - if (event.changedTouches) { - for (let i = 0; i < event.changedTouches.length; i++) { - if (event.changedTouches[i].identifier !== menuTouchIdx && event.changedTouches[i].identifier !== vpadTouchIdx) { - // check class - - let elem = document.elementFromPoint(event.changedTouches[i].clientX, event.changedTouches[i].clientY); - - if (elem.classList.contains('btn')) { - elem.dispatchEvent(new Event('touchstart')); - } else { - elem.dispatchEvent(new Event('touchend')); - } - } - } - } - } - - function handleWindowUp(ev) { - handleVpadJoystickUp(ev); - handleMenuUp(ev); - buttons.forEach((btn) => { - btn.dispatchEvent(new Event('touchend')); +export const touch = { + init: () => { + // add buttons into the state 🤦 + Array.from(document.querySelectorAll('.btn,.btn-big')).forEach((el) => { + vpadState[el.getAttribute('value')] = false; }); + + window.addEventListener('mousemove', handleWindowMove); + window.addEventListener('touchmove', handleWindowMove, {passive: false}); + window.addEventListener('mouseup', handleWindowUp); + + log.info('[input] touch input has been initialized'); } - - // touch/mouse events for control buttons. mouseup events is binded to window. - buttons.forEach((btn) => { - btn.addEventListener('mousedown', handleButtonDown); - btn.addEventListener('touchstart', handleButtonDown, {passive: true}); - btn.addEventListener('touchend', handleButtonUp); - }); - - // touch/mouse events for dpad. mouseup events is binded to window. - vpadHolder.addEventListener('mousedown', handleVpadJoystickDown); - vpadHolder.addEventListener('touchstart', handleVpadJoystickDown, {passive: true}); - vpadHolder.addEventListener('touchend', handleVpadJoystickUp); - - dpad.forEach((arrow) => { - arrow.addEventListener('click', handleButtonClick); - }); - - // touch/mouse events for player slider. - playerSlider.addEventListener('oninput', handlePlayerSlider); - playerSlider.addEventListener('onchange', handlePlayerSlider); - playerSlider.addEventListener('click', handlePlayerSlider); - playerSlider.addEventListener('touchend', handlePlayerSlider); - - // Bind events for menu - // TODO change this flow - event.pub(MENU_HANDLER_ATTACHED, {event: 'mousedown', handler: handleMenuDown}); - event.pub(MENU_HANDLER_ATTACHED, {event: 'touchstart', handler: handleMenuDown}); - event.pub(MENU_HANDLER_ATTACHED, {event: 'touchend', handler: handleMenuUp}); - - event.sub(DPAD_TOGGLE, (data) => onDpadToggle(data.checked)); - - return { - init: () => { - // add buttons into the state 🤦 - Array.from(document.querySelectorAll('.btn,.btn-big')).forEach((el) => { - vpadState[el.getAttribute('value')] = false; - }); - - window.addEventListener('mousemove', handleWindowMove); - window.addEventListener('touchmove', handleWindowMove, {passive: false}); - window.addEventListener('mouseup', handleWindowUp); - - log.info('[input] touch input has been initialized'); - } - } -})(document, event, KEY, window); +} diff --git a/web/js/log.js b/web/js/log.js index af138188..2c316225 100644 --- a/web/js/log.js +++ b/web/js/log.js @@ -1,35 +1,31 @@ +const noop = () => ({}) + +const _log = { + ASSERT: 1, + ERROR: 2, + WARN: 3, + INFO: 4, + DEBUG: 5, + TRACE: 6, + + DEFAULT: 5, + + set level(level) { + this.assert = level >= this.ASSERT ? console.assert.bind(window.console) : noop; + this.error = level >= this.ERROR ? console.error.bind(window.console) : noop; + this.warn = level >= this.WARN ? console.warn.bind(window.console) : noop; + this.info = level >= this.INFO ? console.info.bind(window.console) : noop; + this.debug = level >= this.DEBUG ? console.debug.bind(window.console) : noop; + this.trace = level >= this.TRACE ? console.log.bind(window.console) : noop; + this._level = level; + }, + get level() { + return this._level; + } +} +_log.level = _log.DEFAULT; + /** * Logging module. - * - * @version 2 */ -const log = (() => { - const noop = () => ({}) - - const _log = { - ASSERT: 1, - ERROR: 2, - WARN: 3, - INFO: 4, - DEBUG: 5, - TRACE: 6, - - DEFAULT: 5, - - set level(level) { - this.assert = level >= this.ASSERT ? console.assert.bind(window.console) : noop; - this.error = level >= this.ERROR ? console.error.bind(window.console) : noop; - this.warn = level >= this.WARN ? console.warn.bind(window.console) : noop; - this.info = level >= this.INFO ? console.info.bind(window.console) : noop; - this.debug = level >= this.DEBUG ? console.debug.bind(window.console) : noop; - this.trace = level >= this.TRACE ? console.log.bind(window.console) : noop; - this._level = level; - }, - get level() { - return this._level; - } - } - _log.level = _log.DEFAULT; - - return _log -})(console, window); +export const log = _log diff --git a/web/js/message.js b/web/js/message.js new file mode 100644 index 00000000..41e8e66e --- /dev/null +++ b/web/js/message.js @@ -0,0 +1,44 @@ +import {gui} from 'gui'; + +const popupBox = document.getElementById('noti-box'); + +// fifo queue +let queue = []; +const queueMaxSize = 5; + +let isScreenFree = true; + +const _popup = (time = 1000) => { + // recursion edge case: + // no messages in the queue or one on the screen + if (!(queue.length > 0 && isScreenFree)) { + return; + } + + isScreenFree = false; + popupBox.innerText = queue.shift(); + gui.anim.fadeInOut(popupBox, time, .05).finally(() => { + isScreenFree = true; + _popup(); + }) +} + +const _storeMessage = (text) => { + if (queue.length <= queueMaxSize) { + queue.push(text); + } +} + +const _proceed = (text, time) => { + _storeMessage(text); + _popup(time); +} + +const show = (text, time = 1000) => _proceed(text, time) + +/** + * App UI message module. + */ +export const message = { + show, +} diff --git a/web/js/network/ajax.js b/web/js/network/ajax.js index 6f8c69c2..c2f09ccd 100644 --- a/web/js/network/ajax.js +++ b/web/js/network/ajax.js @@ -1,29 +1,26 @@ +const defaultTimeout = 10000; /** * AJAX request module. * @version 1 */ -const ajax = (() => { - const defaultTimeout = 10000; +export const ajax = { + fetch: (url, options, timeout = defaultTimeout) => new Promise((resolve, reject) => { + const controller = new AbortController(); + const signal = controller.signal; + const allOptions = Object.assign({}, options, signal); - return { - fetch: (url, options, timeout = defaultTimeout) => new Promise((resolve, reject) => { - const controller = new AbortController(); - const signal = controller.signal; - const allOptions = Object.assign({}, options, signal); - - // fetch(url, {...options, signal}) - fetch(url, allOptions) - .then(resolve, () => { - controller.abort(); - return reject - }); - - // auto abort when a timeout reached - setTimeout(() => { + // fetch(url, {...options, signal}) + fetch(url, allOptions) + .then(resolve, () => { controller.abort(); - reject(); - }, timeout); - }), - defaultTimeoutMs: () => defaultTimeout - } -})(); \ No newline at end of file + return reject + }); + + // auto abort when a timeout reached + setTimeout(() => { + controller.abort(); + reject(); + }, timeout); + }), + defaultTimeoutMs: () => defaultTimeout +} diff --git a/web/js/network/network.js b/web/js/network/network.js new file mode 100644 index 00000000..ca21be6a --- /dev/null +++ b/web/js/network/network.js @@ -0,0 +1,3 @@ +export {ajax} from './ajax.js?v=3'; +export {socket} from './socket.js?v=3'; +export {webrtc} from './webrtc.js?v=3'; diff --git a/web/js/network/socket.js b/web/js/network/socket.js index 06351246..47314d9d 100644 --- a/web/js/network/socket.js +++ b/web/js/network/socket.js @@ -1,53 +1,51 @@ +import { + pub, + MESSAGE +} from 'event'; +import {log} from 'log'; + +let conn; + +const buildUrl = (params = {}) => { + const url = new URL(window.location); + url.protocol = location.protocol !== 'https:' ? 'ws' : 'wss'; + url.pathname = "/ws"; + Object.keys(params).forEach(k => { + if (!!params[k]) url.searchParams.set(k, params[k]) + }) + return url +} + +const init = (roomId, wid, zone) => { + let objParams = {room_id: roomId, zone: zone}; + if (wid) objParams.wid = wid; + const url = buildUrl(objParams) + console.info(`[ws] connecting to ${url}`); + conn = new WebSocket(url.toString()); + conn.onopen = () => { + log.info('[ws] <- open connection'); + }; + conn.onerror = () => log.error('[ws] some error!'); + conn.onclose = (event) => log.info(`[ws] closed (${event.code})`); + conn.onmessage = response => { + const data = JSON.parse(response.data); + log.debug('[ws] <- ', data); + pub(MESSAGE, data); + }; +}; + +const send = (data) => { + if (conn.readyState === 1) { + conn.send(JSON.stringify(data)); + } +} + /** * WebSocket connection module. * * Needs init() call. - * - * @version 1 - * - * Events: - * @link MESSAGE - * */ -const socket = (() => { - let conn; - - const buildUrl = (params = {}) => { - const url = new URL(window.location); - url.protocol = location.protocol !== 'https:' ? 'ws' : 'wss'; - url.pathname = "/ws"; - Object.keys(params).forEach(k => { - if (!!params[k]) url.searchParams.set(k, params[k]) - }) - return url - } - - const init = (roomId, wid, zone) => { - let objParams = {room_id: roomId, zone: zone}; - if (wid) objParams.wid = wid; - const url = buildUrl(objParams) - console.info(`[ws] connecting to ${url}`); - conn = new WebSocket(url.toString()); - conn.onopen = () => { - log.info('[ws] <- open connection'); - }; - conn.onerror = () => log.error('[ws] some error!'); - conn.onclose = (event) => log.info(`[ws] closed (${event.code})`); - conn.onmessage = response => { - const data = JSON.parse(response.data); - log.debug('[ws] <- ', data); - event.pub(MESSAGE, data); - }; - }; - - const send = (data) => { - if (conn.readyState === 1) { - conn.send(JSON.stringify(data)); - } - } - - return { - init: init, - send: send, - } -})(event, log); +export const socket = { + init, + send +} diff --git a/web/js/network/webrtc.js b/web/js/network/webrtc.js index 544a9370..5e8ae47d 100644 --- a/web/js/network/webrtc.js +++ b/web/js/network/webrtc.js @@ -1,177 +1,176 @@ -/** - * WebRTC connection module. - * @version 1 - * - * Events: - * @link WEBRTC_CONNECTION_CLOSED - * @link WEBRTC_CONNECTION_READY - * @link WEBRTC_ICE_CANDIDATE_FOUND - * @link WEBRTC_ICE_CANDIDATES_FLUSH - * @link WEBRTC_SDP_ANSWER - * - */ -const webrtc = (() => { - let connection; - let dataChannel; - let mediaStream; - let candidates = []; - let isAnswered = false; - let isFlushing = false; +import { + pub, + WEBRTC_CONNECTION_CLOSED, + WEBRTC_CONNECTION_READY, + WEBRTC_ICE_CANDIDATE_FOUND, + WEBRTC_ICE_CANDIDATES_FLUSH, + WEBRTC_SDP_ANSWER +} from 'event'; +import {log} from 'log'; - let connected = false; - let inputReady = false; +let connection; +let dataChannel; +let mediaStream; +let candidates = []; +let isAnswered = false; +let isFlushing = false; - let onData; +let connected = false; +let inputReady = false; - const start = (iceservers) => { - log.info('[rtc] <- ICE servers', iceservers); - const servers = iceservers || []; - connection = new RTCPeerConnection({iceServers: servers}); - mediaStream = new MediaStream(); +let onData; - connection.ondatachannel = e => { - log.debug('[rtc] ondatachannel', e.channel.label) - e.channel.binaryType = "arraybuffer"; +const start = (iceservers) => { + log.info('[rtc] <- ICE servers', iceservers); + const servers = iceservers || []; + connection = new RTCPeerConnection({iceServers: servers}); + mediaStream = new MediaStream(); - dataChannel = e.channel; - dataChannel.onopen = () => { - log.info('[rtc] the input channel has been opened'); - inputReady = true; - event.pub(WEBRTC_CONNECTION_READY) - }; - if (onData) { - dataChannel.onmessage = onData; - } - dataChannel.onclose = () => log.info('[rtc] the input channel has been closed'); + connection.ondatachannel = e => { + log.debug('[rtc] ondatachannel', e.channel.label) + e.channel.binaryType = "arraybuffer"; + + dataChannel = e.channel; + dataChannel.onopen = () => { + log.info('[rtc] the input channel has been opened'); + inputReady = true; + pub(WEBRTC_CONNECTION_READY) + }; + if (onData) { + dataChannel.onmessage = onData; } - connection.oniceconnectionstatechange = ice.onIceConnectionStateChange; - connection.onicegatheringstatechange = ice.onIceStateChange; - connection.onicecandidate = ice.onIcecandidate; - connection.ontrack = event => { - mediaStream.addTrack(event.track); - } - }; - - const stop = () => { - if (mediaStream) { - mediaStream.getTracks().forEach(t => { - t.stop(); - mediaStream.removeTrack(t); - }); - mediaStream = null; - } - if (connection) { - connection.close(); - connection = null; - } - if (dataChannel) { - dataChannel.close(); - dataChannel = null; - } - candidates = Array(); - log.info('[rtc] WebRTC has been closed'); + dataChannel.onclose = () => log.info('[rtc] the input channel has been closed'); } + connection.oniceconnectionstatechange = ice.onIceConnectionStateChange; + connection.onicegatheringstatechange = ice.onIceStateChange; + connection.onicecandidate = ice.onIcecandidate; + connection.ontrack = event => { + mediaStream.addTrack(event.track); + } +}; - const ice = (() => { - const ICE_TIMEOUT = 2000; - let timeForIceGathering; +const stop = () => { + if (mediaStream) { + mediaStream.getTracks().forEach(t => { + t.stop(); + mediaStream.removeTrack(t); + }); + mediaStream = null; + } + if (connection) { + connection.close(); + connection = null; + } + if (dataChannel) { + dataChannel.close(); + dataChannel = null; + } + candidates = []; + log.info('[rtc] WebRTC has been closed'); +} - return { - onIcecandidate: data => { - if (!data.candidate) return; - log.info('[rtc] user candidate', data.candidate); - event.pub(WEBRTC_ICE_CANDIDATE_FOUND, {candidate: data.candidate}) - }, - onIceStateChange: event => { - switch (event.target.iceGatheringState) { - case 'gathering': - log.info('[rtc] ice gathering'); - timeForIceGathering = setTimeout(() => { - log.warn(`[rtc] ice gathering was aborted due to timeout ${ICE_TIMEOUT}ms`); - // sendCandidates(); - }, ICE_TIMEOUT); - break; - case 'complete': - log.info('[rtc] ice gathering has been completed'); - if (timeForIceGathering) { - clearTimeout(timeForIceGathering); - } - } - }, - onIceConnectionStateChange: () => { - log.info('[rtc] <- iceConnectionState', connection.iceConnectionState); - switch (connection.iceConnectionState) { - case 'connected': { - log.info('[rtc] connected...'); - connected = true; - break; - } - case 'disconnected': { - log.info(`[rtc] disconnected... ` + - `connection: ${connection.connectionState}, ice: ${connection.iceConnectionState}, ` + - `gathering: ${connection.iceGatheringState}, signalling: ${connection.signalingState}`) - connected = false; - event.pub(WEBRTC_CONNECTION_CLOSED); - break; - } - case 'failed': { - log.error('[rtc] failed establish connection, retry...'); - connected = false; - connection.createOffer({iceRestart: true}) - .then(description => connection.setLocalDescription(description).catch(log.error)) - .catch(log.error); - break; - } - } - } - } - })(); +const ice = (() => { + const ICE_TIMEOUT = 2000; + let timeForIceGathering; return { - start: start, - setRemoteDescription: async (data, media) => { - log.debug('[rtc] remote SDP', data) - const offer = new RTCSessionDescription(JSON.parse(atob(data))); - await connection.setRemoteDescription(offer); - - const answer = await connection.createAnswer(); - // Chrome bug https://bugs.chromium.org/p/chromium/issues/detail?id=818180 workaround - // force stereo params for Opus tracks (a=fmtp:111 ...) - answer.sdp = answer.sdp.replace(/(a=fmtp:111 .*)/g, '$1;stereo=1'); - await connection.setLocalDescription(answer); - log.debug("[rtc] local SDP", answer) - - isAnswered = true; - event.pub(WEBRTC_ICE_CANDIDATES_FLUSH); - event.pub(WEBRTC_SDP_ANSWER, {sdp: answer}); - media.srcObject = mediaStream; + onIcecandidate: data => { + if (!data.candidate) return; + log.info('[rtc] user candidate', data.candidate); + pub(WEBRTC_ICE_CANDIDATE_FOUND, {candidate: data.candidate}) }, - addCandidate: (data) => { - if (data === '') { - event.pub(WEBRTC_ICE_CANDIDATES_FLUSH); - } else { - candidates.push(data); + onIceStateChange: event => { + switch (event.target.iceGatheringState) { + case 'gathering': + log.info('[rtc] ice gathering'); + timeForIceGathering = setTimeout(() => { + log.warn(`[rtc] ice gathering was aborted due to timeout ${ICE_TIMEOUT}ms`); + // sendCandidates(); + }, ICE_TIMEOUT); + break; + case 'complete': + log.info('[rtc] ice gathering has been completed'); + if (timeForIceGathering) { + clearTimeout(timeForIceGathering); + } } }, - flushCandidates: () => { - if (isFlushing || !isAnswered) return; - isFlushing = true; - log.debug('[rtc] flushing candidates', candidates); - candidates.forEach(data => { - const candidate = new RTCIceCandidate(JSON.parse(atob(data))) - connection.addIceCandidate(candidate).catch(e => { - log.error('[rtc] candidate add failed', e.name); - }); - }); - isFlushing = false; - }, - input: (data) => dataChannel.send(data), - isConnected: () => connected, - isInputReady: () => inputReady, - getConnection: () => connection, - stop, - set onData(fn) { - onData = fn + onIceConnectionStateChange: () => { + log.info('[rtc] <- iceConnectionState', connection.iceConnectionState); + switch (connection.iceConnectionState) { + case 'connected': { + log.info('[rtc] connected...'); + connected = true; + break; + } + case 'disconnected': { + log.info(`[rtc] disconnected... ` + + `connection: ${connection.connectionState}, ice: ${connection.iceConnectionState}, ` + + `gathering: ${connection.iceGatheringState}, signalling: ${connection.signalingState}`) + connected = false; + pub(WEBRTC_CONNECTION_CLOSED); + break; + } + case 'failed': { + log.error('[rtc] failed establish connection, retry...'); + connected = false; + connection.createOffer({iceRestart: true}) + .then(description => connection.setLocalDescription(description).catch(log.error)) + .catch(log.error); + break; + } + } } } -})(event, log); +})(); + +/** + * WebRTC connection module. + */ +export const webrtc = { + start, + setRemoteDescription: async (data, media) => { + log.debug('[rtc] remote SDP', data) + const offer = new RTCSessionDescription(JSON.parse(atob(data))); + await connection.setRemoteDescription(offer); + + const answer = await connection.createAnswer(); + // Chrome bug https://bugs.chromium.org/p/chromium/issues/detail?id=818180 workaround + // force stereo params for Opus tracks (a=fmtp:111 ...) + answer.sdp = answer.sdp.replace(/(a=fmtp:111 .*)/g, '$1;stereo=1'); + await connection.setLocalDescription(answer); + log.debug("[rtc] local SDP", answer) + + isAnswered = true; + pub(WEBRTC_ICE_CANDIDATES_FLUSH); + pub(WEBRTC_SDP_ANSWER, {sdp: answer}); + media.srcObject = mediaStream; + }, + addCandidate: (data) => { + if (data === '') { + pub(WEBRTC_ICE_CANDIDATES_FLUSH); + } else { + candidates.push(data); + } + }, + flushCandidates: () => { + if (isFlushing || !isAnswered) return; + isFlushing = true; + log.debug('[rtc] flushing candidates', candidates); + candidates.forEach(data => { + const candidate = new RTCIceCandidate(JSON.parse(atob(data))) + connection.addIceCandidate(candidate).catch(e => { + log.error('[rtc] candidate add failed', e.name); + }); + }); + isFlushing = false; + }, + input: (data) => dataChannel.send(data), + isConnected: () => connected, + isInputReady: () => inputReady, + getConnection: () => connection, + stop, + set onData(fn) { + onData = fn + } +} diff --git a/web/js/recording.js b/web/js/recording.js index b78cc01e..70f18ad0 100644 --- a/web/js/recording.js +++ b/web/js/recording.js @@ -1,64 +1,66 @@ -const RECORDING_ON = 1; -const RECORDING_OFF = 0; -const RECORDING_REC = 2; +import { + pub, + KEYBOARD_TOGGLE_FILTER_MODE, + RECORDING_TOGGLED +} from 'event'; +import {throttle} from 'utils'; -/** - * Recording module. - * @version 1 - */ -const recording = (() => { - const userName = document.getElementById('user-name'), - recButton = document.getElementById('btn-rec'); +export const RECORDING_ON = 1; +export const RECORDING_OFF = 0; +export const RECORDING_REC = 2; - if (!userName || !recButton) { - return { - isActive: () => false, - getUser: () => '', +const userName = document.getElementById('user-name'), + recButton = document.getElementById('btn-rec'); + +let state = { + userName: '', + state: RECORDING_OFF, +}; + +const restoreLastState = () => { + const lastState = localStorage.getItem('recording'); + if (lastState) { + const _last = JSON.parse(lastState); + if (_last) { + state = _last; } } + userName.value = state.userName +} - let state = { - userName: '', - state: RECORDING_OFF, - }; +const setRec = (val) => { + recButton.classList.toggle('record', val); +} +const setIndicator = (val) => { + recButton.classList.toggle('blink', val); +}; - const restoreLastState = () => { - const lastState = localStorage.getItem('recording'); - if (lastState) { - const _last = JSON.parse(lastState); - if (_last) { - state = _last; - } - } - userName.value = state.userName - } +// persistence +const saveLastState = () => { + const _state = Object.keys(state) + .filter(key => !key.startsWith('_')) + .reduce((obj, key) => ({...obj, [key]: state[key]}), {}); + localStorage.setItem('recording', JSON.stringify(_state)); +} +const saveUserName = throttle(() => { + state.userName = userName.value; + saveLastState(); +}, 500) - const setRec = (val) => { - recButton.classList.toggle('record', val); - } - const setIndicator = (val) => { - recButton.classList.toggle('blink', val); - }; - - // persistence - const saveLastState = () => { - const _state = Object.keys(state) - .filter(key => !key.startsWith('_')) - .reduce((obj, key) => ({...obj, [key]: state[key]}), {}); - localStorage.setItem('recording', JSON.stringify(_state)); - } - const saveUserName = utils.throttle(() => { - state.userName = userName.value; - saveLastState(); - }, 500) +let _recording = { + isActive: () => false, + getUser: () => '', + setIndicator: () => ({}), +} +if (userName && recButton) { restoreLastState(); setIndicator(false); setRec(state.state === RECORDING_ON) // text - userName.addEventListener('focus', () => event.pub(KEYBOARD_TOGGLE_FILTER_MODE)) - userName.addEventListener('blur', () => event.pub(KEYBOARD_TOGGLE_FILTER_MODE, {mode: true})) + userName.addEventListener('focus', () => pub(KEYBOARD_TOGGLE_FILTER_MODE)) + userName.addEventListener('blur', () => pub(KEYBOARD_TOGGLE_FILTER_MODE, {mode: true})) userName.addEventListener('keyup', ev => { ev.stopPropagation(); saveUserName() @@ -70,11 +72,17 @@ const recording = (() => { const active = state.state === RECORDING_ON setRec(active) saveLastState() - event.pub(RECORDING_TOGGLED, {userName: state.userName, recording: active}) + pub(RECORDING_TOGGLED, {userName: state.userName, recording: active}) }) - return { + + _recording = { isActive: () => state.state > 0, getUser: () => state.userName, - setIndicator: setIndicator, + setIndicator, } -})(document, event, localStorage, utils); +} + +/** + * Recording module. + */ +export const recording = _recording diff --git a/web/js/room.js b/web/js/room.js index 20a53a73..f8f2e37f 100644 --- a/web/js/room.js +++ b/web/js/room.js @@ -1,76 +1,79 @@ +import { + sub, + GAME_ROOM_AVAILABLE +} from 'event'; + +let id = ''; + +// UI +const roomLabel = document.getElementById('room-txt'); + +// !to rewrite +const parseURLForRoom = () => { + let queryDict = {}; + let regex = /^\/?([A-Za-z]*)\/?/g; + const zone = regex.exec(location.pathname)[1]; + let room = null; + + // get room from URL + location.search.substr(1) + .split('&') + .forEach((item) => { + queryDict[item.split('=')[0]] = item.split('=')[1] + }); + + if (typeof queryDict.id === 'string') { + room = decodeURIComponent(queryDict.id); + } + + return [room, zone]; +}; + +sub(GAME_ROOM_AVAILABLE, data => { + room.setId(data.roomId); + room.save(data.roomId); +}, 1); + /** * Game room module. - * @version 1 */ -const room = (() => { - let id = ''; +export const room = { + getId: () => id, + setId: (id_) => { + id = id_; + roomLabel.value = id; + }, + reset: () => { + id = ''; + roomLabel.value = id; + }, + save: (roomIndex) => { + localStorage.setItem('roomID', roomIndex); + }, + load: () => localStorage.getItem('roomID'), + getLink: () => window.location.href.split('?')[0] + `?id=${encodeURIComponent(room.getId())}`, + loadMaybe: () => { + // localStorage first + //roomID = loadRoomID(); + let zone = ''; - // UI - const roomLabel = document.getElementById('room-txt'); - - // !to rewrite - const parseURLForRoom = () => { - let queryDict = {}; - let regex = /^\/?([A-Za-z]*)\/?/g; - const zone = regex.exec(location.pathname)[1]; - let room = null; - - // get room from URL - location.search.substr(1) - .split('&') - .forEach((item) => { - queryDict[item.split('=')[0]] = item.split('=')[1] - }); - - if (typeof queryDict.id === 'string') { - room = decodeURIComponent(queryDict.id); + // Shared URL second + const [parsedId, czone] = parseURLForRoom(); + if (parsedId !== null) { + id = parsedId; + } + if (czone !== null) { + zone = czone; } - return [room, zone]; - }; - - event.sub(GAME_ROOM_AVAILABLE, data => { - room.setId(data.roomId); - room.save(data.roomId); - }, 1); - - return { - getId: () => id, - setId: (id_) => { - id = id_; - roomLabel.value = id; - }, - reset: () => { - id = ''; - roomLabel.value = id; - }, - save: (roomIndex) => { - localStorage.setItem('roomID', roomIndex); - }, - load: () => localStorage.getItem('roomID'), - getLink: () => window.location.href.split('?')[0] + `?id=${encodeURIComponent(room.getId())}`, - loadMaybe: () => { - // localStorage first - //roomID = loadRoomID(); - - // Shared URL second - const [parsedId, czone] = parseURLForRoom(); - if (parsedId !== null) { - id = parsedId; - } - if (czone !== null) { - zone = czone; - } - - return [id, zone]; - }, - copyToClipboard: () => { - const el = document.createElement('textarea'); - el.value = room.getLink(); - document.body.appendChild(el); - el.select(); - document.execCommand('copy'); - document.body.removeChild(el); - } + return [id, zone]; + }, + copyToClipboard: () => { + const el = document.createElement('textarea'); + el.value = room.getLink(); + document.body.appendChild(el); + el.select(); + document.execCommand('copy'); + document.body.removeChild(el); } -})(document, event, location, localStorage, window); +} diff --git a/web/js/settings.js b/web/js/settings.js new file mode 100644 index 00000000..e63b1394 --- /dev/null +++ b/web/js/settings.js @@ -0,0 +1,537 @@ +import { + pub, + sub, + SETTINGS_CHANGED, + KEYBOARD_KEY_PRESSED, + KEYBOARD_TOGGLE_FILTER_MODE +} from 'event'; +import {gui} from 'gui'; +import {log} from 'log'; + +/** + * Stores app wide option names. + * + * Use the following format: + * UPPERCASE_NAME: 'uppercase.name' + * + * @version 1 + */ +export const opts = { + _VERSION: '_version', + LOG_LEVEL: 'log.level', + INPUT_KEYBOARD_MAP: 'input.keyboard.map', + MIRROR_SCREEN: 'mirror.screen', + VOLUME: 'volume', + FORCE_FULLSCREEN: 'force.fullscreen' +} + + +// internal structure version +const revision = 1.51; + +// default settings +// keep them for revert to defaults option +const _defaults = Object.create(null); +_defaults[opts._VERSION] = revision; + +/** + * The main store with settings passed around by reference + * (because of that we need a wrapper object) + * don't do this at work (it's faster to write than immutable code). + * + * @type {{settings: {_version: number}}} + */ +let store = { + settings: { + ..._defaults + } +}; +let provider; + +/** + * Enum for settings types (the explicit type of a key-value pair). + * + * @readonly + * @enum {number} + */ +const option = Object.freeze({undefined: 0, string: 1, number: 2, object: 3, list: 4}); + +const exportFileName = `cloud-game.settings.v${revision}.txt`; + +const getStore = () => store.settings; + +/** + * The NullObject provider if everything else fails. + */ +const voidProvider = (store_ = {settings: {}}) => { + const nil = () => ({}) + + return { + get: key => store_.settings[key], + set: nil, + remove: nil, + save: nil, + loadSettings: nil, + reset: nil, + } +} + +/** + * The LocalStorage backend for our settings (store). + * + * For simplicity it will rewrite all the settings on every store change. + * If you want to roll your own, then use its "interface". + */ +const localStorageProvider = ((store_ = {settings: {}}) => { + if (!_isSupported()) return; + + const root = 'settings'; + + const _serialize = data => JSON.stringify(data, null, 2); + + const save = () => localStorage.setItem(root, _serialize(store_.settings)); + + function _isSupported() { + const testKey = '_test_42'; + try { + // check if it's writable and isn't full + localStorage.setItem(testKey, testKey); + localStorage.removeItem(testKey); + return true; + } catch (e) { + log.error(e); + return false; + } + } + + const get = key => JSON.parse(localStorage.getItem(key)); + + const set = () => save(); + + const remove = () => save(); + + const loadSettings = () => { + if (!localStorage.getItem(root)) save(); + store_.settings = JSON.parse(localStorage.getItem(root)); + } + + const reset = () => { + localStorage.removeItem(root); + localStorage.setItem(root, _serialize(store_.settings)); + } + + return { + get, + clear: () => localStorage.removeItem(root), + set, + remove, + save, + loadSettings, + reset, + } +}); + +/** + * Nuke existing settings with provided data. + * @param text The text to extract data from. + * @private + */ +const _import = text => { + try { + for (const property of Object.getOwnPropertyNames(store.settings)) delete store.settings[property]; + Object.assign(store.settings, JSON.parse(text).settings); + provider.save(); + pub(SETTINGS_CHANGED); + } catch (e) { + log.error(`Your import file is broken!`); + } + + _render(); +} + +const _export = () => { + let el = document.createElement('a'); + el.setAttribute( + 'href', + `data:text/plain;charset=utf-8,${encodeURIComponent(JSON.stringify(store, null, 2))}` + ); + el.setAttribute('download', exportFileName); + el.style.display = 'none'; + document.body.appendChild(el); + el.click(); + document.body.removeChild(el); +} + +const init = () => { + // try to load settings from the localStorage with fallback to null-object + provider = localStorageProvider(store) || voidProvider(store); + provider.loadSettings(); + + const lastRev = (store.settings || {_version: 0})._version + + if (revision > lastRev) { + log.warn(`Your settings are in older format (v${lastRev}) and will be reset to (v${revision})!`); + _reset(); + } +} + +const get = () => store.settings; + +const _isLoaded = key => store.settings.hasOwnProperty(key); + +/** + * Tries to load settings by some key. + * + * @param key A key to find values with. + * @param default_ The default values to set if none exist. + * @returns A slice of the settings with the given key or a copy of the value. + */ +const loadOr = (key, default_) => { + // preserve defaults + _defaults[key] = default_; + + if (!_isLoaded(key)) { + store.settings[key] = {}; + set(key, default_); + } else { + // !to check if settings do have new properties from default & update + // or it have ones that defaults doesn't + } + + return store.settings[key]; +} + +const set = (key, value, updateProvider = true) => { + const type = _getType(value); + + // mutate settings w/o changing the reference + switch (type) { + case option.list: + store.settings[key].splice(0, Infinity, ...value); + break; + case option.object: + for (let option of Object.keys(value)) { + log.debug(`Change key [${option}] from ${store.settings[key][option]} to ${value[option]}`); + store.settings[key][option] = value[option]; + } + break; + case option.string: + case option.number: + case option.undefined: + default: + store.settings[key] = value; + } + + if (updateProvider) { + provider.set(key, value); + pub(SETTINGS_CHANGED); + } +} + +const _reset = () => { + for (let _option of Object.keys(_defaults)) { + const value = _defaults[_option]; + + // delete all sub-options not in defaults + if (_getType(value) === option.object) { + for (let opt of Object.keys(store.settings[_option])) { + const prev = store.settings[_option][opt]; + const isDeleted = delete store.settings[_option][opt]; + log.debug(`User option [${opt}=${prev}] has been deleted (${isDeleted}) from the [${_option}]`); + } + } + + set(_option, value, false); + } + + provider.reset(); + pub(SETTINGS_CHANGED); +} + +const remove = (key, subKey) => { + const isRemoved = subKey !== undefined ? delete store.settings[key][subKey] : delete store.settings[key]; + if (!isRemoved) log.warn(`The key: ${key + (subKey ? '.' + subKey : '')} wasn't deleted!`); + provider.remove(key, subKey); +} + +const _render = () => { + renderer.data = panel.contentEl; + renderer.render() +} + +const panel = gui.panel(document.getElementById('settings'), '> OPTIONS', 'settings', null, [ + {caption: 'Export', handler: () => _export(), title: 'Save',}, + {caption: 'Import', handler: () => _fileReader.read(onFileLoad), title: 'Load',}, + { + caption: 'Reset', + handler: () => { + if (window.confirm("Are you sure want to reset your settings?")) { + _reset(); + pub(SETTINGS_CHANGED); + } + }, + title: 'Reset', + }, + {} + ], + (show) => { + if (show) { + _render(); + return; + } + + // to make sure it's disabled, but it's a tad verbose + pub(KEYBOARD_TOGGLE_FILTER_MODE, {mode: true}); + }) + +function _getType(value) { + if (value === undefined) return option.undefined + else if (Array.isArray(value)) return option.list + else if (typeof value === 'object' && value !== null) return option.object + else if (typeof value === 'string') return option.string + else if (typeof value === 'number') return option.number + else return option.undefined; +} + +const _fileReader = (() => { + let callback_ = () => ({}) + + const el = document.createElement('input'); + const reader = new FileReader(); + + el.type = 'file'; + el.accept = '.txt'; + el.onchange = event => event.target.files.length && reader.readAsBinaryString(event.target.files[0]); + reader.onload = event => callback_(event.target.result); + + return { + read: callback => { + callback_ = callback; + el.click(); + }, + } +})(); + +const onFileLoad = text => { + try { + _import(text); + } catch (e) { + log.error(`Couldn't read your settings!`, e); + } +} + +sub(SETTINGS_CHANGED, _render); + +/** + * App settings module. + * + * So the basic idea is to let app modules request their settings + * from an abstract store first, and if the store doesn't contain such settings yet, + * then let the store to take default values from the module to save them before that. + * The return value with the settings is gonna be a slice of in-memory structure + * backed by a data provider (localStorage). + * Doing it this way allows us to considerably simplify the code and make sure that + * exposed settings will have the latest values without additional update/get calls. + */ +export const settings = { + init, + loadOr, + getStore, + get, + set, + remove, + import: _import, + export: _export, + ui: { + set onToggle(fn) { + panel.onToggle(fn); + }, + toggle: () => panel.toggle(), + }, +} + +// don't show these options (i.e. ignored = {'_version': 1}) +const ignored = {'_version': 1}; + +// the main display data holder element +let data = null; + +const scrollState = ((sx = 0, sy = 0, el) => ({ + track(_el) { + el = _el + el.addEventListener("scroll", () => ({scrollTop: sx, scrollLeft: sy} = el), {passive: true}) + }, + restore() { + el.scrollTop = sx + el.scrollLeft = sy + } +}))() + +// a fast way to clear data holder. +const clearData = () => { + while (data.firstChild) data.removeChild(data.firstChild) +}; + +const _option = (holderEl) => { + const wrapperEl = document.createElement('div'); + wrapperEl.classList.add('settings__option'); + + const titleEl = document.createElement('div'); + titleEl.classList.add('settings__option-title'); + wrapperEl.append(titleEl); + + const nameEl = document.createElement('div'); + + const valueEl = document.createElement('div'); + valueEl.classList.add('settings__option-value'); + wrapperEl.append(valueEl); + + return { + withName: function (name = '') { + if (name === '') return this; + nameEl.classList.add('settings__option-name'); + nameEl.textContent = name; + titleEl.append(nameEl); + return this; + }, + withClass: function (name = '') { + wrapperEl.classList.add(name); + return this; + }, + withDescription(text = '') { + if (text === '') return this; + const descEl = document.createElement('div'); + descEl.classList.add('settings__option-desc'); + descEl.textContent = text; + titleEl.append(descEl); + return this; + }, + restartNeeded: function () { + nameEl.classList.add('restart-needed-asterisk'); + return this; + }, + add: function (...elements) { + if (elements.length) for (let _el of elements.flat()) valueEl.append(_el); + return this; + }, + build: () => holderEl.append(wrapperEl), + }; +} + +const onKeyChange = (key, oldValue, newValue, handler) => { + + if (newValue !== 'Escape') { + const _settings = settings.get()[opts.INPUT_KEYBOARD_MAP]; + + if (_settings[newValue] !== undefined) { + log.warn(`There are old settings for key: ${_settings[newValue]}, won't change!`); + } else { + settings.remove(opts.INPUT_KEYBOARD_MAP, oldValue); + settings.set(opts.INPUT_KEYBOARD_MAP, {[newValue]: key}); + } + } + + handler?.unsub(); + + pub(KEYBOARD_TOGGLE_FILTER_MODE); + pub(SETTINGS_CHANGED); +} + +const _keyChangeOverlay = (keyName, oldValue) => { + const wrapperEl = document.createElement('div'); + wrapperEl.classList.add('settings__key-wait'); + wrapperEl.textContent = `Let's choose a ${keyName} key...`; + + let handler = sub(KEYBOARD_KEY_PRESSED, button => onKeyChange(keyName, oldValue, button.key, handler)); + + return wrapperEl; +} + +/** + * Handles a normal option change. + * + * @param key The name (id) of an option. + * @param newValue A new value to set. + */ +const onChange = (key, newValue) => { + settings.set(key, newValue); + scrollState.restore(data); +} + +const onKeyBindingChange = (key, oldValue) => { + clearData(); + data.append(_keyChangeOverlay(key, oldValue)); + pub(KEYBOARD_TOGGLE_FILTER_MODE); +} + +const render = function () { + const _settings = settings.getStore(); + + clearData(); + for (let k of Object.keys(_settings).sort()) { + if (ignored[k]) continue; + + const value = _settings[k]; + switch (k) { + case opts._VERSION: + _option(data).withName('Options format version').add(value).build(); + break; + case opts.LOG_LEVEL: + _option(data).withName('Log level') + .add(gui.select(k, onChange, { + labels: ['trace', 'debug', 'warning', 'info'], + values: [log.TRACE, log.DEBUG, log.WARN, log.INFO].map(String) + }, value)) + .build(); + break; + case opts.INPUT_KEYBOARD_MAP: + _option(data).withName('Keyboard bindings') + .withClass('keyboard-bindings') + .add(Object.keys(value).map(k => gui.binding(value[k], k, onKeyBindingChange))) + .build(); + break; + case opts.MIRROR_SCREEN: + _option(data).withName('Video mirroring') + .add(gui.select(k, onChange, {values: ['mirror'], labels: []}, value)) + .withDescription('Disables video image smoothing by rendering the video on a canvas (much more demanding for browser)') + .build(); + break; + case opts.VOLUME: + _option(data).withName('Volume (%)') + .add(gui.inputN(k, onChange, value)) + .restartNeeded() + .build() + break; + case opts.FORCE_FULLSCREEN: + _option(data).withName('Force fullscreen') + .withDescription( + 'Whether games should open in full-screen mode after starting up (excluding mobile devices)' + ) + .add(gui.checkbox(k, onChange, value, 'Enabled', 'settings__option-checkbox')) + .build() + break; + default: + _option(data).withName(k).add(value).build(); + } + } + + data.append( + gui.create('br'), + gui.create('div', (el) => { + el.classList.add('settings__info', 'restart-needed-asterisk-b'); + el.innerText = ' -- applied after page reload' + }), + gui.create('div', (el) => { + el.classList.add('settings__info'); + el.innerText = `Options format version: ${_settings?._version}`; + }) + ); +} + +const renderer = { + render, + set data(el) { + data = el; + scrollState.track(el) + } +} diff --git a/web/js/settings/opts.js b/web/js/settings/opts.js deleted file mode 100644 index 5e9fac03..00000000 --- a/web/js/settings/opts.js +++ /dev/null @@ -1,16 +0,0 @@ -/** - * Stores app wide option names. - * - * Use the following format: - * UPPERCASE_NAME: 'uppercase.name' - * - * @version 1 - */ -const opts = Object.freeze({ - _VERSION: '_version', - LOG_LEVEL: 'log.level', - INPUT_KEYBOARD_MAP: 'input.keyboard.map', - MIRROR_SCREEN: 'mirror.screen', - VOLUME: 'volume', - FORCE_FULLSCREEN: 'force.fullscreen' -}); diff --git a/web/js/settings/settings.js b/web/js/settings/settings.js deleted file mode 100644 index 76c20c33..00000000 --- a/web/js/settings/settings.js +++ /dev/null @@ -1,525 +0,0 @@ -/** - * App settings module. - * - * So the basic idea is to let app modules request their settings - * from an abstract store first, and if the store doesn't contain such settings yet, - * then let the store to take default values from the module to save them before that. - * The return value with the settings is gonna be a slice of in-memory structure - * backed by a data provider (localStorage). - * Doing it this way allows us to considerably simplify the code and make sure that - * exposed settings will have the latest values without additional update/get calls. - * - * Uses ES8. - * - * @version 1 - */ -const settings = (() => { - // internal structure version - const revision = 1.51; - - // default settings - // keep them for revert to defaults option - const _defaults = Object.create(null); - _defaults[opts._VERSION] = revision; - - /** - * The main store with settings passed around by reference - * (because of that we need a wrapper object) - * don't do this at work (it's faster to write than immutable code). - * - * @type {{settings: {_version: number}}} - */ - let store = { - settings: { - ..._defaults - } - }; - let provider; - - /** - * Enum for settings types (the explicit type of a key-value pair). - * - * @readonly - * @enum {number} - */ - const option = Object.freeze({undefined: 0, string: 1, number: 2, object: 3, list: 4}); - - const exportFileName = `cloud-game.settings.v${revision}.txt`; - - let _renderer = {render: () => ({})}; - - const getStore = () => store.settings; - - /** - * The NullObject provider if everything else fails. - */ - const voidProvider = (store_ = {settings: {}}) => { - const nil = () => ({}) - - return { - get: key => store_.settings[key], - set: nil, - remove: nil, - save: nil, - loadSettings: nil, - reset: nil, - } - } - - /** - * The LocalStorage backend for our settings (store). - * - * For simplicity it will rewrite all the settings on every store change. - * If you want to roll your own, then use its "interface". - */ - const localStorageProvider = ((store_ = {settings: {}}) => { - if (!_isSupported()) return; - - const root = 'settings'; - - const _serialize = data => JSON.stringify(data, null, 2); - - const save = () => localStorage.setItem(root, _serialize(store_.settings)); - - function _isSupported() { - const testKey = '_test_42'; - try { - // check if it's writable and isn't full - localStorage.setItem(testKey, testKey); - localStorage.removeItem(testKey); - return true; - } catch (e) { - log.error(e); - return false; - } - } - - const get = key => JSON.parse(localStorage.getItem(key)); - - const set = () => save(); - - const remove = () => save(); - - const loadSettings = () => { - if (!localStorage.getItem(root)) save(); - store_.settings = JSON.parse(localStorage.getItem(root)); - } - - const reset = () => { - localStorage.removeItem(root); - localStorage.setItem(root, _serialize(store_.settings)); - } - - return { - get, - clear: () => localStorage.removeItem(root), - set, - remove, - save, - loadSettings, - reset, - } - }); - - /** - * Nuke existing settings with provided data. - * @param text The text to extract data from. - * @private - */ - const _import = text => { - try { - for (const property of Object.getOwnPropertyNames(store.settings)) delete store.settings[property]; - Object.assign(store.settings, JSON.parse(text).settings); - provider.save(); - event.pub(SETTINGS_CHANGED); - } catch (e) { - log.error(`Your import file is broken!`); - } - - _render(); - } - - const _export = () => { - let el = document.createElement('a'); - el.setAttribute( - 'href', - `data:text/plain;charset=utf-8,${encodeURIComponent(JSON.stringify(store, null, 2))}` - ); - el.setAttribute('download', exportFileName); - el.style.display = 'none'; - document.body.appendChild(el); - el.click(); - document.body.removeChild(el); - } - - const init = () => { - // try to load settings from the localStorage with fallback to null-object - provider = localStorageProvider(store) || voidProvider(store); - provider.loadSettings(); - - const lastRev = (store.settings || {_version: 0})._version - - if (revision > lastRev) { - log.warn(`Your settings are in older format (v${lastRev}) and will be reset to (v${revision})!`); - _reset(); - } - } - - const get = () => store.settings; - - const _isLoaded = key => store.settings.hasOwnProperty(key); - - /** - * Tries to load settings by some key. - * - * @param key A key to find values with. - * @param default_ The default values to set if none exist. - * @returns A slice of the settings with the given key or a copy of the value. - */ - const loadOr = (key, default_) => { - // preserve defaults - _defaults[key] = default_; - - if (!_isLoaded(key)) { - store.settings[key] = {}; - set(key, default_); - } else { - // !to check if settings do have new properties from default & update - // or it have ones that defaults doesn't - } - - return store.settings[key]; - } - - const set = (key, value, updateProvider = true) => { - const type = _getType(value); - - // mutate settings w/o changing the reference - switch (type) { - case option.list: - store.settings[key].splice(0, Infinity, ...value); - break; - case option.object: - for (let option of Object.keys(value)) { - log.debug(`Change key [${option}] from ${store.settings[key][option]} to ${value[option]}`); - store.settings[key][option] = value[option]; - } - break; - case option.string: - case option.number: - case option.undefined: - default: - store.settings[key] = value; - } - - if (updateProvider) { - provider.set(key, value); - event.pub(SETTINGS_CHANGED); - } - } - - const _reset = () => { - for (let _option of Object.keys(_defaults)) { - const value = _defaults[_option]; - - // delete all sub-options not in defaults - if (_getType(value) === option.object) { - for (let opt of Object.keys(store.settings[_option])) { - const prev = store.settings[_option][opt]; - const isDeleted = delete store.settings[_option][opt]; - log.debug(`User option [${opt}=${prev}] has been deleted (${isDeleted}) from the [${_option}]`); - } - } - - set(_option, value, false); - } - - provider.reset(); - event.pub(SETTINGS_CHANGED); - } - - const remove = (key, subKey) => { - const isRemoved = subKey !== undefined ? delete store.settings[key][subKey] : delete store.settings[key]; - if (!isRemoved) log.warn(`The key: ${key + (subKey ? '.' + subKey : '')} wasn't deleted!`); - provider.remove(key, subKey); - } - - - const _render = () => { - _renderer.data = panel.contentEl; - _renderer.render() - } - - - const panel = gui.panel(document.getElementById('settings'), '> OPTIONS', 'settings', null, [ - {caption: 'Export', handler: () => _export(), title: 'Save',}, - {caption: 'Import', handler: () => _fileReader.read(onFileLoad), title: 'Load',}, - { - caption: 'Reset', - handler: () => { - if (window.confirm("Are you sure want to reset your settings?")) { - _reset(); - event.pub(SETTINGS_CHANGED); - } - }, - title: 'Reset', - }, - {} - ], - (show) => { - if (show) { - _render(); - return; - } - - // to make sure it's disabled, but it's a tad verbose - event.pub(KEYBOARD_TOGGLE_FILTER_MODE, {mode: true}); - }) - - function _getType(value) { - if (value === undefined) return option.undefined - else if (Array.isArray(value)) return option.list - else if (typeof value === 'object' && value !== null) return option.object - else if (typeof value === 'string') return option.string - else if (typeof value === 'number') return option.number - else return option.undefined; - } - - const _fileReader = (() => { - let callback_ = () => ({}) - - const el = document.createElement('input'); - const reader = new FileReader(); - - el.type = 'file'; - el.accept = '.txt'; - el.onchange = event => event.target.files.length && reader.readAsBinaryString(event.target.files[0]); - reader.onload = event => callback_(event.target.result); - - return { - read: callback => { - callback_ = callback; - el.click(); - }, - } - })(); - - const onFileLoad = text => { - try { - _import(text); - } catch (e) { - log.error(`Couldn't read your settings!`, e); - } - } - - event.sub(SETTINGS_CHANGED, _render); - - return { - init, - loadOr, - getStore, - get, - set, - remove, - import: _import, - export: _export, - ui: { - set onToggle(fn) { - panel.onToggle(fn); - }, - toggle: () => panel.toggle(), - }, - set renderer(fn) { - _renderer = fn; - } - } -})(document, event, JSON, localStorage, log, window); - -// hardcoded ui stuff -settings.renderer = (() => { - // don't show these options (i.e. ignored = {'_version': 1}) - const ignored = {'_version': 1}; - - // the main display data holder element - let data = null; - - const scrollState = ((sx = 0, sy = 0, el) => ({ - track(_el) { - el = _el - el.addEventListener("scroll", () => ({scrollTop: sx, scrollLeft: sy} = el), {passive: true}) - }, - restore() { - el.scrollTop = sx - el.scrollLeft = sy - } - }))() - - // a fast way to clear data holder. - const clearData = () => { - while (data.firstChild) data.removeChild(data.firstChild) - }; - - const _option = (holderEl) => { - const wrapperEl = document.createElement('div'); - wrapperEl.classList.add('settings__option'); - - const titleEl = document.createElement('div'); - titleEl.classList.add('settings__option-title'); - wrapperEl.append(titleEl); - - const nameEl = document.createElement('div'); - - const valueEl = document.createElement('div'); - valueEl.classList.add('settings__option-value'); - wrapperEl.append(valueEl); - - return { - withName: function (name = '') { - if (name === '') return this; - nameEl.classList.add('settings__option-name'); - nameEl.textContent = name; - titleEl.append(nameEl); - return this; - }, - withClass: function (name = '') { - wrapperEl.classList.add(name); - return this; - }, - withDescription(text = '') { - if (text === '') return this; - const descEl = document.createElement('div'); - descEl.classList.add('settings__option-desc'); - descEl.textContent = text; - titleEl.append(descEl); - return this; - }, - restartNeeded: function () { - nameEl.classList.add('restart-needed-asterisk'); - return this; - }, - add: function (...elements) { - if (elements.length) for (let _el of elements.flat()) valueEl.append(_el); - return this; - }, - build: () => holderEl.append(wrapperEl), - }; - } - - const onKeyChange = (key, oldValue, newValue, handler) => { - - if (newValue !== 'Escape') { - const _settings = settings.get()[opts.INPUT_KEYBOARD_MAP]; - - if (_settings[newValue] !== undefined) { - log.warn(`There are old settings for key: ${_settings[newValue]}, won't change!`); - } else { - settings.remove(opts.INPUT_KEYBOARD_MAP, oldValue); - settings.set(opts.INPUT_KEYBOARD_MAP, {[newValue]: key}); - } - } - - handler?.unsub(); - - event.pub(KEYBOARD_TOGGLE_FILTER_MODE); - event.pub(SETTINGS_CHANGED); - } - - const _keyChangeOverlay = (keyName, oldValue) => { - const wrapperEl = document.createElement('div'); - wrapperEl.classList.add('settings__key-wait'); - wrapperEl.textContent = `Let's choose a ${keyName} key...`; - - let handler = event.sub(KEYBOARD_KEY_PRESSED, button => onKeyChange(keyName, oldValue, button.key, handler)); - - return wrapperEl; - } - - /** - * Handles a normal option change. - * - * @param key The name (id) of an option. - * @param newValue A new value to set. - */ - const onChange = (key, newValue) => { - settings.set(key, newValue); - scrollState.restore(data); - } - - const onKeyBindingChange = (key, oldValue) => { - clearData(); - data.append(_keyChangeOverlay(key, oldValue)); - event.pub(KEYBOARD_TOGGLE_FILTER_MODE); - } - - const render = function () { - const _settings = settings.getStore(); - - clearData(); - for (let k of Object.keys(_settings).sort()) { - if (ignored[k]) continue; - - const value = _settings[k]; - switch (k) { - case opts._VERSION: - _option(data).withName('Options format version').add(value).build(); - break; - case opts.LOG_LEVEL: - _option(data).withName('Log level') - .add(gui.select(k, onChange, { - labels: ['trace', 'debug', 'warning', 'info'], - values: [log.TRACE, log.DEBUG, log.WARN, log.INFO].map(String) - }, value)) - .build(); - break; - case opts.INPUT_KEYBOARD_MAP: - _option(data).withName('Keyboard bindings') - .withClass('keyboard-bindings') - .add(Object.keys(value).map(k => gui.binding(value[k], k, onKeyBindingChange))) - .build(); - break; - case opts.MIRROR_SCREEN: - _option(data).withName('Video mirroring') - .add(gui.select(k, onChange, {values: ['mirror'], labels: []}, value)) - .withDescription('Disables video image smoothing by rendering the video on a canvas (much more demanding for browser)') - .build(); - break; - case opts.VOLUME: - _option(data).withName('Volume (%)') - .add(gui.inputN(k, onChange, value)) - .restartNeeded() - .build() - break; - case opts.FORCE_FULLSCREEN: - _option(data).withName('Force fullscreen') - .withDescription( - 'Whether games should open in full-screen mode after starting up (excluding mobile devices)' - ) - .add(gui.checkbox(k, onChange, value, 'Enabled', 'settings__option-checkbox')) - .build() - break; - default: - _option(data).withName(k).add(value).build(); - } - } - - data.append( - gui.create('br'), - gui.create('div', (el) => { - el.classList.add('settings__info', 'restart-needed-asterisk-b'); - el.innerText = ' -- applied after page reload' - }), - gui.create('div', (el) => { - el.classList.add('settings__info'); - el.innerText = `Options format version: ${_settings?._version}`; - }) - ); - } - - return { - render, - set data(el) { - data = el; - scrollState.track(el) - } - } -})(document, gui, log, opts, settings); diff --git a/web/js/stats.js b/web/js/stats.js new file mode 100644 index 00000000..126ca4a8 --- /dev/null +++ b/web/js/stats.js @@ -0,0 +1,440 @@ +import {env} from 'env'; +import { + pub, + sub, + STATS_TOGGLE, + HELP_OVERLAY_TOGGLED, + PING_REQUEST, + PING_RESPONSE +} from 'event'; +import {log} from 'log'; +import {webrtc} from 'network'; + +const _modules = []; +let tempHide = false; + +// internal rendering stuff +const fps = 30; +let time = 0; +let active = false; + +// !to add connection drop notice + +const statsOverlayEl = document.getElementById('stats-overlay'); + +/** + * The graph element. + */ +const graph = (parent, opts = { + historySize: 60, + width: 60 * 2 + 2, + height: 20, + pad: 4, + scale: 1, + style: { + barColor: '#9bd914', + barFallColor: '#c12604' + } +}) => { + const _canvas = document.createElement('canvas'); + const _context = _canvas.getContext('2d'); + + let data = []; + + _canvas.setAttribute('class', 'graph'); + + _canvas.width = opts.width * opts.scale; + _canvas.height = opts.height * opts.scale; + + _context.scale(opts.scale, opts.scale); + _context.imageSmoothingEnabled = false; + _context.fillStyle = opts.fillStyle; + + if (parent) parent.append(_canvas); + + // bar size + const barWidth = Math.round(_canvas.width / opts.scale / opts.historySize); + const barHeight = Math.round(_canvas.height / opts.scale); + + let maxN = 0, + minN = 0; + + const max = () => maxN + + const get = () => _canvas + + const add = (value) => { + if (data.length > opts.historySize) data.shift(); + data.push(value); + render(); + } + + /** + * Draws a bar graph on the canvas. + */ + const render = () => { + // 0,0 w,0 0,0 w,0 0,0 w,0 + // +-------+ +-------+ +---------+ + // | | |+---+ | |+---+ | + // | | |||||| | ||||||+---+ + // | | |||||| | ||||||||||| + // +-------+ +----+--+ +---------+ + // 0,h w,h 0,h w,h 0,h w,h + // [] [3] [3, 2] + // + + _context.clearRect(0, 0, _canvas.width, _canvas.height); + + maxN = data[0] || 1; + minN = 0; + for (let k = 1; k < data.length; k++) { + if (data[k] > maxN) maxN = data[k]; + if (data[k] < minN) minN = data[k]; + } + + for (let j = 0; j < data.length; j++) { + let x = j * barWidth, + y = (barHeight - opts.pad * 2) * (data[j] - minN) / (maxN - minN) + opts.pad; + + const color = j > 0 && data[j] > data[j - 1] ? opts.style.barFallColor : opts.style.barColor; + + drawRect(x, barHeight - Math.round(y), barWidth, barHeight, color); + } + } + + const drawRect = (x, y, w, h, color = opts.style.barColor) => { + _context.fillStyle = color; + _context.fillRect(x, y, w, h); + } + + return {add, get, max, render} +} + +/** + * Get cached module UI. + * + * HTML: + *
    LABEL
    VALUE[]
    + * + * @param label The name of the stat to show. + * @param withGraph True if to draw a graph. + * @param postfix Supposed to be the name of the stat passed as a function. + * @returns {{el: HTMLDivElement, update: function}} + */ +const moduleUi = (label = '', withGraph = false, postfix = () => 'ms') => { + const ui = document.createElement('div'), + _label = document.createElement('div'), + _value = document.createElement('span'); + ui.append(_label, _value); + + let postfix_ = postfix; + + let _graph; + if (withGraph) { + const _container = document.createElement('span'); + ui.append(_container); + _graph = graph(_container); + } + + _label.innerHTML = label; + + const withPostfix = (value) => postfix_ = value; + + const update = (value) => { + if (_graph) _graph.add(value); + // 203 (333) ms + _value.textContent = `${value < 1 ? '<1' : value} ${_graph ? `(${_graph.max()}) ` : ''}${postfix_(value)}`; + } + + return {el: ui, update, withPostfix} +} + +/** + * Latency stats submodule. + * + * Accumulates the simple rolling mean value + * between the next server request and following server response values. + * + * window + * _____________ + * | | + * [1, 1, 3, 4, 1, 4, 3, 1, 2, 1, 1, 1, 2, ... n] + * | + * stats_snapshot_period + * mean = round(next - mean / length % window) + * + * Events: + * <- PING_RESPONSE + * <- PING_REQUEST + * + * ?Interface: + * HTMLElement get() + * void enable() + * void disable() + * void render() + * + * @version 1 + */ +const latency = (() => { + let listeners = []; + + let mean = 0; + let length = 0; + let previous = 0; + const window = 5; + + const ui = moduleUi('Ping(c)', true); + + const onPingRequest = (data) => previous = data.time; + + const onPingResponse = () => { + length++; + const delta = Date.now() - previous; + mean += Math.round((delta - mean) / length); + + if (length % window === 0) { + length = 1; + mean = delta; + } + } + + const enable = () => { + listeners.push( + sub(PING_RESPONSE, onPingResponse), + sub(PING_REQUEST, onPingRequest) + ); + } + + const disable = () => { + while (listeners.length) listeners.shift().unsub(); + } + + const render = () => ui.update(mean); + + const get = () => ui.el; + + return {get, enable, disable, render} +})(event, moduleUi); + +/** + * User agent memory stats. + * + * ?Interface: + * HTMLElement get() + * void enable() + * void disable() + * void render() + * + * @version 1 + */ +const clientMemory = (() => { + let active = false; + + const measures = ['B', 'KB', 'MB', 'GB']; + const precision = 1; + let mLog = 0; + + const ui = moduleUi('Memory', false, (x) => (x > 0) ? measures[mLog] : ''); + + const get = () => ui.el; + + const enable = () => { + active = true; + render(); + } + + const disable = () => active = false; + + const render = () => { + if (!active) return; + + const m = performance.memory.usedJSHeapSize; + let newValue = 'N/A'; + + if (m > 0) { + mLog = Math.floor(Math.log(m) / Math.log(1000)); + newValue = Math.round(m * precision / Math.pow(1000, mLog)) / precision; + } + + ui.update(newValue); + } + + if (window.performance && !performance.memory) performance.memory = {usedJSHeapSize: 0, totalJSHeapSize: 0}; + + return {get, enable, disable, render} +})(moduleUi, performance, window); + + +const webRTCStats_ = (() => { + let interval = null + + function getStats() { + if (!webrtc.isConnected()) return; + webrtc.getConnection().getStats(null).then(stats => { + let frameStatValue = '?'; + stats.forEach(report => { + if (report["framesReceived"] !== undefined && report["framesDecoded"] !== undefined && report["framesDropped"] !== undefined) { + frameStatValue = report["framesReceived"] - report["framesDecoded"] - report["framesDropped"]; + pub('STATS_WEBRTC_FRAME_STATS', frameStatValue) + } else if (report["framerateMean"] !== undefined) { + frameStatValue = Math.round(report["framerateMean"] * 100) / 100; + pub('STATS_WEBRTC_FRAME_STATS', frameStatValue) + } + + if (report["nominated"] && report["currentRoundTripTime"] !== undefined) { + pub('STATS_WEBRTC_ICE_RTT', report["currentRoundTripTime"] * 1000); + } + }); + }); + } + + const enable = () => { + interval = window.setInterval(getStats, 1000); + } + + const disable = () => window.clearInterval(interval); + + return {enable, disable, internal: true} +})(event, webrtc, window); + +/** + * User agent frame stats. + * + * ?Interface: + * HTMLElement get() + * void enable() + * void disable() + * void render() + * + * @version 1 + */ +const webRTCFrameStats = (() => { + let value = 0; + let listener; + + const label = env.getBrowser() === 'firefox' ? 'FramerateMean' : 'FrameDelay'; + const ui = moduleUi(label, false, () => ''); + + const get = () => ui.el; + + const enable = () => { + listener = sub('STATS_WEBRTC_FRAME_STATS', onStats); + } + + const disable = () => { + value = 0; + if (listener) listener.unsub(); + } + + const render = () => ui.update(value); + + function onStats(val) { + value = val; + } + + return {get, enable, disable, render} +})(env, event, moduleUi); + +const webRTCRttStats = (() => { + let value = 0; + let listener; + + const ui = moduleUi('RTT', true, () => 'ms'); + + const get = () => ui.el; + + const enable = () => { + listener = sub('STATS_WEBRTC_ICE_RTT', onStats); + } + + const disable = () => { + value = 0; + if (listener) listener.unsub(); + } + + const render = () => ui.update(value); + + function onStats(val) { + value = val; + } + + return {get, enable, disable, render} +})(event, moduleUi); + +const modules = (fn, force = true) => _modules.forEach(m => (force || !m.internal) && fn(m)) + +const enable = () => { + active = true; + modules(m => m.enable()) + render(); + draw(); + _show(); +}; + +function draw(timestamp) { + if (!active) return; + + const time_ = time + 1000 / fps; + + if (timestamp > time_) { + time = timestamp; + render(); + } + + requestAnimationFrame(draw); +} + +const disable = () => { + active = false; + modules(m => m.disable()); + _hide(); +} + +const _show = () => statsOverlayEl.style.visibility = 'visible'; +const _hide = () => statsOverlayEl.style.visibility = 'hidden'; + +const onToggle = () => active ? disable() : enable(); + +/** + * Handles help overlay toggle event. + * Workaround for a not normal app layout layering. + * + * !to remove when app layering is fixed + * + * @param {Object} overlay Overlay data. + * @param {boolean} overlay.shown A flag if the overlay is being currently showed. + */ +const onHelpOverlayToggle = (overlay) => { + if (statsOverlayEl.style.visibility === 'visible' && overlay.shown && !tempHide) { + _hide(); + tempHide = true; + } else { + if (tempHide) { + _show(); + tempHide = false; + } + } +} + +const render = () => modules(m => m.render(), false); + +// add submodules +_modules.push( + webRTCRttStats, + // latency, + clientMemory, + webRTCStats_, + webRTCFrameStats +); +modules(m => statsOverlayEl.append(m.get()), false); + +sub(STATS_TOGGLE, onToggle); +sub(HELP_OVERLAY_TOGGLED, onHelpOverlayToggle) + +/** + * App statistics module. + */ +export const stats = { + enable, + disable +} diff --git a/web/js/stats/stats.js b/web/js/stats/stats.js deleted file mode 100644 index c71b96e7..00000000 --- a/web/js/stats/stats.js +++ /dev/null @@ -1,433 +0,0 @@ -/** - * App statistics module. - * - * Events: - * <- STATS_TOGGLE - * <- HELP_OVERLAY_TOGGLED - * - * @version 1 - */ -const stats = (() => { - const _modules = []; - let tempHide = false; - - // internal rendering stuff - const fps = 30; - let time = 0; - let active = false; - - // !to add connection drop notice - - const statsOverlayEl = document.getElementById('stats-overlay'); - - /** - * The graph element. - */ - const graph = (parent, opts = { - historySize: 60, - width: 60 * 2 + 2, - height: 20, - pad: 4, - scale: 1, - style: { - barColor: '#9bd914', - barFallColor: '#c12604' - } - }) => { - const _canvas = document.createElement('canvas'); - const _context = _canvas.getContext('2d'); - - let data = []; - - _canvas.setAttribute('class', 'graph'); - - _canvas.width = opts.width * opts.scale; - _canvas.height = opts.height * opts.scale; - - _context.scale(opts.scale, opts.scale); - _context.imageSmoothingEnabled = false; - _context.fillStyle = opts.fillStyle; - - if (parent) parent.append(_canvas); - - // bar size - const barWidth = Math.round(_canvas.width / opts.scale / opts.historySize); - const barHeight = Math.round(_canvas.height / opts.scale); - - let maxN = 0, - minN = 0; - - const max = () => maxN - - const get = () => _canvas - - const add = (value) => { - if (data.length > opts.historySize) data.shift(); - data.push(value); - render(); - } - - /** - * Draws a bar graph on the canvas. - */ - const render = () => { - // 0,0 w,0 0,0 w,0 0,0 w,0 - // +-------+ +-------+ +---------+ - // | | |+---+ | |+---+ | - // | | |||||| | ||||||+---+ - // | | |||||| | ||||||||||| - // +-------+ +----+--+ +---------+ - // 0,h w,h 0,h w,h 0,h w,h - // [] [3] [3, 2] - // - - _context.clearRect(0, 0, _canvas.width, _canvas.height); - - maxN = data[0] || 1; - minN = 0; - for (let k = 1; k < data.length; k++) { - if (data[k] > maxN) maxN = data[k]; - if (data[k] < minN) minN = data[k]; - } - - for (let j = 0; j < data.length; j++) { - let x = j * barWidth, - y = (barHeight - opts.pad * 2) * (data[j] - minN) / (maxN - minN) + opts.pad; - - const color = j > 0 && data[j] > data[j - 1] ? opts.style.barFallColor : opts.style.barColor; - - drawRect(x, barHeight - Math.round(y), barWidth, barHeight, color); - } - } - - const drawRect = (x, y, w, h, color = opts.style.barColor) => { - _context.fillStyle = color; - _context.fillRect(x, y, w, h); - } - - return {add, get, max, render} - } - - /** - * Get cached module UI. - * - * HTML: - *
    LABEL
    VALUE[]
    - * - * @param label The name of the stat to show. - * @param withGraph True if to draw a graph. - * @param postfix Supposed to be the name of the stat passed as a function. - * @returns {{el: HTMLDivElement, update: function}} - */ - const moduleUi = (label = '', withGraph = false, postfix = () => 'ms') => { - const ui = document.createElement('div'), - _label = document.createElement('div'), - _value = document.createElement('span'); - ui.append(_label, _value); - - let postfix_ = postfix; - - let _graph; - if (withGraph) { - const _container = document.createElement('span'); - ui.append(_container); - _graph = graph(_container); - } - - _label.innerHTML = label; - - const withPostfix = (value) => postfix_ = value; - - const update = (value) => { - if (_graph) _graph.add(value); - // 203 (333) ms - _value.textContent = `${value < 1 ? '<1' : value} ${_graph ? `(${_graph.max()}) ` : ''}${postfix_(value)}`; - } - - return {el: ui, update, withPostfix} - } - - /** - * Latency stats submodule. - * - * Accumulates the simple rolling mean value - * between the next server request and following server response values. - * - * window - * _____________ - * | | - * [1, 1, 3, 4, 1, 4, 3, 1, 2, 1, 1, 1, 2, ... n] - * | - * stats_snapshot_period - * mean = round(next - mean / length % window) - * - * Events: - * <- PING_RESPONSE - * <- PING_REQUEST - * - * ?Interface: - * HTMLElement get() - * void enable() - * void disable() - * void render() - * - * @version 1 - */ - const latency = (() => { - let listeners = []; - - let mean = 0; - let length = 0; - let previous = 0; - const window = 5; - - const ui = moduleUi('Ping(c)', true); - - const onPingRequest = (data) => previous = data.time; - - const onPingResponse = () => { - length++; - const delta = Date.now() - previous; - mean += Math.round((delta - mean) / length); - - if (length % window === 0) { - length = 1; - mean = delta; - } - } - - const enable = () => { - listeners.push( - event.sub(PING_RESPONSE, onPingResponse), - event.sub(PING_REQUEST, onPingRequest) - ); - } - - const disable = () => { - while (listeners.length) listeners.shift().unsub(); - } - - const render = () => ui.update(mean); - - const get = () => ui.el; - - return {get, enable, disable, render} - })(event, moduleUi); - - /** - * User agent memory stats. - * - * ?Interface: - * HTMLElement get() - * void enable() - * void disable() - * void render() - * - * @version 1 - */ - const clientMemory = (() => { - let active = false; - - const measures = ['B', 'KB', 'MB', 'GB']; - const precision = 1; - let mLog = 0; - - const ui = moduleUi('Memory', false, (x) => (x > 0) ? measures[mLog] : ''); - - const get = () => ui.el; - - const enable = () => { - active = true; - render(); - } - - const disable = () => active = false; - - const render = () => { - if (!active) return; - - const m = performance.memory.usedJSHeapSize; - let newValue = 'N/A'; - - if (m > 0) { - mLog = Math.floor(Math.log(m) / Math.log(1000)); - newValue = Math.round(m * precision / Math.pow(1000, mLog)) / precision; - } - - ui.update(newValue); - } - - if (window.performance && !performance.memory) performance.memory = {usedJSHeapSize: 0, totalJSHeapSize: 0}; - - return {get, enable, disable, render} - })(moduleUi, performance, window); - - - const webRTCStats_ = (() => { - let interval = null - - function getStats() { - if (!webrtc.isConnected()) return; - webrtc.getConnection().getStats(null).then(stats => { - let frameStatValue = '?'; - stats.forEach(report => { - if (report["framesReceived"] !== undefined && report["framesDecoded"] !== undefined && report["framesDropped"] !== undefined) { - frameStatValue = report["framesReceived"] - report["framesDecoded"] - report["framesDropped"]; - event.pub('STATS_WEBRTC_FRAME_STATS', frameStatValue) - } else if (report["framerateMean"] !== undefined) { - frameStatValue = Math.round(report["framerateMean"] * 100) / 100; - event.pub('STATS_WEBRTC_FRAME_STATS', frameStatValue) - } - - if (report["nominated"] && report["currentRoundTripTime"] !== undefined) { - event.pub('STATS_WEBRTC_ICE_RTT', report["currentRoundTripTime"] * 1000); - } - }); - }); - } - - const enable = () => { - interval = window.setInterval(getStats, 1000); - } - - const disable = () => window.clearInterval(interval); - - return {enable, disable, internal: true} - })(event, webrtc, window); - - /** - * User agent frame stats. - * - * ?Interface: - * HTMLElement get() - * void enable() - * void disable() - * void render() - * - * @version 1 - */ - const webRTCFrameStats = (() => { - let value = 0; - let listener; - - const label = env.getBrowser() === 'firefox' ? 'FramerateMean' : 'FrameDelay'; - const ui = moduleUi(label, false, () => ''); - - const get = () => ui.el; - - const enable = () => { - listener = event.sub('STATS_WEBRTC_FRAME_STATS', onStats); - } - - const disable = () => { - value = 0; - if (listener) listener.unsub(); - } - - const render = () => ui.update(value); - - function onStats(val) { - value = val; - } - - return {get, enable, disable, render} - })(env, event, moduleUi); - - const webRTCRttStats = (() => { - let value = 0; - let listener; - - const ui = moduleUi('RTT', true, () => 'ms'); - - const get = () => ui.el; - - const enable = () => { - listener = event.sub('STATS_WEBRTC_ICE_RTT', onStats); - } - - const disable = () => { - value = 0; - if (listener) listener.unsub(); - } - - const render = () => ui.update(value); - - function onStats(val) { - value = val; - } - - return {get, enable, disable, render} - })(event, moduleUi); - - const modules = (fn, force = true) => _modules.forEach(m => (force || !m.internal) && fn(m)) - - const enable = () => { - active = true; - modules(m => m.enable()) - render(); - draw(); - _show(); - }; - - function draw(timestamp) { - if (!active) return; - - const time_ = time + 1000 / fps; - - if (timestamp > time_) { - time = timestamp; - render(); - } - - requestAnimationFrame(draw); - } - - const disable = () => { - active = false; - modules(m => m.disable()); - _hide(); - } - - const _show = () => statsOverlayEl.style.visibility = 'visible'; - const _hide = () => statsOverlayEl.style.visibility = 'hidden'; - - const onToggle = () => active ? disable() : enable(); - - /** - * Handles help overlay toggle event. - * Workaround for a not normal app layout layering. - * - * !to remove when app layering is fixed - * - * @param {Object} overlay Overlay data. - * @param {boolean} overlay.shown A flag if the overlay is being currently showed. - */ - const onHelpOverlayToggle = (overlay) => { - if (statsOverlayEl.style.visibility === 'visible' && overlay.shown && !tempHide) { - _hide(); - tempHide = true; - } else { - if (tempHide) { - _show(); - tempHide = false; - } - } - } - - const render = () => modules(m => m.render(), false); - - // add submodules - _modules.push( - webRTCRttStats, - // latency, - clientMemory, - webRTCStats_, - webRTCFrameStats - ); - modules(m => statsOverlayEl.append(m.get()), false); - - event.sub(STATS_TOGGLE, onToggle); - event.sub(HELP_OVERLAY_TOGGLED, onHelpOverlayToggle) - - return {enable, disable} -})(document, env, event, log, webrtc, window); diff --git a/web/js/stream.js b/web/js/stream.js new file mode 100644 index 00000000..cd213464 --- /dev/null +++ b/web/js/stream.js @@ -0,0 +1,222 @@ +import {env} from 'env'; +import { + sub, + APP_VIDEO_CHANGED, + SETTINGS_CHANGED +} from 'event' ; +import {gui} from 'gui'; +import {log} from 'log'; +import {opts, settings} from 'settings'; + +const screen = document.getElementById('stream'); + +let options = { + volume: 0.5, + poster: '/img/screen_loading.gif', + mirrorMode: null, + mirrorUpdateRate: 1 / 60, + forceFullscreen: true, + }, + state = { + screen: screen, + fullscreen: false, + timerId: null, + w: 0, + h: 0, + aspect: 4 / 3 + }; + +const mute = (mute) => screen.muted = mute + +const _stream = () => { + screen.play() + .then(() => log.info('Media can autoplay')) + .catch(error => { + log.error('Media failed to play', error); + }); +} + +const toggle = (show) => { + state.screen.toggleAttribute('hidden', !show) +} + +const toggleFullscreen = () => { + let h = parseFloat(getComputedStyle(state.screen, null) + .height + .replace('px', '') + ) + env.display().toggleFullscreen(h !== window.innerHeight, state.screen); +} + +const getVideoEl = () => screen + +screen.onerror = (e) => { + // video playback failed - show a message saying why + switch (e.target.error.code) { + case e.target.error.MEDIA_ERR_ABORTED: + log.error('You aborted the video playback.'); + break; + case e.target.error.MEDIA_ERR_NETWORK: + log.error('A network error caused the video download to fail part-way.'); + break; + case e.target.error.MEDIA_ERR_DECODE: + log.error('The video playback was aborted due to a corruption problem or because the video used features your browser did not support.'); + break; + case e.target.error.MEDIA_ERR_SRC_NOT_SUPPORTED: + log.error('The video could not be loaded, either because the server or network failed or because the format is not supported.'); + break; + default: + log.error('An unknown video error occurred.'); + break; + } +}; + +screen.addEventListener('loadedmetadata', () => { + if (state.screen !== screen) { + state.screen.setAttribute('width', screen.videoWidth); + state.screen.setAttribute('height', screen.videoHeight); + } +}, false); +screen.addEventListener('loadstart', () => { + screen.volume = options.volume; + screen.poster = options.poster; +}, false); +screen.addEventListener('canplay', () => { + screen.poster = ''; + useCustomScreen(options.mirrorMode === 'mirror'); +}, false); + +screen.addEventListener('fullscreenchange', () => { + state.fullscreen = !!document.fullscreenElement; + + const w = window.screen.width ?? window.innerWidth; + const h = window.screen.height ?? window.innerHeight; + + const ww = document.documentElement.innerWidth; + const hh = document.documentElement.innerHeight; + + screen.style.padding = '0' + if (state.fullscreen) { + const dw = (w - ww * state.aspect) / 2 + screen.style.padding = `0 ${dw}px` + // chrome bug + setTimeout(() => { + const dw = (h - hh * state.aspect) / 2 + screen.style.padding = `0 ${dw}px` + }, 1) + makeFullscreen(true); + } else { + makeFullscreen(false); + } + + // !to flipped +}) + +const makeFullscreen = (make = false) => { + screen.classList.toggle('no-media-controls', make) +} + +const forceFullscreenMaybe = () => { + const touchMode = env.isMobileDevice(); + log.debug('touch check', touchMode) + !touchMode && options.forceFullscreen && toggleFullscreen(); +} + +const useCustomScreen = (use) => { + if (use) { + if (screen.paused || screen.ended) return; + + let id = state.screen.getAttribute('id'); + if (id === 'canvas-mirror') return; + + const canvas = gui.create('canvas'); + canvas.setAttribute('id', 'canvas-mirror'); + canvas.setAttribute('hidden', ''); + canvas.setAttribute('width', screen.videoWidth); + canvas.setAttribute('height', screen.videoHeight); + canvas.style['image-rendering'] = 'pixelated'; + canvas.style.width = '100%' + canvas.style.height = '100%' + canvas.classList.add('game-screen'); + + // stretch depending on the video orientation + // portrait -- vertically, landscape -- horizontally + const isPortrait = screen.videoWidth < screen.videoHeight; + canvas.style.width = isPortrait ? 'auto' : canvas.style.width; + // canvas.style.height = isPortrait ? canvas.style.height : 'auto'; + + let surface = canvas.getContext('2d'); + screen.parentNode.insertBefore(canvas, screen.nextSibling); + toggle(false) + state.screen = canvas + toggle(true) + state.timerId = setInterval(function () { + if (screen.paused || screen.ended || !surface) return; + surface.drawImage(screen, 0, 0); + }, options.mirrorUpdateRate); + } else { + clearInterval(state.timerId); + let mirror = state.screen; + state.screen = screen; + toggle(true); + if (mirror !== screen) { + mirror.parentNode.removeChild(mirror); + } + } +} + +const init = () => { + options.mirrorMode = settings.loadOr(opts.MIRROR_SCREEN, 'none'); + options.volume = settings.loadOr(opts.VOLUME, 50) / 100; + options.forceFullscreen = settings.loadOr(opts.FORCE_FULLSCREEN, false); +} + +sub(SETTINGS_CHANGED, () => { + const s = settings.get(); + const newValue = s[opts.MIRROR_SCREEN]; + if (newValue !== options.mirrorMode) { + useCustomScreen(newValue === 'mirror'); + options.mirrorMode = newValue; + } + const newValue2 = s[opts.FORCE_FULLSCREEN]; + if (newValue2 !== options.forceFullscreen) { + options.forceFullscreen = newValue2; + } +}); + +const fit = 'contain' + +sub(APP_VIDEO_CHANGED, (payload) => { + const {w, h, a, s} = payload + + const scale = !s ? 1 : s; + const ww = w * scale; + const hh = h * scale; + + state.aspect = a + + const a2 = (ww / hh).toFixed(6) + + state.screen.style['object-fit'] = a > 1 && a.toFixed(6) !== a2 ? 'fill' : fit + state.h = hh + state.w = Math.floor(hh * a) + state.screen.setAttribute('width', '' + ww) + state.screen.setAttribute('height', '' + hh) + state.screen.style.aspectRatio = '' + state.aspect +}) + +/** + * Game streaming module. + * Contains HTML5 AV media elements. + * + * @version 1 + */ +export const stream = { + audio: {mute}, + video: {toggleFullscreen, el: getVideoEl}, + play: _stream, + toggle, + useCustomScreen, + forceFullscreenMaybe, + init +} diff --git a/web/js/stream/stream.js b/web/js/stream/stream.js deleted file mode 100644 index b0fb730d..00000000 --- a/web/js/stream/stream.js +++ /dev/null @@ -1,216 +0,0 @@ -/** - * Game streaming module. - * Contains HTML5 AV media elements. - * - * @version 1 - */ -const stream = (() => { - const screen = document.getElementById('stream'); - - let options = { - volume: 0.5, - poster: '/img/screen_loading.gif', - mirrorMode: null, - mirrorUpdateRate: 1 / 60, - forceFullscreen: true, - }, - state = { - screen: screen, - fullscreen: false, - timerId: null, - w: 0, - h: 0, - aspect: 4 / 3 - }; - - const mute = (mute) => screen.muted = mute - - const stream = () => { - screen.play() - .then(() => log.info('Media can autoplay')) - .catch(error => { - log.error('Media failed to play', error); - }); - } - - const toggle = (show) => { - state.screen.toggleAttribute('hidden', !show) - } - - const toggleFullscreen = () => { - let h = parseFloat(getComputedStyle(state.screen, null) - .height - .replace('px', '') - ) - env.display().toggleFullscreen(h !== window.innerHeight, state.screen); - } - - const getVideoEl = () => screen - - screen.onerror = (e) => { - // video playback failed - show a message saying why - switch (e.target.error.code) { - case e.target.error.MEDIA_ERR_ABORTED: - log.error('You aborted the video playback.'); - break; - case e.target.error.MEDIA_ERR_NETWORK: - log.error('A network error caused the video download to fail part-way.'); - break; - case e.target.error.MEDIA_ERR_DECODE: - log.error('The video playback was aborted due to a corruption problem or because the video used features your browser did not support.'); - break; - case e.target.error.MEDIA_ERR_SRC_NOT_SUPPORTED: - log.error('The video could not be loaded, either because the server or network failed or because the format is not supported.'); - break; - default: - log.error('An unknown video error occurred.'); - break; - } - }; - - screen.addEventListener('loadedmetadata', () => { - if (state.screen !== screen) { - state.screen.setAttribute('width', screen.videoWidth); - state.screen.setAttribute('height', screen.videoHeight); - } - }, false); - screen.addEventListener('loadstart', () => { - screen.volume = options.volume; - screen.poster = options.poster; - }, false); - screen.addEventListener('canplay', () => { - screen.poster = ''; - useCustomScreen(options.mirrorMode === 'mirror'); - }, false); - - screen.addEventListener('fullscreenchange', () => { - state.fullscreen = !!document.fullscreenElement; - - const w = window.screen.width ?? window.innerWidth; - const h = window.screen.height ?? window.innerHeight; - - const ww = document.documentElement.innerWidth; - const hh = document.documentElement.innerHeight; - - screen.style.padding = '0' - if (state.fullscreen) { - const dw = (w - ww * state.aspect) / 2 - screen.style.padding = `0 ${dw}px` - // chrome bug - setTimeout(() => { - const dw = (h - hh * state.aspect) / 2 - screen.style.padding = `0 ${dw}px` - }, 1) - makeFullscreen(true); - } else { - makeFullscreen(false); - } - - // !to flipped - }) - - const makeFullscreen = (make = false) => { - screen.classList.toggle('no-media-controls', make) - } - - const forceFullscreenMaybe = () => { - const touchMode = env.isMobileDevice(); - log.debug('touch check', touchMode) - !touchMode && options.forceFullscreen && toggleFullscreen(); - } - - const useCustomScreen = (use) => { - if (use) { - if (screen.paused || screen.ended) return; - - let id = state.screen.getAttribute('id'); - if (id === 'canvas-mirror') return; - - const canvas = gui.create('canvas'); - canvas.setAttribute('id', 'canvas-mirror'); - canvas.setAttribute('hidden', ''); - canvas.setAttribute('width', screen.videoWidth); - canvas.setAttribute('height', screen.videoHeight); - canvas.style['image-rendering'] = 'pixelated'; - canvas.style.width = '100%' - canvas.style.height = '100%' - canvas.classList.add('game-screen'); - - // stretch depending on the video orientation - // portrait -- vertically, landscape -- horizontally - const isPortrait = screen.videoWidth < screen.videoHeight; - canvas.style.width = isPortrait ? 'auto' : canvas.style.width; - // canvas.style.height = isPortrait ? canvas.style.height : 'auto'; - - let surface = canvas.getContext('2d'); - screen.parentNode.insertBefore(canvas, screen.nextSibling); - toggle(false) - state.screen = canvas - toggle(true) - state.timerId = setInterval(function () { - if (screen.paused || screen.ended || !surface) return; - surface.drawImage(screen, 0, 0); - }, options.mirrorUpdateRate); - } else { - clearInterval(state.timerId); - let mirror = state.screen; - state.screen = screen; - toggle(true); - if (mirror !== screen) { - mirror.parentNode.removeChild(mirror); - } - } - } - - const init = () => { - options.mirrorMode = settings.loadOr(opts.MIRROR_SCREEN, 'none'); - options.volume = settings.loadOr(opts.VOLUME, 50) / 100; - options.forceFullscreen = settings.loadOr(opts.FORCE_FULLSCREEN, false); - } - - event.sub(SETTINGS_CHANGED, () => { - const s = settings.get(); - const newValue = s[opts.MIRROR_SCREEN]; - if (newValue !== options.mirrorMode) { - useCustomScreen(newValue === 'mirror'); - options.mirrorMode = newValue; - } - const newValue2 = s[opts.FORCE_FULLSCREEN]; - if (newValue2 !== options.forceFullscreen) { - options.forceFullscreen = newValue2; - } - }); - - - const fit = 'contain' - - event.sub(APP_VIDEO_CHANGED, (payload) => { - const {w, h, a, s} = payload - - const scale = !s ? 1 : s; - const ww = w * scale; - const hh = h * scale; - - state.aspect = a - - const a2 = (ww / hh).toFixed(6) - - state.screen.style['object-fit'] = a > 1 && a.toFixed(6) !== a2 ? 'fill' : fit - state.h = hh - state.w = Math.floor(hh * a) - state.screen.setAttribute('width', '' + ww) - state.screen.setAttribute('height', '' + hh) - state.screen.style.aspectRatio = '' + state.aspect - }) - - return { - audio: {mute}, - video: {toggleFullscreen, el: getVideoEl}, - play: stream, - toggle, - useCustomScreen, - forceFullscreenMaybe, - init - } - } -)(env, event, gui, log, opts, settings); diff --git a/web/js/utils.js b/web/js/utils.js index 28f557ab..5725c6cb 100644 --- a/web/js/utils.js +++ b/web/js/utils.js @@ -1,58 +1,50 @@ /** - * Utility module. - * @version 1 + * A decorator that passes the call to function at maximum once per specified milliseconds. + * @param f The function to call. + * @param ms The amount of time in milliseconds to ignore the function calls. + * @returns {Function} + * @example + * const showMessage = () => { alert('00001'); } + * const showOnlyOnceASecond = debounce(showMessage, 1000); */ -const utils = (() => { - return { - /** - * A decorator that passes the call to function at maximum once per specified milliseconds. - * @param f The function to call. - * @param ms The amount of time in milliseconds to ignore the function calls. - * @returns {Function} - * @example - * const showMessage = () => { alert('00001'); } - * const showOnlyOnceASecond = debounce(showMessage, 1000); - */ - debounce: (f, ms) => { - let wait = false; +export const debounce = (f, ms) => { + let wait = false; - return function () { - if (wait) return; + return function () { + if (wait) return; - f.apply(this, arguments); - wait = true; - setTimeout(() => wait = false, ms); - }; - }, + f.apply(this, arguments); + wait = true; + setTimeout(() => wait = false, ms); + }; +} - /** - * A decorator that blocks and calls the last function until the specified amount of milliseconds. - * @param f The function to call. - * @param ms The amount of time in milliseconds to ignore the function calls. - * @returns {Function} - */ - throttle: (f, ms) => { - let lastCall; - let lastTime; +/** + * A decorator that blocks and calls the last function until the specified amount of milliseconds. + * @param f The function to call. + * @param ms The amount of time in milliseconds to ignore the function calls. + * @returns {Function} + */ +export const throttle = (f, ms) => { + let lastCall; + let lastTime; - return function () { - // could be a stack - const lastContext = this; - const lastArguments = arguments; + return function () { + // could be a stack + const lastContext = this; + const lastArguments = arguments; - if (!lastTime) { + if (!lastTime) { + f.apply(lastContext, lastArguments); + lastTime = Date.now() + } else { + clearTimeout(lastCall); + lastCall = setTimeout(() => { + if (Date.now() - lastTime >= ms) { f.apply(lastContext, lastArguments); lastTime = Date.now() - } else { - clearTimeout(lastCall); - lastCall = setTimeout(() => { - if (Date.now() - lastTime >= ms) { - f.apply(lastContext, lastArguments); - lastTime = Date.now() - } - }, ms - (Date.now() - lastTime)) } - } + }, ms - (Date.now() - lastTime)) } } -})(); +} diff --git a/web/js/workerManager.js b/web/js/workerManager.js index 3d119b2a..4afba4ca 100644 --- a/web/js/workerManager.js +++ b/web/js/workerManager.js @@ -1,151 +1,158 @@ -/** - * Worker manager module. - * @version 1 - */ -const workerManager = (() => { - const id = 'servers', - _class = 'server-list', - trigger = document.getElementById('w'), - panel = gui.panel(document.getElementById(id), 'WORKERS', 'server-list', null, [ - { - caption: '⟳', - cl: ['bold'], - handler: utils.debounce(handleReload, 1000), - title: 'Reload server data', - } - ]), - index = ((i = 1) => ({v: () => i++, r: () => i = 1}))(), - // caption -- the field caption - // renderer -- an arbitrary DOM output for the field - list = { - 'n': { - renderer: renderIdEl - }, - 'id': { - caption: 'ID', - renderer: (data) => data?.in_group ? `${data.id} x ${data.replicas}` : data.id - }, - 'addr': { - caption: 'Address', - renderer: (data) => data?.port ? `${data.addr}:${data.port}` : data.addr - }, - 'is_busy': { - caption: 'State', - renderer: renderStateEl - }, - 'use': { - caption: 'Use', - renderer: renderServerChangeEl - } +import {api} from 'api'; +import { + sub, + WORKER_LIST_FETCHED +} from 'event' +import {gui} from 'gui'; +import {log} from 'log'; +import {ajax} from 'network'; +import {debounce} from 'utils'; + +const id = 'servers', + _class = 'server-list', + trigger = document.getElementById('w'), + panel = gui.panel(document.getElementById(id), 'WORKERS', 'server-list', null, [ + { + caption: '⟳', + cl: ['bold'], + handler: debounce(handleReload, 1000), + title: 'Reload server data', + } + ]), + index = ((i = 1) => ({v: () => i++, r: () => i = 1}))(), + // caption -- the field caption + // renderer -- an arbitrary DOM output for the field + list = { + 'n': { + renderer: renderIdEl }, - fields = Object.keys(list); - - let state = { - lastId: null, - workers: [], - } - - const onNewData = (dat = {servers: []}) => { - panel.setLoad(false); - index.r(); - state.workers = dat?.servers || []; - _render(state.workers); - } - - function _render(servers = []) { - if (panel.isHidden()) return; - - const content = gui.fragment(); - - if (servers.length === 0) { - content.append(gui.create('span', (el) => el.innerText = 'No data :(')); - panel.setContent(content); - return; + 'id': { + caption: 'ID', + renderer: (data) => data?.in_group ? `${data.id} x ${data.replicas}` : data.id + }, + 'addr': { + caption: 'Address', + renderer: (data) => data?.port ? `${data.addr}:${data.port}` : data.addr + }, + 'is_busy': { + caption: 'State', + renderer: renderStateEl + }, + 'use': { + caption: 'Use', + renderer: renderServerChangeEl } + }, + fields = Object.keys(list); - const header = gui.create('div', (el) => { - el.classList.add(`${_class}__header`); - fields.forEach(field => el.append(gui.create('span', (f) => f.innerHTML = list[field]?.caption || ''))) - }); - content.append(header) +let state = { + lastId: null, + workers: [], +} - const renderRow = (server) => (row) => { - if (server?.id && state.lastId && state.lastId === server?.id) { - row.classList.add('active'); - } - return fields.forEach(field => { - const val = server.hasOwnProperty(field) ? server[field] : ''; - const renderer = list[field]?.renderer; - row.append(gui.create('span', (f) => f.append(renderer ? renderer(server) : val))); - }) - } - servers.forEach(server => content.append(gui.create('div', renderRow(server)))) +const onNewData = (dat = {servers: []}) => { + panel.setLoad(false); + index.r(); + state.workers = dat?.servers || []; + _render(state.workers); +} + +function _render(servers = []) { + if (panel.isHidden()) return; + + const content = gui.fragment(); + + if (servers.length === 0) { + content.append(gui.create('span', (el) => el.innerText = 'No data :(')); panel.setContent(content); + return; } - function handleReload() { - panel.setLoad(true); - api.server.getWorkerList(); - } + const header = gui.create('div', (el) => { + el.classList.add(`${_class}__header`); + fields.forEach(field => el.append(gui.create('span', (f) => f.innerHTML = list[field]?.caption || ''))) + }); + content.append(header) - function renderIdEl(server) { - const id = String(index.v()).padStart(2, '0'); - const isActive = server?.id && state.lastId && state.lastId === server?.id - return `${(isActive ? '>' : '')}${id}` - } - - function renderServerChangeEl(server) { - const handleServerChange = (e) => { - e.preventDefault(); - window.location.search = `wid=${server.id}` + const renderRow = (server) => (row) => { + if (server?.id && state.lastId && state.lastId === server?.id) { + row.classList.add('active'); } - return gui.create('a', (el) => { - el.innerText = '>>'; - el.href = "#"; - el.addEventListener('click', handleServerChange); + return fields.forEach(field => { + const val = server.hasOwnProperty(field) ? server[field] : ''; + const renderer = list[field]?.renderer; + row.append(gui.create('span', (f) => f.append(renderer ? renderer(server) : val))); }) } + servers.forEach(server => content.append(gui.create('div', renderRow(server)))) + panel.setContent(content); +} - function renderStateEl(server) { - const state = server?.is_busy === true ? 'R' : '' - if (server.room) { - return gui.create('a', (el) => { - el.innerText = state; - el.href = "/?id=" + server.room; - }) - } - return state +function handleReload() { + panel.setLoad(true); + api.server.getWorkerList(); +} + +function renderIdEl(server) { + const id = String(index.v()).padStart(2, '0'); + const isActive = server?.id && state.lastId && state.lastId === server?.id + return `${(isActive ? '>' : '')}${id}` +} + +function renderServerChangeEl(server) { + const handleServerChange = (e) => { + e.preventDefault(); + window.location.search = `wid=${server.id}` } - - panel.toggle(false); - - trigger.addEventListener('click', () => { - handleReload(); - panel.toggle(true); + return gui.create('a', (el) => { + el.innerText = '>>'; + el.href = "#"; + el.addEventListener('click', handleServerChange); }) +} - const checkLatencies = (data) => { - const timeoutMs = 1111; - // deduplicate - const addresses = [...new Set(data.addresses || [])]; - - return Promise.all(addresses.map(address => { - const start = Date.now(); - return ajax.fetch(`${address}?_=${start}`, {method: "GET", redirect: "follow"}, timeoutMs) - .then(() => ({[address]: Date.now() - start})) - .catch(() => ({[address]: 9999})); - })) - }; - - const whoami = (id) => { - state.lastId = id; - _render(state.workers); +function renderStateEl(server) { + const state = server?.is_busy === true ? 'R' : '' + if (server.room) { + return gui.create('a', (el) => { + el.innerText = state; + el.href = "/?id=" + server.room; + }) } + return state +} - event.sub(WORKER_LIST_FETCHED, onNewData); +panel.toggle(false); - return { - checkLatencies, - whoami, - } -})(ajax, api, document, event, gui, log, utils); +trigger.addEventListener('click', () => { + handleReload(); + panel.toggle(true); +}) + +const checkLatencies = (data) => { + const timeoutMs = 1111; + // deduplicate + const addresses = [...new Set(data.addresses || [])]; + + return Promise.all(addresses.map(address => { + const start = Date.now(); + return ajax.fetch(`${address}?_=${start}`, {method: "GET", redirect: "follow"}, timeoutMs) + .then(() => ({[address]: Date.now() - start})) + .catch(() => ({[address]: 9999})); + })) +}; + +const whoami = (id) => { + state.lastId = id; + _render(state.workers); +} + +sub(WORKER_LIST_FETCHED, onNewData); + +/** + * Worker manager module. + */ +export const workerManager = { + checkLatencies, + whoami, +} From 8654604b9bc636ebb025e660ad88fac8632fbc65 Mon Sep 17 00:00:00 2001 From: Sergey Stepanov Date: Sun, 17 Mar 2024 22:01:10 +0300 Subject: [PATCH 193/361] Fix index.html warnings --- web/index.html | 41 ++++++++++++++++++++--------------------- web/js/input/touch.js | 15 ++++++++++----- 2 files changed, 30 insertions(+), 26 deletions(-) diff --git a/web/index.html b/web/index.html index 61f24f13..8093f5d4 100644 --- a/web/index.html +++ b/web/index.html @@ -24,10 +24,10 @@
    W
    -
    -
    -
    -
    +
    +
    +
    +
    @@ -53,31 +53,30 @@ Shift/Enter/K/L (select/start/save/load), F (fullscreen), share (copy the link to the clipboard)
    -
    +
    player choice - +
    -
    +
    - - -
    -
    + + +
    +
    -
    -
    -
    -
    +
    +
    +
    +
    -
    +
    - - +

    h)$P*|>69m1BOE0Q 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%0ACY~Cc;Su4zM+C3$0qTc)E{I)!(wV# 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�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