Vulkan官方API文档 Vulkan® 1.0.95 - A Specification 对于开发者来说，非常有用。
由于官方网站访问非常缓慢，建议下载PDF版本到本地来查看。
官方文档地址： Vulkan® 1.0.95 - A Specification - Khronos Group
官方PDF版本地址： Vulkan® 1.0.95 - A Specification - Khronos Group
本站的一份PDF版拷贝
继续阅读Vulkan官方API文档Vulkan® 1.0.95 - A Specification
最近在学习Vulkan,结果在查看示例代码的时候：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
#version 430 core layout (local_size_x = 64) in; layout(std430, binding=4 ) buffer INFO { vec2 info[]; }; void main() { uint gid = gl_GlobalInvocationID.x; info[gid].x += 1.0; info[gid].y += 1.0; memoryBarrier(); } |
对于如下语句出现了疑问
|
1 |
#version 430 core |
这句话的意思是OpenGL必须是4.3以及以上的版本。
那么是不是意味着，如果设备上的OpenGL低于这个版本，那么我们编写的Vulkan代码就不能执行呢？
答案是否定的，目前我们开发Vulkan默认是使用GLSL（OpenGL Shading Language）语言，然后编译完成后的操作符被直接映射成Vulkan的定义操作符。
换句话说，我们只要执行如下命令，
|
1 |
$ glslangValidator xx.comp --target-env vulkan1.0 |
能编译通过，就可以随意指定#version的版本。
这个版本号仅仅是GLSL语言在进行语法检查的时候需要的，而Vulkan是没有这个版本号需要的。
如果不使用GLSL语言编写，上述的#version应该都不会在语法中出现。
最近在学习Vulkan,结果在查看示例代码的时候，对于如下两句出现了疑问：
|
1 |
layout(local_size_x = X, local_size_y = Y, local_size_z = Z) in; |
|
1 |
ivec3 pos = ivec3(gl_GlobalInvocationID); |
首先是Invocation这个单词的理解，计算机语言中他的意思是 "the act of making a particular function start" ,中文意思是 "调用，启用"。
其中
|
1 |
layout(local_size_x = X, local_size_y = Y, local_size_z = Z) in; |
意思是初始化，X * Y * Z 个计算单元供我们的代码调用，可以简单理解成线程数。如果不设置这几个值，默认值是 1，也就是只提供一个计算单元（线程）。
而使用如下的代码
|
1 |
ivec3 pos = ivec3(gl_GlobalInvocationID); |
意思是获取当前代码运行的计算单元的编号，也可以理解成获取当前线程的索引。
下面的代码都使用如下的命令编译成Vulkan使用的SPIR-V格式的代码
|
1 |
$ glslangValidator xx.comp --target-env vulkan1.0 |
比如下面的代码,就是一个简单的利用gl_GlobalInvocationID，进行并行计算的例子：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
#version 430 core layout (local_size_x = 64) in; layout(std430, binding=4 ) buffer INFO { vec2 info[]; }; void main() { uint gid = gl_GlobalInvocationID.x; info[gid].x += 1.0; info[gid].y += 1.0; memoryBarrier(); } |
但是，如果传入的数组的大小超过我们设置的计算单元的数量的情况，上述的代码是处理不了的。
可以如下方式处理上述情况：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
/*atomicAdd 从4.30版本的opengl开始提供，之前的版本没有这个函数*/ #version 430 core layout (local_size_x = 64) in; layout(std430, binding=4 ) buffer INFO { vec2 info[]; }; layout(std430, binding=5 ) buffer LEN { uint len; }; uint counter = 0; void main() { uint gid = atomicAdd(counter,1); if (gid <= len ) { info[gid].x += 1.0; info[gid].y += 1.0; memoryBarrier(); } } void main() { uint gid = atomicAdd(counter,1); if (gid <= len ) { info[gid].x += 1.0; info[gid].y += 1.0; memoryBarrier(); } } |
如果想动态调整计算单元的数量，增加处理灵活性，可以参考下面的代码：
|
1 2 3 4 5 6 |
#version 450 layout(local_size_x_id = 0) in; layout(local_size_y_id = 1) in; layout(local_size_z_id = 2) in; //rest of the shader |
外部通过
|
1 2 3 4 5 6 7 |
VkResult vkCreateComputePipelines( VkDevice device, VkPipelineCache pipelineCache, uint32_t createInfoCount, const VkComputePipelineCreateInfo* pCreateInfos, const VkAllocationCallbacks* pAllocator, VkPipeline* pPipelines); |
函数调用的时候，指定
|
1 2 3 4 5 6 7 8 9 |
typedef struct VkComputePipelineCreateInfo { VkStructureType sType; const void* pNext; VkPipelineCreateFlags flags; VkPipelineShaderStageCreateInfo stage; VkPipelineLayout layout; VkPipeline basePipelineHandle; int32_t basePipelineIndex; } VkComputePipelineCreateInfo; |
参数中的
|
1 2 3 4 5 6 7 8 9 |
typedef struct VkPipelineShaderStageCreateInfo { VkStructureType sType; const void* pNext; VkPipelineShaderStageCreateFlags flags; VkShaderStageFlagBits stage; VkShaderModule module; const char* pName; const VkSpecializationInfo* pSpecializationInfo; } VkPipelineShaderStageCreateInfo; |
参数中的
|
1 2 3 4 5 6 |
typedef struct VkSpecializationInfo { uint32_t mapEntryCount; const VkSpecializationMapEntry* pMapEntries; size_t dataSize; const void* pData; } VkSpecializationInfo; |
参数中的
|
1 2 3 4 5 |
typedef struct VkSpecializationMapEntry { uint32_t constantID; uint32_t offset; size_t size; } VkSpecializationMapEntry; |
指定的数值来动态调整所需要的计算单元的数量。
整个参数的设置流程特别长，非常难掌握。具体的使用例子参考 Glavnokoman/vuh以及 Vulkan® 1.0.95 - A Specification - Khronos Group文档中的上述参数的使用例子。
如果内部不指定，也可以通过外部调用
|
1 2 3 4 5 |
void vkCmdDispatch( VkCommandBuffer commandBuffer, uint32_t groupCountX, uint32_t groupCountY, uint32_t groupCountZ); |
的时候设置，但是这样的设置存在一定的灵活性问题，可能需要多个独立的ComputePipeline来配合。
最近升级到WordPress 5.0,这个版本的一个重要功能改进就是Gutenberg 编辑器，但是遗憾的是，这个版本的编辑器目前跟很多插件不兼容。我们只能是暂时禁用Gutenberg 编辑器，而是使用以前的经典版本的编辑器。
另外，目前试用来看，这个编辑器，也不好用。
最简单的办法就是安装官方提供的Classic Editor这个插件，如下图：
继续阅读WordPress 5.0禁用古腾堡(Gutenberg)编辑器
最近在学习Vulkan,根据Google官方给出的文档，是存在一些问题的，总结一下：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
# 官方文档说要检出 git clone https://github.com/googlesamples/vulkan-basic-samples.git # 实际上 vulkan-basic-samples.git 是 VulkanSamples.git 的一个fork，google简化了部分编译流程 # vulkan-basic-samples.git检出后，直接用 Android Studio打开即可 # https://github.com/SaschaWillems/Vulkan.git也存在一个例子工程 # 但是貌似根正苗红的是VulkanSamples这个例子 $ git clone https://github.com/LunarG/VulkanSamples.git $ cd VulkanSamples $ cd API-Samples # 最后在当前目录下生成一个 android 的目录，用Android Studio导入这个目录下的工程 # 也就是 "VulkanSamples/API-Samples/android" 这个目录是我们的工程目录 $ cmake -DANDROID=ON -DABI_NAME=armeabi-v7a |
服务器经常需要备份，但是长时间的下载，难免会出现下载中断的情况。
一直使用scp下载备份好的文件，以前数据量少的时候，直接重新下载就可以了。随着网站上数据越来越多，下载的时间越来越长，完全重新开始变得不现实了。有时候下载到90%以上的时候，失败了，完全重传是没有必要的。
我们只需要下载缺失的部分就好了，幸运的是rsync支持这种需求。
具体的做法是将如下的选项组合传递给rsync，-checksum（文件分块计算校验和，只传输校验和不一致的部分），-in-place（将文件原地替换，因为rsync通常会写一个临时文件，然后移动）和-no-whole-file（告诉rsync不要复制整个文件，而是使用deltas（部分传输））。
例如：
|
1 |
$ rsync -Pa --checksum --inplace --no-whole-file --progress remote.server:file local.file |
下面是一个真实的例子：
|
1 2 3 4 5 |
$ rsync -Pa --checksum --inplace --no-whole-file --progress -e 'ssh -p 22' user@www.mobibrw.com:~/backup/wordpress.20181203.tar.gz wordpress.20181203.tar.gz receiving incremental file list sent 19 bytes received 76 bytes 0.22 bytes/sec total size is 8379088896 speedup is 88200935.75 |
整个过程非常的快，比完全重传快多了。
scp命令拷贝文件非常好用，但在拷贝大文件时存在一个问题就是连接经常会断开，此时再使用scp进行拷贝会重新拷贝文件，为了解决这个问题。我们可以使用rsync命令来进行断点续传。命令如下：
|
1 |
$ rsync -P --rsh=ssh xxx.zip 192.168.0.1:~/ |
为了使用方便可以设置alias:
|
1 |
$ alias rscp="rsync -P --rsh=ssh" |
目前在研究学习Vulkan，Vulkan使用SPIR-V工具链进行编译，在macOS Mojave(10.14.1)中使用如下命令安装工具链：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
$ brew info glslang glslang: stable 7.10.2984 (bottled), HEAD OpenGL and OpenGL ES reference compiler for shading languages https://www.khronos.org/opengles/sdk/tools/Reference-Compiler/ Not installed From: https://github.com/Homebrew/homebrew-core/blob/master/Formula/glslang.rb ==> Dependencies Build: cmake ✘ ==> Options --HEAD Install HEAD version ==> Analytics install: 1,147 (30 days), 1,770 (90 days), 2,664 (365 days) install_on_request: 383 (30 days), 696 (90 days), 1,537 (365 days) build_error: 0 (30 days) $ brew install glslang ==> Downloading https://homebrew.bintray.com/bottles/glslang-7.10.2984.mojave.bo ######################################################################## 100.0% ==> Pouring glslang-7.10.2984.mojave.bottle.tar.gz ? /usr/local/Cellar/glslang/7.10.2984: 58 files, 6.7MB $ glslangValidator -v Glslang Version: 7.10.2984 ESSL Version: OpenGL ES GLSL 3.20 glslang Khronos. 10.2984 GLSL Version: 4.60 glslang Khronos. 10.2984 SPIR-V Version 0x00010300, Revision 1 GLSL.std.450 Version 100, Revision 1 Khronos Tool ID 8 SPIR-V Generator Version 7 GL_KHR_vulkan_glsl version 100 ARB_GL_gl_spirv version 100 |
但是，需要注意的是，使用HomeBrew安装的版本，缺少部分功能，如果使用"-Os"(代码大小优化)参数的时候，会报告错误，如下：
|
1 2 |
$ glslangValidator -V -Os glslangValidator: Error -Os not available; optimizer not linked (use -h for usage) |
这是由于代码大小优化部分需要spirv-tools执行，然而HomeBrew编译的版本没有关联spirv-tools导致安装的程序没办法使用这个功能。
如果需要这部分功能，我们只能手动编译安装：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
# 移除brew安装的版本 $ brew remove glslang # 编译安装 glslang $ git clone https://github.com/KhronosGroup/glslang.git $ cd glslang # 目前（2018.12.17）的正式版，最稳定的版本，试过最新的版本，编译部分代码存在问题 $ git checkout 7.10.2984 # 下载 spirv-tools 部分的功能代码 $ python update_glslang_sources.py $ mkdir build $ cd build $ cmake .. $ make $ sudo make install |
在使用Android Studio 3.2.1 结合 NDK r16/r18编译代码时候出现如下警告：
|
1 2 |
<built-in>: In function 'float abs(float)': <built-in>: warning: conflicts with previous declaration here [-Wattributes] |
关键是出现警告的代码文件中并不一定存在abs函数的调用。
这个警告产生的条件是在编译器中指定了STL，并且指定编译器为GCC，调用的源代码文件中恰好有STL的代码。
类似如下：
|
1 2 3 4 5 6 |
externalNativeBuild { cmake { cppFlags "-DANDROID_ARM_NEON=TRUE", "-DANDROID_TOOLCHAIN=gcc", "-DANDROID_PLATFORM=android-21", "-DANDROID_STL=c++_static" abiFilters 'armeabi-v7a' } } |
原因在于新版本的NDK r16/r18中，对于GCC部分的适配已经不是非常完善了，已经逐步迁移到CLANG(LLVM)了。导致STL进行编译的时候，会出现一些警告信息。这个警告信息是STL库的警告信息，跟我们自己的代码没有关系。
只需要指定 "-DANDROID_TOOLCHAIN=clang" 即可解决这个问题。
NDK r13, -fexceptions -Wall --> warning: conflicts with previous declaration
在使用如下命令检出Vulkan的时候，发生失败，Vulkan的代码已经成功检出，但是子模块没有完成
|
1 |
$ git clone --recursive https://github.com/SaschaWillems/Vulkan.git |
|
1 2 3 |
warning: 克隆成功，但是检出失败。 您可以通过 'git status' 检查哪些已被检出，然后使用命令 'git checkout -f HEAD' 重试 |
|
1 |
$ git submodule update --init --recursive --progress |
在用Android Studio 3.2.1导入以前的项目，进行编译的时候，报告如下错误信息：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
FAILURE: Build failed with an exception. * What went wrong: A problem occurred configuring project ':app'. > No toolchains found in the NDK toolchains folder for ABI with prefix: mips64el-linux-android * Try: Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights. * Get more help at https://help.gradle.org CONFIGURE FAILED in 5s No toolchains found in the NDK toolchains folder for ABI with prefix: mips64el-linux-android |
这个错误信息的原因是从NDK r17版本开始，已经不支持"armeabi、mips、mips64"这三种ABI格式了，而当前机器上安装的NDK版本是NDK r17之后的版本。
不过这个提示很能迷惑人，会让人误以为自己的build.gradle中配置了MIPS的ABI。实际上根本没有配置，是低版本的构建工具自己在默认构建MIPS格式，而又找不到对应的工具链。
解决方法很简单，要么使用低于NDK r17的NDK版本，要么修改主工程的build.gradle,找到如下
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
// Top-level build file where you can add configuration options common to all sub-projects/modules. configure(allprojects) { buildscript { repositories { google() jcenter() } dependencies { classpath 'com.android.tools.build:gradle:3.0.0' } } repositories { jcenter() } } |
将其中的
|
1 |
classpath 'com.android.tools.build:gradle:3.0.0' |
修改成
|
1 |
classpath 'com.android.tools.build:gradle:3.2.1' |
高版本的构建工具，才能适配高版本的NDK。